@jirawatpyk/aura-react 5.8.0 → 5.10.0

package/dist/styles.css

@@ -226,7 +226,13 @@ a.aura-btn { text-decoration: none; }
 }
 .aura-menu__item:hover, .aura-menu__item:focus { background: var(--aura-bg-surface-hover); outline: none; }
 .aura-menu__item:focus-visible { outline: var(--aura-focus-ring-width) solid var(--aura-focus-ring); outline-offset: calc(-1 * var(--aura-focus-ring-width)); }
-.aura-menu__item:disabled { opacity: var(--aura-disabled-opacity); cursor: default; background: transparent; }
+.aura-menu__item:disabled { opacity: var(--aura-disabled-opacity); cursor: default; }
+/* 5.10: a disabled item is dimmed but focusable; its reason stays at full strength (it is the information). */
+.aura-menu__item[aria-disabled="true"] { cursor: default; }
+.aura-menu__item[aria-disabled="true"] > :not(.aura-menu__reason) { opacity: var(--aura-disabled-opacity); }
+.aura-menu__reason { padding-left: var(--aura-space-4); }
+.aura-menu__item:disabled, .aura-menu__item[aria-disabled="true"]:hover:not(:focus) { background: transparent; }
+.aura-menu:focus, .aura-menu__list:focus { outline: none; }
 .aura-menu__item .aura-icon { color: var(--aura-fg-secondary); }
 .aura-menu__label { flex: 1; }
 .aura-menu__blank { width: var(--aura-icon-sm); flex: none; }
@@ -623,6 +629,7 @@ a.aura-tab { text-decoration: none; }
   font-size: 11px; line-height: 18px; text-align: center; font-variant-numeric: tabular-nums;
 }
 .aura-tabs__panel { padding-top: var(--aura-space-6); outline: none; }
+.aura-tabs__panel[hidden] { display: none; }
 .aura-tabs__panel:focus-visible { outline: var(--aura-focus-ring-width) solid var(--aura-focus-ring); outline-offset: 2px; border-radius: var(--aura-radius-sm); }
 
 /* ---------- SideNav ---------- */
@@ -1202,6 +1209,16 @@ button.aura-stepper__step:hover .aura-stepper__label { text-decoration: underlin
 .aura-segmented--sm .aura-segmented__option { height: 24px; padding: 0 var(--aura-space-3); font-size: 12px; }
 .aura-segmented--sm .aura-segmented__option.is-icon { width: 28px; padding: 0; }
 .aura-segmented.is-disabled { opacity: var(--aura-disabled-opacity); }
+/* 5.10 (Chamber-OS 72): Tabs variant="segmented" — the tablist wears SegmentedControl's track and pills. The focus
+ * ring is drawn inside the pill, so neither the scrolling list (many tabs on a phone) nor the next pill can cover it;
+ * full-width tabs share the track but never shrink below their label (the track scrolls instead). The phone rule's
+ * wider tab gap doesn't apply. */
+.aura-tabs--segmented .aura-tabs__list.aura-segmented { gap: 2px; }
+.aura-tabs--segmented .aura-tabs__list.aura-segmented.is-full .aura-tab { min-width: max-content; }
+.aura-tabs--segmented .aura-tab.aura-segmented__option { margin-bottom: 0; }
+.aura-tabs--segmented .aura-tab.aura-segmented__option:focus-visible { border-radius: var(--aura-radius-full); outline-offset: calc(-1 * var(--aura-focus-ring-width)); }
+.aura-tabs--segmented .aura-tab.aura-segmented__option:disabled,
+.aura-tabs--segmented .aura-tab.aura-segmented__option.is-disabled { opacity: var(--aura-disabled-opacity); cursor: not-allowed; }
 
 /* A field inside a row Stack takes the remaining width (a search box beside its button). */
 .aura-stack > .aura-field { flex: 1 1 auto; min-width: 0; }
@@ -1589,4 +1606,8 @@ button.aura-stepper__step:hover .aura-stepper__label { text-decoration: underlin
   .aura-segmented__option.is-selected { outline: 2px solid Highlight; outline-offset: -2px; }
   .aura-tab { border-bottom-color: Canvas; }
   .aura-tab.is-active { border-bottom-color: Highlight; }
+  /* 5.10: segmented tabs mark the selection with a border and focus with a dashed ring inside it, so a focused tab
+   * and the selected one never look alike (manual activation moves focus without selecting). */
+  .aura-tabs--segmented .aura-tab.aura-segmented__option.is-selected { outline: none; border: 2px solid Highlight; }
+  .aura-tabs--segmented .aura-tab.aura-segmented__option:focus-visible { outline: 2px dashed CanvasText; outline-offset: -5px; }
 }

package/dist/styles.layer.css

@@ -228,7 +228,13 @@ a.aura-btn { text-decoration: none; }
 }
 .aura-menu__item:hover, .aura-menu__item:focus { background: var(--aura-bg-surface-hover); outline: none; }
 .aura-menu__item:focus-visible { outline: var(--aura-focus-ring-width) solid var(--aura-focus-ring); outline-offset: calc(-1 * var(--aura-focus-ring-width)); }
-.aura-menu__item:disabled { opacity: var(--aura-disabled-opacity); cursor: default; background: transparent; }
+.aura-menu__item:disabled { opacity: var(--aura-disabled-opacity); cursor: default; }
+/* 5.10: a disabled item is dimmed but focusable; its reason stays at full strength (it is the information). */
+.aura-menu__item[aria-disabled="true"] { cursor: default; }
+.aura-menu__item[aria-disabled="true"] > :not(.aura-menu__reason) { opacity: var(--aura-disabled-opacity); }
+.aura-menu__reason { padding-left: var(--aura-space-4); }
+.aura-menu__item:disabled, .aura-menu__item[aria-disabled="true"]:hover:not(:focus) { background: transparent; }
+.aura-menu:focus, .aura-menu__list:focus { outline: none; }
 .aura-menu__item .aura-icon { color: var(--aura-fg-secondary); }
 .aura-menu__label { flex: 1; }
 .aura-menu__blank { width: var(--aura-icon-sm); flex: none; }
@@ -625,6 +631,7 @@ a.aura-tab { text-decoration: none; }
   font-size: 11px; line-height: 18px; text-align: center; font-variant-numeric: tabular-nums;
 }
 .aura-tabs__panel { padding-top: var(--aura-space-6); outline: none; }
+.aura-tabs__panel[hidden] { display: none; }
 .aura-tabs__panel:focus-visible { outline: var(--aura-focus-ring-width) solid var(--aura-focus-ring); outline-offset: 2px; border-radius: var(--aura-radius-sm); }
 
 /* ---------- SideNav ---------- */
@@ -1204,6 +1211,16 @@ button.aura-stepper__step:hover .aura-stepper__label { text-decoration: underlin
 .aura-segmented--sm .aura-segmented__option { height: 24px; padding: 0 var(--aura-space-3); font-size: 12px; }
 .aura-segmented--sm .aura-segmented__option.is-icon { width: 28px; padding: 0; }
 .aura-segmented.is-disabled { opacity: var(--aura-disabled-opacity); }
+/* 5.10 (Chamber-OS 72): Tabs variant="segmented" — the tablist wears SegmentedControl's track and pills. The focus
+ * ring is drawn inside the pill, so neither the scrolling list (many tabs on a phone) nor the next pill can cover it;
+ * full-width tabs share the track but never shrink below their label (the track scrolls instead). The phone rule's
+ * wider tab gap doesn't apply. */
+.aura-tabs--segmented .aura-tabs__list.aura-segmented { gap: 2px; }
+.aura-tabs--segmented .aura-tabs__list.aura-segmented.is-full .aura-tab { min-width: max-content; }
+.aura-tabs--segmented .aura-tab.aura-segmented__option { margin-bottom: 0; }
+.aura-tabs--segmented .aura-tab.aura-segmented__option:focus-visible { border-radius: var(--aura-radius-full); outline-offset: calc(-1 * var(--aura-focus-ring-width)); }
+.aura-tabs--segmented .aura-tab.aura-segmented__option:disabled,
+.aura-tabs--segmented .aura-tab.aura-segmented__option.is-disabled { opacity: var(--aura-disabled-opacity); cursor: not-allowed; }
 
 /* A field inside a row Stack takes the remaining width (a search box beside its button). */
 .aura-stack > .aura-field { flex: 1 1 auto; min-width: 0; }
@@ -1591,6 +1608,10 @@ button.aura-stepper__step:hover .aura-stepper__label { text-decoration: underlin
   .aura-segmented__option.is-selected { outline: 2px solid Highlight; outline-offset: -2px; }
   .aura-tab { border-bottom-color: Canvas; }
   .aura-tab.is-active { border-bottom-color: Highlight; }
+  /* 5.10: segmented tabs mark the selection with a border and focus with a dashed ring inside it, so a focused tab
+   * and the selected one never look alike (manual activation moves focus without selecting). */
+  .aura-tabs--segmented .aura-tab.aura-segmented__option.is-selected { outline: none; border: 2px solid Highlight; }
+  .aura-tabs--segmented .aura-tab.aura-segmented__option:focus-visible { outline: 2px dashed CanvasText; outline-offset: -5px; }
 }
 
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jirawatpyk/aura-react",
-  "version": "5.8.0",
+  "version": "5.10.0",
   "description": "AURA Design System — React components (Enterprise Standard, Human Creative). Thai-first: Buddhist-era dates, Thai collation.",
   "license": "MIT",
   "type": "module",
@@ -28,6 +28,36 @@
         "default": "./dist/server/index.cjs"
       }
     },
+    "./icons": {
+      "import": {
+        "types": "./dist/icons/index.d.ts",
+        "default": "./dist/esm/icons.js"
+      },
+      "require": {
+        "types": "./dist/icons/index.d.cts",
+        "default": "./dist/icons/index.cjs"
+      }
+    },
+    "./locales/th": {
+      "import": {
+        "types": "./dist/locales/th.d.ts",
+        "default": "./dist/esm/strings.th.js"
+      },
+      "require": {
+        "types": "./dist/locales/th.d.cts",
+        "default": "./dist/locales/th.cjs"
+      }
+    },
+    "./locales/sv": {
+      "import": {
+        "types": "./dist/locales/sv.d.ts",
+        "default": "./dist/esm/strings.sv.js"
+      },
+      "require": {
+        "types": "./dist/locales/sv.d.cts",
+        "default": "./dist/locales/sv.cjs"
+      }
+    },
     "./styles.css": "./dist/styles.css",
     "./styles.layer.css": "./dist/styles.layer.css",
     "./aura.bundle.js": "./dist/aura.bundle.js",
@@ -36,6 +66,7 @@
   "files": [
     "dist",
     "scripts/aura-theme.mjs",
+    "scripts/aura-icons-codemod.mjs",
     "README.md",
     "LICENSE"
   ],
@@ -45,7 +76,7 @@
   ],
   "scripts": {
     "build": "node scripts/build.ts && node scripts/sync-bundle.ts",
-    "test:ssr": "node scripts/ssr-test.ts && node --conditions=react-server scripts/server-entry-test.ts",
+    "test:ssr": "node scripts/ssr-test.ts && node scripts/prep60-test.ts && node --conditions=react-server scripts/server-entry-test.ts",
     "typecheck": "tsc -p tsconfig.src.json && tsc -p tsconfig.json && tsc -p tsconfig.exact.json && tsc -p examples/tsconfig.json",
     "examples": "node examples/build.ts",
     "themes": "node scripts/test-themes.ts",
@@ -76,7 +107,8 @@
     "@playwright/test": "^1.45.0"
   },
   "bin": {
-    "aura-theme": "scripts/aura-theme.mjs"
+    "aura-theme": "scripts/aura-theme.mjs",
+    "aura-icons-codemod": "scripts/aura-icons-codemod.mjs"
   },
   "repository": {
     "type": "git",

package/scripts/aura-icons-codemod.mjs

@@ -0,0 +1,345 @@
+#!/usr/bin/env node
+// @ts-check
+/* aura-icons-codemod (5.9) — moves icon names as strings to the per-icon components, ready for 6.0.
+ *   npx aura-icons-codemod src [more paths…] [--dry]
+ * In .tsx and .jsx files that import from @jirawatpyk/aura-react (or /server), for names in AURA's set, it rewrites
+ *   <Icon name="users" size={20} />               →  <IconUsers size={20} />
+ *   <Button icon="plus"> (icon / iconRight on an AURA component)  →  <Button icon={<IconPlus />}>
+ *   { id: 'home', label: 'Home', icon: 'house' }  →  { id: 'home', label: 'Home', icon: <IconHouse /> }
+ *     (an object literal with a `label` or `title`: nav, menu, tab and option items)
+ * and adds `import { IconHouse, IconPlus, IconUsers } from '@jirawatpyk/aura-react/icons'`. It reads the code with
+ * the TypeScript parser (your project's `typescript`), so types, strings and comments are never touched. Everything
+ * it leaves — names chosen at run time, items in .ts files, objects it isn't sure are AURA's, a name already taken by
+ * another import — is listed at the end: convert those by hand, or keep names with registerIcons(allIcons).
+ * --dry prints what would change and writes nothing. */
+import fs from 'node:fs';
+import path from 'node:path';
+import { createRequire } from 'node:module';
+import { fileURLToPath } from 'node:url';
+
+const here = path.dirname(fileURLToPath(import.meta.url));
+const iconsSrc = fs.readFileSync(path.join(here, '../dist/esm/icons.js'), 'utf8');
+const NAMES = new Set(Array.from(iconsSrc.matchAll(/defineIcon\d*\("([a-z0-9-]+)"/g), (m) => m[1]));
+/** @param {string} n */
+export const pascal = (n) =>
+  'Icon' +
+  n
+    .split('-')
+    .map((p) => p.charAt(0).toUpperCase() + p.slice(1))
+    .join('');
+
+/** TypeScript from the project being migrated, else from next to this package. */
+function loadTs() {
+  for (const from of [path.join(process.cwd(), 'package.json'), fileURLToPath(import.meta.url)]) {
+    try {
+      return createRequire(from)('typescript');
+    } catch (e) {
+      /* try the next */
+    }
+  }
+  return null;
+}
+/** @type {any} */
+let ts = null;
+
+const ROOT = '@jirawatpyk/aura-react';
+const ICONS = '@jirawatpyk/aura-react/icons';
+const ICON_PROPS = ['icon', 'iconRight'];
+
+/**
+ * Rewrites one file. Returns the new text, the icon names it imported, and notes on what it left.
+ * @param {string} src
+ * @param {string} [file]
+ */
+export function transform(src, file = 'file.tsx') {
+  if (!ts) ts = loadTs();
+  if (!ts) throw new Error('aura-icons-codemod needs TypeScript to read your code: npm i -D typescript');
+  /** @type {Set<string>} */
+  const used = new Set();
+  /** @type {string[]} */
+  const left = [];
+  const none = { code: src, used, left };
+  if (!/@jirawatpyk\/aura-react/.test(src)) return none;
+  const ext = path.extname(file).toLowerCase();
+  /** @type {Record<string, number>} */
+  const kinds = { '.tsx': ts.ScriptKind.TSX, '.ts': ts.ScriptKind.TS };
+  /* .js / .jsx / .mjs are read as JSX (plain JavaScript parses the same). */
+  const kind = kinds[ext] || ts.ScriptKind.JSX;
+  const sf = ts.createSourceFile(file, src, ts.ScriptTarget.Latest, true, kind);
+  /* An element can go where the file already allows JSX: .tsx/.jsx, or a .js file that has some. */
+  let jsx = ext === '.tsx' || ext === '.jsx';
+  if (!jsx && kind === ts.ScriptKind.JSX) {
+    const find = (/** @type {any} */ n) => {
+      if (jsx) return;
+      if (ts.isJsxElement(n) || ts.isJsxSelfClosingElement(n) || ts.isJsxFragment(n)) jsx = true;
+      else ts.forEachChild(n, find);
+    };
+    find(sf);
+  }
+  const nl = src.indexOf('\r\n') >= 0 ? '\r\n' : '\n';
+  const line = (/** @type {any} */ node) => sf.getLineAndCharacterOfPosition(node.getStart(sf)).line + 1;
+
+  /* AURA's components by local name, the namespace (`import * as Aura`), Icon's local name, the icons import. */
+  /** @type {Set<string>} */
+  const aura = new Set();
+  /** @type {string[]} */
+  const nsNames = [];
+  let iconLocal = '';
+  /** @type {any} */
+  let iconsImport = null;
+  /** @type {any} */
+  let lastImport = null;
+  /** Names bound by imports from anywhere else and top-level declarations — a new IconX must not collide. */
+  /** @type {Set<string>} */
+  const taken = new Set();
+  for (const st of sf.statements) {
+    if (!ts.isImportDeclaration(st)) continue;
+    lastImport = st;
+    const from = st.moduleSpecifier.text;
+    const cl = st.importClause;
+    if (from === ICONS) {
+      /* Merge into a value import only: names added to `import type { … }` couldn't be used as JSX. */
+      if (cl && !cl.isTypeOnly) iconsImport = st;
+      continue;
+    }
+    const mine = from === ROOT || from === ROOT + '/server';
+    if (!cl) continue;
+    if (cl.name) (mine ? aura : taken).add(cl.name.text);
+    const nb = cl.namedBindings;
+    if (nb && ts.isNamespaceImport(nb)) {
+      if (mine) nsNames.push(nb.name.text);
+      else taken.add(nb.name.text);
+    }
+    if (nb && ts.isNamedImports(nb))
+      for (const el of nb.elements) {
+        if (!mine) {
+          taken.add(el.name.text);
+          continue;
+        }
+        aura.add(el.name.text);
+        if ((el.propertyName || el.name).text === 'Icon') iconLocal = el.name.text;
+      }
+  }
+  if (!aura.size && !nsNames.length) return none;
+  /* Every name declared anywhere in the file (a local `const IconUsers` inside a component too): a new IconX that
+   * matches one would silently render the local thing. */
+  const declared = (/** @type {any} */ n) => {
+    if (
+      (ts.isVariableDeclaration(n) ||
+        ts.isParameter(n) ||
+        ts.isFunctionDeclaration(n) ||
+        ts.isClassDeclaration(n) ||
+        ts.isBindingElement(n)) &&
+      n.name &&
+      ts.isIdentifier(n.name)
+    )
+      taken.add(n.name.text);
+    ts.forEachChild(n, declared);
+  };
+  declared(sf);
+
+  const isAura = (/** @type {string} */ t) => aura.has(t) || nsNames.some((n) => t.startsWith(n + '.'));
+  const isIconTag = (/** @type {string} */ t) =>
+    (!!iconLocal && t === iconLocal) || nsNames.some((n) => t === n + '.Icon');
+  /** @type {Array<{ start: number, end: number, text: string }>} */
+  const edits = [];
+  /** A literal icon name in an attribute initializer or a property value, else null.
+   * @param {any} init @returns {string | null} */
+  const literal = (init) => {
+    if (!init) return null;
+    if (ts.isStringLiteral(init) || ts.isNoSubstitutionTemplateLiteral(init)) return init.text;
+    if (ts.isJsxExpression(init) && init.expression) return literal(init.expression);
+    if (ts.isParenthesizedExpression(init)) return literal(init.expression);
+    return null;
+  };
+  /** Can this name be imported as its component here? */
+  const usable = (/** @type {string} */ n, /** @type {any} */ node) => {
+    if (!NAMES.has(n)) return false;
+    if (taken.has(pascal(n))) {
+      left.push(line(node) + ': ' + pascal(n) + ' is already a name in this file — "' + n + '" left as a string');
+      return false;
+    }
+    return true;
+  };
+  const isElement = (/** @type {any} */ e) => !!e && (ts.isJsxElement(e) || ts.isJsxSelfClosingElement(e));
+
+  /** @param {any} node */
+  function visit(node) {
+    if (ts.isJsxSelfClosingElement(node) || ts.isJsxOpeningElement(node)) {
+      const tag = node.tagName.getText(sf);
+      if (isAura(tag)) {
+        for (const attr of node.attributes.properties) {
+          if (!ts.isJsxAttribute(attr)) continue;
+          const prop = attr.name.getText(sf);
+          const isName = prop === 'name' && isIconTag(tag);
+          if (!isName && ICON_PROPS.indexOf(prop) < 0) continue;
+          const init = attr.initializer;
+          const n = literal(init);
+          if (n == null) {
+            if (init && !(ts.isJsxExpression(init) && isElement(init.expression)))
+              left.push(line(attr) + ': ' + attr.getText(sf) + ' (chosen at run time)');
+            continue;
+          }
+          if (!usable(n, attr)) continue;
+          used.add(n);
+          if (isName) {
+            /* <Icon name="users" …> → <IconUsers …>: rename the tag (and a closing tag), drop `name`. */
+            edits.push({ start: node.tagName.getStart(sf), end: node.tagName.end, text: pascal(n) });
+            edits.push({ start: attr.getFullStart(), end: attr.end, text: '' });
+            if (ts.isJsxOpeningElement(node)) {
+              const close = node.parent.closingElement;
+              edits.push({ start: close.tagName.getStart(sf), end: close.tagName.end, text: pascal(n) });
+            }
+          } else edits.push({ start: init.getStart(sf), end: init.end, text: '{<' + pascal(n) + ' />}' });
+        }
+      }
+    }
+    if (ts.isPropertyAssignment(node) && ts.isObjectLiteralExpression(node.parent)) {
+      const key = ts.isIdentifier(node.name) || ts.isStringLiteral(node.name) ? node.name.text : '';
+      if (ICON_PROPS.indexOf(key) >= 0) {
+        const n = literal(node.initializer);
+        /* An item has a label or title that is text (a string, template or JSX), not a config object. */
+        const item = node.parent.properties.some(
+          (/** @type {any} */ p) =>
+            ts.isPropertyAssignment(p) &&
+            (ts.isIdentifier(p.name) || ts.isStringLiteral(p.name)) &&
+            (p.name.text === 'label' || p.name.text === 'title') &&
+            (ts.isStringLiteral(p.initializer) ||
+              ts.isNoSubstitutionTemplateLiteral(p.initializer) ||
+              ts.isTemplateExpression(p.initializer) ||
+              ts.isJsxElement(p.initializer) ||
+              ts.isJsxSelfClosingElement(p.initializer) ||
+              ts.isJsxFragment(p.initializer) ||
+              ts.isIdentifier(p.initializer) ||
+              ts.isPropertyAccessExpression(p.initializer) ||
+              ts.isCallExpression(p.initializer)),
+        );
+        if (n != null && NAMES.has(n)) {
+          if (!item)
+            left.push(
+              line(node) + ': ' + node.getText(sf) + " (an object with no label or title — AURA's? convert by hand)",
+            );
+          else if (!jsx)
+            left.push(line(node) + ': ' + node.getText(sf) + ' (in a ' + ext + ' file: an element needs JSX)');
+          else if (usable(n, node)) {
+            used.add(n);
+            edits.push({
+              start: node.initializer.getStart(sf),
+              end: node.initializer.end,
+              text: '<' + pascal(n) + ' />',
+            });
+          }
+        } else if (
+          n == null &&
+          item &&
+          (ts.isIdentifier(node.initializer) || ts.isPropertyAccessExpression(node.initializer))
+        )
+          left.push(line(node) + ': ' + node.getText(sf) + ' (chosen at run time)');
+      }
+    }
+    ts.forEachChild(node, visit);
+  }
+  visit(sf);
+  if (!edits.length) return { code: src, used, left };
+
+  /* The import: merged into an existing icons import, else after the last import (or after the directives). */
+  const names = Array.from(used, pascal);
+  const nbIcons =
+    iconsImport &&
+    iconsImport.importClause &&
+    !iconsImport.importClause.isTypeOnly &&
+    iconsImport.importClause.namedBindings;
+  if (nbIcons && ts.isNamedImports(nbIcons)) {
+    const have = nbIcons.elements.map((/** @type {any} */ e) => e.getText(sf));
+    const add = names.filter((x) => have.indexOf(x) < 0);
+    if (add.length)
+      edits.push({
+        start: nbIcons.getStart(sf),
+        end: nbIcons.end,
+        text: '{ ' + have.concat(add).sort().join(', ') + ' }',
+      });
+  } else {
+    let at = 0;
+    if (lastImport) {
+      /* After the import's line, so a trailing comment stays with it. */
+      const eol = src.indexOf('\n', lastImport.end);
+      at = eol < 0 ? src.length : src[eol - 1] === '\r' ? eol - 1 : eol;
+    } else
+      for (const st of sf.statements) {
+        if (ts.isExpressionStatement(st) && ts.isStringLiteral(st.expression)) at = st.end;
+        else break;
+      }
+    const text = 'import { ' + names.sort().join(', ') + " } from '" + ICONS + "';";
+    edits.push({ start: at, end: at, text: at ? nl + text : text + nl });
+  }
+  edits.sort((a, b) => b.start - a.start || b.end - a.end);
+  let code = src;
+  for (const e of edits) code = code.slice(0, e.start) + e.text + code.slice(e.end);
+
+  /* Drop AURA's Icon from its import when nothing uses it any more (not when it is the only name there). */
+  if (iconLocal) {
+    const again = ts.createSourceFile(file, code, ts.ScriptTarget.Latest, true, kind);
+    let refs = 0;
+    /** @type {any} */
+    let spec = null;
+    const count = (/** @type {any} */ n) => {
+      if (ts.isImportSpecifier(n) && n.name.text === iconLocal) spec = n;
+      else if (ts.isIdentifier(n) && n.text === iconLocal && !ts.isImportSpecifier(n.parent)) refs++;
+      ts.forEachChild(n, count);
+    };
+    count(again);
+    if (!refs && spec && spec.parent.elements.length > 1) {
+      const list = spec.parent.elements
+        .filter((/** @type {any} */ e) => e !== spec)
+        .map((/** @type {any} */ e) => e.getText(again));
+      code = code.slice(0, spec.parent.getStart(again)) + '{ ' + list.join(', ') + ' }' + code.slice(spec.parent.end);
+    }
+  }
+  return { code, used, left };
+}
+
+/** @param {string} p @param {string[]} out */
+function walk(p, out) {
+  const st = fs.statSync(p);
+  if (st.isDirectory()) {
+    for (const f of fs.readdirSync(p))
+      if (!/^(node_modules|dist|build|\.next|\.git)$/.test(f)) walk(path.join(p, f), out);
+  } else if (/\.(tsx|jsx|ts|js|mjs)$/.test(p) && !/\.d\.ts$/.test(p)) out.push(p);
+  return out;
+}
+
+if (process.argv[1] && fileURLToPath(import.meta.url) === fs.realpathSync(process.argv[1])) {
+  const argv = process.argv.slice(2);
+  const dry = argv.includes('--dry');
+  const roots = argv.filter((a) => !a.startsWith('--'));
+  if (!roots.length || argv.includes('--help')) {
+    console.log('Usage: aura-icons-codemod <files or folders…> [--dry]');
+    process.exit(roots.length ? 0 : 2);
+  }
+  if (!NAMES.size) {
+    console.error('aura-icons-codemod: no icons found in dist/esm/icons.js — is the package built?');
+    process.exit(2);
+  }
+  ts = loadTs();
+  if (!ts) {
+    console.error('aura-icons-codemod: needs TypeScript to read your code (it only parses): npm i -D typescript');
+    process.exit(2);
+  }
+  let changed = 0;
+  /** @type {string[]} */
+  const todo = [];
+  for (const f of roots.flatMap((r) => walk(r, []))) {
+    const src = fs.readFileSync(f, 'utf8');
+    const r = transform(src, f);
+    for (const l of r.left) todo.push(f + ':' + l);
+    if (r.code === src) continue;
+    changed++;
+    console.log((dry ? 'would change ' : 'changed ') + f + '  (' + Array.from(r.used, pascal).join(', ') + ')');
+    if (!dry) fs.writeFileSync(f, r.code);
+  }
+  console.log('\n' + changed + (changed === 1 ? ' file' : ' files') + (dry ? ' would change.' : ' changed.'));
+  if (todo.length) {
+    console.log('\nLeft as names — convert by hand, or keep them with registerIcons(allIcons):');
+    for (const t of todo) console.log('  ' + t);
+  }
+}