feat: add instant frontend ticker validation with debounced API verification

.gitignore

@@ -23,3 +23,4 @@ data/*_report.json
 data/feedback_logs.json
 data/feedback_staging/
 data/valid_tickers.json
+node_modules/

package-lock.json

@@ -0,0 +1,817 @@
+{
+  "name": "iris-ai-frontend-tests",
+  "version": "1.0.0",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "iris-ai-frontend-tests",
+      "version": "1.0.0",
+      "devDependencies": {
+        "jsdom": "^25.0.0"
+      }
+    },
+    "node_modules/@asamuzakjp/css-color": {
+      "version": "3.2.0",
+      "resolved": "https://registry.npmjs.org/@asamuzakjp/css-color/-/css-color-3.2.0.tgz",
+      "integrity": "sha512-K1A6z8tS3XsmCMM86xoWdn7Fkdn9m6RSVtocUrJYIwZnFVkng/PvkEoWtOWmP+Scc6saYWHWZYbndEEXxl24jw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@csstools/css-calc": "^2.1.3",
+        "@csstools/css-color-parser": "^3.0.9",
+        "@csstools/css-parser-algorithms": "^3.0.4",
+        "@csstools/css-tokenizer": "^3.0.3",
+        "lru-cache": "^10.4.3"
+      }
+    },
+    "node_modules/@csstools/color-helpers": {
+      "version": "5.1.0",
+      "resolved": "https://registry.npmjs.org/@csstools/color-helpers/-/color-helpers-5.1.0.tgz",
+      "integrity": "sha512-S11EXWJyy0Mz5SYvRmY8nJYTFFd1LCNV+7cXyAgQtOOuzb4EsgfqDufL+9esx72/eLhsRdGZwaldu/h+E4t4BA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/csstools"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/csstools"
+        }
+      ],
+      "license": "MIT-0",
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/@csstools/css-calc": {
+      "version": "2.1.4",
+      "resolved": "https://registry.npmjs.org/@csstools/css-calc/-/css-calc-2.1.4.tgz",
+      "integrity": "sha512-3N8oaj+0juUw/1H3YwmDDJXCgTB1gKU6Hc/bB502u9zR0q2vd786XJH9QfrKIEgFlZmhZiq6epXl4rHqhzsIgQ==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/csstools"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/csstools"
+        }
+      ],
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "@csstools/css-parser-algorithms": "^3.0.5",
+        "@csstools/css-tokenizer": "^3.0.4"
+      }
+    },
+    "node_modules/@csstools/css-color-parser": {
+      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/@csstools/css-color-parser/-/css-color-parser-3.1.0.tgz",
+      "integrity": "sha512-nbtKwh3a6xNVIp/VRuXV64yTKnb1IjTAEEh3irzS+HkKjAOYLTGNb9pmVNntZ8iVBHcWDA2Dof0QtPgFI1BaTA==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/csstools"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/csstools"
+        }
+      ],
+      "license": "MIT",
+      "dependencies": {
+        "@csstools/color-helpers": "^5.1.0",
+        "@csstools/css-calc": "^2.1.4"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "@csstools/css-parser-algorithms": "^3.0.5",
+        "@csstools/css-tokenizer": "^3.0.4"
+      }
+    },
+    "node_modules/@csstools/css-parser-algorithms": {
+      "version": "3.0.5",
+      "resolved": "https://registry.npmjs.org/@csstools/css-parser-algorithms/-/css-parser-algorithms-3.0.5.tgz",
+      "integrity": "sha512-DaDeUkXZKjdGhgYaHNJTV9pV7Y9B3b644jCLs9Upc3VeNGg6LWARAT6O+Q+/COo+2gg/bM5rhpMAtf70WqfBdQ==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/csstools"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/csstools"
+        }
+      ],
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "@csstools/css-tokenizer": "^3.0.4"
+      }
+    },
+    "node_modules/@csstools/css-tokenizer": {
+      "version": "3.0.4",
+      "resolved": "https://registry.npmjs.org/@csstools/css-tokenizer/-/css-tokenizer-3.0.4.tgz",
+      "integrity": "sha512-Vd/9EVDiu6PPJt9yAh6roZP6El1xHrdvIVGjyBsHR0RYwNHgL7FJPyIIW4fANJNG6FtyZfvlRPpFI4ZM/lubvw==",
+      "dev": true,
+      "funding": [
+        {
+          "type": "github",
+          "url": "https://github.com/sponsors/csstools"
+        },
+        {
+          "type": "opencollective",
+          "url": "https://opencollective.com/csstools"
+        }
+      ],
+      "license": "MIT",
+      "peer": true,
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/agent-base": {
+      "version": "7.1.4",
+      "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-7.1.4.tgz",
+      "integrity": "sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 14"
+      }
+    },
+    "node_modules/asynckit": {
+      "version": "0.4.0",
+      "resolved": "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz",
+      "integrity": "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/call-bind-apply-helpers": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
+      "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/combined-stream": {
+      "version": "1.0.8",
+      "resolved": "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.8.tgz",
+      "integrity": "sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "delayed-stream": "~1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.8"
+      }
+    },
+    "node_modules/cssstyle": {
+      "version": "4.6.0",
+      "resolved": "https://registry.npmjs.org/cssstyle/-/cssstyle-4.6.0.tgz",
+      "integrity": "sha512-2z+rWdzbbSZv6/rhtvzvqeZQHrBaqgogqt85sqFNbabZOuFbCVFb8kPeEtZjiKkbrm395irpNKiYeFeLiQnFPg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "@asamuzakjp/css-color": "^3.2.0",
+        "rrweb-cssom": "^0.8.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/cssstyle/node_modules/rrweb-cssom": {
+      "version": "0.8.0",
+      "resolved": "https://registry.npmjs.org/rrweb-cssom/-/rrweb-cssom-0.8.0.tgz",
+      "integrity": "sha512-guoltQEx+9aMf2gDZ0s62EcV8lsXR+0w8915TC3ITdn2YueuNjdAYh/levpU9nFaoChh9RUS5ZdQMrKfVEN9tw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/data-urls": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/data-urls/-/data-urls-5.0.0.tgz",
+      "integrity": "sha512-ZYP5VBHshaDAiVZxjbRVcFJpc+4xGgT0bK3vzy1HLN8jTO975HEbuYzZJcHoQEY5K1a0z8YayJkyVETa08eNTg==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "whatwg-mimetype": "^4.0.0",
+        "whatwg-url": "^14.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/debug": {
+      "version": "4.4.3",
+      "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
+      "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "ms": "^2.1.3"
+      },
+      "engines": {
+        "node": ">=6.0"
+      },
+      "peerDependenciesMeta": {
+        "supports-color": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/decimal.js": {
+      "version": "10.6.0",
+      "resolved": "https://registry.npmjs.org/decimal.js/-/decimal.js-10.6.0.tgz",
+      "integrity": "sha512-YpgQiITW3JXGntzdUmyUR1V812Hn8T1YVXhCu+wO3OpS4eU9l4YdD3qjyiKdV6mvV29zapkMeD390UVEf2lkUg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/delayed-stream": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz",
+      "integrity": "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=0.4.0"
+      }
+    },
+    "node_modules/dunder-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz",
+      "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "gopd": "^1.2.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/entities": {
+      "version": "6.0.1",
+      "resolved": "https://registry.npmjs.org/entities/-/entities-6.0.1.tgz",
+      "integrity": "sha512-aN97NXWF6AWBTahfVOIrB/NShkzi5H7F9r1s9mD3cDj4Ko5f2qhhVoYMibXF7GlLveb/D2ioWay8lxI97Ven3g==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">=0.12"
+      },
+      "funding": {
+        "url": "https://github.com/fb55/entities?sponsor=1"
+      }
+    },
+    "node_modules/es-define-property": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",
+      "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-errors": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",
+      "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-object-atoms": {
+      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz",
+      "integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/es-set-tostringtag": {
+      "version": "2.1.0",
+      "resolved": "https://registry.npmjs.org/es-set-tostringtag/-/es-set-tostringtag-2.1.0.tgz",
+      "integrity": "sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "es-errors": "^1.3.0",
+        "get-intrinsic": "^1.2.6",
+        "has-tostringtag": "^1.0.2",
+        "hasown": "^2.0.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/form-data": {
+      "version": "4.0.5",
+      "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.5.tgz",
+      "integrity": "sha512-8RipRLol37bNs2bhoV67fiTEvdTrbMUYcFTiy3+wuuOnUog2QBHCZWXDRijWQfAkhBj2Uf5UnVaiWwA5vdd82w==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "asynckit": "^0.4.0",
+        "combined-stream": "^1.0.8",
+        "es-set-tostringtag": "^2.1.0",
+        "hasown": "^2.0.2",
+        "mime-types": "^2.1.12"
+      },
+      "engines": {
+        "node": ">= 6"
+      }
+    },
+    "node_modules/function-bind": {
+      "version": "1.1.2",
+      "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
+      "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
+      "dev": true,
+      "license": "MIT",
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/get-intrinsic": {
+      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
+      "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "call-bind-apply-helpers": "^1.0.2",
+        "es-define-property": "^1.0.1",
+        "es-errors": "^1.3.0",
+        "es-object-atoms": "^1.1.1",
+        "function-bind": "^1.1.2",
+        "get-proto": "^1.0.1",
+        "gopd": "^1.2.0",
+        "has-symbols": "^1.1.0",
+        "hasown": "^2.0.2",
+        "math-intrinsics": "^1.1.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/get-proto": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz",
+      "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "dunder-proto": "^1.0.1",
+        "es-object-atoms": "^1.0.0"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/gopd": {
+      "version": "1.2.0",
+      "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
+      "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/has-symbols": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
+      "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/has-tostringtag": {
+      "version": "1.0.2",
+      "resolved": "https://registry.npmjs.org/has-tostringtag/-/has-tostringtag-1.0.2.tgz",
+      "integrity": "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "has-symbols": "^1.0.3"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      },
+      "funding": {
+        "url": "https://github.com/sponsors/ljharb"
+      }
+    },
+    "node_modules/hasown": {
+      "version": "2.0.2",
+      "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz",
+      "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "function-bind": "^1.1.2"
+      },
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/html-encoding-sniffer": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/html-encoding-sniffer/-/html-encoding-sniffer-4.0.0.tgz",
+      "integrity": "sha512-Y22oTqIU4uuPgEemfz7NDJz6OeKf12Lsu+QC+s3BVpda64lTiMYCyGwg5ki4vFxkMwQdeZDl2adZoqUgdFuTgQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "whatwg-encoding": "^3.1.1"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/http-proxy-agent": {
+      "version": "7.0.2",
+      "resolved": "https://registry.npmjs.org/http-proxy-agent/-/http-proxy-agent-7.0.2.tgz",
+      "integrity": "sha512-T1gkAiYYDWYx3V5Bmyu7HcfcvL7mUrTWiM6yOfa3PIphViJ/gFPbvidQ+veqSOHci/PxBcDabeUNCzpOODJZig==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "agent-base": "^7.1.0",
+        "debug": "^4.3.4"
+      },
+      "engines": {
+        "node": ">= 14"
+      }
+    },
+    "node_modules/https-proxy-agent": {
+      "version": "7.0.6",
+      "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-7.0.6.tgz",
+      "integrity": "sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "agent-base": "^7.1.2",
+        "debug": "4"
+      },
+      "engines": {
+        "node": ">= 14"
+      }
+    },
+    "node_modules/iconv-lite": {
+      "version": "0.6.3",
+      "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.6.3.tgz",
+      "integrity": "sha512-4fCk79wshMdzMp2rH06qWrJE4iolqLhCUH+OiuIgU++RB0+94NlDL81atO7GX55uUKueo0txHNtvEyI6D7WdMw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "safer-buffer": ">= 2.1.2 < 3.0.0"
+      },
+      "engines": {
+        "node": ">=0.10.0"
+      }
+    },
+    "node_modules/is-potential-custom-element-name": {
+      "version": "1.0.1",
+      "resolved": "https://registry.npmjs.org/is-potential-custom-element-name/-/is-potential-custom-element-name-1.0.1.tgz",
+      "integrity": "sha512-bCYeRA2rVibKZd+s2625gGnGF/t7DSqDs4dP7CrLA1m7jKWz6pps0LpYLJN8Q64HtmPKJ1hrN3nzPNKFEKOUiQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/jsdom": {
+      "version": "25.0.1",
+      "resolved": "https://registry.npmjs.org/jsdom/-/jsdom-25.0.1.tgz",
+      "integrity": "sha512-8i7LzZj7BF8uplX+ZyOlIz86V6TAsSs+np6m1kpW9u0JWi4z/1t+FzcK1aek+ybTnAC4KhBL4uXCNT0wcUIeCw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "cssstyle": "^4.1.0",
+        "data-urls": "^5.0.0",
+        "decimal.js": "^10.4.3",
+        "form-data": "^4.0.0",
+        "html-encoding-sniffer": "^4.0.0",
+        "http-proxy-agent": "^7.0.2",
+        "https-proxy-agent": "^7.0.5",
+        "is-potential-custom-element-name": "^1.0.1",
+        "nwsapi": "^2.2.12",
+        "parse5": "^7.1.2",
+        "rrweb-cssom": "^0.7.1",
+        "saxes": "^6.0.0",
+        "symbol-tree": "^3.2.4",
+        "tough-cookie": "^5.0.0",
+        "w3c-xmlserializer": "^5.0.0",
+        "webidl-conversions": "^7.0.0",
+        "whatwg-encoding": "^3.1.1",
+        "whatwg-mimetype": "^4.0.0",
+        "whatwg-url": "^14.0.0",
+        "ws": "^8.18.0",
+        "xml-name-validator": "^5.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      },
+      "peerDependencies": {
+        "canvas": "^2.11.2"
+      },
+      "peerDependenciesMeta": {
+        "canvas": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/lru-cache": {
+      "version": "10.4.3",
+      "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-10.4.3.tgz",
+      "integrity": "sha512-JNAzZcXrCt42VGLuYz0zfAzDfAvJWW6AfYlDBQyDV5DClI2m5sAmK+OIO7s59XfsRsWHp02jAJrRadPRGTt6SQ==",
+      "dev": true,
+      "license": "ISC"
+    },
+    "node_modules/math-intrinsics": {
+      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
+      "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.4"
+      }
+    },
+    "node_modules/mime-db": {
+      "version": "1.52.0",
+      "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz",
+      "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/mime-types": {
+      "version": "2.1.35",
+      "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz",
+      "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "mime-db": "1.52.0"
+      },
+      "engines": {
+        "node": ">= 0.6"
+      }
+    },
+    "node_modules/ms": {
+      "version": "2.1.3",
+      "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
+      "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/nwsapi": {
+      "version": "2.2.23",
+      "resolved": "https://registry.npmjs.org/nwsapi/-/nwsapi-2.2.23.tgz",
+      "integrity": "sha512-7wfH4sLbt4M0gCDzGE6vzQBo0bfTKjU7Sfpqy/7gs1qBfYz2vEJH6vXcBKpO3+6Yu1telwd0t9HpyOoLEQQbIQ==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/parse5": {
+      "version": "7.3.0",
+      "resolved": "https://registry.npmjs.org/parse5/-/parse5-7.3.0.tgz",
+      "integrity": "sha512-IInvU7fabl34qmi9gY8XOVxhYyMyuH2xUNpb2q8/Y+7552KlejkRvqvD19nMoUW/uQGGbqNpA6Tufu5FL5BZgw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "entities": "^6.0.0"
+      },
+      "funding": {
+        "url": "https://github.com/inikulin/parse5?sponsor=1"
+      }
+    },
+    "node_modules/punycode": {
+      "version": "2.3.1",
+      "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz",
+      "integrity": "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=6"
+      }
+    },
+    "node_modules/rrweb-cssom": {
+      "version": "0.7.1",
+      "resolved": "https://registry.npmjs.org/rrweb-cssom/-/rrweb-cssom-0.7.1.tgz",
+      "integrity": "sha512-TrEMa7JGdVm0UThDJSx7ddw5nVm3UJS9o9CCIZ72B1vSyEZoziDqBYP3XIoi/12lKrJR8rE3jeFHMok2F/Mnsg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/safer-buffer": {
+      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
+      "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/saxes": {
+      "version": "6.0.0",
+      "resolved": "https://registry.npmjs.org/saxes/-/saxes-6.0.0.tgz",
+      "integrity": "sha512-xAg7SOnEhrm5zI3puOOKyy1OMcMlIJZYNJY7xLBwSze0UjhPLnWfj2GF2EpT0jmzaJKIWKHLsaSSajf35bcYnA==",
+      "dev": true,
+      "license": "ISC",
+      "dependencies": {
+        "xmlchars": "^2.2.0"
+      },
+      "engines": {
+        "node": ">=v12.22.7"
+      }
+    },
+    "node_modules/symbol-tree": {
+      "version": "3.2.4",
+      "resolved": "https://registry.npmjs.org/symbol-tree/-/symbol-tree-3.2.4.tgz",
+      "integrity": "sha512-9QNk5KwDF+Bvz+PyObkmSYjI5ksVUYtjW7AU22r2NKcfLJcXp96hkDWU3+XndOsUb+AQ9QhfzfCT2O+CNWT5Tw==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/tldts": {
+      "version": "6.1.86",
+      "resolved": "https://registry.npmjs.org/tldts/-/tldts-6.1.86.tgz",
+      "integrity": "sha512-WMi/OQ2axVTf/ykqCQgXiIct+mSQDFdH2fkwhPwgEwvJ1kSzZRiinb0zF2Xb8u4+OqPChmyI6MEu4EezNJz+FQ==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "tldts-core": "^6.1.86"
+      },
+      "bin": {
+        "tldts": "bin/cli.js"
+      }
+    },
+    "node_modules/tldts-core": {
+      "version": "6.1.86",
+      "resolved": "https://registry.npmjs.org/tldts-core/-/tldts-core-6.1.86.tgz",
+      "integrity": "sha512-Je6p7pkk+KMzMv2XXKmAE3McmolOQFdxkKw0R8EYNr7sELW46JqnNeTX8ybPiQgvg1ymCoF8LXs5fzFaZvJPTA==",
+      "dev": true,
+      "license": "MIT"
+    },
+    "node_modules/tough-cookie": {
+      "version": "5.1.2",
+      "resolved": "https://registry.npmjs.org/tough-cookie/-/tough-cookie-5.1.2.tgz",
+      "integrity": "sha512-FVDYdxtnj0G6Qm/DhNPSb8Ju59ULcup3tuJxkFb5K8Bv2pUXILbf0xZWU8PX8Ov19OXljbUyveOFwRMwkXzO+A==",
+      "dev": true,
+      "license": "BSD-3-Clause",
+      "dependencies": {
+        "tldts": "^6.1.32"
+      },
+      "engines": {
+        "node": ">=16"
+      }
+    },
+    "node_modules/tr46": {
+      "version": "5.1.1",
+      "resolved": "https://registry.npmjs.org/tr46/-/tr46-5.1.1.tgz",
+      "integrity": "sha512-hdF5ZgjTqgAntKkklYw0R03MG2x/bSzTtkxmIRw/sTNV8YXsCJ1tfLAX23lhxhHJlEf3CRCOCGGWw3vI3GaSPw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "punycode": "^2.3.1"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/w3c-xmlserializer": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/w3c-xmlserializer/-/w3c-xmlserializer-5.0.0.tgz",
+      "integrity": "sha512-o8qghlI8NZHU1lLPrpi2+Uq7abh4GGPpYANlalzWxyWteJOCsr/P+oPBA49TOLu5FTZO4d3F9MnWJfiMo4BkmA==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "xml-name-validator": "^5.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/webidl-conversions": {
+      "version": "7.0.0",
+      "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-7.0.0.tgz",
+      "integrity": "sha512-VwddBukDzu71offAQR975unBIGqfKZpM+8ZX6ySk8nYhVoo5CYaZyzt3YBvYtRtO+aoGlqxPg/B87NGVZ/fu6g==",
+      "dev": true,
+      "license": "BSD-2-Clause",
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/whatwg-encoding": {
+      "version": "3.1.1",
+      "resolved": "https://registry.npmjs.org/whatwg-encoding/-/whatwg-encoding-3.1.1.tgz",
+      "integrity": "sha512-6qN4hJdMwfYBtE3YBTTHhoeuUrDBPZmbQaxWAqSALV/MeEnR5z1xd8UKud2RAkFoPkmB+hli1TZSnyi84xz1vQ==",
+      "deprecated": "Use @exodus/bytes instead for a more spec-conformant and faster implementation",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "iconv-lite": "0.6.3"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/whatwg-mimetype": {
+      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/whatwg-mimetype/-/whatwg-mimetype-4.0.0.tgz",
+      "integrity": "sha512-QaKxh0eNIi2mE9p2vEdzfagOKHCcj1pJ56EEHGQOVxp8r9/iszLUUV7v89x9O1p/T+NlTM5W7jW6+cz4Fq1YVg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/whatwg-url": {
+      "version": "14.2.0",
+      "resolved": "https://registry.npmjs.org/whatwg-url/-/whatwg-url-14.2.0.tgz",
+      "integrity": "sha512-De72GdQZzNTUBBChsXueQUnPKDkg/5A5zp7pFDuQAj5UFoENpiACU0wlCvzpAGnTkj++ihpKwKyYewn/XNUbKw==",
+      "dev": true,
+      "license": "MIT",
+      "dependencies": {
+        "tr46": "^5.1.0",
+        "webidl-conversions": "^7.0.0"
+      },
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/ws": {
+      "version": "8.19.0",
+      "resolved": "https://registry.npmjs.org/ws/-/ws-8.19.0.tgz",
+      "integrity": "sha512-blAT2mjOEIi0ZzruJfIhb3nps74PRWTCz1IjglWEEpQl5XS/UNama6u2/rjFkDDouqr4L67ry+1aGIALViWjDg==",
+      "dev": true,
+      "license": "MIT",
+      "engines": {
+        "node": ">=10.0.0"
+      },
+      "peerDependencies": {
+        "bufferutil": "^4.0.1",
+        "utf-8-validate": ">=5.0.2"
+      },
+      "peerDependenciesMeta": {
+        "bufferutil": {
+          "optional": true
+        },
+        "utf-8-validate": {
+          "optional": true
+        }
+      }
+    },
+    "node_modules/xml-name-validator": {
+      "version": "5.0.0",
+      "resolved": "https://registry.npmjs.org/xml-name-validator/-/xml-name-validator-5.0.0.tgz",
+      "integrity": "sha512-EvGK8EJ3DhaHfbRlETOWAS5pO9MZITeauHKJyb8wyajUfQUenkIg2MvLDTZ4T/TgIcm3HU0TFBgWWboAZ30UHg==",
+      "dev": true,
+      "license": "Apache-2.0",
+      "engines": {
+        "node": ">=18"
+      }
+    },
+    "node_modules/xmlchars": {
+      "version": "2.2.0",
+      "resolved": "https://registry.npmjs.org/xmlchars/-/xmlchars-2.2.0.tgz",
+      "integrity": "sha512-JZnDKK8B0RCDw84FNdDAIpZK+JuJw+s7Lz8nksI7SIuU3UXJJslUthsi+uWBUYOwPFwW7W7PRLRfUKpxjtjFCw==",
+      "dev": true,
+      "license": "MIT"
+    }
+  }
+}

package.json

@@ -0,0 +1,12 @@
+{
+  "name": "iris-ai-frontend-tests",
+  "version": "1.0.0",
+  "private": true,
+  "description": "Frontend unit tests for IRIS-AI ticker validation",
+  "scripts": {
+    "test": "node --test tests/test_ticker_validation.js"
+  },
+  "devDependencies": {
+    "jsdom": "^25.0.0"
+  }
+}

static/app.js

@@ -73,6 +73,162 @@ document.addEventListener('DOMContentLoaded', () => {
     let latestPredictedPrice = null;
     let latestAnalyzeHistory = [];
     let latestAnalyzeTimeframe = '6M';
+    // --- Validation UI elements ---
+    const inputWrapper    = document.getElementById('ticker-input-wrapper');
+    const clearBtn        = document.getElementById('ticker-clear');
+    const valIndicator    = document.getElementById('ticker-val-indicator');
+    const validationHint  = document.getElementById('validation-hint');
+    const validationMsgEl = document.getElementById('validation-msg');
+    const suggestionChips = document.getElementById('suggestion-chips');
+
+    // --- Validation state ---
+    let _validatedTicker  = null;   // non-null only when remote validation passed
+    let _debounceTimer    = null;
+    let _abortController  = null;
+
+    function _setInputState(state) {
+        // state: '' | 'error' | 'validating' | 'valid' | 'warn'
+        input.className = state ? `ticker-input--${state}` : '';
+        if (valIndicator) {
+            valIndicator.classList.toggle('is-spinning', state === 'validating');
+            valIndicator.classList.toggle('hidden', state !== 'validating');
+        }
+    }
+
+    function _showValidationHint(text, type) {
+        if (!validationMsgEl || !validationHint) return;
+        validationMsgEl.textContent = text;
+        validationMsgEl.className = `validation-msg validation-msg--${type}`;
+        validationHint.classList.remove('hidden');
+    }
+
+    function _clearValidationHint() {
+        if (validationHint) validationHint.classList.add('hidden');
+        if (validationMsgEl) validationMsgEl.textContent = '';
+        if (suggestionChips) suggestionChips.innerHTML = '';
+    }
+
+    function _renderSuggestions(suggestions) {
+        if (!suggestionChips) return;
+        suggestionChips.innerHTML = '';
+        if (!Array.isArray(suggestions) || !suggestions.length) return;
+        suggestions.forEach((s) => {
+            const chip = document.createElement('button');
+            chip.type = 'button';
+            chip.className = 'suggestion-chip';
+            chip.textContent = s;
+            chip.addEventListener('click', () => {
+                input.value = s;
+                _triggerValidation(s);
+            });
+            suggestionChips.appendChild(chip);
+        });
+    }
+
+    async function _triggerValidation(rawValue) {
+        const val = String(rawValue || '').trim().toUpperCase();
+
+        // Cancel previous in-flight remote request
+        if (_abortController) _abortController.abort();
+        _abortController = new AbortController();
+
+        // Instant format check
+        const fmt = (window.TickerValidation || {}).validateTickerFormat;
+        if (!fmt) return;
+        const fmtResult = fmt(val);
+        if (!fmtResult.valid) {
+            _validatedTicker = null;
+            analyzeBtn.disabled = true;
+            _setInputState('error');
+            _showValidationHint(fmtResult.error, 'error');
+            _renderSuggestions([]);
+            if (clearBtn) clearBtn.classList.toggle('hidden', !val);
+            return;
+        }
+
+        // Format OK → remote check
+        _validatedTicker = null;
+        analyzeBtn.disabled = true;
+        _setInputState('validating');
+        _clearValidationHint();
+        if (clearBtn) clearBtn.classList.remove('hidden');
+
+        const { signal } = _abortController;
+        const remoteCheck = (window.TickerValidation || {}).validateTickerRemote;
+        if (!remoteCheck) return;
+
+        const result = await remoteCheck(val, signal);
+        if (!result) return; // cancelled by a newer keystroke
+
+        if (result.valid) {
+            _validatedTicker = val;
+            analyzeBtn.disabled = false;
+            _setInputState('valid');
+            _showValidationHint(`✓ ${result.company_name || val}`, 'success');
+            _renderSuggestions([]);
+        } else {
+            _setInputState('error');
+            _showValidationHint(result.error || 'Ticker not found.', 'error');
+            _renderSuggestions(result.suggestions);
+        }
+    }
+
+    if (input) {
+        input.addEventListener('input', () => {
+            // Auto-uppercase as user types
+            const pos = input.selectionStart;
+            input.value = input.value.toUpperCase();
+            try { input.setSelectionRange(pos, pos); } catch (_) {}
+
+            if (clearBtn) clearBtn.classList.toggle('hidden', !input.value);
+
+            const val = input.value.trim();
+            clearTimeout(_debounceTimer);
+
+            // Instant format check for immediate feedback
+            const fmt = (window.TickerValidation || {}).validateTickerFormat;
+            if (fmt) {
+                const fmtResult = fmt(val);
+                if (!fmtResult.valid) {
+                    if (_abortController) _abortController.abort();
+                    _validatedTicker = null;
+                    analyzeBtn.disabled = true;
+                    _setInputState(val ? 'error' : '');
+                    if (val) {
+                        _showValidationHint(fmtResult.error, 'error');
+                    } else {
+                        _clearValidationHint();
+                        _setInputState('');
+                    }
+                    _renderSuggestions([]);
+                    return;
+                }
+            }
+
+            // Format OK — debounce the remote call
+            _validatedTicker = null;
+            analyzeBtn.disabled = true;
+            _setInputState('validating');
+            _clearValidationHint();
+            _debounceTimer = setTimeout(() => _triggerValidation(val), 500);
+        });
+    }
+
+    if (clearBtn) {
+        clearBtn.addEventListener('click', () => {
+            input.value = '';
+            _validatedTicker = null;
+            analyzeBtn.disabled = true;
+            clearTimeout(_debounceTimer);
+            if (_abortController) _abortController.abort();
+            _setInputState('');
+            _clearValidationHint();
+            clearBtn.classList.add('hidden');
+            input.focus();
+        });
+    }
+    // --- End ticker validation ---
+
     let historyRequestId = 0;
     const usdFormatter = new Intl.NumberFormat('en-US', { style: 'currency', currency: 'USD' });
 
@@ -324,6 +480,7 @@ document.addEventListener('DOMContentLoaded', () => {
             dashboard.classList.remove('hidden');
             currentTicker = String(data?.meta?.symbol || normalizedTicker).toUpperCase();
             input.value = currentTicker;
+            _validatedTicker = currentTicker; // keep in sync after successful analysis
             latestPredictedPrice = Number(data?.market?.predicted_price_next_session);
             latestAnalyzeHistory = normalizeHistoryPoints(data?.market?.history);
             latestAnalyzeTimeframe = getActiveTimeframe();
@@ -343,9 +500,8 @@ document.addEventListener('DOMContentLoaded', () => {
 
     form.addEventListener('submit', async (e) => {
         e.preventDefault();
-        const ticker = input.value.trim().toUpperCase();
-        if (!ticker) return;
-        await loadTickerData(ticker, false);
+        if (!_validatedTicker) return;
+        await loadTickerData(_validatedTicker, false);
     });
 
     timeframeButtons.forEach((btn) => {
@@ -471,7 +627,8 @@ document.addEventListener('DOMContentLoaded', () => {
         } else {
             btnText.classList.remove('hidden');
             spinner.classList.add('hidden');
-            analyzeBtn.disabled = false;
+            // Only re-enable if the current input is still validated
+            analyzeBtn.disabled = !_validatedTicker;
             timeframeButtons.forEach((btn) => { btn.disabled = false; });
         }
     }

static/style.css

@@ -1206,4 +1206,124 @@ footer p {
     .search-box button {
         padding: 0.8rem 1.5rem;
     }
+}
+
+/* ============================================================
+   Ticker input validation states
+   ============================================================ */
+
+/* -- Input wrapper (positions clear btn + indicator) -- */
+.input-wrapper {
+    position: relative;
+    flex: 1;
+    display: flex;
+}
+
+.input-wrapper input {
+    width: 100%;
+    padding-right: 3rem; /* room for clear btn */
+}
+
+/* -- Clear button (× inside the field) -- */
+.ticker-clear {
+    position: absolute;
+    right: 0.75rem;
+    top: 50%;
+    transform: translateY(-50%);
+    background: none;
+    border: none;
+    cursor: pointer;
+    color: var(--text-muted);
+    font-size: 1.2rem;
+    line-height: 1;
+    padding: 0.2rem 0.3rem;
+    border-radius: 4px;
+    transition: color 0.2s ease;
+}
+.ticker-clear:hover {
+    color: var(--text-main);
+}
+
+/* -- Small inline validation indicator (spinner / checkmark) -- */
+.ticker-val-indicator {
+    position: absolute;
+    right: 2.2rem;
+    top: 50%;
+    transform: translateY(-50%);
+    width: 16px;
+    height: 16px;
+    pointer-events: none;
+}
+
+/* spinning ring while remote validation is running */
+.ticker-val-indicator.is-spinning {
+    border: 2px solid var(--accent-blue-glow);
+    border-top-color: var(--accent-blue);
+    border-radius: 50%;
+    animation: spin 0.8s linear infinite;
+}
+
+/* -- Input border states -- */
+#ticker-input.ticker-input--error {
+    border-color: var(--status-red);
+    box-shadow: 0 0 0 3px var(--status-red-glow);
+}
+
+#ticker-input.ticker-input--validating {
+    border-color: var(--accent-blue);
+    box-shadow: 0 0 0 3px var(--accent-blue-glow);
+}
+
+#ticker-input.ticker-input--valid {
+    border-color: var(--status-green);
+    box-shadow: 0 0 0 3px var(--status-green-glow);
+}
+
+#ticker-input.ticker-input--warn {
+    border-color: var(--status-yellow);
+    box-shadow: 0 0 0 3px var(--status-yellow-glow);
+}
+
+/* -- Validation hint area below the search box -- */
+.validation-hint {
+    margin-top: 0.6rem;
+    text-align: left;
+}
+
+.validation-msg {
+    display: block;
+    font-size: 0.88rem;
+    font-weight: 500;
+    margin-bottom: 0.4rem;
+}
+
+.validation-msg--error { color: var(--status-red); }
+.validation-msg--success { color: var(--status-green); }
+.validation-msg--warn { color: var(--status-yellow); }
+.validation-msg--info { color: var(--text-muted); }
+
+/* -- Suggestion chips -- */
+.suggestion-chips {
+    display: flex;
+    flex-wrap: wrap;
+    gap: 0.4rem;
+    margin-top: 0.25rem;
+}
+
+.suggestion-chip {
+    padding: 0.25rem 0.75rem;
+    border-radius: 999px;
+    border: 1px solid var(--panel-border);
+    background: var(--bg-subtle);
+    color: var(--accent-blue);
+    font-size: 0.82rem;
+    font-weight: 600;
+    cursor: pointer;
+    transition: background 0.2s ease, box-shadow 0.2s ease;
+}
+
+.suggestion-chip:hover {
+    background: var(--accent-blue);
+    color: var(--text-inverse);
+    box-shadow: 0 0 0 2px var(--accent-blue-glow);
 }

static/tickerValidation.js

@@ -0,0 +1,93 @@
+/**
+ * Ticker validation utilities — usable in browser (sets window.TickerValidation)
+ * and in Node.js (module.exports) for unit testing.
+ */
+(function (root, factory) {
+    if (typeof module !== 'undefined' && module.exports) {
+        module.exports = factory();       // Node.js / CommonJS
+    } else {
+        root.TickerValidation = factory(); // browser global
+    }
+}(typeof self !== 'undefined' ? self : this, function () {
+    'use strict';
+
+    const _RESERVED = new Set(['TEST', 'NULL', 'NONE', 'HELP', 'NA']);
+
+    /**
+     * Instant client-side format check — no network call.
+     * @param {string} input
+     * @returns {{ valid: boolean, error?: string, cleaned?: string }}
+     */
+    function validateTickerFormat(input) {
+        const cleaned = String(input == null ? '' : input).trim().toUpperCase();
+
+        if (!cleaned) {
+            return { valid: false, error: 'Please enter a stock ticker symbol.' };
+        }
+        if (!/^[A-Z]+$/.test(cleaned)) {
+            return { valid: false, error: 'Tickers contain only letters (e.g., AAPL, MSFT).' };
+        }
+        if (cleaned.length > 5) {
+            return { valid: false, error: 'US stock tickers are 1-5 letters long.' };
+        }
+        if (_RESERVED.has(cleaned)) {
+            return { valid: false, error: `"${cleaned}" is not a stock ticker.` };
+        }
+        return { valid: true, cleaned };
+    }
+
+    /**
+     * Server-side ticker verification via POST /api/validate-ticker.
+     * Accepts an optional AbortSignal for external cancellation.
+     * A 5-second internal timeout is always applied.
+     *
+     * @param {string} ticker  — already-normalised uppercase ticker
+     * @param {AbortSignal|null} [externalSignal]
+     * @returns {Promise<{valid: boolean, ticker?: string, company_name?: string,
+     *                    error?: string, suggestions?: string[]} | null>}
+     *   Returns null when cancelled via externalSignal (caller should ignore the result).
+     */
+    async function validateTickerRemote(ticker, externalSignal) {
+        const timeoutController = new AbortController();
+        const timeoutId = setTimeout(() => timeoutController.abort(), 5000);
+
+        // Forward external cancellation to our timeout controller
+        let onExternalAbort = null;
+        if (externalSignal) {
+            if (externalSignal.aborted) {
+                clearTimeout(timeoutId);
+                return null;
+            }
+            onExternalAbort = () => { clearTimeout(timeoutId); timeoutController.abort(); };
+            externalSignal.addEventListener('abort', onExternalAbort, { once: true });
+        }
+
+        try {
+            const response = await fetch('/api/validate-ticker', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ ticker }),
+                signal: timeoutController.signal,
+            });
+            clearTimeout(timeoutId);
+            if (externalSignal && onExternalAbort) {
+                externalSignal.removeEventListener('abort', onExternalAbort);
+            }
+            return await response.json();
+        } catch (err) {
+            clearTimeout(timeoutId);
+            if (externalSignal && onExternalAbort) {
+                externalSignal.removeEventListener('abort', onExternalAbort);
+            }
+            if (err.name === 'AbortError') {
+                if (externalSignal && externalSignal.aborted) {
+                    return null; // cancelled externally — caller should ignore
+                }
+                return { valid: false, error: 'Validation timed out. Please try again.' };
+            }
+            return { valid: false, error: 'Network error. Please check your connection.' };
+        }
+    }
+
+    return { validateTickerFormat, validateTickerRemote };
+}));

templates/index.html

@@ -49,14 +49,25 @@
             <h2>Enter Ticker to Analyze</h2>
             <form id="analyze-form">
                 <div class="search-box">
-                    <input type="text" id="ticker-input" placeholder="e.g. AAPL, TSLA, NVDA" required
-                        autocomplete="off">
-                    <button type="submit" id="analyze-btn">
+                    <div class="input-wrapper" id="ticker-input-wrapper">
+                        <input type="text" id="ticker-input"
+                            placeholder="Enter stock ticker (e.g., AAPL)"
+                            autocomplete="off" spellcheck="false" maxlength="10">
+                        <button type="button" id="ticker-clear" class="ticker-clear hidden"
+                            aria-label="Clear input" tabindex="-1">×</button>
+                        <span id="ticker-val-indicator" class="ticker-val-indicator hidden"
+                            aria-hidden="true"></span>
+                    </div>
+                    <button type="submit" id="analyze-btn" disabled>
                         <span class="btn-text">Analyze Risk</span>
                         <div class="spinner hidden" id="loading-spinner"></div>
                     </button>
                 </div>
             </form>
+            <div id="validation-hint" class="validation-hint hidden">
+                <span id="validation-msg" class="validation-msg"></span>
+                <div id="suggestion-chips" class="suggestion-chips"></div>
+            </div>
             <div id="error-message" class="error-msg hidden"></div>
         </section>
 
@@ -158,7 +169,8 @@
     <!-- TradingView Lightweight Charts -->
     <script
         src="https://unpkg.com/lightweight-charts@4.1.1/dist/lightweight-charts.standalone.production.js?v=4"></script>
-    <script src="/static/app.js?v=18"></script>
+    <script src="/static/tickerValidation.js?v=1"></script>
+    <script src="/static/app.js?v=19"></script>
 </body>
 
 </html>

tests/test_ticker_validation.js

@@ -0,0 +1,291 @@
+'use strict';
+/**
+ * Unit tests for tickerValidation.js and the TickerInput component behaviour.
+ * Run with:  node --test tests/test_ticker_validation.js
+ * Requires:  npm install   (installs jsdom for DOM tests)
+ */
+
+const { test, describe } = require('node:test');
+const assert = require('node:assert/strict');
+const path = require('node:path');
+const { JSDOM } = require('jsdom');
+
+// Load the validation module (UMD — sets module.exports in Node.js)
+const { validateTickerFormat, validateTickerRemote } = require(
+    path.join(__dirname, '..', 'static', 'tickerValidation.js')
+);
+
+// ---------------------------------------------------------------------------
+// Pure format-validation tests (no DOM, no network)
+// ---------------------------------------------------------------------------
+
+describe('validateTickerFormat', () => {
+
+    test('test_empty_input_shows_error — empty string returns error', () => {
+        const result = validateTickerFormat('');
+        assert.equal(result.valid, false);
+        assert.match(result.error, /Please enter/i);
+    });
+
+    test('test_empty_input_shows_error — whitespace-only returns error', () => {
+        const result = validateTickerFormat('   ');
+        assert.equal(result.valid, false);
+        assert.match(result.error, /Please enter/i);
+    });
+
+    test('test_numbers_rejected_instantly — digits in input', () => {
+        for (const bad of ['123', '1A', 'A1B', '9XYZ']) {
+            const result = validateTickerFormat(bad);
+            assert.equal(result.valid, false,
+                `Expected "${bad}" to be rejected`);
+            assert.match(result.error, /only letters/i);
+        }
+    });
+
+    test('test_too_long_ticker_rejected — 6+ letters rejected', () => {
+        const result = validateTickerFormat('ABCDEF');
+        assert.equal(result.valid, false);
+        assert.match(result.error, /1-5 letters/i);
+    });
+
+    test('reserved words rejected', () => {
+        for (const word of ['TEST', 'NULL', 'NONE', 'HELP', 'NA']) {
+            const result = validateTickerFormat(word);
+            assert.equal(result.valid, false,
+                `Expected "${word}" to be rejected as reserved`);
+            assert.match(result.error, /not a stock ticker/i);
+        }
+    });
+
+    test('test_valid_format_triggers_remote_check — valid formats pass', () => {
+        for (const good of ['AAPL', 'msft', ' TSLA ', 'A', 'GOOGL']) {
+            const result = validateTickerFormat(good);
+            assert.equal(result.valid, true,
+                `Expected "${good}" to pass format check`);
+            assert.equal(result.cleaned, good.trim().toUpperCase());
+        }
+    });
+});
+
+// ---------------------------------------------------------------------------
+// DOM behaviour tests (requires jsdom)
+// ---------------------------------------------------------------------------
+
+/** Build a minimal DOM that mirrors the search section in index.html */
+function buildDOM() {
+    const dom = new JSDOM(`<!DOCTYPE html>
+<html><body>
+  <form id="analyze-form">
+    <div class="search-box">
+      <div class="input-wrapper" id="ticker-input-wrapper">
+        <input type="text" id="ticker-input" />
+        <button type="button" id="ticker-clear" class="ticker-clear hidden">×</button>
+        <span id="ticker-val-indicator" class="ticker-val-indicator hidden"></span>
+      </div>
+      <button type="submit" id="analyze-btn" disabled>
+        <span class="btn-text">Analyze Risk</span>
+      </button>
+    </div>
+  </form>
+  <div id="validation-hint" class="hidden">
+    <span id="validation-msg"></span>
+    <div id="suggestion-chips"></div>
+  </div>
+  <div id="error-message" class="error-msg hidden"></div>
+</body></html>`, { runScripts: 'dangerously', pretendToBeVisual: true });
+
+    const { window } = dom;
+
+    // Expose TickerValidation in the fake window before loading app logic
+    window.TickerValidation = { validateTickerFormat, validateTickerRemote };
+
+    return { window, document: window.document };
+}
+
+/**
+ * Wire up a minimal version of the validation logic from app.js so we can
+ * test component behaviour without importing the full 1 000-line app.js
+ * (which has heavyweight dependencies like LightweightCharts).
+ */
+function wireValidation(window) {
+    const { document } = window;
+    const input         = document.getElementById('ticker-input');
+    const analyzeBtn    = document.getElementById('analyze-btn');
+    const clearBtn      = document.getElementById('ticker-clear');
+    const validationHint  = document.getElementById('validation-hint');
+    const validationMsgEl = document.getElementById('validation-msg');
+    const suggestionChips = document.getElementById('suggestion-chips');
+
+    let _validatedTicker = null;
+    let _debounceTimer   = null;
+    let _abortController = null;
+
+    function getValidatedTicker() { return _validatedTicker; }
+
+    function _setInputState(state) {
+        input.className = state ? `ticker-input--${state}` : '';
+    }
+
+    function _showHint(text, type) {
+        validationMsgEl.textContent = text;
+        validationMsgEl.className = `validation-msg validation-msg--${type}`;
+        validationHint.classList.remove('hidden');
+    }
+
+    function _clearHint() {
+        validationHint.classList.add('hidden');
+        validationMsgEl.textContent = '';
+        suggestionChips.innerHTML = '';
+    }
+
+    function _renderSuggestions(suggestions) {
+        suggestionChips.innerHTML = '';
+        if (!Array.isArray(suggestions)) return;
+        suggestions.forEach((s) => {
+            const chip = document.createElement('button');
+            chip.type = 'button';
+            chip.className = 'suggestion-chip';
+            chip.textContent = s;
+            chip.addEventListener('click', () => {
+                input.value = s;
+                triggerValidation(s);
+            });
+            suggestionChips.appendChild(chip);
+        });
+    }
+
+    async function triggerValidation(rawValue) {
+        const val = String(rawValue || '').trim().toUpperCase();
+        if (_abortController) _abortController.abort();
+        _abortController = new window.AbortController();
+
+        const fmt = window.TickerValidation.validateTickerFormat(val);
+        if (!fmt.valid) {
+            _validatedTicker = null;
+            analyzeBtn.disabled = true;
+            _setInputState('error');
+            _showHint(fmt.error, 'error');
+            _renderSuggestions([]);
+            return;
+        }
+
+        _validatedTicker = null;
+        analyzeBtn.disabled = true;
+        _setInputState('validating');
+        _clearHint();
+
+        const { signal } = _abortController;
+        const result = await window.TickerValidation.validateTickerRemote(val, signal);
+        if (!result) return;
+
+        if (result.valid) {
+            _validatedTicker = val;
+            analyzeBtn.disabled = false;
+            _setInputState('valid');
+            _showHint(`✓ ${result.company_name || val}`, 'success');
+            _renderSuggestions([]);
+        } else {
+            _setInputState('error');
+            _showHint(result.error || 'Not found.', 'error');
+            _renderSuggestions(result.suggestions || []);
+        }
+    }
+
+    input.addEventListener('input', () => {
+        input.value = input.value.toUpperCase();
+        clearBtn.classList.toggle('hidden', !input.value);
+        const val = input.value.trim();
+        clearTimeout(_debounceTimer);
+
+        const fmt = window.TickerValidation.validateTickerFormat(val);
+        if (!fmt.valid) {
+            if (_abortController) _abortController.abort();
+            _validatedTicker = null;
+            analyzeBtn.disabled = true;
+            _setInputState(val ? 'error' : '');
+            if (val) _showHint(fmt.error, 'error');
+            else _clearHint();
+            _renderSuggestions([]);
+            return;
+        }
+
+        _validatedTicker = null;
+        analyzeBtn.disabled = true;
+        _setInputState('validating');
+        _clearHint();
+        _debounceTimer = setTimeout(() => triggerValidation(val), 500);
+    });
+
+    clearBtn.addEventListener('click', () => {
+        input.value = '';
+        _validatedTicker = null;
+        analyzeBtn.disabled = true;
+        clearTimeout(_debounceTimer);
+        if (_abortController) _abortController.abort();
+        _setInputState('');
+        _clearHint();
+        clearBtn.classList.add('hidden');
+    });
+
+    return { input, analyzeBtn, clearBtn, validationHint, validationMsgEl,
+             suggestionChips, triggerValidation, getValidatedTicker };
+}
+
+// Helper: fire input event
+function fireInput(input, value) {
+    input.value = value;
+    input.dispatchEvent(new input.ownerDocument.defaultView.Event('input', { bubbles: true }));
+}
+
+describe('TickerInput DOM behaviour', () => {
+
+    test('test_submit_disabled_until_valid — button starts disabled', () => {
+        const { document } = buildDOM();
+        const btn = document.getElementById('analyze-btn');
+        assert.equal(btn.disabled, true);
+    });
+
+    test('test_suggestion_click_fills_input — clicking chip fills input', async () => {
+        const { window } = buildDOM();
+
+        // Mock validateTickerRemote to return suggestions for a bad ticker
+        window.TickerValidation.validateTickerRemote = async () => ({
+            valid: false,
+            error: 'Not found.',
+            suggestions: ['AAPL', 'APD'],
+        });
+
+        const { input, suggestionChips, triggerValidation } = wireValidation(window);
+
+        await triggerValidation('AAPL1'); // invalid format handled locally
+        // Use a format-valid but server-rejected ticker to get suggestions
+        // Bypass format check by directly calling with a valid-format ticker
+        // Override validateTickerFormat temporarily
+        const original = window.TickerValidation.validateTickerFormat;
+        window.TickerValidation.validateTickerFormat = () => ({ valid: true, cleaned: 'AAPX' });
+        await triggerValidation('AAPX');
+        window.TickerValidation.validateTickerFormat = original;
+
+        const chips = suggestionChips.querySelectorAll('.suggestion-chip');
+        assert.ok(chips.length > 0, 'Expected suggestion chips to be rendered');
+
+        // Click the first chip — it should fill the input
+        chips[0].click();
+        assert.equal(input.value, chips[0].textContent);
+    });
+
+    test('test_submit_disabled_until_valid — button enabled after valid remote result', async () => {
+        const { window } = buildDOM();
+        window.TickerValidation.validateTickerRemote = async () => ({
+            valid: true,
+            ticker: 'AAPL',
+            company_name: 'Apple Inc.',
+        });
+
+        const { analyzeBtn, triggerValidation } = wireValidation(window);
+
+        assert.equal(analyzeBtn.disabled, true, 'Should start disabled');
+        await triggerValidation('AAPL');
+        assert.equal(analyzeBtn.disabled, false, 'Should be enabled after valid result');
+    });
+});