@jc-times/business-ui 0.2.55 → 0.3.0

package/README.md

@@ -1,55 +1,55 @@
-# @jc-times/business-ui
-
-精诚时代业务应用共用的 React 基础组件与交互标准。公共包负责通用 UI、无障碍与响应式；权限、接口、业务文案和合同、客户、订单、ERP 等领域状态由消费应用提供。
-
-**Agent 从 [docs/agent-guide.md](docs/agent-guide.md) 开始阅读：按需求选组件，再查 API 和专题。** 本仓库 [AGENTS.md](AGENTS.md) 同样指向该入口。
-
-## 安装与引入
-
-内部 registry 为 GitHub Packages（`https://npm.pkg.github.com`）。按 [发布与消费说明](docs/release.md) 配置访问，选择已发布的精确版本并提交锁文件；受控 tarball 消费也必须固定版本和制品。不要复制源码、跨仓库引用源文件或使用目录软链接。
-
-```tsx
-import { Button, ModalShell } from "@jc-times/business-ui";
-import "@jc-times/business-ui/styles.css";
-```
-
-React 等 peer dependencies 按所安装版本的 package.json 配置。应用通过 `--ui-*` 语义令牌提供主题；普通控件默认 40px，粗指针触屏最小 44px。
-
-文档查看器、行政区划数据、纯金额格式化使用独立子入口；对应导入与依赖见专题文档。仓库工作树中的新入口不代表消费方已安装或该能力已发布。
-
-## 文档导航
-
-| 文档 | 用途 |
-| --- | --- |
+# @jc-times/business-ui
+
+精诚时代业务应用共用的 React 基础组件与交互标准。公共包负责通用 UI、无障碍与响应式；权限、接口、业务文案和合同、客户、订单、ERP 等领域状态由消费应用提供。
+
+**Agent 从 [docs/agent-guide.md](docs/agent-guide.md) 开始阅读：按需求选组件，再查 API 和专题。** 本仓库 [AGENTS.md](AGENTS.md) 同样指向该入口。
+
+## 安装与引入
+
+内部 registry 为 GitHub Packages（`https://npm.pkg.github.com`）。按 [发布与消费说明](docs/release.md) 配置访问，选择已发布的精确版本并提交锁文件；受控 tarball 消费也必须固定版本和制品。不要复制源码、跨仓库引用源文件或使用目录软链接。
+
+```tsx
+import { Button, ModalShell } from "@jc-times/business-ui";
+import "@jc-times/business-ui/styles.css";
+```
+
+React 等 peer dependencies 按所安装版本的 package.json 配置。应用通过 `--ui-*` 语义令牌提供主题；普通控件默认 40px，粗指针触屏最小 44px。
+
+文档查看器、行政区划数据、纯金额格式化使用独立子入口；对应导入与依赖见专题文档。仓库工作树中的新入口不代表消费方已安装或该能力已发布。
+
+## 文档导航
+
+| 文档 | 用途 |
+| --- | --- |
 | [Agent 使用指南](docs/agent-guide.md) | 场景选型、组件组合、边界和接入检查 |
 | [依赖维护](docs/dependencies.md) | 稳定版本核查、兼容例外、消费迁移要求 |
 | [公共 API](docs/api.md) | 公共行为、参数说明、数字输入与装饰示例；完整签名见安装包类型声明 |
 | [DataTable 与 MRT 迁移](docs/data-table.md) | 公共表格替代、旧参数兼容、完整配置、独立入口与合并明细；0.2.31起提供 |
 | [表格能力与 MRT 样例](docs/mrt-poc.md) | DataTable边界、筛选/列管理、产品行合并/展开、配置及性能；包含业务样例与公共API边界 |
-| [分段控制器](docs/api.md#分段控制器-segmentedcontrol) | 少量互斥选项、浅底/图标/纵向示例、兼容边界 |
-| [组件设计策略](docs/component-strategy.md) | 设计依据、公共能力范围和交互内核策略 |
-| [弹窗迁移](docs/modal-shell-migration.md) | header/content/footer 稳定插槽与历史写法迁移 |
-| [成熟度迁移](docs/maturity-migration.md) | 日期、多选、目录缓存、表格、文件限制及 Toast 行为 |
-| [上传前处理](docs/file-preparation.md) | 文件异步前处理、整批提交与取消 |
-| [文档查看器](docs/document-viewer.md) | PDF.js 与图片查看入口 |
+| [分段控制器](docs/api.md#分段控制器-segmentedcontrol) | 少量互斥选项、浅底/图标/纵向示例、兼容边界 |
+| [组件设计策略](docs/component-strategy.md) | 设计依据、公共能力范围和交互内核策略 |
+| [弹窗迁移](docs/modal-shell-migration.md) | header/content/footer 稳定插槽与历史写法迁移 |
+| [成熟度迁移](docs/maturity-migration.md) | 日期、多选、目录缓存、表格、文件限制及 Toast 行为 |
+| [上传前处理](docs/file-preparation.md) | 文件异步前处理、整批提交与取消 |
+| [文档查看器](docs/document-viewer.md) | PDF.js 与图片查看入口 |
 | [文档与图片查看器 V2](docs/document-viewer-v2.md) | PDFium/WASM、原生页面叠层、图片及 V1 兼容入口与迁移边界 |
-| [多视口验收](docs/viewport-qa.md) | 桌面、移动与交互验证 |
-| [发布流程](docs/release.md) | registry、版本、制品与发布检查 |
-| [变更记录](CHANGELOG.md) | 按版本查看变化 |
-
-详细用法集中于 API 和专题；新增公共能力时同步 Agent 选型表和发布文档清单。历史审计文档保留作证据，不作为当前 API 说明。
-
-## 开发与消费边界
-
-- 通用缺陷、无障碍、响应式及跨项目能力在公共包修复；单项目领域需求通过业务包装实现。
-- 优先兼容既有 API；破坏性修改需要 major 版本及迁移说明。
-- 消费方使用公开插槽和 props，固定弹窗底栏使用 footer；不要依赖内部 DOM 或重复实现焦点管理。
-- 已配置 `business-ui-gate` 的消费项目继续运行门禁；首次接入需要生成并审核基线，不通过扩大 baseline 掩盖新增手写组件。
-
-## 本地验证与发布
-
-`pnpm dev:matrix` 打开组件验收页面；`pnpm verify` 执行类型、单元测试、库和矩阵构建；`pnpm test:browser` 验证真实浏览器交互。详细要求见多视口验收与发布流程。
-
-仓库通过 `v<package.version>` 标签触发受控发布。公共包本地验证、正式发布、消费应用升级和生产部署是不同状态，应分别验证和记录。
-
+| [多视口验收](docs/viewport-qa.md) | 桌面、移动与交互验证 |
+| [发布流程](docs/release.md) | registry、版本、制品与发布检查 |
+| [变更记录](CHANGELOG.md) | 按版本查看变化 |
+
+详细用法集中于 API 和专题；新增公共能力时同步 Agent 选型表和发布文档清单。历史审计文档保留作证据，不作为当前 API 说明。
+
+## 开发与消费边界
+
+- 通用缺陷、无障碍、响应式及跨项目能力在公共包修复；单项目领域需求通过业务包装实现。
+- 优先兼容既有 API；破坏性修改需要 major 版本及迁移说明。
+- 消费方使用公开插槽和 props，固定弹窗底栏使用 footer；不要依赖内部 DOM 或重复实现焦点管理。
+- 已配置 `business-ui-gate` 的消费项目继续运行门禁；首次接入需要生成并审核基线，不通过扩大 baseline 掩盖新增手写组件。
+
+## 本地验证与发布
+
+`pnpm dev:matrix` 打开组件验收页面；`pnpm verify` 执行类型、单元测试、库和矩阵构建；`pnpm test:browser` 验证真实浏览器交互。详细要求见多视口验收与发布流程。
+
+仓库通过 `v<package.version>` 标签触发受控发布。公共包本地验证、正式发布、消费应用升级和生产部署是不同状态，应分别验证和记录。
+
 - [通用级联选择与部门/地址适配](docs/cascader.md)

package/THIRD_PARTY_NOTICES.md

@@ -1,7 +1,7 @@
-# Third-party notices
-
-`@jc-times/business-ui` 使用以下固定版本开源依赖。依赖源码未复制到本仓库；最终安装包由包管理器连同各自许可证一并解析。
-
+# Third-party notices
+
+`@jc-times/business-ui` 使用以下固定版本开源依赖。依赖源码未复制到本仓库；最终安装包由包管理器连同各自许可证一并解析。
+
 | Package | Version | License | Project |
 | --- | --- | --- | --- |
 | `lucide-react` | 1.45.0（开发验证版本） | ISC | https://github.com/lucide-icons/lucide |
@@ -12,20 +12,20 @@
 | `@emotion/react`, `@emotion/styled` | 11.14.0 / 11.14.1 | MIT | https://github.com/emotion-js/emotion |
 | `@embedpdf/react-pdf-viewer` | 2.15.0 | MIT | https://github.com/embedpdf/embed-pdf-viewer |
 | `@embedpdf/core`, `@embedpdf/engines`, `@embedpdf/plugin-document-manager`, `@embedpdf/plugin-viewport`, `@embedpdf/plugin-scroll`, `@embedpdf/plugin-render`, `@embedpdf/plugin-zoom`, `@embedpdf/plugin-rotate`, `@embedpdf/plugin-thumbnail` | 2.15.0 | MIT | https://github.com/embedpdf/embed-pdf-viewer |
-| PDFium（由 `@embedpdf/pdfium` 随查看器分发） | 2.15.0 | BSD-3-Clause / Apache-2.0 等，详见依赖内 `LICENSE.pdfium` | https://pdfium.googlesource.com/pdfium/ |
-| `@radix-ui/react-popover` | 1.1.23 | MIT | https://github.com/radix-ui/primitives |
-| `@radix-ui/react-dialog` | 1.1.23 | MIT | https://github.com/radix-ui/primitives |
-| `@radix-ui/react-toast` | 1.2.23 | MIT | https://github.com/radix-ui/primitives |
-| `@internationalized/date` | 3.12.4 | Apache-2.0 | https://github.com/adobe/react-spectrum |
-| `@radix-ui/react-select` | 2.3.7 | MIT | https://github.com/radix-ui/primitives |
-| `@radix-ui/react-tooltip` | 1.2.16 | MIT | https://github.com/radix-ui/primitives |
-| `react-aria-components` | 1.21.1 | Apache-2.0 | https://github.com/adobe/react-spectrum |
-| `cn-division` | 2026.0.1 | MIT | https://github.com/kk-418/cn-division |
-
-完整许可证文本以各依赖包内的 `LICENSE` 文件为准。
-
-## @rc-component/cascader 1.25.0
-
+| PDFium（由 `@embedpdf/pdfium` 随查看器分发） | 2.15.0 | BSD-3-Clause / Apache-2.0 等，详见依赖内 `LICENSE.pdfium` | https://pdfium.googlesource.com/pdfium/ |
+| `@radix-ui/react-popover` | 1.1.23 | MIT | https://github.com/radix-ui/primitives |
+| `@radix-ui/react-dialog` | 1.1.23 | MIT | https://github.com/radix-ui/primitives |
+| `@radix-ui/react-toast` | 1.2.23 | MIT | https://github.com/radix-ui/primitives |
+| `@internationalized/date` | 3.12.4 | Apache-2.0 | https://github.com/adobe/react-spectrum |
+| `@radix-ui/react-select` | 2.3.7 | MIT | https://github.com/radix-ui/primitives |
+| `@radix-ui/react-tooltip` | 1.2.16 | MIT | https://github.com/radix-ui/primitives |
+| `react-aria-components` | 1.21.1 | Apache-2.0 | https://github.com/adobe/react-spectrum |
+| `cn-division` | 2026.0.1 | MIT | https://github.com/kk-418/cn-division |
+
+完整许可证文本以各依赖包内的 `LICENSE` 文件为准。
+
+## @rc-component/cascader 1.25.0
+
 MIT, Copyright (c) 2019-present react-component. Source: https://github.com/react-component/cascader. Used as the external Cascader interaction dependency; license reproduced in licenses/rc-cascader-MIT.txt. Transitive dependencies retain their own notices in their installed packages.
 
 0.2.46 additionally bundles the React gesture entry of @embedpdf/plugin-zoom@2.15.0 with a pinned bounds/precision patch. Original MIT license: licenses/embedpdf-MIT.txt; patch: patches/@embedpdf__plugin-zoom@2.15.0.patch. Engine and core plugin implementations remain external.

package/bin/business-ui-gate.mjs

@@ -1,171 +1,171 @@
-#!/usr/bin/env node
-import fs from "node:fs";
-import path from "node:path";
-import ts from "typescript";
-
-const args = process.argv.slice(2);
-const root = process.cwd();
-const sourceRoot = path.resolve(root, value("--root") ?? "src");
-const baselinePath = path.resolve(root, value("--baseline") ?? "scripts/business-ui-gate-baseline.json");
-const only = new Set((value("--only") ?? "").split(",").filter(Boolean));
-const snapshot = filterSnapshot(scan(sourceRoot));
-
-if (args.includes("--snapshot")) {
-  process.stdout.write(`${JSON.stringify(snapshot, null, 2)}\n`);
-  process.exit(0);
-}
-if (!fs.existsSync(baselinePath)) {
-  process.stderr.write(`缺少门禁基线：${baselinePath}\n请先使用 --snapshot 生成并审核基线。\n`);
-  process.exit(1);
-}
-
-const baseline = JSON.parse(fs.readFileSync(baselinePath, "utf8"));
-const regressions = [];
-for (const [file, current] of Object.entries(snapshot)) {
-  for (const [kind, count] of Object.entries(current)) {
-    const allowed = baseline[file]?.[kind] ?? 0;
-    if (count > allowed) regressions.push({ file, kind, count, allowed });
-  }
-}
-if (regressions.length) {
-  process.stderr.write(`发现新增的未统一 UI 实现：\n${regressions.map(formatRegression).join("\n")}\n`);
-  process.exit(1);
-}
-process.stdout.write("Business UI gate passed.\n");
-
-function value(flag) {
-  const index = args.indexOf(flag);
-  return index < 0 ? undefined : args[index + 1];
-}
-
-function filterSnapshot(input) {
-  if (!only.size) return input;
-  const output = {};
-  for (const [file, counts] of Object.entries(input)) {
-    const selected = Object.fromEntries(Object.entries(counts).filter(([kind]) => only.has(kind)));
-    if (Object.keys(selected).length) output[file] = selected;
-  }
-  return output;
-}
-
-function formatRegression({ file, kind, count, allowed }) {
-  const base = `- ${file}: ${kind} ${count}（基线 ${allowed}）`;
-  if (kind !== "legacyModalFooter") return base;
-  return `${base}\n  ModalShell 的固定底栏必须改用 footer 属性，并通过 footerClassName 定制；不要把原生 <footer> 直接放在 children 中。`;
-}
-
-function scan(directory) {
-  const result = {};
-  for (const absolute of walk(directory)) {
-    if (!absolute.endsWith(".tsx") || absolute.endsWith(".test.tsx")) continue;
-    const source = fs.readFileSync(absolute, "utf8");
-    const sourceFile = ts.createSourceFile(absolute, source, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
-    const modalImports = collectModalImports(sourceFile);
-    const counts = {
-      bareButton: 0,
-      bareInput: 0,
-      bareSelect: 0,
-      bareTextarea: 0,
-      handwrittenDialog: 0,
-      handwrittenMenu: 0,
-      handwrittenCombobox: 0,
-      legacyModalFooter: 0,
-    };
-    visit(sourceFile);
-    const used = Object.fromEntries(Object.entries(counts).filter(([, count]) => count));
-    if (Object.keys(used).length) result[path.relative(root, absolute).replaceAll(path.sep, "/")] = used;
-
-    function visit(node) {
-      if (ts.isJsxElement(node) && isImportedModalTag(node.openingElement.tagName, modalImports)
-        && !hasAttribute(node.openingElement, "footer") && node.children.some(rendersDirectFooter)) {
-        counts.legacyModalFooter += 1;
-      }
-      if (ts.isJsxOpeningElement(node) || ts.isJsxSelfClosingElement(node)) {
-        const tag = node.tagName.getText(sourceFile);
-        const hasClass = hasAttribute(node, "className");
-        if (tag === "button" && !hasClass) counts.bareButton += 1;
-        if (tag === "input" && !exemptInput(node)) counts.bareInput += 1;
-        if (tag === "select") counts.bareSelect += 1;
-        if (tag === "textarea") counts.bareTextarea += 1;
-        const role = stringAttribute(node, "role");
-        if (/^[a-z]/.test(tag) && (role === "dialog" || role === "alertdialog")) counts.handwrittenDialog += 1;
-        if (/^[a-z]/.test(tag) && (role === "menu" || role === "menuitem")) counts.handwrittenMenu += 1;
-        if (/^[a-z]/.test(tag) && (role === "combobox" || role === "listbox" || role === "option")) counts.handwrittenCombobox += 1;
-      }
-      ts.forEachChild(node, visit);
-    }
-
-    function exemptInput(node) {
-      const type = stringAttribute(node, "type");
-      return ["file", "hidden", "range"].includes(type ?? "");
-    }
-
-    function stringAttribute(node, name) {
-      const attribute = node.attributes.properties.find((item) => ts.isJsxAttribute(item) && item.name.getText(sourceFile) === name);
-      return attribute && ts.isJsxAttribute(attribute) && attribute.initializer && ts.isStringLiteral(attribute.initializer)
-        ? attribute.initializer.text : undefined;
-    }
-
-    function hasAttribute(node, name) {
-      return node.attributes.properties.some((item) => ts.isJsxAttribute(item) && item.name.getText(sourceFile) === name);
-    }
-
-    function rendersDirectFooter(node) {
-      if (ts.isJsxElement(node)) return node.openingElement.tagName.getText(sourceFile) === "footer";
-      if (ts.isJsxSelfClosingElement(node)) return node.tagName.getText(sourceFile) === "footer";
-      if (ts.isJsxFragment(node)) return node.children.some(rendersDirectFooter);
-      if (ts.isJsxExpression(node) && node.expression) return expressionRendersFooter(node.expression);
-      return false;
-    }
-
-    function expressionRendersFooter(expression) {
-      if (ts.isParenthesizedExpression(expression)) return expressionRendersFooter(expression.expression);
-      if (ts.isJsxElement(expression) || ts.isJsxSelfClosingElement(expression) || ts.isJsxFragment(expression)) {
-        return rendersDirectFooter(expression);
-      }
-      if (ts.isConditionalExpression(expression)) {
-        return expressionRendersFooter(expression.whenTrue) || expressionRendersFooter(expression.whenFalse);
-      }
-      if (ts.isBinaryExpression(expression) && [ts.SyntaxKind.AmpersandAmpersandToken, ts.SyntaxKind.BarBarToken,
-        ts.SyntaxKind.QuestionQuestionToken].includes(expression.operatorToken.kind)) {
-        return expressionRendersFooter(expression.left) || expressionRendersFooter(expression.right);
-      }
-      if (ts.isArrayLiteralExpression(expression)) return expression.elements.some(expressionRendersFooter);
-      return false;
-    }
-  }
-  return Object.fromEntries(Object.entries(result).sort(([a], [b]) => a.localeCompare(b)));
-}
-
-function collectModalImports(sourceFile) {
-  const names = new Set();
-  const namespaces = new Set();
-  for (const statement of sourceFile.statements) {
-    if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier)
-      || statement.moduleSpecifier.text !== "@jc-times/business-ui") continue;
-    const bindings = statement.importClause?.namedBindings;
-    if (bindings && ts.isNamedImports(bindings)) {
-      for (const element of bindings.elements) {
-        const importedName = (element.propertyName ?? element.name).text;
-        if (importedName === "ModalShell" || importedName === "Dialog") names.add(element.name.text);
-      }
-    } else if (bindings && ts.isNamespaceImport(bindings)) {
-      namespaces.add(bindings.name.text);
-    }
-  }
-  return { names, namespaces };
-}
-
-function isImportedModalTag(tagName, { names, namespaces }) {
-  if (ts.isIdentifier(tagName)) return names.has(tagName.text);
-  if (!ts.isPropertyAccessExpression(tagName) || !ts.isIdentifier(tagName.expression)) return false;
-  return namespaces.has(tagName.expression.text) && (tagName.name.text === "ModalShell" || tagName.name.text === "Dialog");
-}
-
-function* walk(directory) {
-  for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
-    const absolute = path.join(directory, entry.name);
-    if (entry.isDirectory()) yield* walk(absolute);
-    else yield absolute;
-  }
-}
+#!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
+import ts from "typescript";
+
+const args = process.argv.slice(2);
+const root = process.cwd();
+const sourceRoot = path.resolve(root, value("--root") ?? "src");
+const baselinePath = path.resolve(root, value("--baseline") ?? "scripts/business-ui-gate-baseline.json");
+const only = new Set((value("--only") ?? "").split(",").filter(Boolean));
+const snapshot = filterSnapshot(scan(sourceRoot));
+
+if (args.includes("--snapshot")) {
+  process.stdout.write(`${JSON.stringify(snapshot, null, 2)}\n`);
+  process.exit(0);
+}
+if (!fs.existsSync(baselinePath)) {
+  process.stderr.write(`缺少门禁基线：${baselinePath}\n请先使用 --snapshot 生成并审核基线。\n`);
+  process.exit(1);
+}
+
+const baseline = JSON.parse(fs.readFileSync(baselinePath, "utf8"));
+const regressions = [];
+for (const [file, current] of Object.entries(snapshot)) {
+  for (const [kind, count] of Object.entries(current)) {
+    const allowed = baseline[file]?.[kind] ?? 0;
+    if (count > allowed) regressions.push({ file, kind, count, allowed });
+  }
+}
+if (regressions.length) {
+  process.stderr.write(`发现新增的未统一 UI 实现：\n${regressions.map(formatRegression).join("\n")}\n`);
+  process.exit(1);
+}
+process.stdout.write("Business UI gate passed.\n");
+
+function value(flag) {
+  const index = args.indexOf(flag);
+  return index < 0 ? undefined : args[index + 1];
+}
+
+function filterSnapshot(input) {
+  if (!only.size) return input;
+  const output = {};
+  for (const [file, counts] of Object.entries(input)) {
+    const selected = Object.fromEntries(Object.entries(counts).filter(([kind]) => only.has(kind)));
+    if (Object.keys(selected).length) output[file] = selected;
+  }
+  return output;
+}
+
+function formatRegression({ file, kind, count, allowed }) {
+  const base = `- ${file}: ${kind} ${count}（基线 ${allowed}）`;
+  if (kind !== "legacyModalFooter") return base;
+  return `${base}\n  ModalShell 的固定底栏必须改用 footer 属性，并通过 footerClassName 定制；不要把原生 <footer> 直接放在 children 中。`;
+}
+
+function scan(directory) {
+  const result = {};
+  for (const absolute of walk(directory)) {
+    if (!absolute.endsWith(".tsx") || absolute.endsWith(".test.tsx")) continue;
+    const source = fs.readFileSync(absolute, "utf8");
+    const sourceFile = ts.createSourceFile(absolute, source, ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
+    const modalImports = collectModalImports(sourceFile);
+    const counts = {
+      bareButton: 0,
+      bareInput: 0,
+      bareSelect: 0,
+      bareTextarea: 0,
+      handwrittenDialog: 0,
+      handwrittenMenu: 0,
+      handwrittenCombobox: 0,
+      legacyModalFooter: 0,
+    };
+    visit(sourceFile);
+    const used = Object.fromEntries(Object.entries(counts).filter(([, count]) => count));
+    if (Object.keys(used).length) result[path.relative(root, absolute).replaceAll(path.sep, "/")] = used;
+
+    function visit(node) {
+      if (ts.isJsxElement(node) && isImportedModalTag(node.openingElement.tagName, modalImports)
+        && !hasAttribute(node.openingElement, "footer") && node.children.some(rendersDirectFooter)) {
+        counts.legacyModalFooter += 1;
+      }
+      if (ts.isJsxOpeningElement(node) || ts.isJsxSelfClosingElement(node)) {
+        const tag = node.tagName.getText(sourceFile);
+        const hasClass = hasAttribute(node, "className");
+        if (tag === "button" && !hasClass) counts.bareButton += 1;
+        if (tag === "input" && !exemptInput(node)) counts.bareInput += 1;
+        if (tag === "select") counts.bareSelect += 1;
+        if (tag === "textarea") counts.bareTextarea += 1;
+        const role = stringAttribute(node, "role");
+        if (/^[a-z]/.test(tag) && (role === "dialog" || role === "alertdialog")) counts.handwrittenDialog += 1;
+        if (/^[a-z]/.test(tag) && (role === "menu" || role === "menuitem")) counts.handwrittenMenu += 1;
+        if (/^[a-z]/.test(tag) && (role === "combobox" || role === "listbox" || role === "option")) counts.handwrittenCombobox += 1;
+      }
+      ts.forEachChild(node, visit);
+    }
+
+    function exemptInput(node) {
+      const type = stringAttribute(node, "type");
+      return ["file", "hidden", "range"].includes(type ?? "");
+    }
+
+    function stringAttribute(node, name) {
+      const attribute = node.attributes.properties.find((item) => ts.isJsxAttribute(item) && item.name.getText(sourceFile) === name);
+      return attribute && ts.isJsxAttribute(attribute) && attribute.initializer && ts.isStringLiteral(attribute.initializer)
+        ? attribute.initializer.text : undefined;
+    }
+
+    function hasAttribute(node, name) {
+      return node.attributes.properties.some((item) => ts.isJsxAttribute(item) && item.name.getText(sourceFile) === name);
+    }
+
+    function rendersDirectFooter(node) {
+      if (ts.isJsxElement(node)) return node.openingElement.tagName.getText(sourceFile) === "footer";
+      if (ts.isJsxSelfClosingElement(node)) return node.tagName.getText(sourceFile) === "footer";
+      if (ts.isJsxFragment(node)) return node.children.some(rendersDirectFooter);
+      if (ts.isJsxExpression(node) && node.expression) return expressionRendersFooter(node.expression);
+      return false;
+    }
+
+    function expressionRendersFooter(expression) {
+      if (ts.isParenthesizedExpression(expression)) return expressionRendersFooter(expression.expression);
+      if (ts.isJsxElement(expression) || ts.isJsxSelfClosingElement(expression) || ts.isJsxFragment(expression)) {
+        return rendersDirectFooter(expression);
+      }
+      if (ts.isConditionalExpression(expression)) {
+        return expressionRendersFooter(expression.whenTrue) || expressionRendersFooter(expression.whenFalse);
+      }
+      if (ts.isBinaryExpression(expression) && [ts.SyntaxKind.AmpersandAmpersandToken, ts.SyntaxKind.BarBarToken,
+        ts.SyntaxKind.QuestionQuestionToken].includes(expression.operatorToken.kind)) {
+        return expressionRendersFooter(expression.left) || expressionRendersFooter(expression.right);
+      }
+      if (ts.isArrayLiteralExpression(expression)) return expression.elements.some(expressionRendersFooter);
+      return false;
+    }
+  }
+  return Object.fromEntries(Object.entries(result).sort(([a], [b]) => a.localeCompare(b)));
+}
+
+function collectModalImports(sourceFile) {
+  const names = new Set();
+  const namespaces = new Set();
+  for (const statement of sourceFile.statements) {
+    if (!ts.isImportDeclaration(statement) || !ts.isStringLiteral(statement.moduleSpecifier)
+      || statement.moduleSpecifier.text !== "@jc-times/business-ui") continue;
+    const bindings = statement.importClause?.namedBindings;
+    if (bindings && ts.isNamedImports(bindings)) {
+      for (const element of bindings.elements) {
+        const importedName = (element.propertyName ?? element.name).text;
+        if (importedName === "ModalShell" || importedName === "Dialog") names.add(element.name.text);
+      }
+    } else if (bindings && ts.isNamespaceImport(bindings)) {
+      namespaces.add(bindings.name.text);
+    }
+  }
+  return { names, namespaces };
+}
+
+function isImportedModalTag(tagName, { names, namespaces }) {
+  if (ts.isIdentifier(tagName)) return names.has(tagName.text);
+  if (!ts.isPropertyAccessExpression(tagName) || !ts.isIdentifier(tagName.expression)) return false;
+  return namespaces.has(tagName.expression.text) && (tagName.name.text === "ModalShell" || tagName.name.text === "Dialog");
+}
+
+function* walk(directory) {
+  for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
+    const absolute = path.join(directory, entry.name);
+    if (entry.isDirectory()) yield* walk(absolute);
+    else yield absolute;
+  }
+}

package/dist/form-controls.js

@@ -0,0 +1,4 @@
+import { Button as e, LinkButton as t, buttonClassName as n } from "./Button.js";
+import { Alert as r } from "./Alert.js";
+import { Checkbox as i, FormField as a, SelectInput as o, TextArea as s, TextInput as c } from "./FormField.js";
+export { r as Alert, e as Button, i as Checkbox, a as FormField, t as LinkButton, o as SelectInput, s as TextArea, c as TextInput, n as buttonClassName };

package/dist/types/form-controls.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Lightweight entry point for simple authenticated forms and standalone pages.
+ * It deliberately excludes directory pickers, date controls, data tables and
+ * document viewers so consumers do not pull their dependency graphs.
+ */
+export { Alert, type AlertProps, type AlertTone } from "./Alert";
+export { Button, LinkButton, buttonClassName, type ButtonProps, type ButtonVariant, type ButtonSize, type LinkButtonProps } from "./Button";
+export { Checkbox, FormField, SelectInput, TextArea, TextInput, type TextInputProps, type TextAreaProps, type SelectInputProps } from "./FormField";

package/dist/vendor/embedpdf-zoom-react.js

@@ -5,7 +5,7 @@ import { useCapability as c, useDocumentState as l, usePlugin as u } from "@embe
 import { useViewportElement as d } from "@embedpdf/plugin-viewport/react";
 import { ZoomPlugin as f, initialDocumentState as p } from "@embedpdf/plugin-zoom";
 export * from "@embedpdf/plugin-zoom";
-//#region node_modules/.pnpm/@embedpdf+plugin-zoom@2.15._aede46f2a75cbc54dc0fefd84f941023/node_modules/@embedpdf/plugin-zoom/dist/react/index.js
+//#region node_modules/.pnpm/@embedpdf+plugin-zoom@2.15.0_patch_hash=21cc50a50730a2920846ef4e8bb72d24d69849e9fd43d6f_aede46f2a75cbc54dc0fefd84f941023/node_modules/@embedpdf/plugin-zoom/dist/react/index.js
 var m = /* @__PURE__ */ e({
 	MarqueeZoom: () => w,
 	ZoomGestureWrapper: () => C,