@dataverse-kit/form-runtime 0.1.0

package/dist/hooks.d.cts

@@ -0,0 +1,24 @@
+import { x as ControlDefinition } from './control-DFOg_pc_.cjs';
+import { T as TimelineItem } from './runtime-capabilities-BdGDdu0d.cjs';
+import './theme-BfeZIxmZ.cjs';
+
+interface UseLiveDataResult {
+    records: Record<string, unknown>[] | null;
+    loading: boolean;
+    error: string | null;
+    fetchXmlAttributes: string[];
+    timelineItems: TimelineItem[] | null;
+}
+/**
+ * Subscribe to live records / timeline activities for a bound control.
+ * Calls `FormRuntimeCapabilities.fetchLiveData` on mount + whenever the
+ * control reference changes. Returns the empty/no-context shape when no
+ * provider wraps the caller (the deployed runtime is expected to wrap;
+ * tests can use the un-wrapped shape).
+ *
+ * The capability returns raw data; this hook adds the React state
+ * machinery (loading flag, error string, abort on unmount).
+ */
+declare function useLiveData(control: ControlDefinition, enabled?: boolean): UseLiveDataResult;
+
+export { type UseLiveDataResult, useLiveData };

package/dist/hooks.d.ts

@@ -0,0 +1,24 @@
+import { x as ControlDefinition } from './control-DaXBm-52.js';
+import { T as TimelineItem } from './runtime-capabilities-Brfc7loJ.js';
+import './theme-BfeZIxmZ.js';
+
+interface UseLiveDataResult {
+    records: Record<string, unknown>[] | null;
+    loading: boolean;
+    error: string | null;
+    fetchXmlAttributes: string[];
+    timelineItems: TimelineItem[] | null;
+}
+/**
+ * Subscribe to live records / timeline activities for a bound control.
+ * Calls `FormRuntimeCapabilities.fetchLiveData` on mount + whenever the
+ * control reference changes. Returns the empty/no-context shape when no
+ * provider wraps the caller (the deployed runtime is expected to wrap;
+ * tests can use the un-wrapped shape).
+ *
+ * The capability returns raw data; this hook adds the React state
+ * machinery (loading flag, error string, abort on unmount).
+ */
+declare function useLiveData(control: ControlDefinition, enabled?: boolean): UseLiveDataResult;
+
+export { type UseLiveDataResult, useLiveData };

package/dist/hooks.mjs

@@ -0,0 +1,60 @@
+// src/hooks.ts
+import { useEffect, useState } from "react";
+
+// src/context/FormRuntimeContext.tsx
+import { createContext, useContext } from "react";
+import { jsx } from "react/jsx-runtime";
+var FormRuntimeContext = createContext(null);
+FormRuntimeContext.displayName = "FormRuntimeContext";
+function useOptionalFormRuntimeContext() {
+  return useContext(FormRuntimeContext);
+}
+
+// src/hooks.ts
+function useLiveData(control, enabled = true) {
+  const ctx = useOptionalFormRuntimeContext();
+  const [records, setRecords] = useState(null);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState(null);
+  const [fetchXmlAttributes, setFetchXmlAttributes] = useState([]);
+  const [timelineItems, setTimelineItems] = useState(null);
+  const fetchLiveData = ctx?.fetchLiveData;
+  const propertiesKey = JSON.stringify(control.properties ?? {});
+  const dataBindingKey = JSON.stringify(control.dataBinding ?? {});
+  useEffect(() => {
+    if (!enabled || !fetchLiveData) {
+      setRecords(null);
+      setLoading(false);
+      setError(null);
+      setTimelineItems(null);
+      setFetchXmlAttributes([]);
+      return;
+    }
+    let cancelled = false;
+    const controller = new AbortController();
+    setLoading(true);
+    setError(null);
+    fetchLiveData(control, { signal: controller.signal }).then((data) => {
+      if (cancelled) return;
+      setRecords(data.records);
+      setFetchXmlAttributes(data.fetchXmlAttributes);
+      setTimelineItems(data.timelineItems);
+      setLoading(false);
+    }).catch((err) => {
+      if (cancelled) return;
+      setError(err instanceof Error ? err.message : "Failed to fetch live data");
+      setRecords(null);
+      setTimelineItems(null);
+      setLoading(false);
+    });
+    return () => {
+      cancelled = true;
+      controller.abort();
+    };
+  }, [fetchLiveData, enabled, control.type, control.name, propertiesKey, dataBindingKey]);
+  return { records, loading, error, fetchXmlAttributes, timelineItems };
+}
+export {
+  useLiveData
+};
+//# sourceMappingURL=hooks.mjs.map

package/dist/hooks.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks.ts","../src/context/FormRuntimeContext.tsx"],"sourcesContent":["// @dataverse-kit/form-runtime/hooks — FluentUI-agnostic React hooks.\n//\n// Today: `useLiveData` — wraps `FormRuntimeCapabilities.fetchLiveData`\n// with React-state choreography (loading / error / records /\n// timelineItems / fetchXmlAttributes). Used by the runtime's subgrid\n// and timeline per-type branches.\n//\n// Planned: useSubgridData, useChartData, useLookupSearch, useFormState,\n// useDirtyTracker (scaffolds; populated when their consumers move into\n// form-runtime).\n\nimport { useEffect, useState } from 'react';\nimport type { ControlDefinition } from './types';\nimport type { LiveDataResult, TimelineItem } from './types/runtime-capabilities';\nimport { useOptionalFormRuntimeContext } from './context/FormRuntimeContext';\n\nexport interface UseLiveDataResult {\n  records: Record<string, unknown>[] | null;\n  loading: boolean;\n  error: string | null;\n  fetchXmlAttributes: string[];\n  timelineItems: TimelineItem[] | null;\n}\n\n/**\n * Subscribe to live records / timeline activities for a bound control.\n * Calls `FormRuntimeCapabilities.fetchLiveData` on mount + whenever the\n * control reference changes. Returns the empty/no-context shape when no\n * provider wraps the caller (the deployed runtime is expected to wrap;\n * tests can use the un-wrapped shape).\n *\n * The capability returns raw data; this hook adds the React state\n * machinery (loading flag, error string, abort on unmount).\n */\nexport function useLiveData(control: ControlDefinition, enabled: boolean = true): UseLiveDataResult {\n  const ctx = useOptionalFormRuntimeContext();\n  const [records, setRecords] = useState<Record<string, unknown>[] | null>(null);\n  const [loading, setLoading] = useState(false);\n  const [error, setError] = useState<string | null>(null);\n  const [fetchXmlAttributes, setFetchXmlAttributes] = useState<string[]>([]);\n  const [timelineItems, setTimelineItems] = useState<TimelineItem[] | null>(null);\n\n  // The hook fires on stable primitive deps only — `control` and `ctx`\n  // are referentially unstable each render (FormRuntime walks the tree;\n  // capabilities memo rebuilds when callbacks change), and depending on\n  // them caused an abort/refetch loop. The fetcher reference, control\n  // identity, and a hash of the properties that affect the query are\n  // what actually matter; everything else is a noisy false positive.\n  const fetchLiveData = ctx?.fetchLiveData;\n  const propertiesKey = JSON.stringify(control.properties ?? {});\n  const dataBindingKey = JSON.stringify(control.dataBinding ?? {});\n\n  useEffect(() => {\n    if (!enabled || !fetchLiveData) {\n      setRecords(null);\n      setLoading(false);\n      setError(null);\n      setTimelineItems(null);\n      setFetchXmlAttributes([]);\n      return;\n    }\n\n    let cancelled = false;\n    const controller = new AbortController();\n    setLoading(true);\n    setError(null);\n\n    fetchLiveData(control, { signal: controller.signal })\n      .then((data: LiveDataResult) => {\n        if (cancelled) return;\n        setRecords(data.records);\n        setFetchXmlAttributes(data.fetchXmlAttributes);\n        setTimelineItems(data.timelineItems);\n        setLoading(false);\n      })\n      .catch((err: unknown) => {\n        if (cancelled) return;\n        setError(err instanceof Error ? err.message : 'Failed to fetch live data');\n        setRecords(null);\n        setTimelineItems(null);\n        setLoading(false);\n      });\n\n    return () => {\n      cancelled = true;\n      controller.abort();\n    };\n    // `control` is read once per fetch call but isn't a dep — its\n    // identity churns each parent render. The `*Key` strings cover\n    // the actual inputs the capability reads from `control`.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [fetchLiveData, enabled, control.type, control.name, propertiesKey, dataBindingKey]);\n\n  return { records, loading, error, fetchXmlAttributes, timelineItems };\n}\n","import React, { createContext, useContext } from 'react';\nimport type { FormRuntimeCapabilities } from '../types/runtime-capabilities';\n\n/**\n * Context that exposes editor- or host-supplied async capabilities to\n * the runtime's controls.\n *\n * Two implementations exist (Phase 1 Task 6.5 onwards):\n * - `EditorFormRuntimeProvider` in `apps/form-builder/src/contexts/` —\n *   wires capabilities to the form-builder's Zustand stores (designer,\n *   dataverse, previewRecord, gridCustomizer).\n * - Generated host code's provider (Phase 3) — wires capabilities to\n *   `IApiService` from `@dataverse-kit/api-service`.\n *\n * Per `feedback_v1_migrations`, the runtime DOES NOT define a default\n * mock or no-op provider. Controls that depend on capabilities throw if\n * the consumer hasn't wrapped them in a provider — the error names the\n * provider that's expected, so the failure points at the integration\n * gap rather than masking it with silent no-ops.\n */\nconst FormRuntimeContext = createContext<FormRuntimeCapabilities | null>(null);\n\nFormRuntimeContext.displayName = 'FormRuntimeContext';\n\nexport interface FormRuntimeProviderProps {\n  capabilities: FormRuntimeCapabilities;\n  children: React.ReactNode;\n}\n\n/**\n * Provider wrapper. Caller supplies a `FormRuntimeCapabilities` value;\n * descendants read it via `useFormRuntimeContext()`. Wrap the runtime's\n * mount point (`<FormRuntime>`) with this; failing to do so causes\n * capability-consuming controls to throw on first render.\n */\nexport const FormRuntimeProvider: React.FC<FormRuntimeProviderProps> = ({\n  capabilities,\n  children,\n}) => <FormRuntimeContext.Provider value={capabilities}>{children}</FormRuntimeContext.Provider>;\n\n/**\n * Hook for runtime-internal callers that REQUIRE capabilities. Throws\n * with a directed error message if no provider is present so the\n * integration gap is visible at the call site (rather than a vague\n * \"Cannot read properties of null\" that points at the consumer).\n */\nexport function useFormRuntimeContext(): FormRuntimeCapabilities {\n  const value = useContext(FormRuntimeContext);\n  if (value === null) {\n    throw new Error(\n      '[@dataverse-kit/form-runtime] useFormRuntimeContext was called outside of a ' +\n        '<FormRuntimeProvider>. Wrap your <FormRuntime> mount with a provider that ' +\n        'supplies FormRuntimeCapabilities (the editor app uses ' +\n        'EditorFormRuntimeProvider; generated host code uses ServiceFactory-backed ' +\n        'capabilities). See packages/form-runtime/src/context/FormRuntimeContext.tsx.',\n    );\n  }\n  return value;\n}\n\n/**\n * Same as `useFormRuntimeContext()` but returns `null` when no provider\n * is present. Use for OPTIONAL capability access — controls that have a\n * sensible offline rendering (e.g. timeline, which renders a placeholder\n * when not connected) prefer this over the throwing variant.\n */\nexport function useOptionalFormRuntimeContext(): FormRuntimeCapabilities | null {\n  return useContext(FormRuntimeContext);\n}\n"],"mappings":";AAWA,SAAS,WAAW,gBAAgB;;;ACXpC,SAAgB,eAAe,kBAAkB;AAsC3C;AAlBN,IAAM,qBAAqB,cAA8C,IAAI;AAE7E,mBAAmB,cAAc;AA4C1B,SAAS,gCAAgE;AAC9E,SAAO,WAAW,kBAAkB;AACtC;;;ADlCO,SAAS,YAAY,SAA4B,UAAmB,MAAyB;AAClG,QAAM,MAAM,8BAA8B;AAC1C,QAAM,CAAC,SAAS,UAAU,IAAI,SAA2C,IAAI;AAC7E,QAAM,CAAC,SAAS,UAAU,IAAI,SAAS,KAAK;AAC5C,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAwB,IAAI;AACtD,QAAM,CAAC,oBAAoB,qBAAqB,IAAI,SAAmB,CAAC,CAAC;AACzE,QAAM,CAAC,eAAe,gBAAgB,IAAI,SAAgC,IAAI;AAQ9E,QAAM,gBAAgB,KAAK;AAC3B,QAAM,gBAAgB,KAAK,UAAU,QAAQ,cAAc,CAAC,CAAC;AAC7D,QAAM,iBAAiB,KAAK,UAAU,QAAQ,eAAe,CAAC,CAAC;AAE/D,YAAU,MAAM;AACd,QAAI,CAAC,WAAW,CAAC,eAAe;AAC9B,iBAAW,IAAI;AACf,iBAAW,KAAK;AAChB,eAAS,IAAI;AACb,uBAAiB,IAAI;AACrB,4BAAsB,CAAC,CAAC;AACxB;AAAA,IACF;AAEA,QAAI,YAAY;AAChB,UAAM,aAAa,IAAI,gBAAgB;AACvC,eAAW,IAAI;AACf,aAAS,IAAI;AAEb,kBAAc,SAAS,EAAE,QAAQ,WAAW,OAAO,CAAC,EACjD,KAAK,CAAC,SAAyB;AAC9B,UAAI,UAAW;AACf,iBAAW,KAAK,OAAO;AACvB,4BAAsB,KAAK,kBAAkB;AAC7C,uBAAiB,KAAK,aAAa;AACnC,iBAAW,KAAK;AAAA,IAClB,CAAC,EACA,MAAM,CAAC,QAAiB;AACvB,UAAI,UAAW;AACf,eAAS,eAAe,QAAQ,IAAI,UAAU,2BAA2B;AACzE,iBAAW,IAAI;AACf,uBAAiB,IAAI;AACrB,iBAAW,KAAK;AAAA,IAClB,CAAC;AAEH,WAAO,MAAM;AACX,kBAAY;AACZ,iBAAW,MAAM;AAAA,IACnB;AAAA,EAKF,GAAG,CAAC,eAAe,SAAS,QAAQ,MAAM,QAAQ,MAAM,eAAe,cAAc,CAAC;AAEtF,SAAO,EAAE,SAAS,SAAS,OAAO,oBAAoB,cAAc;AACtE;","names":[]}

package/dist/icons.cjs

@@ -0,0 +1,202 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/icons/index.ts
+var icons_exports = {};
+__export(icons_exports, {
+  V8_ICONS_WITHOUT_V9: () => V8_ICONS_WITHOUT_V9,
+  V8_PERSONA_SIZE_TO_V9: () => V8_PERSONA_SIZE_TO_V9,
+  V8_PRESENCE_TO_V9_STATUS: () => V8_PRESENCE_TO_V9_STATUS,
+  V8_TO_V9_ICON_MAP: () => V8_TO_V9_ICON_MAP,
+  buildV9IconImport: () => buildV9IconImport,
+  mapV8IconToV9: () => mapV8IconToV9,
+  mapV8PersonaSizeToV9: () => mapV8PersonaSizeToV9,
+  mapV8PresenceToV9Status: () => mapV8PresenceToV9Status,
+  sanitizeV8EnumIdentifier: () => sanitizeV8EnumIdentifier,
+  sanitizeV8PersonaSizeName: () => sanitizeV8PersonaSizeName,
+  sanitizeV8PresenceName: () => sanitizeV8PresenceName
+});
+module.exports = __toCommonJS(icons_exports);
+
+// src/icons/iconNameMap.ts
+var V8_TO_V9_ICON_MAP = {
+  Accept: "Checkmark20Regular",
+  Add: "Add20Regular",
+  AddTo: "AddSquare20Regular",
+  AlignCenter: "TextAlignCenter20Regular",
+  AlignLeft: "TextAlignLeft20Regular",
+  AlignRight: "TextAlignRight20Regular",
+  Back: "ArrowLeft20Regular",
+  Blocked2: "Prohibited20Regular",
+  BucketColor: "PaintBucket20Regular",
+  BulkUpload: "CloudArrowUp20Regular",
+  BulletedList: "TextBulletList20Regular",
+  CalculatorAddition: "Calculator20Regular",
+  Calendar: "Calendar20Regular",
+  Cancel: "Dismiss20Regular",
+  CellPhone: "Phone20Regular",
+  CheckList: "ClipboardTaskList20Regular",
+  CheckMark: "Checkmark20Regular",
+  ChevronDown: "ChevronDown20Regular",
+  ChevronLeft: "ChevronLeft20Regular",
+  ChevronRight: "ChevronRight20Regular",
+  ChevronUp: "ChevronUp20Regular",
+  CirclePause: "Pause20Regular",
+  CityNext: "BuildingMultiple20Regular",
+  Clear: "Dismiss20Regular",
+  Clock: "Clock20Regular",
+  CloudDownload: "CloudArrowDown20Regular",
+  CloudUpload: "CloudArrowUp20Regular",
+  Code: "Code20Regular",
+  Color: "Color20Regular",
+  ColumnOptions: "TableSettings20Regular",
+  Comment: "Comment20Regular",
+  Contact: "Person20Regular",
+  Copy: "Copy20Regular",
+  CustomList: "TextBulletList20Regular",
+  Database: "Database20Regular",
+  Delete: "Delete20Regular",
+  Down: "ArrowDown20Regular",
+  Download: "ArrowDownload20Regular",
+  Edit: "Edit20Regular",
+  ErrorBadge: "ErrorCircle20Regular",
+  FabricFolder: "Folder20Regular",
+  FabricOpenFolderHorizontal: "FolderOpen20Regular",
+  FavoriteStar: "Star20Regular",
+  FavoriteStarFill: "Star20Filled",
+  Filter: "Filter20Regular",
+  FitPage: "AutoFitWidth20Regular",
+  Flow: "Flow20Regular",
+  FullScreen: "FullScreenMaximize20Regular",
+  GridViewMedium: "Grid20Regular",
+  GridViewSmall: "Grid20Regular",
+  GroupObject: "Group20Regular",
+  Header1: "TextHeader120Regular",
+  History: "History20Regular",
+  Info: "Info20Regular",
+  Leave: "SignOut20Regular",
+  Link: "Link20Regular",
+  List: "TextBulletList20Regular",
+  Lock: "LockClosed20Regular",
+  Mail: "Mail20Regular",
+  Money: "Money20Regular",
+  More: "MoreHorizontal20Regular",
+  MoreVertical: "MoreVertical20Regular",
+  MoveToFolder: "FolderArrowRight20Regular",
+  NumberSymbol: "NumberSymbol20Regular",
+  OpenFolderHorizontal: "FolderOpen20Regular",
+  OpenInNewTab: "Open20Regular",
+  OpenInNewWindow: "Open20Regular",
+  Package: "Box20Regular",
+  PageHeaderEdit: "Edit20Regular",
+  Permissions: "ShieldCheckmark20Regular",
+  Phone: "Phone20Regular",
+  PhotoCollection: "ImageMultiple20Regular",
+  PlugDisconnected: "PlugDisconnected20Regular",
+  Redo: "ArrowRedo20Regular",
+  Refresh: "ArrowSync20Regular",
+  Remove: "Subtract20Regular",
+  Rename: "Rename20Regular",
+  Save: "Save20Regular",
+  SaveAndClose: "SaveEdit20Regular",
+  SaveTemplate: "SaveCopy20Regular",
+  Search: "Search20Regular",
+  Settings: "Settings20Regular",
+  Shapes: "Shapes20Regular",
+  SidePanel: "PanelRight20Regular",
+  Spacer: "TextWrap20Regular",
+  Star: "Star20Regular",
+  StatusCircleCheckmark: "CheckmarkCircle20Regular",
+  Switch: "ArrowSwap20Regular",
+  TVMonitor: "Tv20Regular",
+  Table: "Table20Regular",
+  TableGroup: "TableSimple20Regular",
+  Tablet: "Tablet20Regular",
+  TestPlan: "ClipboardTaskList20Regular",
+  TriggerAuto: "Flash20Regular",
+  Undo: "ArrowUndo20Regular",
+  Up: "ArrowUp20Regular",
+  Upload: "ArrowUpload20Regular",
+  View: "Eye20Regular",
+  Warning: "Warning20Regular",
+  ZipFolder: "FolderZip20Regular",
+  ZoomIn: "ZoomIn20Regular",
+  ZoomOut: "ZoomOut20Regular"
+};
+var V8_ICONS_WITHOUT_V9 = /* @__PURE__ */ new Set();
+function mapV8IconToV9(v8Name) {
+  return V8_TO_V9_ICON_MAP[v8Name] ?? null;
+}
+function buildV9IconImport(v9IconNames) {
+  const sorted = Array.from(new Set(v9IconNames)).sort();
+  if (sorted.length === 0) return "";
+  return `import { ${sorted.join(", ")} } from '@fluentui/react-icons';
+`;
+}
+
+// src/icons/personaCompatibilityMaps.ts
+var V8_PERSONA_SIZE_TO_V9 = {
+  size8: 16,
+  size24: 24,
+  size32: 32,
+  size40: 40,
+  size48: 48,
+  size56: 56,
+  size72: 72,
+  size100: 96,
+  size120: 120
+};
+var V8_PRESENCE_TO_V9_STATUS = {
+  online: "available",
+  offline: "offline",
+  away: "away",
+  busy: "busy",
+  dnd: "do-not-disturb",
+  blocked: "unknown"
+};
+function mapV8PersonaSizeToV9(v8Size) {
+  return V8_PERSONA_SIZE_TO_V9[v8Size] ?? 48;
+}
+function mapV8PresenceToV9Status(v8Presence) {
+  return V8_PRESENCE_TO_V9_STATUS[v8Presence] ?? null;
+}
+function sanitizeV8EnumIdentifier(value, fallback) {
+  return /^[a-zA-Z][a-zA-Z0-9]*$/.test(value) ? value : fallback;
+}
+function sanitizeV8PresenceName(v8Presence) {
+  return sanitizeV8EnumIdentifier(v8Presence, "none");
+}
+function sanitizeV8PersonaSizeName(v8Size) {
+  return sanitizeV8EnumIdentifier(v8Size, "size48");
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  V8_ICONS_WITHOUT_V9,
+  V8_PERSONA_SIZE_TO_V9,
+  V8_PRESENCE_TO_V9_STATUS,
+  V8_TO_V9_ICON_MAP,
+  buildV9IconImport,
+  mapV8IconToV9,
+  mapV8PersonaSizeToV9,
+  mapV8PresenceToV9Status,
+  sanitizeV8EnumIdentifier,
+  sanitizeV8PersonaSizeName,
+  sanitizeV8PresenceName
+});
+//# sourceMappingURL=icons.cjs.map

package/dist/icons.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/icons/index.ts","../src/icons/iconNameMap.ts","../src/icons/personaCompatibilityMaps.ts"],"sourcesContent":["// v8 → v9 compatibility maps for icons and Persona.\n//\n// Moved from packages/export-engine/src/generators/{iconNameMap,\n// personaCompatibilityMaps}.ts in Phase 1 of the WYSIWYG-canvas refactor.\n// The generator imports them back from here; the runtime's v9 entry (Phase\n// 4) consumes them when rendering live v9 controls. Single source of truth.\n\nexport * from './iconNameMap';\nexport * from './personaCompatibilityMaps';\n","/**\n * Phase 3f.0 — v8 → v9 icon name lookup table.\n *\n * Maps Fluent UI v8 icon names (used by the form-builder picker and\n * emitted as `iconName=\"...\"` strings) to their equivalent component\n * names in `@fluentui/react-icons` for v9 generated output.\n *\n * v9 react-icons naming convention: `${Glyph}${Size}${Variant}` —\n *   - Size: 12 | 16 | 20 | 24 | 28 | 32 | 48\n *   - Variant: Regular | Filled\n *\n * The form generator emits inline icons in buttons, headers, and\n * column actions. 20px Regular is the standard size for inline use,\n * matching v8's default rendering. Callers needing a different size\n * can override at the call site.\n *\n * Coverage: every icon name referenced by `iconName: 'X'` patterns\n * in the form-builder project (~100 glyphs). Generated by surveying\n * `grep -rE \"iconName: ['\\\"]\"` output across `src/` on 2026-05-01.\n *\n * **Excluded from the v9 map** (no clean v9 equivalent — emit warning\n * via Phase 3f.1's scanV9Compatibility):\n *   - none currently; v9 react-icons covers all 100 surveyed glyphs.\n *     If a future v8 icon name has no v9 mapping, add it to\n *     V8_ICONS_WITHOUT_V9 below so the scanner reports it.\n */\n\n/** v9 component name from `@fluentui/react-icons`. */\nexport type V9IconName = string;\n\n/**\n * v8 → v9 icon-name lookup. v8 keys are the literal `iconName=\"...\"`\n * strings the form generator emits today. v9 values are the component\n * names exported by `@fluentui/react-icons` at the standard 20px Regular\n * size. Default to `Regular` over `Filled` — matches v8's default weight.\n *\n * Some v8 names map to renamed v9 glyphs (Cancel → Dismiss, More →\n * MoreHorizontal, Refresh → ArrowSync, Back → ArrowLeft, Down → ArrowDown,\n * Up → ArrowUp, View → Eye, Remove → Subtract, Leave → SignOut). The map\n * is the single source of truth for these renames.\n */\nexport const V8_TO_V9_ICON_MAP: Record<string, V9IconName> = {\n  Accept: 'Checkmark20Regular',\n  Add: 'Add20Regular',\n  AddTo: 'AddSquare20Regular',\n  AlignCenter: 'TextAlignCenter20Regular',\n  AlignLeft: 'TextAlignLeft20Regular',\n  AlignRight: 'TextAlignRight20Regular',\n  Back: 'ArrowLeft20Regular',\n  Blocked2: 'Prohibited20Regular',\n  BucketColor: 'PaintBucket20Regular',\n  BulkUpload: 'CloudArrowUp20Regular',\n  BulletedList: 'TextBulletList20Regular',\n  CalculatorAddition: 'Calculator20Regular',\n  Calendar: 'Calendar20Regular',\n  Cancel: 'Dismiss20Regular',\n  CellPhone: 'Phone20Regular',\n  CheckList: 'ClipboardTaskList20Regular',\n  CheckMark: 'Checkmark20Regular',\n  ChevronDown: 'ChevronDown20Regular',\n  ChevronLeft: 'ChevronLeft20Regular',\n  ChevronRight: 'ChevronRight20Regular',\n  ChevronUp: 'ChevronUp20Regular',\n  CirclePause: 'Pause20Regular',\n  CityNext: 'BuildingMultiple20Regular',\n  Clear: 'Dismiss20Regular',\n  Clock: 'Clock20Regular',\n  CloudDownload: 'CloudArrowDown20Regular',\n  CloudUpload: 'CloudArrowUp20Regular',\n  Code: 'Code20Regular',\n  Color: 'Color20Regular',\n  ColumnOptions: 'TableSettings20Regular',\n  Comment: 'Comment20Regular',\n  Contact: 'Person20Regular',\n  Copy: 'Copy20Regular',\n  CustomList: 'TextBulletList20Regular',\n  Database: 'Database20Regular',\n  Delete: 'Delete20Regular',\n  Down: 'ArrowDown20Regular',\n  Download: 'ArrowDownload20Regular',\n  Edit: 'Edit20Regular',\n  ErrorBadge: 'ErrorCircle20Regular',\n  FabricFolder: 'Folder20Regular',\n  FabricOpenFolderHorizontal: 'FolderOpen20Regular',\n  FavoriteStar: 'Star20Regular',\n  FavoriteStarFill: 'Star20Filled',\n  Filter: 'Filter20Regular',\n  FitPage: 'AutoFitWidth20Regular',\n  Flow: 'Flow20Regular',\n  FullScreen: 'FullScreenMaximize20Regular',\n  GridViewMedium: 'Grid20Regular',\n  GridViewSmall: 'Grid20Regular',\n  GroupObject: 'Group20Regular',\n  Header1: 'TextHeader120Regular',\n  History: 'History20Regular',\n  Info: 'Info20Regular',\n  Leave: 'SignOut20Regular',\n  Link: 'Link20Regular',\n  List: 'TextBulletList20Regular',\n  Lock: 'LockClosed20Regular',\n  Mail: 'Mail20Regular',\n  Money: 'Money20Regular',\n  More: 'MoreHorizontal20Regular',\n  MoreVertical: 'MoreVertical20Regular',\n  MoveToFolder: 'FolderArrowRight20Regular',\n  NumberSymbol: 'NumberSymbol20Regular',\n  OpenFolderHorizontal: 'FolderOpen20Regular',\n  OpenInNewTab: 'Open20Regular',\n  OpenInNewWindow: 'Open20Regular',\n  Package: 'Box20Regular',\n  PageHeaderEdit: 'Edit20Regular',\n  Permissions: 'ShieldCheckmark20Regular',\n  Phone: 'Phone20Regular',\n  PhotoCollection: 'ImageMultiple20Regular',\n  PlugDisconnected: 'PlugDisconnected20Regular',\n  Redo: 'ArrowRedo20Regular',\n  Refresh: 'ArrowSync20Regular',\n  Remove: 'Subtract20Regular',\n  Rename: 'Rename20Regular',\n  Save: 'Save20Regular',\n  SaveAndClose: 'SaveEdit20Regular',\n  SaveTemplate: 'SaveCopy20Regular',\n  Search: 'Search20Regular',\n  Settings: 'Settings20Regular',\n  Shapes: 'Shapes20Regular',\n  SidePanel: 'PanelRight20Regular',\n  Spacer: 'TextWrap20Regular',\n  Star: 'Star20Regular',\n  StatusCircleCheckmark: 'CheckmarkCircle20Regular',\n  Switch: 'ArrowSwap20Regular',\n  TVMonitor: 'Tv20Regular',\n  Table: 'Table20Regular',\n  TableGroup: 'TableSimple20Regular',\n  Tablet: 'Tablet20Regular',\n  TestPlan: 'ClipboardTaskList20Regular',\n  TriggerAuto: 'Flash20Regular',\n  Undo: 'ArrowUndo20Regular',\n  Up: 'ArrowUp20Regular',\n  Upload: 'ArrowUpload20Regular',\n  View: 'Eye20Regular',\n  Warning: 'Warning20Regular',\n  ZipFolder: 'FolderZip20Regular',\n  ZoomIn: 'ZoomIn20Regular',\n  ZoomOut: 'ZoomOut20Regular',\n};\n\n/**\n * v8 icons that have no clean v9 equivalent. Empty today — every\n * surveyed v8 name maps to a v9 glyph above. Reserved for future v8\n * names (e.g. esoteric Office-suite glyphs) that don't ship in\n * `@fluentui/react-icons`. Phase 3f.1's `scanV9Compatibility` reads\n * this set to flag forms that use them.\n */\nexport const V8_ICONS_WITHOUT_V9: ReadonlySet<string> = new Set<string>();\n\n/**\n * Look up a v9 icon component name for a v8 icon name. Returns null\n * if no mapping exists; callers should consult `V8_ICONS_WITHOUT_V9`\n * to decide whether to flag it as a compatibility issue or just emit\n * a generic fallback.\n *\n * @param v8Name v8 `iconName` string (e.g. 'Add', 'Cancel')\n * @returns v9 component name (e.g. 'Add20Regular') or null\n */\nexport function mapV8IconToV9(v8Name: string): V9IconName | null {\n  return V8_TO_V9_ICON_MAP[v8Name] ?? null;\n}\n\n/**\n * Build the import statement string for a set of v9 icons. Used by\n * generators that need to emit `import { Add20Regular, Delete20Regular }\n * from '@fluentui/react-icons'`. Empty input returns empty string —\n * caller should not include the import block at all in that case.\n *\n * @param v9IconNames Set or array of v9 component names\n * @returns Single-line import statement, or empty string if none\n */\nexport function buildV9IconImport(v9IconNames: Iterable<string>): string {\n  const sorted = Array.from(new Set(v9IconNames)).sort();\n  if (sorted.length === 0) return '';\n  return `import { ${sorted.join(', ')} } from '@fluentui/react-icons';\\n`;\n}\n","/**\n * Phase 3f.4 — v8 Persona ↔ v9 Avatar compatibility maps.\n *\n * Extracted from FormCodeGenerator.ts (review fix) so the maps live\n * next to `iconNameMap.ts` and follow the same convention. Keeps the\n * generator focused on emission and lets the maps evolve independently.\n *\n * Naming convention parity with `mapV8IconToV9` from `iconNameMap.ts`:\n * `mapV8XxxToV9` — explicit v8 → v9 direction in the function name.\n *\n * v8 PersonaSize and PersonaPresence are enum names (`size48`, `online`)\n * that v8 turned into runtime values via `PersonaSize.size48` etc. v9\n * Avatar takes a numeric `size` and v9 PresenceBadge takes a `status`\n * string — different shapes, hence the lookup tables.\n */\n\n/**\n * v8 PersonaSize enum name → v9 Avatar `size` numeric value.\n *\n * v9 Avatar accepts only a fixed set of sizes (16/20/24/28/32/36/40/48/56\n * /64/72/96/120/128). v8 has a slightly different set (size8/24/32/40/48\n * /56/72/100/120). Round to the nearest valid v9 size when v8 has no\n * direct match (size8→16, size100→96).\n */\nexport const V8_PERSONA_SIZE_TO_V9: Record<string, number> = {\n  size8: 16,\n  size24: 24,\n  size32: 32,\n  size40: 40,\n  size48: 48,\n  size56: 56,\n  size72: 72,\n  size100: 96,\n  size120: 120,\n};\n\n/**\n * v8 PersonaPresence enum name → v9 PresenceBadge `status` value.\n *\n * Returns null for unknown inputs — caller omits the badge entirely.\n * (Default v8 sentinel `'none'` is also unknown here — it never reaches\n * this map because the call site guards against `presence === 'none'`.)\n */\nexport const V8_PRESENCE_TO_V9_STATUS: Record<string, string> = {\n  online: 'available',\n  offline: 'offline',\n  away: 'away',\n  busy: 'busy',\n  dnd: 'do-not-disturb',\n  blocked: 'unknown',\n};\n\n/** Look up the v9 Avatar size for a v8 PersonaSize enum name. Defaults to 48. */\nexport function mapV8PersonaSizeToV9(v8Size: string): number {\n  return V8_PERSONA_SIZE_TO_V9[v8Size] ?? 48;\n}\n\n/**\n * Look up the v9 PresenceBadge status for a v8 PersonaPresence enum name.\n * Returns null for unrecognized inputs — caller omits the badge.\n */\nexport function mapV8PresenceToV9Status(v8Presence: string): string | null {\n  return V8_PRESENCE_TO_V9_STATUS[v8Presence] ?? null;\n}\n\n/**\n * Phase 3f.4 review fix — sanitize a user-controlled string that's\n * about to be interpolated into a JS member-access expression like\n * `PersonaPresence.${name}` or `PersonaSize.${name}`. The v8 emission\n * generates raw JS code, so an unvalidated user value (`'} alert(1) //'`)\n * would close the expression and inject arbitrary code. Whitelist to\n * identifier-shaped tokens; fall back to `fallback` for anything else.\n *\n * Pure-regex check intentional — doesn't tie us to a specific v8 enum\n * (which can shift across Fluent v8 patches). If the runtime enum\n * lookup yields undefined for a legal-but-unknown identifier, v8\n * silently renders without that prop — same outcome as the fallback.\n *\n * Used by the v8 Persona emission for both `presence` and `size` props.\n */\nexport function sanitizeV8EnumIdentifier(value: string, fallback: string): string {\n  return /^[a-zA-Z][a-zA-Z0-9]*$/.test(value) ? value : fallback;\n}\n\n/** v8 PersonaPresence sanitizer — fallback `'none'` (no presence shown). */\nexport function sanitizeV8PresenceName(v8Presence: string): string {\n  return sanitizeV8EnumIdentifier(v8Presence, 'none');\n}\n\n/** v8 PersonaSize sanitizer — fallback `'size48'` (the v8 default). */\nexport function sanitizeV8PersonaSizeName(v8Size: string): string {\n  return sanitizeV8EnumIdentifier(v8Size, 'size48');\n}\n"],"mappings":"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","names":[]}

package/dist/icons.d.cts

@@ -0,0 +1,130 @@
+/**
+ * Phase 3f.0 — v8 → v9 icon name lookup table.
+ *
+ * Maps Fluent UI v8 icon names (used by the form-builder picker and
+ * emitted as `iconName="..."` strings) to their equivalent component
+ * names in `@fluentui/react-icons` for v9 generated output.
+ *
+ * v9 react-icons naming convention: `${Glyph}${Size}${Variant}` —
+ *   - Size: 12 | 16 | 20 | 24 | 28 | 32 | 48
+ *   - Variant: Regular | Filled
+ *
+ * The form generator emits inline icons in buttons, headers, and
+ * column actions. 20px Regular is the standard size for inline use,
+ * matching v8's default rendering. Callers needing a different size
+ * can override at the call site.
+ *
+ * Coverage: every icon name referenced by `iconName: 'X'` patterns
+ * in the form-builder project (~100 glyphs). Generated by surveying
+ * `grep -rE "iconName: ['\"]"` output across `src/` on 2026-05-01.
+ *
+ * **Excluded from the v9 map** (no clean v9 equivalent — emit warning
+ * via Phase 3f.1's scanV9Compatibility):
+ *   - none currently; v9 react-icons covers all 100 surveyed glyphs.
+ *     If a future v8 icon name has no v9 mapping, add it to
+ *     V8_ICONS_WITHOUT_V9 below so the scanner reports it.
+ */
+/** v9 component name from `@fluentui/react-icons`. */
+type V9IconName = string;
+/**
+ * v8 → v9 icon-name lookup. v8 keys are the literal `iconName="..."`
+ * strings the form generator emits today. v9 values are the component
+ * names exported by `@fluentui/react-icons` at the standard 20px Regular
+ * size. Default to `Regular` over `Filled` — matches v8's default weight.
+ *
+ * Some v8 names map to renamed v9 glyphs (Cancel → Dismiss, More →
+ * MoreHorizontal, Refresh → ArrowSync, Back → ArrowLeft, Down → ArrowDown,
+ * Up → ArrowUp, View → Eye, Remove → Subtract, Leave → SignOut). The map
+ * is the single source of truth for these renames.
+ */
+declare const V8_TO_V9_ICON_MAP: Record<string, V9IconName>;
+/**
+ * v8 icons that have no clean v9 equivalent. Empty today — every
+ * surveyed v8 name maps to a v9 glyph above. Reserved for future v8
+ * names (e.g. esoteric Office-suite glyphs) that don't ship in
+ * `@fluentui/react-icons`. Phase 3f.1's `scanV9Compatibility` reads
+ * this set to flag forms that use them.
+ */
+declare const V8_ICONS_WITHOUT_V9: ReadonlySet<string>;
+/**
+ * Look up a v9 icon component name for a v8 icon name. Returns null
+ * if no mapping exists; callers should consult `V8_ICONS_WITHOUT_V9`
+ * to decide whether to flag it as a compatibility issue or just emit
+ * a generic fallback.
+ *
+ * @param v8Name v8 `iconName` string (e.g. 'Add', 'Cancel')
+ * @returns v9 component name (e.g. 'Add20Regular') or null
+ */
+declare function mapV8IconToV9(v8Name: string): V9IconName | null;
+/**
+ * Build the import statement string for a set of v9 icons. Used by
+ * generators that need to emit `import { Add20Regular, Delete20Regular }
+ * from '@fluentui/react-icons'`. Empty input returns empty string —
+ * caller should not include the import block at all in that case.
+ *
+ * @param v9IconNames Set or array of v9 component names
+ * @returns Single-line import statement, or empty string if none
+ */
+declare function buildV9IconImport(v9IconNames: Iterable<string>): string;
+
+/**
+ * Phase 3f.4 — v8 Persona ↔ v9 Avatar compatibility maps.
+ *
+ * Extracted from FormCodeGenerator.ts (review fix) so the maps live
+ * next to `iconNameMap.ts` and follow the same convention. Keeps the
+ * generator focused on emission and lets the maps evolve independently.
+ *
+ * Naming convention parity with `mapV8IconToV9` from `iconNameMap.ts`:
+ * `mapV8XxxToV9` — explicit v8 → v9 direction in the function name.
+ *
+ * v8 PersonaSize and PersonaPresence are enum names (`size48`, `online`)
+ * that v8 turned into runtime values via `PersonaSize.size48` etc. v9
+ * Avatar takes a numeric `size` and v9 PresenceBadge takes a `status`
+ * string — different shapes, hence the lookup tables.
+ */
+/**
+ * v8 PersonaSize enum name → v9 Avatar `size` numeric value.
+ *
+ * v9 Avatar accepts only a fixed set of sizes (16/20/24/28/32/36/40/48/56
+ * /64/72/96/120/128). v8 has a slightly different set (size8/24/32/40/48
+ * /56/72/100/120). Round to the nearest valid v9 size when v8 has no
+ * direct match (size8→16, size100→96).
+ */
+declare const V8_PERSONA_SIZE_TO_V9: Record<string, number>;
+/**
+ * v8 PersonaPresence enum name → v9 PresenceBadge `status` value.
+ *
+ * Returns null for unknown inputs — caller omits the badge entirely.
+ * (Default v8 sentinel `'none'` is also unknown here — it never reaches
+ * this map because the call site guards against `presence === 'none'`.)
+ */
+declare const V8_PRESENCE_TO_V9_STATUS: Record<string, string>;
+/** Look up the v9 Avatar size for a v8 PersonaSize enum name. Defaults to 48. */
+declare function mapV8PersonaSizeToV9(v8Size: string): number;
+/**
+ * Look up the v9 PresenceBadge status for a v8 PersonaPresence enum name.
+ * Returns null for unrecognized inputs — caller omits the badge.
+ */
+declare function mapV8PresenceToV9Status(v8Presence: string): string | null;
+/**
+ * Phase 3f.4 review fix — sanitize a user-controlled string that's
+ * about to be interpolated into a JS member-access expression like
+ * `PersonaPresence.${name}` or `PersonaSize.${name}`. The v8 emission
+ * generates raw JS code, so an unvalidated user value (`'} alert(1) //'`)
+ * would close the expression and inject arbitrary code. Whitelist to
+ * identifier-shaped tokens; fall back to `fallback` for anything else.
+ *
+ * Pure-regex check intentional — doesn't tie us to a specific v8 enum
+ * (which can shift across Fluent v8 patches). If the runtime enum
+ * lookup yields undefined for a legal-but-unknown identifier, v8
+ * silently renders without that prop — same outcome as the fallback.
+ *
+ * Used by the v8 Persona emission for both `presence` and `size` props.
+ */
+declare function sanitizeV8EnumIdentifier(value: string, fallback: string): string;
+/** v8 PersonaPresence sanitizer — fallback `'none'` (no presence shown). */
+declare function sanitizeV8PresenceName(v8Presence: string): string;
+/** v8 PersonaSize sanitizer — fallback `'size48'` (the v8 default). */
+declare function sanitizeV8PersonaSizeName(v8Size: string): string;
+
+export { V8_ICONS_WITHOUT_V9, V8_PERSONA_SIZE_TO_V9, V8_PRESENCE_TO_V9_STATUS, V8_TO_V9_ICON_MAP, type V9IconName, buildV9IconImport, mapV8IconToV9, mapV8PersonaSizeToV9, mapV8PresenceToV9Status, sanitizeV8EnumIdentifier, sanitizeV8PersonaSizeName, sanitizeV8PresenceName };

package/dist/icons.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Phase 3f.0 — v8 → v9 icon name lookup table.
+ *
+ * Maps Fluent UI v8 icon names (used by the form-builder picker and
+ * emitted as `iconName="..."` strings) to their equivalent component
+ * names in `@fluentui/react-icons` for v9 generated output.
+ *
+ * v9 react-icons naming convention: `${Glyph}${Size}${Variant}` —
+ *   - Size: 12 | 16 | 20 | 24 | 28 | 32 | 48
+ *   - Variant: Regular | Filled
+ *
+ * The form generator emits inline icons in buttons, headers, and
+ * column actions. 20px Regular is the standard size for inline use,
+ * matching v8's default rendering. Callers needing a different size
+ * can override at the call site.
+ *
+ * Coverage: every icon name referenced by `iconName: 'X'` patterns
+ * in the form-builder project (~100 glyphs). Generated by surveying
+ * `grep -rE "iconName: ['\"]"` output across `src/` on 2026-05-01.
+ *
+ * **Excluded from the v9 map** (no clean v9 equivalent — emit warning
+ * via Phase 3f.1's scanV9Compatibility):
+ *   - none currently; v9 react-icons covers all 100 surveyed glyphs.
+ *     If a future v8 icon name has no v9 mapping, add it to
+ *     V8_ICONS_WITHOUT_V9 below so the scanner reports it.
+ */
+/** v9 component name from `@fluentui/react-icons`. */
+type V9IconName = string;
+/**
+ * v8 → v9 icon-name lookup. v8 keys are the literal `iconName="..."`
+ * strings the form generator emits today. v9 values are the component
+ * names exported by `@fluentui/react-icons` at the standard 20px Regular
+ * size. Default to `Regular` over `Filled` — matches v8's default weight.
+ *
+ * Some v8 names map to renamed v9 glyphs (Cancel → Dismiss, More →
+ * MoreHorizontal, Refresh → ArrowSync, Back → ArrowLeft, Down → ArrowDown,
+ * Up → ArrowUp, View → Eye, Remove → Subtract, Leave → SignOut). The map
+ * is the single source of truth for these renames.
+ */
+declare const V8_TO_V9_ICON_MAP: Record<string, V9IconName>;
+/**
+ * v8 icons that have no clean v9 equivalent. Empty today — every
+ * surveyed v8 name maps to a v9 glyph above. Reserved for future v8
+ * names (e.g. esoteric Office-suite glyphs) that don't ship in
+ * `@fluentui/react-icons`. Phase 3f.1's `scanV9Compatibility` reads
+ * this set to flag forms that use them.
+ */
+declare const V8_ICONS_WITHOUT_V9: ReadonlySet<string>;
+/**
+ * Look up a v9 icon component name for a v8 icon name. Returns null
+ * if no mapping exists; callers should consult `V8_ICONS_WITHOUT_V9`
+ * to decide whether to flag it as a compatibility issue or just emit
+ * a generic fallback.
+ *
+ * @param v8Name v8 `iconName` string (e.g. 'Add', 'Cancel')
+ * @returns v9 component name (e.g. 'Add20Regular') or null
+ */
+declare function mapV8IconToV9(v8Name: string): V9IconName | null;
+/**
+ * Build the import statement string for a set of v9 icons. Used by
+ * generators that need to emit `import { Add20Regular, Delete20Regular }
+ * from '@fluentui/react-icons'`. Empty input returns empty string —
+ * caller should not include the import block at all in that case.
+ *
+ * @param v9IconNames Set or array of v9 component names
+ * @returns Single-line import statement, or empty string if none
+ */
+declare function buildV9IconImport(v9IconNames: Iterable<string>): string;
+
+/**
+ * Phase 3f.4 — v8 Persona ↔ v9 Avatar compatibility maps.
+ *
+ * Extracted from FormCodeGenerator.ts (review fix) so the maps live
+ * next to `iconNameMap.ts` and follow the same convention. Keeps the
+ * generator focused on emission and lets the maps evolve independently.
+ *
+ * Naming convention parity with `mapV8IconToV9` from `iconNameMap.ts`:
+ * `mapV8XxxToV9` — explicit v8 → v9 direction in the function name.
+ *
+ * v8 PersonaSize and PersonaPresence are enum names (`size48`, `online`)
+ * that v8 turned into runtime values via `PersonaSize.size48` etc. v9
+ * Avatar takes a numeric `size` and v9 PresenceBadge takes a `status`
+ * string — different shapes, hence the lookup tables.
+ */
+/**
+ * v8 PersonaSize enum name → v9 Avatar `size` numeric value.
+ *
+ * v9 Avatar accepts only a fixed set of sizes (16/20/24/28/32/36/40/48/56
+ * /64/72/96/120/128). v8 has a slightly different set (size8/24/32/40/48
+ * /56/72/100/120). Round to the nearest valid v9 size when v8 has no
+ * direct match (size8→16, size100→96).
+ */
+declare const V8_PERSONA_SIZE_TO_V9: Record<string, number>;
+/**
+ * v8 PersonaPresence enum name → v9 PresenceBadge `status` value.
+ *
+ * Returns null for unknown inputs — caller omits the badge entirely.
+ * (Default v8 sentinel `'none'` is also unknown here — it never reaches
+ * this map because the call site guards against `presence === 'none'`.)
+ */
+declare const V8_PRESENCE_TO_V9_STATUS: Record<string, string>;
+/** Look up the v9 Avatar size for a v8 PersonaSize enum name. Defaults to 48. */
+declare function mapV8PersonaSizeToV9(v8Size: string): number;
+/**
+ * Look up the v9 PresenceBadge status for a v8 PersonaPresence enum name.
+ * Returns null for unrecognized inputs — caller omits the badge.
+ */
+declare function mapV8PresenceToV9Status(v8Presence: string): string | null;
+/**
+ * Phase 3f.4 review fix — sanitize a user-controlled string that's
+ * about to be interpolated into a JS member-access expression like
+ * `PersonaPresence.${name}` or `PersonaSize.${name}`. The v8 emission
+ * generates raw JS code, so an unvalidated user value (`'} alert(1) //'`)
+ * would close the expression and inject arbitrary code. Whitelist to
+ * identifier-shaped tokens; fall back to `fallback` for anything else.
+ *
+ * Pure-regex check intentional — doesn't tie us to a specific v8 enum
+ * (which can shift across Fluent v8 patches). If the runtime enum
+ * lookup yields undefined for a legal-but-unknown identifier, v8
+ * silently renders without that prop — same outcome as the fallback.
+ *
+ * Used by the v8 Persona emission for both `presence` and `size` props.
+ */
+declare function sanitizeV8EnumIdentifier(value: string, fallback: string): string;
+/** v8 PersonaPresence sanitizer — fallback `'none'` (no presence shown). */
+declare function sanitizeV8PresenceName(v8Presence: string): string;
+/** v8 PersonaSize sanitizer — fallback `'size48'` (the v8 default). */
+declare function sanitizeV8PersonaSizeName(v8Size: string): string;
+
+export { V8_ICONS_WITHOUT_V9, V8_PERSONA_SIZE_TO_V9, V8_PRESENCE_TO_V9_STATUS, V8_TO_V9_ICON_MAP, type V9IconName, buildV9IconImport, mapV8IconToV9, mapV8PersonaSizeToV9, mapV8PresenceToV9Status, sanitizeV8EnumIdentifier, sanitizeV8PersonaSizeName, sanitizeV8PresenceName };