ui-strings 0.1.3 → 0.1.5

package/README.md

@@ -15,9 +15,13 @@
 
 # UI Strings Scanner
 
-UI Strings Scanner lists every string that could reach the user in a React (JSX/TSX) codebase, without running the code. It parses the AST with [ts-morph](https://ts-morph.com/), so it works on any React project with one command: no build, no mocks, no runtime. Detection is built on JSX semantics, so it is React-only.
+UI Strings Scanner lists every string that could reach the user in a React (JSX/TSX) codebase. It parses the AST with [ts-morph](https://ts-morph.com/) instead of running the code, so one command covers any React project without a build step or a dev server. Detection relies on JSX semantics, so the scanner is React-only.
 
-Use it to audit hardcoded copy, review tone and wording, catch untranslated strings, or take stock before adopting i18n. It inventories strings; translation-key management is out of scope.
+Use it to audit hardcoded copy, review tone and wording, catch untranslated strings, or take stock before adopting i18n. The scanner inventories strings and leaves translation-key management to your i18n tooling.
+
+<img src="https://raw.githubusercontent.com/junseinagao/ui-strings-scanner/main/assets/report-page-view.png" alt="HTML report: every UI string grouped by route, with search, surface filters, and stats" />
+
+<p align="center"><i>The HTML report for <a href="https://github.com/shadcn-ui/ui">shadcn/ui</a>: 27,000+ strings from 3,550 files, grouped by route and laid out like the page.</i></p>
 
 ## Quick Start
 
@@ -42,14 +46,28 @@ Scanning: /path/to/my-app/src/**/*.{ts,tsx,js,jsx}
 → /path/to/my-app/ui-strings-report/ui-strings.html
 ```
 
+## Review copy, then fix it with your AI agent
+
+The HTML report doubles as a copy-review tool. Spot a string that needs work, click ✎, and type the new copy. The report shows old → new and keeps your edits across reloads.
+
+<img src="https://raw.githubusercontent.com/junseinagao/ui-strings-scanner/main/assets/report-inline-edit.png" alt="Inline editing in the report: the old string is struck through, the replacement shown next to it, with an edits bar at the bottom" />
+
+Once your pass is done, **Copy fix prompt** turns every edit into one prompt with `file:line` locations. Paste it into Claude Code, Cursor, Codex, or any coding agent, and the agent rewrites the exact literals you marked.
+
+<img src="https://raw.githubusercontent.com/junseinagao/ui-strings-scanner/main/assets/report-fix-prompt.png" alt="Fix Prompt modal: a generated prompt listing each edit as file path, line number, current text, and replacement text" />
+
+**Table view** shows one row per string with surface, kind, context, and location columns. Rows copy out as TSV for spreadsheet work.
+
+<img src="https://raw.githubusercontent.com/junseinagao/ui-strings-scanner/main/assets/report-table-view.png" alt="Table view: one row per string with surface, kind, context, and file:line location columns" />
+
 ## Features
 
 - **Sentence-level extraction** - `<p>Hello <b>world</b>,<br />welcome</p>` comes out as one string. Embedded expressions become `{count}` placeholders.
 - **Condition tracking** - Strings inside `cond ? A : B` or `cond && X` carry their condition, so you know when they show.
 - **Symbol resolution** - An option array rendered with `.map()` links back to its declaration, across import chains and `@/` aliases.
-- **Surface classification** - Every string is tagged by how it reaches the user: `visible`, `interactive`, `a11y`, `meta`, or `internal`.
-- **Noise filtering** - Class names, import paths, and directives never make the list. Structural rules combine with lexical shape, and non-Latin text always counts as copy, so mixed-language projects work.
-- **Next.js aware** - Entries group by App Router route, and `metadata` is classified as `meta`.
+- **Surface classification** - Every string carries a tag for how it reaches the user: `visible` (rendered as-is), `interactive` (toasts, validation, API messages), `a11y` (`aria-*`, `alt`, `title`), `meta` (Next.js metadata), or `internal` (console/throw).
+- **Noise filtering** - Class names, import paths, and directives never make the list. Detection combines a string's position (attribute, object key, call argument) with its shape, and treats non-Latin text as copy in any position, so mixed-language projects work.
+- **Next.js aware** - Entries group by App Router route, and `metadata` lands under `meta`.
 - **Fix prompts** - Edit strings in the HTML viewer, then copy all edits as a ready-to-run prompt for an AI coding agent.
 
 ## Usage
@@ -79,7 +97,7 @@ The scanner reads the target project's `tsconfig.json` when present and resolves
 
 ## Limitations
 
-Static analysis has limits. Strings built at runtime, such as API responses and computed values, stay invisible. Copy passed across components is captured at its declaration, and only the array `.map()` pattern resolves to a render site. Unknown copy attributes fall back to lexical detection.
+Strings built at runtime, such as API responses and computed values, stay invisible to static analysis. The scanner records copy passed across components at its declaration and resolves render sites only for the array `.map()` pattern. Unknown copy attributes fall back to lexical detection.
 
 ## Development
 

package/dist/cli.js

@@ -503,17 +503,30 @@ var surfaceFor = (classified, file) => {
   }
   return "visible";
 };
-var groupFor = (relativeFile, hasAppDir) => {
-  const parts = relativeFile.split(sep);
-  const appIndex = parts.indexOf("app");
-  if (hasAppDir && parts[0] === "src" && appIndex === 1) {
-    const segments = parts.slice(2, -1).filter((segment) => segment !== "_dependencies" && !(segment.startsWith("(") && segment.endsWith(")")));
-    return `/${segments.join("/")}`;
+var sharedPrefixLength = (files) => {
+  const first = files[0];
+  if (first === undefined) {
+    return 0;
+  }
+  let shared = first.length - 1;
+  for (const parts of files) {
+    const limit = Math.min(shared, parts.length - 1);
+    let i = 0;
+    while (i < limit && parts[i] === first[i]) {
+      i += 1;
+    }
+    shared = i;
   }
-  const dirs = parts.slice(0, -1);
-  if (dirs[0] === "src") {
-    dirs.shift();
+  const boundary = first.slice(0, shared).findIndex((segment) => segment === "src" || segment === "app");
+  return boundary === -1 ? shared : boundary;
+};
+var groupFor = (parts, hasAppDir) => {
+  const rest = parts[0] === "src" ? parts.slice(1) : parts;
+  if (hasAppDir && rest[0] === "app") {
+    const segments = rest.slice(1, -1).filter((segment) => segment !== "_dependencies" && !(segment.startsWith("(") && segment.endsWith(")")));
+    return `/${segments.slice(0, 2).join("/")}`;
   }
+  const dirs = rest.slice(0, -1);
   return dirs.slice(0, 2).join("/") || "(root)";
 };
 var DEFAULT_EXCLUDES = [
@@ -536,7 +549,13 @@ var scanProject = (options) => {
     `${projectDir}/${srcGlob}`,
     ...excludes.map((glob) => `!${projectDir}/${glob}`)
   ]);
-  const hasAppDir = sourceFiles.some((file) => relative(projectDir, file.getFilePath()).startsWith(`src${sep}app${sep}`));
+  const relativeParts = sourceFiles.map((file) => relative(projectDir, file.getFilePath()).split(sep));
+  const prefixLength = sharedPrefixLength(relativeParts);
+  const hasAppDir = relativeParts.some((parts) => {
+    const stripped = parts.slice(prefixLength);
+    const rest = stripped[0] === "src" ? stripped.slice(1) : stripped;
+    return rest[0] === "app" && rest.length > 1;
+  });
   const renderSites = new Map;
   for (const sourceFile of sourceFiles) {
     const relativeFile = relative(projectDir, sourceFile.getFilePath());
@@ -572,7 +591,7 @@ var scanProject = (options) => {
   const entries = [];
   for (const sourceFile of sourceFiles) {
     const relativeFile = relative(projectDir, sourceFile.getFilePath());
-    const group = groupFor(relativeFile, hasAppDir);
+    const group = groupFor(relativeFile.split(sep).slice(prefixLength), hasAppDir);
     const consumed = new Set;
     const nodeKey = (node) => `${node.getPos()}:${node.getEnd()}`;
     const push = (text, node, classified) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ui-strings",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Extract user-reachable UI strings from React (TS/TSX) codebases and generate JSON / Markdown / HTML reports",
   "type": "module",
   "bin": {