@hjmds/design-contracts 1.13.1 → 1.15.0

package/dist/design-system-provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"design-system-provider.js","sourceRoot":"","sources":["../src/design-system-provider.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ColorReferencePalette } from \"./color-references.js\";\nimport { control, largeTextThreshold } from \"./foundations.js\";\nimport {\n  ACCENTS,\n  THEMES,\n  accentFill,\n  isThemePreference,\n  type ResolvedTheme,\n  type ThemeColors,\n  type ThemePreference,\n} from \"./colors.js\";\n\n/**\n * Canonical logical direction. Existing public component-specific names stay\n * source-compatible as aliases of this type instead of redeclaring the union.\n */\nexport type DesignSystemDirection = \"ltr\" | \"rtl\";\n\n/**\n * A continuous OS/user font-scale multiplier (iOS Dynamic Type, Android font\n * size, browser zoom) — not `ShowcaseTextScale`'s closed `1 | 1.5 | 2`, which\n * only names Showcase's five fixture stories, or `description-list.ts`'s\n * local layout clamp. This is the single upstream signal both now consume.\n */\nexport type DesignSystemTextScale = number;\n\n/**\n * Whether a resolved `textScale` has crossed into large-text layout. A\n * stylesheet cannot compare numbers, so the provider resolves the axis once and\n * publishes the result for surfaces that can only match a flag (#20).\n */\nexport function isLargeTextScale(textScale: DesignSystemTextScale): boolean {\n  return Number.isFinite(textScale) && textScale >= largeTextThreshold;\n}\n\n/**\n * Visible height a compact control paints under a product's target-size policy.\n *\n * The compact recipes stay at 36 and reach the 44pt target through hit slop,\n * which satisfies WCAG 2.5.8 but not the stricter iOS/Android guidance some\n * products commit to. `minimumVisualTarget` turns that commitment into one\n * resolved axis, so both renderers compute the same geometry instead of each\n * consumer re-adding `minHeight` in product styles. It lives beside the axis\n * rather than in `foundations` because it is a policy over a token, not a token.\n */\nexport function visibleControlHeight(\n  recipeHeight: number,\n  minimumVisualTarget: boolean,\n): number {\n  return minimumVisualTarget ? Math.max(recipeHeight, control.minTouchTarget) : recipeHeight;\n}\n\n/**\n * 한 화면 안에서 목록·메뉴·표가 각각 다른 밀도로 그려지던 문제를 하나의 축으로 모은다.\n * 지금까지는 `ListRow density`, `Menu density`, DataTable의 행 높이가 서로 모르는 값이라\n * 제품이 세 군데를 따로 맞췄다. 컴포넌트의 명시적 prop이 언제나 이 축을 이긴다 —\n * 전역값은 기본이지 강제가 아니다.\n *\n * OS 신호가 없다. 밀도는 제품의 입장(같은 화면에 얼마나 담을 것인가)이지 사용자 설정이\n * 아니라서 `system*` 짝을 두지 않았다. 반대로 큰 글자 설정은 사용자 설정이므로\n * `textScale`이 큰 상태에서 `compact`를 쓰는 것은 제품이 스스로 막아야 한다.\n */\nexport type DesignSystemDensity = \"comfortable\" | \"compact\";\n\n/**\n * 전역 밀도를 컴포넌트마다 다른 밀도 어휘로 옮긴다. 컴포넌트의 명시적 prop이 언제나\n * 이긴다 — 전역값은 기본이지 강제가 아니다. 어휘를 하나로 통일하지 않은 이유: 목록의\n * `relaxed`와 표의 `regular`는 같은 말이 아니고, 억지로 합치면 둘 중 하나가 거짓말을 한다.\n */\nexport function resolveDensityDefault<Comfortable extends string, Compact extends string>(\n  density: DesignSystemDensity,\n  vocabulary: Readonly<{ comfortable: Comfortable; compact: Compact }>,\n): Comfortable | Compact {\n  return density === \"compact\" ? vocabulary.compact : vocabulary.comfortable;\n}\n\nexport type DesignSystemEnvironmentInput = Readonly<{\n  theme?: ThemePreference;\n  direction?: DesignSystemDirection;\n  textScale?: DesignSystemTextScale;\n  reducedMotion?: boolean;\n  /**\n   * Paint the minimum touch target as visible control geometry instead of\n   * reaching it with hit slop. This is a product accessibility stance, not an\n   * OS signal, so it has no `system*` counterpart.\n   */\n  minimumVisualTarget?: boolean;\n  /** Default row/menu/table density for everything below this provider. */\n  density?: DesignSystemDensity;\n}>;\n\nexport const designSystemEnvironmentDefaults = {\n  theme: \"system\",\n  direction: \"ltr\",\n  textScale: 1,\n  reducedMotion: false,\n  minimumVisualTarget: false,\n  density: \"comfortable\",\n} as const satisfies Readonly<{\n  theme: ThemePreference;\n  direction: DesignSystemDirection;\n  textScale: DesignSystemTextScale;\n  reducedMotion: boolean;\n  minimumVisualTarget: boolean;\n  density: DesignSystemDensity;\n}>;\n\nexport type ResolvedDesignSystemEnvironment = Readonly<{\n  theme: ResolvedTheme;\n  direction: DesignSystemDirection;\n  textScale: DesignSystemTextScale;\n  reducedMotion: boolean;\n  minimumVisualTarget: boolean;\n  density: DesignSystemDensity;\n}>;\n\nexport type ResolveDesignSystemEnvironmentOptions = Readonly<{\n  /**\n   * The platform's current OS-level scheme, consulted only when `theme`\n   * resolves to `\"system\"`. Renderers detect this themselves\n   * (`Appearance.getColorScheme()`, `matchMedia('(prefers-color-scheme)')`)\n   * — this package never queries the OS.\n   */\n  systemTheme: ResolvedTheme;\n  /** Optional OS/renderer signals used when neither input nor a parent supplies the axis. */\n  systemDirection?: DesignSystemDirection;\n  systemTextScale?: DesignSystemTextScale;\n  systemReducedMotion?: boolean;\n  /**\n   * Product brand colors layered over the HJM semantic keys. The key set is\n   * unchanged, so recipes and contrast rules keep applying. Without this entry\n   * point a consumer has to build its own token layer and override the CSS\n   * variables, which is a copy of the canonical palette. Only the supplied\n   * keys are replaced; the rest keep the HJM defaults.\n   */\n  brandPalette?: Readonly<Partial<Record<ResolvedTheme, Readonly<Partial<ThemeColors>>>>>;\n  /** A nested renderer inherits the already-resolved parent before consulting OS defaults. */\n  parent?: ResolvedDesignSystemEnvironment;\n}>;\n\nexport type DesignSystemProviderValue = Readonly<{\n  environment: ResolvedDesignSystemEnvironment;\n  /** Palette consumed directly by `resolveColorReference`. */\n  palette: ColorReferencePalette;\n}>;\n\nconst themeColorKeys = Object.keys(THEMES.light) as readonly (keyof typeof THEMES.light)[];\nconst accentColorKeys = Object.keys(ACCENTS.light) as readonly (keyof typeof ACCENTS.light)[];\nconst sixDigitHexColor = /^#[0-9a-f]{6}$/i;\n\nfunction assertColorRecord(\n  value: unknown,\n  keys: readonly string[],\n  field: string,\n): asserts value is Readonly<Record<string, string>> {\n  if (value === null || typeof value !== \"object\" || Array.isArray(value)) {\n    throw new TypeError(`DesignSystemProviderValue ${field} must be a color record`);\n  }\n  const record = value as Readonly<Record<string, unknown>>;\n  for (const key of keys) {\n    const color = record[key];\n    if (typeof color !== \"string\" || !sixDigitHexColor.test(color)) {\n      throw new TypeError(\n        `DesignSystemProviderValue ${field}.${key} must be a six-digit hex color`,\n      );\n    }\n  }\n}\n\n/**\n * Runtime boundary for the resolved palette a renderer receives, including one\n * merged from a partial `brandPalette`: after merging, every semantic role a\n * recipe reads must be present, and alpha composition requires six-digit hex.\n * Brand rules: docs/brand-boundary.md.\n */\nexport function validateDesignSystemProviderValue(\n  value: DesignSystemProviderValue,\n): void {\n  if (value === null || typeof value !== \"object\") {\n    throw new TypeError(\"DesignSystemProviderValue must be an object\");\n  }\n  if (value.environment === null || typeof value.environment !== \"object\") {\n    throw new TypeError(\"DesignSystemProviderValue environment must be an object\");\n  }\n  validateResolvedDesignSystemEnvironment(value.environment);\n  const palette = value.palette;\n  if (palette === null || typeof palette !== \"object\") {\n    throw new TypeError(\"DesignSystemProviderValue palette must be an object\");\n  }\n  assertColorRecord(palette.theme, themeColorKeys, \"palette.theme\");\n  assertColorRecord(\n    palette.statusAccents,\n    accentColorKeys,\n    \"palette.statusAccents\",\n  );\n  assertColorRecord(\n    palette.statusAccentFills,\n    accentColorKeys,\n    \"palette.statusAccentFills\",\n  );\n}\n\nfunction assertBoolean(value: boolean, field: string): void {\n  if (typeof value !== \"boolean\") {\n    throw new TypeError(`DesignSystemEnvironment ${field} must be a boolean`);\n  }\n}\n\nfunction assertDirection(value: DesignSystemDirection, field: string): void {\n  if (value !== \"ltr\" && value !== \"rtl\") {\n    throw new TypeError(`Unsupported DesignSystemEnvironment ${field}: ${String(value)}`);\n  }\n}\n\nfunction assertTextScale(value: DesignSystemTextScale, field: string): void {\n  if (typeof value !== \"number\" || !Number.isFinite(value) || value <= 0) {\n    throw new RangeError(\n      `DesignSystemEnvironment ${field} must be a finite number greater than 0`,\n    );\n  }\n}\n\nfunction assertDensity(value: unknown, field: string): asserts value is DesignSystemDensity {\n  if (value !== \"comfortable\" && value !== \"compact\") {\n    throw new TypeError(`Unsupported DesignSystemEnvironment ${field}: ${String(value)}`);\n  }\n}\n\nexport function validateDesignSystemEnvironmentInput(\n  input: DesignSystemEnvironmentInput,\n): void {\n  if (input.theme !== undefined && !isThemePreference(input.theme)) {\n    throw new TypeError(`Unsupported DesignSystemEnvironment theme: ${String(input.theme)}`);\n  }\n  if (\n    input.direction !== undefined &&\n    input.direction !== \"ltr\" &&\n    input.direction !== \"rtl\"\n  ) {\n    throw new TypeError(\n      `Unsupported DesignSystemEnvironment direction: ${String(input.direction)}`,\n    );\n  }\n  if (input.textScale !== undefined) {\n    assertTextScale(input.textScale, \"textScale\");\n  }\n  if (input.reducedMotion !== undefined) {\n    assertBoolean(input.reducedMotion, \"reducedMotion\");\n  }\n  if (input.minimumVisualTarget !== undefined) {\n    assertBoolean(input.minimumVisualTarget, \"minimumVisualTarget\");\n  }\n  if (input.density !== undefined) {\n    assertDensity(input.density, \"density\");\n  }\n}\n\n/**\n * A parent has already crossed the system-preference boundary. Unlike the\n * partial input validator, this rejects `\"system\"`, missing axes, and every\n * malformed resolved value instead of silently resolving them again.\n */\nexport function validateResolvedDesignSystemEnvironment(\n  environment: ResolvedDesignSystemEnvironment,\n): void {\n  if (environment.theme !== \"light\" && environment.theme !== \"dark\") {\n    throw new TypeError(\n      `Unsupported ResolvedDesignSystemEnvironment theme: ${String(environment.theme)}`,\n    );\n  }\n  assertDirection(environment.direction, \"parent direction\");\n  assertTextScale(environment.textScale, \"parent textScale\");\n  assertBoolean(environment.reducedMotion, \"parent reducedMotion\");\n  assertBoolean(environment.minimumVisualTarget, \"parent minimumVisualTarget\");\n  assertDensity(environment.density, \"parent density\");\n}\n\n/**\n * Merges partial signals with safe defaults and resolves `\"system\"` against\n * the renderer-supplied `systemTheme`. This — not a React/RN context, which\n * this package cannot own — is the entire portable contract behind antd\n * `ConfigProvider`: see docs/design-system-provider.md for what was\n * deliberately left to the renderer.\n */\nexport function resolveDesignSystemEnvironment(\n  input: DesignSystemEnvironmentInput,\n  options: ResolveDesignSystemEnvironmentOptions,\n): ResolvedDesignSystemEnvironment {\n  validateDesignSystemEnvironmentInput(input);\n  if (options.systemTheme !== \"light\" && options.systemTheme !== \"dark\") {\n    throw new TypeError(`Unsupported DesignSystemEnvironment systemTheme: ${String(options.systemTheme)}`);\n  }\n  if (options.systemDirection !== undefined) {\n    assertDirection(options.systemDirection, \"systemDirection\");\n  }\n  if (options.systemTextScale !== undefined) {\n    assertTextScale(options.systemTextScale, \"systemTextScale\");\n  }\n  if (options.systemReducedMotion !== undefined) {\n    assertBoolean(options.systemReducedMotion, \"systemReducedMotion\");\n  }\n  if (options.parent !== undefined) {\n    validateResolvedDesignSystemEnvironment(options.parent);\n  }\n\n  const theme =\n    input.theme ?? options.parent?.theme ?? designSystemEnvironmentDefaults.theme;\n  return {\n    theme: theme === \"system\" ? options.systemTheme : theme,\n    direction:\n      input.direction ??\n      options.parent?.direction ??\n      options.systemDirection ??\n      designSystemEnvironmentDefaults.direction,\n    textScale:\n      input.textScale ??\n      options.parent?.textScale ??\n      options.systemTextScale ??\n      designSystemEnvironmentDefaults.textScale,\n    reducedMotion:\n      input.reducedMotion ??\n      options.parent?.reducedMotion ??\n      options.systemReducedMotion ??\n      designSystemEnvironmentDefaults.reducedMotion,\n    minimumVisualTarget:\n      input.minimumVisualTarget ??\n      options.parent?.minimumVisualTarget ??\n      designSystemEnvironmentDefaults.minimumVisualTarget,\n    density:\n      input.density ??\n      options.parent?.density ??\n      designSystemEnvironmentDefaults.density,\n  };\n}\n\n/**\n * Resolves the portable Provider value without owning React/RN Context. A\n * renderer stores this object in its own context and feeds `palette` directly\n * to recipe color resolution.\n */\nexport function resolveDesignSystemProviderValue(\n  input: DesignSystemEnvironmentInput,\n  options: ResolveDesignSystemEnvironmentOptions,\n): DesignSystemProviderValue {\n  const environment = resolveDesignSystemEnvironment(input, options);\n  const brandOverride = options.brandPalette?.[environment.theme];\n  const value = {\n    environment,\n    palette: {\n      theme: brandOverride === undefined\n        ? THEMES[environment.theme]\n        : { ...THEMES[environment.theme], ...brandOverride },\n      statusAccents: ACCENTS[environment.theme],\n      statusAccentFills: accentFill,\n    },\n  };\n  validateDesignSystemProviderValue(value);\n  return value;\n}\n"]}
+{"version":3,"file":"design-system-provider.js","sourceRoot":"","sources":["../src/design-system-provider.ts"],"names":[],"mappings":"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","sourcesContent":["import type { HjmDesignProfile } from \"./design-profile.js\";\nimport type { ColorReferencePalette } from \"./color-references.js\";\nimport { control, largeTextThreshold } from \"./foundations.js\";\nimport {\n  ACCENTS,\n  THEMES,\n  accentFill,\n  isThemePreference,\n  type ResolvedTheme,\n  type ThemeColors,\n  type ThemePreference,\n} from \"./colors.js\";\n\n/**\n * Canonical logical direction. Existing public component-specific names stay\n * source-compatible as aliases of this type instead of redeclaring the union.\n */\nexport type DesignSystemDirection = \"ltr\" | \"rtl\";\n\n/**\n * A continuous OS/user font-scale multiplier (iOS Dynamic Type, Android font\n * size, browser zoom) — not `ShowcaseTextScale`'s closed `1 | 1.5 | 2`, which\n * only names Showcase's five fixture stories, or `description-list.ts`'s\n * local layout clamp. This is the single upstream signal both now consume.\n */\nexport type DesignSystemTextScale = number;\n\n/**\n * Whether a resolved `textScale` has crossed into large-text layout. A\n * stylesheet cannot compare numbers, so the provider resolves the axis once and\n * publishes the result for surfaces that can only match a flag (#20).\n */\nexport function isLargeTextScale(textScale: DesignSystemTextScale): boolean {\n  return Number.isFinite(textScale) && textScale >= largeTextThreshold;\n}\n\n/**\n * Visible height a compact control paints under a product's target-size policy.\n *\n * The compact recipes stay at 36 and reach the 44pt target through hit slop,\n * which satisfies WCAG 2.5.8 but not the stricter iOS/Android guidance some\n * products commit to. `minimumVisualTarget` turns that commitment into one\n * resolved axis, so both renderers compute the same geometry instead of each\n * consumer re-adding `minHeight` in product styles. It lives beside the axis\n * rather than in `foundations` because it is a policy over a token, not a token.\n */\nexport function visibleControlHeight(\n  recipeHeight: number,\n  minimumVisualTarget: boolean,\n): number {\n  return minimumVisualTarget ? Math.max(recipeHeight, control.minTouchTarget) : recipeHeight;\n}\n\n/**\n * 한 화면 안에서 목록·메뉴·표가 각각 다른 밀도로 그려지던 문제를 하나의 축으로 모은다.\n * 지금까지는 `ListRow density`, `Menu density`, DataTable의 행 높이가 서로 모르는 값이라\n * 제품이 세 군데를 따로 맞췄다. 컴포넌트의 명시적 prop이 언제나 이 축을 이긴다 —\n * 전역값은 기본이지 강제가 아니다.\n *\n * OS 신호가 없다. 밀도는 제품의 입장(같은 화면에 얼마나 담을 것인가)이지 사용자 설정이\n * 아니라서 `system*` 짝을 두지 않았다. 반대로 큰 글자 설정은 사용자 설정이므로\n * `textScale`이 큰 상태에서 `compact`를 쓰는 것은 제품이 스스로 막아야 한다.\n */\nexport type DesignSystemDensity = \"comfortable\" | \"compact\";\n\n/**\n * 전역 밀도를 컴포넌트마다 다른 밀도 어휘로 옮긴다. 컴포넌트의 명시적 prop이 언제나\n * 이긴다 — 전역값은 기본이지 강제가 아니다. 어휘를 하나로 통일하지 않은 이유: 목록의\n * `relaxed`와 표의 `regular`는 같은 말이 아니고, 억지로 합치면 둘 중 하나가 거짓말을 한다.\n */\nexport function resolveDensityDefault<Comfortable extends string, Compact extends string>(\n  density: DesignSystemDensity,\n  vocabulary: Readonly<{ comfortable: Comfortable; compact: Compact }>,\n): Comfortable | Compact {\n  return density === \"compact\" ? vocabulary.compact : vocabulary.comfortable;\n}\n\nexport type DesignSystemEnvironmentInput = Readonly<{\n  theme?: ThemePreference;\n  direction?: DesignSystemDirection;\n  textScale?: DesignSystemTextScale;\n  reducedMotion?: boolean;\n  /**\n   * Paint the minimum touch target as visible control geometry instead of\n   * reaching it with hit slop. This is a product accessibility stance, not an\n   * OS signal, so it has no `system*` counterpart.\n   */\n  minimumVisualTarget?: boolean;\n  /** Default row/menu/table density for everything below this provider. */\n  density?: DesignSystemDensity;\n}>;\n\nexport const designSystemEnvironmentDefaults = {\n  theme: \"system\",\n  direction: \"ltr\",\n  textScale: 1,\n  reducedMotion: false,\n  minimumVisualTarget: false,\n  density: \"comfortable\",\n} as const satisfies Readonly<{\n  theme: ThemePreference;\n  direction: DesignSystemDirection;\n  textScale: DesignSystemTextScale;\n  reducedMotion: boolean;\n  minimumVisualTarget: boolean;\n  density: DesignSystemDensity;\n}>;\n\nexport type ResolvedDesignSystemEnvironment = Readonly<{\n  theme: ResolvedTheme;\n  direction: DesignSystemDirection;\n  textScale: DesignSystemTextScale;\n  reducedMotion: boolean;\n  minimumVisualTarget: boolean;\n  density: DesignSystemDensity;\n}>;\n\nexport type ResolveDesignSystemEnvironmentOptions = Readonly<{\n  /**\n   * The platform's current OS-level scheme, consulted only when `theme`\n   * resolves to `\"system\"`. Renderers detect this themselves\n   * (`Appearance.getColorScheme()`, `matchMedia('(prefers-color-scheme)')`)\n   * — this package never queries the OS.\n   */\n  systemTheme: ResolvedTheme;\n  /** Optional OS/renderer signals used when neither input nor a parent supplies the axis. */\n  systemDirection?: DesignSystemDirection;\n  systemTextScale?: DesignSystemTextScale;\n  systemReducedMotion?: boolean;\n  /**\n   * Product brand colors layered over the HJM semantic keys. The key set is\n   * unchanged, so recipes and contrast rules keep applying. Without this entry\n   * point a consumer has to build its own token layer and override the CSS\n   * variables, which is a copy of the canonical palette. Only the supplied\n   * keys are replaced; the rest keep the HJM defaults.\n   */\n  brandPalette?: Readonly<Partial<Record<ResolvedTheme, Readonly<Partial<ThemeColors>>>>>;\n  /** Use defineHjmDesignProfile once at the product boundary; importing its registry\n   * here at runtime would force every granular component to bundle all reference packs. */\n  designProfile?: HjmDesignProfile;\n  /** A nested renderer inherits the already-resolved parent before consulting OS defaults. */\n  parent?: ResolvedDesignSystemEnvironment;\n}>;\n\nexport type DesignSystemProviderValue = Readonly<{\n  environment: ResolvedDesignSystemEnvironment;\n  /** Palette consumed directly by `resolveColorReference`. */\n  palette: ColorReferencePalette;\n  /** Optional to preserve existing pre-resolved provider values. */\n  designProfile?: HjmDesignProfile;\n}>;\n\nconst themeColorKeys = Object.keys(THEMES.light) as readonly (keyof typeof THEMES.light)[];\nconst accentColorKeys = Object.keys(ACCENTS.light) as readonly (keyof typeof ACCENTS.light)[];\nconst sixDigitHexColor = /^#[0-9a-f]{6}$/i;\n\nfunction assertColorRecord(\n  value: unknown,\n  keys: readonly string[],\n  field: string,\n): asserts value is Readonly<Record<string, string>> {\n  if (value === null || typeof value !== \"object\" || Array.isArray(value)) {\n    throw new TypeError(`DesignSystemProviderValue ${field} must be a color record`);\n  }\n  const record = value as Readonly<Record<string, unknown>>;\n  for (const key of keys) {\n    const color = record[key];\n    if (typeof color !== \"string\" || !sixDigitHexColor.test(color)) {\n      throw new TypeError(\n        `DesignSystemProviderValue ${field}.${key} must be a six-digit hex color`,\n      );\n    }\n  }\n}\n\n/**\n * Runtime boundary for the resolved palette a renderer receives, including one\n * merged from a partial `brandPalette`: after merging, every semantic role a\n * recipe reads must be present, and alpha composition requires six-digit hex.\n * Brand rules: docs/brand-boundary.md.\n */\nexport function validateDesignSystemProviderValue(\n  value: DesignSystemProviderValue,\n): void {\n  if (value === null || typeof value !== \"object\") {\n    throw new TypeError(\"DesignSystemProviderValue must be an object\");\n  }\n  if (value.environment === null || typeof value.environment !== \"object\") {\n    throw new TypeError(\"DesignSystemProviderValue environment must be an object\");\n  }\n  validateResolvedDesignSystemEnvironment(value.environment);\n  const palette = value.palette;\n  if (palette === null || typeof palette !== \"object\") {\n    throw new TypeError(\"DesignSystemProviderValue palette must be an object\");\n  }\n  assertColorRecord(palette.theme, themeColorKeys, \"palette.theme\");\n  assertColorRecord(\n    palette.statusAccents,\n    accentColorKeys,\n    \"palette.statusAccents\",\n  );\n  assertColorRecord(\n    palette.statusAccentFills,\n    accentColorKeys,\n    \"palette.statusAccentFills\",\n  );\n}\n\nfunction assertBoolean(value: boolean, field: string): void {\n  if (typeof value !== \"boolean\") {\n    throw new TypeError(`DesignSystemEnvironment ${field} must be a boolean`);\n  }\n}\n\nfunction assertDirection(value: DesignSystemDirection, field: string): void {\n  if (value !== \"ltr\" && value !== \"rtl\") {\n    throw new TypeError(`Unsupported DesignSystemEnvironment ${field}: ${String(value)}`);\n  }\n}\n\nfunction assertTextScale(value: DesignSystemTextScale, field: string): void {\n  if (typeof value !== \"number\" || !Number.isFinite(value) || value <= 0) {\n    throw new RangeError(\n      `DesignSystemEnvironment ${field} must be a finite number greater than 0`,\n    );\n  }\n}\n\nfunction assertDensity(value: unknown, field: string): asserts value is DesignSystemDensity {\n  if (value !== \"comfortable\" && value !== \"compact\") {\n    throw new TypeError(`Unsupported DesignSystemEnvironment ${field}: ${String(value)}`);\n  }\n}\n\nexport function validateDesignSystemEnvironmentInput(\n  input: DesignSystemEnvironmentInput,\n): void {\n  if (input.theme !== undefined && !isThemePreference(input.theme)) {\n    throw new TypeError(`Unsupported DesignSystemEnvironment theme: ${String(input.theme)}`);\n  }\n  if (\n    input.direction !== undefined &&\n    input.direction !== \"ltr\" &&\n    input.direction !== \"rtl\"\n  ) {\n    throw new TypeError(\n      `Unsupported DesignSystemEnvironment direction: ${String(input.direction)}`,\n    );\n  }\n  if (input.textScale !== undefined) {\n    assertTextScale(input.textScale, \"textScale\");\n  }\n  if (input.reducedMotion !== undefined) {\n    assertBoolean(input.reducedMotion, \"reducedMotion\");\n  }\n  if (input.minimumVisualTarget !== undefined) {\n    assertBoolean(input.minimumVisualTarget, \"minimumVisualTarget\");\n  }\n  if (input.density !== undefined) {\n    assertDensity(input.density, \"density\");\n  }\n}\n\n/**\n * A parent has already crossed the system-preference boundary. Unlike the\n * partial input validator, this rejects `\"system\"`, missing axes, and every\n * malformed resolved value instead of silently resolving them again.\n */\nexport function validateResolvedDesignSystemEnvironment(\n  environment: ResolvedDesignSystemEnvironment,\n): void {\n  if (environment.theme !== \"light\" && environment.theme !== \"dark\") {\n    throw new TypeError(\n      `Unsupported ResolvedDesignSystemEnvironment theme: ${String(environment.theme)}`,\n    );\n  }\n  assertDirection(environment.direction, \"parent direction\");\n  assertTextScale(environment.textScale, \"parent textScale\");\n  assertBoolean(environment.reducedMotion, \"parent reducedMotion\");\n  assertBoolean(environment.minimumVisualTarget, \"parent minimumVisualTarget\");\n  assertDensity(environment.density, \"parent density\");\n}\n\n/**\n * Merges partial signals with safe defaults and resolves `\"system\"` against\n * the renderer-supplied `systemTheme`. This — not a React/RN context, which\n * this package cannot own — is the entire portable contract behind antd\n * `ConfigProvider`: see docs/design-system-provider.md for what was\n * deliberately left to the renderer.\n */\nexport function resolveDesignSystemEnvironment(\n  input: DesignSystemEnvironmentInput,\n  options: ResolveDesignSystemEnvironmentOptions,\n): ResolvedDesignSystemEnvironment {\n  validateDesignSystemEnvironmentInput(input);\n  if (options.systemTheme !== \"light\" && options.systemTheme !== \"dark\") {\n    throw new TypeError(`Unsupported DesignSystemEnvironment systemTheme: ${String(options.systemTheme)}`);\n  }\n  if (options.systemDirection !== undefined) {\n    assertDirection(options.systemDirection, \"systemDirection\");\n  }\n  if (options.systemTextScale !== undefined) {\n    assertTextScale(options.systemTextScale, \"systemTextScale\");\n  }\n  if (options.systemReducedMotion !== undefined) {\n    assertBoolean(options.systemReducedMotion, \"systemReducedMotion\");\n  }\n  if (options.parent !== undefined) {\n    validateResolvedDesignSystemEnvironment(options.parent);\n  }\n\n  const theme =\n    input.theme ?? options.parent?.theme ?? designSystemEnvironmentDefaults.theme;\n  return {\n    theme: theme === \"system\" ? options.systemTheme : theme,\n    direction:\n      input.direction ??\n      options.parent?.direction ??\n      options.systemDirection ??\n      designSystemEnvironmentDefaults.direction,\n    textScale:\n      input.textScale ??\n      options.parent?.textScale ??\n      options.systemTextScale ??\n      designSystemEnvironmentDefaults.textScale,\n    reducedMotion:\n      input.reducedMotion ??\n      options.parent?.reducedMotion ??\n      options.systemReducedMotion ??\n      designSystemEnvironmentDefaults.reducedMotion,\n    minimumVisualTarget:\n      input.minimumVisualTarget ??\n      options.parent?.minimumVisualTarget ??\n      designSystemEnvironmentDefaults.minimumVisualTarget,\n    density:\n      input.density ??\n      options.parent?.density ??\n      designSystemEnvironmentDefaults.density,\n  };\n}\n\n/**\n * Resolves the portable Provider value without owning React/RN Context. A\n * renderer stores this object in its own context and feeds `palette` directly\n * to recipe color resolution.\n */\nexport function resolveDesignSystemProviderValue(\n  input: DesignSystemEnvironmentInput,\n  options: ResolveDesignSystemEnvironmentOptions,\n): DesignSystemProviderValue {\n  const environment = resolveDesignSystemEnvironment(input, options);\n  const brandOverride = options.brandPalette?.[environment.theme];\n  const basePalette = options.designProfile?.palette[environment.theme] ?? THEMES[environment.theme];\n  const value = {\n    environment,\n    ...(options.designProfile === undefined ? {} : { designProfile: options.designProfile }),\n    palette: {\n      theme: brandOverride === undefined\n        ? basePalette\n        : { ...basePalette, ...brandOverride },\n      statusAccents: ACCENTS[environment.theme],\n      statusAccentFills: accentFill,\n    },\n  };\n  validateDesignSystemProviderValue(value);\n  return value;\n}\n"]}

package/dist/document-resource.d.ts

@@ -0,0 +1,104 @@
+/** Candidate composition contract; file access, transfer and receipt verification stay with the host. */
+export type DocumentPreviewState = Readonly<{
+    status: "none" | "loading" | "ready";
+}> | Readonly<{
+    status: "error";
+    message: string;
+    retryable: boolean;
+}>;
+export type DocumentSaveState = Readonly<{
+    status: "idle" | "pending" | "started" | "saved" | "cancelled";
+}> | Readonly<{
+    status: "error";
+    message: string;
+    retryable: boolean;
+}>;
+export type DocumentResourceDescriptor = Readonly<{
+    /** Include a revision when reusing a resource id for different file contents. */
+    id: string;
+    name: string;
+    formatLabel?: string;
+    sizeLabel?: string;
+    description?: string;
+    disabled?: boolean;
+    /** Product review/permission gates may block export while keeping preview accessible. */
+    saveDisabled?: boolean;
+    preview: DocumentPreviewState;
+    save: DocumentSaveState;
+}>;
+export type DocumentResourceLabels = Readonly<{
+    preview: string;
+    previewLoading: string;
+    previewUnavailable: string;
+    retryPreview: string;
+    save: string;
+    saving: string;
+    started: string;
+    saved: string;
+    cancelled: string;
+    retrySave: string;
+}>;
+export type DocumentResourceControls = Readonly<{
+    descriptor: DocumentResourceDescriptor;
+    labels: DocumentResourceLabels;
+    onPreview?: () => void;
+    onRetryPreview?: () => void;
+    onSave: () => void;
+    onRetrySave?: () => void;
+}>;
+/** Controlled UI only: hosts connect the existing action session to their verified results. */
+export declare function resolveDocumentResourceControls(props: DocumentResourceControls): Readonly<{
+    id: string;
+    name: string;
+    metadata: readonly string[];
+    description: string | undefined;
+    disabled: boolean;
+    saveDisabled: boolean;
+    preview: Readonly<{
+        status: "none" | "loading" | "ready";
+    } | {
+        status: "error";
+        message: string;
+        retryable: boolean;
+    }>;
+    save: Readonly<{
+        status: "idle" | "pending" | "started" | "saved" | "cancelled";
+    } | {
+        status: "error";
+        message: string;
+        retryable: boolean;
+    }>;
+    canPreview: boolean;
+    canRetryPreview: boolean;
+    canSave: boolean;
+    canRetrySave: boolean;
+    saved: boolean;
+}>;
+export declare function resolveDocumentResource(descriptor: DocumentResourceDescriptor): Readonly<{
+    id: string;
+    name: string;
+    metadata: readonly string[];
+    description: string | undefined;
+    disabled: boolean;
+    saveDisabled: boolean;
+    preview: Readonly<{
+        status: "none" | "loading" | "ready";
+    } | {
+        status: "error";
+        message: string;
+        retryable: boolean;
+    }>;
+    save: Readonly<{
+        status: "idle" | "pending" | "started" | "saved" | "cancelled";
+    } | {
+        status: "error";
+        message: string;
+        retryable: boolean;
+    }>;
+    canPreview: boolean;
+    canRetryPreview: boolean;
+    canSave: boolean;
+    canRetrySave: boolean;
+    saved: boolean;
+}>;
+//# sourceMappingURL=document-resource.d.ts.map

package/dist/document-resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-resource.d.ts","sourceRoot":"","sources":["../src/document-resource.ts"],"names":[],"mappings":"AAAA,yGAAyG;AACzG,MAAM,MAAM,oBAAoB,GAC5B,QAAQ,CAAC;IAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAA;CAAE,CAAC,GAClD,QAAQ,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAEvE,MAAM,MAAM,iBAAiB,GACzB,QAAQ,CAAC;IAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,CAAA;CAAE,CAAC,GAC5E,QAAQ,CAAC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAEvE,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAAC;IAChD,iFAAiF;IACjF,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yFAAyF;IACzF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,oBAAoB,CAAC;IAC9B,IAAI,EAAE,iBAAiB,CAAC;CACzB,CAAC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC;IAC9C,UAAU,EAAE,0BAA0B,CAAC;IACvC,MAAM,EAAE,sBAAsB,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;IAC5B,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;CAC1B,CAAC,CAAC;AAEH,+FAA+F;AAC/F,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,wBAAwB;;;;;;;;gBA5CxD,MAAM,GAAG,SAAS,GAAG,OAAO;;gBAC5B,OAAO;iBAAW,MAAM;mBAAa,OAAO;;;gBAG5C,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW;;gBACtD,OAAO;iBAAW,MAAM;mBAAa,OAAO;;;;;;;GAmDlE;AAmBD,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,0BAA0B;;;;;;;;gBA3EvD,MAAM,GAAG,SAAS,GAAG,OAAO;;gBAC5B,OAAO;iBAAW,MAAM;mBAAa,OAAO;;;gBAG5C,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW;;gBACtD,OAAO;iBAAW,MAAM;mBAAa,OAAO;;;;;;;GA6GlE"}

package/dist/document-resource.js

@@ -0,0 +1,77 @@
+/** Controlled UI only: hosts connect the existing action session to their verified results. */
+export function resolveDocumentResourceControls(props) {
+    const resource = resolveDocumentResource(props.descriptor);
+    for (const key of ["preview", "previewLoading", "previewUnavailable", "retryPreview", "save", "saving", "started", "saved", "cancelled", "retrySave"]) {
+        text(props.labels[key], `labels.${key}`);
+    }
+    if (typeof props.onSave !== "function")
+        throw new TypeError("Document resource requires onSave");
+    for (const key of ["onPreview", "onRetryPreview", "onRetrySave"]) {
+        if (props[key] !== undefined && typeof props[key] !== "function")
+            throw new TypeError(`Document resource ${key} must be a function`);
+    }
+    if (resource.preview.status === "error" && resource.preview.retryable && !props.onRetryPreview)
+        throw new TypeError("Retryable preview requires onRetryPreview");
+    if (resource.save.status === "error" && resource.save.retryable && !props.onRetrySave)
+        throw new TypeError("Retryable save requires onRetrySave");
+    return resource;
+}
+function text(value, field) {
+    if (typeof value !== "string" || !value.trim())
+        throw new TypeError(`Document resource ${field} must be nonempty text`);
+}
+function state(value, states, field) {
+    if (!value || typeof value !== "object" || !("status" in value) || !states.includes(value.status)) {
+        throw new TypeError(`Document resource ${field} has an unsupported status`);
+    }
+    if (value.status === "error") {
+        const error = value;
+        text(error.message, `${field} error`);
+        // An uncertain native save can have committed. Retry permission is explicit,
+        // just like action-session; an error alone never authorizes another write.
+        if (typeof error.retryable !== "boolean")
+            throw new TypeError(`Document resource ${field} retryable must be boolean`);
+    }
+}
+export function resolveDocumentResource(descriptor) {
+    text(descriptor.id, "id");
+    text(descriptor.name, "name");
+    for (const key of ["formatLabel", "sizeLabel", "description"]) {
+        if (descriptor[key] !== undefined)
+            text(descriptor[key], key);
+    }
+    for (const key of ["disabled", "saveDisabled"]) {
+        if (descriptor[key] !== undefined && typeof descriptor[key] !== "boolean") {
+            throw new TypeError(`Document resource ${key} must be boolean`);
+        }
+    }
+    state(descriptor.preview, ["none", "loading", "ready", "error"], "preview");
+    state(descriptor.save, ["idle", "pending", "started", "saved", "cancelled", "error"], "save");
+    const disabled = descriptor.disabled ?? false;
+    // Utilverse requires viewing the output before accepting export; whole-card disabling
+    // would prevent that review. The host owns the requirement, not a fake pending state.
+    const saveDisabled = disabled || descriptor.saveDisabled === true;
+    const preview = Object.freeze({ ...descriptor.preview });
+    const save = Object.freeze({ ...descriptor.save });
+    return Object.freeze({
+        id: descriptor.id,
+        name: descriptor.name,
+        // Preserve product formatting and order; neither URL extensions nor inferred
+        // byte counts are reliable metadata for remote/signed/local resources.
+        metadata: Object.freeze([descriptor.formatLabel, descriptor.sizeLabel].filter((value) => value !== undefined)),
+        description: descriptor.description,
+        disabled,
+        saveDisabled,
+        preview,
+        save,
+        canPreview: !disabled && preview.status === "ready",
+        canRetryPreview: !disabled && preview.status === "error" && preview.retryable,
+        // Keep failures on the explicit retry path. A second ordinary save must not
+        // bypass a host's retryable=false policy after an ambiguous OS response.
+        canSave: !saveDisabled && save.status !== "pending" && save.status !== "error",
+        canRetrySave: !saveDisabled && save.status === "error" && save.retryable,
+        // Browser anchor activation proves initiation, not file-system completion.
+        saved: save.status === "saved",
+    });
+}
+//# sourceMappingURL=document-resource.js.map

package/dist/document-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-resource.js","sourceRoot":"","sources":["../src/document-resource.ts"],"names":[],"mappings":"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","sourcesContent":["/** Candidate composition contract; file access, transfer and receipt verification stay with the host. */\nexport type DocumentPreviewState =\n  | Readonly<{ status: \"none\" | \"loading\" | \"ready\" }>\n  | Readonly<{ status: \"error\"; message: string; retryable: boolean }>;\n\nexport type DocumentSaveState =\n  | Readonly<{ status: \"idle\" | \"pending\" | \"started\" | \"saved\" | \"cancelled\" }>\n  | Readonly<{ status: \"error\"; message: string; retryable: boolean }>;\n\nexport type DocumentResourceDescriptor = Readonly<{\n  /** Include a revision when reusing a resource id for different file contents. */\n  id: string;\n  name: string;\n  formatLabel?: string;\n  sizeLabel?: string;\n  description?: string;\n  disabled?: boolean;\n  /** Product review/permission gates may block export while keeping preview accessible. */\n  saveDisabled?: boolean;\n  preview: DocumentPreviewState;\n  save: DocumentSaveState;\n}>;\n\nexport type DocumentResourceLabels = Readonly<{\n  preview: string;\n  previewLoading: string;\n  previewUnavailable: string;\n  retryPreview: string;\n  save: string;\n  saving: string;\n  started: string;\n  saved: string;\n  cancelled: string;\n  retrySave: string;\n}>;\n\nexport type DocumentResourceControls = Readonly<{\n  descriptor: DocumentResourceDescriptor;\n  labels: DocumentResourceLabels;\n  onPreview?: () => void;\n  onRetryPreview?: () => void;\n  onSave: () => void;\n  onRetrySave?: () => void;\n}>;\n\n/** Controlled UI only: hosts connect the existing action session to their verified results. */\nexport function resolveDocumentResourceControls(props: DocumentResourceControls) {\n  const resource = resolveDocumentResource(props.descriptor);\n  for (const key of [\"preview\", \"previewLoading\", \"previewUnavailable\", \"retryPreview\", \"save\", \"saving\", \"started\", \"saved\", \"cancelled\", \"retrySave\"] as const) {\n    text(props.labels[key], `labels.${key}`);\n  }\n  if (typeof props.onSave !== \"function\") throw new TypeError(\"Document resource requires onSave\");\n  for (const key of [\"onPreview\", \"onRetryPreview\", \"onRetrySave\"] as const) {\n    if (props[key] !== undefined && typeof props[key] !== \"function\") throw new TypeError(`Document resource ${key} must be a function`);\n  }\n  if (resource.preview.status === \"error\" && resource.preview.retryable && !props.onRetryPreview) throw new TypeError(\"Retryable preview requires onRetryPreview\");\n  if (resource.save.status === \"error\" && resource.save.retryable && !props.onRetrySave) throw new TypeError(\"Retryable save requires onRetrySave\");\n  return resource;\n}\n\nfunction text(value: unknown, field: string): asserts value is string {\n  if (typeof value !== \"string\" || !value.trim()) throw new TypeError(`Document resource ${field} must be nonempty text`);\n}\n\nfunction state(value: unknown, states: readonly string[], field: string): void {\n  if (!value || typeof value !== \"object\" || !(\"status\" in value) || !states.includes(value.status as string)) {\n    throw new TypeError(`Document resource ${field} has an unsupported status`);\n  }\n  if (value.status === \"error\") {\n    const error = value as { message?: unknown; retryable?: unknown };\n    text(error.message, `${field} error`);\n    // An uncertain native save can have committed. Retry permission is explicit,\n    // just like action-session; an error alone never authorizes another write.\n    if (typeof error.retryable !== \"boolean\") throw new TypeError(`Document resource ${field} retryable must be boolean`);\n  }\n}\n\nexport function resolveDocumentResource(descriptor: DocumentResourceDescriptor) {\n  text(descriptor.id, \"id\");\n  text(descriptor.name, \"name\");\n  for (const key of [\"formatLabel\", \"sizeLabel\", \"description\"] as const) {\n    if (descriptor[key] !== undefined) text(descriptor[key], key);\n  }\n  for (const key of [\"disabled\", \"saveDisabled\"] as const) {\n    if (descriptor[key] !== undefined && typeof descriptor[key] !== \"boolean\") {\n      throw new TypeError(`Document resource ${key} must be boolean`);\n    }\n  }\n  state(descriptor.preview, [\"none\", \"loading\", \"ready\", \"error\"], \"preview\");\n  state(descriptor.save, [\"idle\", \"pending\", \"started\", \"saved\", \"cancelled\", \"error\"], \"save\");\n  const disabled = descriptor.disabled ?? false;\n  // Utilverse requires viewing the output before accepting export; whole-card disabling\n  // would prevent that review. The host owns the requirement, not a fake pending state.\n  const saveDisabled = disabled || descriptor.saveDisabled === true;\n  const preview = Object.freeze({ ...descriptor.preview });\n  const save = Object.freeze({ ...descriptor.save });\n  return Object.freeze({\n    id: descriptor.id,\n    name: descriptor.name,\n    // Preserve product formatting and order; neither URL extensions nor inferred\n    // byte counts are reliable metadata for remote/signed/local resources.\n    metadata: Object.freeze([descriptor.formatLabel, descriptor.sizeLabel].filter((value): value is string => value !== undefined)),\n    description: descriptor.description,\n    disabled,\n    saveDisabled,\n    preview,\n    save,\n    canPreview: !disabled && preview.status === \"ready\",\n    canRetryPreview: !disabled && preview.status === \"error\" && preview.retryable,\n    // Keep failures on the explicit retry path. A second ordinary save must not\n    // bypass a host's retryable=false policy after an ambiguous OS response.\n    canSave: !saveDisabled && save.status !== \"pending\" && save.status !== \"error\",\n    canRetrySave: !saveDisabled && save.status === \"error\" && save.retryable,\n    // Browser anchor activation proves initiation, not file-system completion.\n    saved: save.status === \"saved\",\n  });\n}\n"]}

package/dist/effect-surface.d.ts

@@ -1,5 +1,5 @@
 import { type ColorReference } from "./color-references.js";
-export type EffectLayer = "mesh" | "glow" | "grain";
+export type EffectLayer = "mesh" | "glow" | "grain" | "noise";
 export type EffectSurfaceDescriptor = Readonly<{
     layers?: readonly EffectLayer[];
     seed?: string;
@@ -15,6 +15,11 @@ export declare function resolveEffectSurface(descriptor?: EffectSurfaceDescripto
     period: number;
     active: boolean;
     colors: readonly [ColorReference, ColorReference, ColorReference];
+    noise: {
+        uri: string;
+        size: number;
+        offset: number;
+    } | undefined;
     points: {
         x: number;
         y: number;

package/dist/effect-surface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"effect-surface.d.ts","sourceRoot":"","sources":["../src/effect-surface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACxE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AACpD,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAAC;IAC7C,MAAM,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,SAAS,CAAC,cAAc,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC;CACpE,CAAC,CAAC;AACH,wBAAgB,oBAAoB,CAAC,UAAU,GAAE,uBAA4B;;;;;;;;;;;;;;;;EAkB5E"}
+{"version":3,"file":"effect-surface.d.ts","sourceRoot":"","sources":["../src/effect-surface.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACxE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAC9D,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAAC;IAC7C,MAAM,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oFAAoF;IACpF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,SAAS,CAAC,cAAc,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC;CACpE,CAAC,CAAC;AACH,wBAAgB,oBAAoB,CAAC,UAAU,GAAE,uBAA4B;;;;;;;;;;;;;;;;;;;;;EAoB5E"}

package/dist/effect-surface.js

@@ -1,8 +1,9 @@
+import { effectNoiseTile } from "./internal/effect-noise.js";
 import { themeColor } from "./color-references.js";
 export function resolveEffectSurface(descriptor = {}) {
     const layers = descriptor.layers ?? ["mesh"];
-    if (!layers.length || layers.length > 3 || new Set(layers).size !== layers.length || layers.some(layer => !["mesh", "glow", "grain"].includes(layer)))
-        throw new TypeError("Choose one to three unique effect layers");
+    if (!layers.length || layers.length > 4 || new Set(layers).size !== layers.length || layers.some(layer => !["mesh", "glow", "grain", "noise"].includes(layer)))
+        throw new TypeError("Choose one to four unique effect layers");
     const intensity = descriptor.intensity ?? 0.22;
     if (!Number.isFinite(intensity) || intensity < 0 || intensity > 1)
         throw new RangeError("Effect intensity must be between 0 and 1");
@@ -21,6 +22,8 @@ export function resolveEffectSurface(descriptor = {}) {
     const points = Array.from({ length: 32 }, () => ({ x: Math.round(random() * 100), y: Math.round(random() * 100), radius: 0.2 + random() * 0.5 }));
     return { layers, intensity, period, active: descriptor.active ?? false,
         colors: descriptor.colors ?? [themeColor("primary"), themeColor("contentBrand"), themeColor("surfaceAccent")],
+        // Fixed periodic raster is shared across hosts; seed shifts its phase, not its pixels.
+        noise: layers.includes("noise") ? { uri: effectNoiseTile, size: 64, offset: points[0].x / 4 } : undefined,
         points, anchors: points.slice(0, 3) };
 }
 //# sourceMappingURL=effect-surface.js.map

package/dist/effect-surface.js.map

@@ -1 +1 @@
-{"version":3,"file":"effect-surface.js","sourceRoot":"","sources":["../src/effect-surface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAuB,MAAM,uBAAuB,CAAC;AAWxE,MAAM,UAAU,oBAAoB,CAAC,aAAsC,EAAE;IAC3E,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,0CAA0C,CAAC,CAAC;IACvN,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS,IAAI,IAAI,CAAC;IAC/C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,GAAG,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,0CAA0C,CAAC,CAAC;IACpI,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,IAAI,EAAE,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,GAAG;QAAE,MAAM,IAAI,UAAU,CAAC,iDAAiD,CAAC,CAAC;IACpI,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,IAAI,KAAK,CAAC;IACtC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,+BAA+B,CAAC,CAAC;IACxG,6EAA6E;IAC7E,0EAA0E;IAC1E,IAAI,KAAK,GAAG,UAAU,CAAC;IACvB,KAAK,MAAM,SAAS,IAAI,IAAI;QAAE,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC,CAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnG,MAAM,MAAM,GAAG,GAAG,EAAE,GAAG,KAAK,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAC5G,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,GAAG,MAAM,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC;IAClJ,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,IAAI,KAAK;QACpE,MAAM,EAAE,UAAU,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,UAAU,CAAC,cAAc,CAAC,EAAE,UAAU,CAAC,eAAe,CAAC,CAAU;QACtH,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AAC1C,CAAC","sourcesContent":["import { themeColor, type ColorReference } from \"./color-references.js\";\nexport type EffectLayer = \"mesh\" | \"glow\" | \"grain\";\nexport type EffectSurfaceDescriptor = Readonly<{\n  layers?: readonly EffectLayer[];\n  seed?: string;\n  intensity?: number;\n  /** One slow cycle in seconds; decorative motion is off unless explicitly active. */\n  period?: number;\n  active?: boolean;\n  colors?: readonly [ColorReference, ColorReference, ColorReference];\n}>;\nexport function resolveEffectSurface(descriptor: EffectSurfaceDescriptor = {}) {\n  const layers = descriptor.layers ?? [\"mesh\"];\n  if (!layers.length || layers.length > 3 || new Set(layers).size !== layers.length || layers.some(layer => ![\"mesh\", \"glow\", \"grain\"].includes(layer))) throw new TypeError(\"Choose one to three unique effect layers\");\n  const intensity = descriptor.intensity ?? 0.22;\n  if (!Number.isFinite(intensity) || intensity < 0 || intensity > 1) throw new RangeError(\"Effect intensity must be between 0 and 1\");\n  const period = descriptor.period ?? 12;\n  if (!Number.isFinite(period) || period < 2 || period > 120) throw new RangeError(\"Effect period must be between 2 and 120 seconds\");\n  const seed = descriptor.seed ?? \"hjm\";\n  if (typeof seed !== \"string\" || seed.length === 0) throw new TypeError(\"Effect seed must not be empty\");\n  // Small deterministic spatial sampling keeps SSR/native geometry consistent;\n  // it is decorative randomness, not a security or account identifier hash.\n  let state = 2166136261;\n  for (const character of seed) state = Math.imul(state ^ character.codePointAt(0)!, 16777619) >>> 0;\n  const random = () => { state = (Math.imul(state, 1664525) + 1013904223) >>> 0; return state / 4294967296; };\n  const points = Array.from({ length: 32 }, () => ({ x: Math.round(random() * 100), y: Math.round(random() * 100), radius: 0.2 + random() * 0.5 }));\n  return { layers, intensity, period, active: descriptor.active ?? false,\n    colors: descriptor.colors ?? [themeColor(\"primary\"), themeColor(\"contentBrand\"), themeColor(\"surfaceAccent\")] as const,\n    points, anchors: points.slice(0, 3) };\n}\n"]}
+{"version":3,"file":"effect-surface.js","sourceRoot":"","sources":["../src/effect-surface.ts"],"names":[],"mappings":"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","sourcesContent":["import { effectNoiseTile } from \"./internal/effect-noise.js\";\nimport { themeColor, type ColorReference } from \"./color-references.js\";\nexport type EffectLayer = \"mesh\" | \"glow\" | \"grain\" | \"noise\";\nexport type EffectSurfaceDescriptor = Readonly<{\n  layers?: readonly EffectLayer[];\n  seed?: string;\n  intensity?: number;\n  /** One slow cycle in seconds; decorative motion is off unless explicitly active. */\n  period?: number;\n  active?: boolean;\n  colors?: readonly [ColorReference, ColorReference, ColorReference];\n}>;\nexport function resolveEffectSurface(descriptor: EffectSurfaceDescriptor = {}) {\n  const layers = descriptor.layers ?? [\"mesh\"];\n  if (!layers.length || layers.length > 4 || new Set(layers).size !== layers.length || layers.some(layer => ![\"mesh\", \"glow\", \"grain\", \"noise\"].includes(layer))) throw new TypeError(\"Choose one to four unique effect layers\");\n  const intensity = descriptor.intensity ?? 0.22;\n  if (!Number.isFinite(intensity) || intensity < 0 || intensity > 1) throw new RangeError(\"Effect intensity must be between 0 and 1\");\n  const period = descriptor.period ?? 12;\n  if (!Number.isFinite(period) || period < 2 || period > 120) throw new RangeError(\"Effect period must be between 2 and 120 seconds\");\n  const seed = descriptor.seed ?? \"hjm\";\n  if (typeof seed !== \"string\" || seed.length === 0) throw new TypeError(\"Effect seed must not be empty\");\n  // Small deterministic spatial sampling keeps SSR/native geometry consistent;\n  // it is decorative randomness, not a security or account identifier hash.\n  let state = 2166136261;\n  for (const character of seed) state = Math.imul(state ^ character.codePointAt(0)!, 16777619) >>> 0;\n  const random = () => { state = (Math.imul(state, 1664525) + 1013904223) >>> 0; return state / 4294967296; };\n  const points = Array.from({ length: 32 }, () => ({ x: Math.round(random() * 100), y: Math.round(random() * 100), radius: 0.2 + random() * 0.5 }));\n  return { layers, intensity, period, active: descriptor.active ?? false,\n    colors: descriptor.colors ?? [themeColor(\"primary\"), themeColor(\"contentBrand\"), themeColor(\"surfaceAccent\")] as const,\n    // Fixed periodic raster is shared across hosts; seed shifts its phase, not its pixels.\n    noise: layers.includes(\"noise\") ? { uri: effectNoiseTile, size: 64, offset: points[0]!.x / 4 } : undefined,\n    points, anchors: points.slice(0, 3) };\n}\n"]}

package/dist/field-group.d.ts

@@ -0,0 +1,47 @@
+/** Related-input grouping contract. Values and submit/validation timing remain product-owned. */
+export type FieldGroupMember = Readonly<{
+    id: string;
+    label: string;
+    description?: string;
+    error?: string;
+    disabled?: boolean;
+}>;
+export type FieldGroupDescriptor = Readonly<{
+    label: string;
+    description?: string;
+    disabled?: boolean;
+    /** An empty fieldIds list is a group-only error, not a reason to mark every field invalid. */
+    error?: Readonly<{
+        message: string;
+        fieldIds: readonly string[];
+    }>;
+    fields: readonly FieldGroupMember[];
+}>;
+export type ResolvedFieldGroupMember = Readonly<{
+    id: string;
+    label: string;
+    groupLabel: string;
+    disabled: boolean;
+    invalid: boolean;
+    /** Renderers associate these messages without replacing a field's own help or error. */
+    support: readonly Readonly<{
+        scope: "group" | "field";
+        kind: "description" | "error";
+        text: string;
+    }>[];
+}>;
+/** Late native events and retained callbacks must use the current committed group policy. */
+export declare function createFieldGroupEditSession(fields: readonly ResolvedFieldGroupMember[]): {
+    update(next: readonly ResolvedFieldGroupMember[]): void;
+    /** Effect cleanup blocks events without treating Strict Mode replay as field removal. */
+    suspend(): void;
+    guard<Args extends unknown[]>(id: string, callback: (...args: Args) => void): (...args: Args) => void;
+};
+export declare function resolveFieldGroup(descriptor: FieldGroupDescriptor): Readonly<{
+    label: string;
+    description: string | undefined;
+    error: string | undefined;
+    disabled: boolean;
+    fields: readonly ResolvedFieldGroupMember[];
+}>;
+//# sourceMappingURL=field-group.d.ts.map

package/dist/field-group.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-group.d.ts","sourceRoot":"","sources":["../src/field-group.ts"],"names":[],"mappings":"AAAA,iGAAiG;AACjG,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,8FAA8F;IAC9F,KAAK,CAAC,EAAE,QAAQ,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACnE,MAAM,EAAE,SAAS,gBAAgB,EAAE,CAAC;CACrC,CAAC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,wFAAwF;IACxF,OAAO,EAAE,SAAS,QAAQ,CAAC;QAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;QAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;CACzG,CAAC,CAAC;AAMH,6FAA6F;AAC7F,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,wBAAwB,EAAE;iBAItE,SAAS,wBAAwB,EAAE;IAQhD,yFAAyF;;UAEnF,IAAI,SAAS,OAAO,EAAE,MAAM,MAAM,YAAY,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,IAAI,GAAG,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,IAAI;EAOxG;AAUD,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,oBAAoB,GAAG,QAAQ,CAAC;IAC5E,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,SAAS,wBAAwB,EAAE,CAAC;CAC7C,CAAC,CA2CD"}

package/dist/field-group.js

@@ -0,0 +1,92 @@
+function requireText(value, name) {
+    if (typeof value !== "string" || !value.trim())
+        throw new TypeError(`Field group ${name} must be nonempty text`);
+}
+/** Late native events and retained callbacks must use the current committed group policy. */
+export function createFieldGroupEditSession(fields) {
+    let enabled = new Set(fields.filter(field => !field.disabled).map(field => field.id));
+    const members = new Map(fields.map(field => [field.id, {}]));
+    return {
+        update(next) {
+            const current = new Set(next.map(field => field.id));
+            // A reused id is a new mounted field after removal. Checking only enabled ids
+            // would revive queued events from the old field and overwrite the new draft.
+            for (const id of members.keys())
+                if (!current.has(id))
+                    members.delete(id);
+            for (const id of current)
+                if (!members.has(id))
+                    members.set(id, {});
+            enabled = new Set(next.filter(field => !field.disabled).map(field => field.id));
+        },
+        /** Effect cleanup blocks events without treating Strict Mode replay as field removal. */
+        suspend() { enabled.clear(); },
+        guard(id, callback) {
+            // A new host binds during render, before its committed policy enables it.
+            if (!members.has(id))
+                members.set(id, {});
+            const member = members.get(id);
+            return (...args) => { if (members.get(id) === member && enabled.has(id))
+                callback(...args); };
+        },
+    };
+}
+function optionalText(value, name) {
+    if (value !== undefined)
+        requireText(value, name);
+}
+function optionalBoolean(value) {
+    if (value !== undefined && typeof value !== "boolean")
+        throw new TypeError("Field group disabled must be boolean");
+}
+export function resolveFieldGroup(descriptor) {
+    requireText(descriptor.label, "label");
+    optionalText(descriptor.description, "description");
+    optionalBoolean(descriptor.disabled);
+    if (!Array.isArray(descriptor.fields))
+        throw new TypeError("Field group fields must be an array");
+    const ids = new Set();
+    for (const field of descriptor.fields) {
+        requireText(field.id, "field id");
+        requireText(field.label, "field label");
+        optionalText(field.description, "field description");
+        optionalText(field.error, "field error");
+        optionalBoolean(field.disabled);
+        if (ids.has(field.id))
+            throw new TypeError("Field group field ids must be unique");
+        ids.add(field.id);
+    }
+    if (descriptor.error !== undefined) {
+        requireText(descriptor.error.message, "error");
+        const affected = descriptor.error.fieldIds;
+        // A typo or removed field must not silently lose its validation feedback.
+        // Products update the visible error with their dynamic field list atomically.
+        if (!Array.isArray(affected) || new Set(affected).size !== affected.length || affected.some(id => !ids.has(id))) {
+            throw new TypeError("Field group error must reference distinct current field ids");
+        }
+    }
+    const disabled = descriptor.disabled ?? false;
+    return Object.freeze({
+        label: descriptor.label,
+        description: descriptor.description,
+        error: descriptor.error?.message,
+        disabled,
+        fields: Object.freeze(descriptor.fields.map(field => {
+            const groupError = descriptor.error?.fieldIds.includes(field.id) ? descriptor.error.message : undefined;
+            const support = [];
+            if (descriptor.description !== undefined)
+                support.push({ scope: "group", kind: "description", text: descriptor.description });
+            if (field.description !== undefined)
+                support.push({ scope: "field", kind: "description", text: field.description });
+            if (field.error !== undefined)
+                support.push({ scope: "field", kind: "error", text: field.error });
+            if (groupError !== undefined)
+                support.push({ scope: "group", kind: "error", text: groupError });
+            return Object.freeze({ id: field.id, label: field.label, groupLabel: descriptor.label,
+                // Group unlock restores independently disabled members; it never enables them.
+                disabled: disabled || (field.disabled ?? false), invalid: field.error !== undefined || groupError !== undefined,
+                support: Object.freeze(support.map(message => Object.freeze(message))) });
+        })),
+    });
+}
+//# sourceMappingURL=field-group.js.map

package/dist/field-group.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-group.js","sourceRoot":"","sources":["../src/field-group.ts"],"names":[],"mappings":"AA4BA,SAAS,WAAW,CAAC,KAAc,EAAE,IAAY;IAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;QAAE,MAAM,IAAI,SAAS,CAAC,eAAe,IAAI,wBAAwB,CAAC,CAAC;AACnH,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,2BAA2B,CAAC,MAA2C;IACrF,IAAI,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IACtF,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAC7D,OAAO;QACL,MAAM,CAAC,IAAyC;YAC9C,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;YACrD,8EAA8E;YAC9E,6EAA6E;YAC7E,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,IAAI,EAAE;gBAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;oBAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC1E,KAAK,MAAM,EAAE,IAAI,OAAO;gBAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;oBAAE,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YACpE,OAAO,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QAClF,CAAC;QACD,yFAAyF;QACzF,OAAO,KAAK,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC9B,KAAK,CAAyB,EAAU,EAAE,QAAiC;YACzE,0EAA0E;YAC1E,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC/B,OAAO,CAAC,GAAG,IAAI,EAAE,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAChG,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,KAAc,EAAE,IAAY;IAChD,IAAI,KAAK,KAAK,SAAS;QAAE,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,MAAM,IAAI,SAAS,CAAC,sCAAsC,CAAC,CAAC;AACrH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,UAAgC;IAOhE,WAAW,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACvC,YAAY,CAAC,UAAU,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IACpD,eAAe,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,qCAAqC,CAAC,CAAC;IAClG,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,KAAK,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;QACtC,WAAW,CAAC,KAAK,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QAClC,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QACxC,YAAY,CAAC,KAAK,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC;QACrD,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QACzC,eAAe,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAChC,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,SAAS,CAAC,sCAAsC,CAAC,CAAC;QACnF,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACpB,CAAC;IACD,IAAI,UAAU,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACnC,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/C,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC;QAC3C,0EAA0E;QAC1E,8EAA8E;QAC9E,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAChH,MAAM,IAAI,SAAS,CAAC,6DAA6D,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IACD,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,IAAI,KAAK,CAAC;IAC9C,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,OAAO;QAChC,QAAQ;QACR,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;YAClD,MAAM,UAAU,GAAG,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;YACxG,MAAM,OAAO,GAAkD,EAAE,CAAC;YAClE,IAAI,UAAU,CAAC,WAAW,KAAK,SAAS;gBAAE,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;YAC9H,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS;gBAAE,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;YACpH,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;gBAAE,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;YAClG,IAAI,UAAU,KAAK,SAAS;gBAAE,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;YAChG,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,CAAC,KAAK;gBACnF,+EAA+E;gBAC/E,QAAQ,EAAE,QAAQ,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,UAAU,KAAK,SAAS;gBAC/G,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC9E,CAAC,CAAC,CAAC;KACJ,CAAC,CAAC;AACL,CAAC","sourcesContent":["/** Related-input grouping contract. Values and submit/validation timing remain product-owned. */\nexport type FieldGroupMember = Readonly<{\n  id: string;\n  label: string;\n  description?: string;\n  error?: string;\n  disabled?: boolean;\n}>;\n\nexport type FieldGroupDescriptor = Readonly<{\n  label: string;\n  description?: string;\n  disabled?: boolean;\n  /** An empty fieldIds list is a group-only error, not a reason to mark every field invalid. */\n  error?: Readonly<{ message: string; fieldIds: readonly string[] }>;\n  fields: readonly FieldGroupMember[];\n}>;\n\nexport type ResolvedFieldGroupMember = Readonly<{\n  id: string;\n  label: string;\n  groupLabel: string;\n  disabled: boolean;\n  invalid: boolean;\n  /** Renderers associate these messages without replacing a field's own help or error. */\n  support: readonly Readonly<{ scope: \"group\" | \"field\"; kind: \"description\" | \"error\"; text: string }>[];\n}>;\n\nfunction requireText(value: unknown, name: string): asserts value is string {\n  if (typeof value !== \"string\" || !value.trim()) throw new TypeError(`Field group ${name} must be nonempty text`);\n}\n\n/** Late native events and retained callbacks must use the current committed group policy. */\nexport function createFieldGroupEditSession(fields: readonly ResolvedFieldGroupMember[]) {\n  let enabled = new Set(fields.filter(field => !field.disabled).map(field => field.id));\n  const members = new Map(fields.map(field => [field.id, {}]));\n  return {\n    update(next: readonly ResolvedFieldGroupMember[]) {\n      const current = new Set(next.map(field => field.id));\n      // A reused id is a new mounted field after removal. Checking only enabled ids\n      // would revive queued events from the old field and overwrite the new draft.\n      for (const id of members.keys()) if (!current.has(id)) members.delete(id);\n      for (const id of current) if (!members.has(id)) members.set(id, {});\n      enabled = new Set(next.filter(field => !field.disabled).map(field => field.id));\n    },\n    /** Effect cleanup blocks events without treating Strict Mode replay as field removal. */\n    suspend() { enabled.clear(); },\n    guard<Args extends unknown[]>(id: string, callback: (...args: Args) => void): (...args: Args) => void {\n      // A new host binds during render, before its committed policy enables it.\n      if (!members.has(id)) members.set(id, {});\n      const member = members.get(id);\n      return (...args) => { if (members.get(id) === member && enabled.has(id)) callback(...args); };\n    },\n  };\n}\n\nfunction optionalText(value: unknown, name: string): void {\n  if (value !== undefined) requireText(value, name);\n}\n\nfunction optionalBoolean(value: unknown): void {\n  if (value !== undefined && typeof value !== \"boolean\") throw new TypeError(\"Field group disabled must be boolean\");\n}\n\nexport function resolveFieldGroup(descriptor: FieldGroupDescriptor): Readonly<{\n  label: string;\n  description: string | undefined;\n  error: string | undefined;\n  disabled: boolean;\n  fields: readonly ResolvedFieldGroupMember[];\n}> {\n  requireText(descriptor.label, \"label\");\n  optionalText(descriptor.description, \"description\");\n  optionalBoolean(descriptor.disabled);\n  if (!Array.isArray(descriptor.fields)) throw new TypeError(\"Field group fields must be an array\");\n  const ids = new Set<string>();\n  for (const field of descriptor.fields) {\n    requireText(field.id, \"field id\");\n    requireText(field.label, \"field label\");\n    optionalText(field.description, \"field description\");\n    optionalText(field.error, \"field error\");\n    optionalBoolean(field.disabled);\n    if (ids.has(field.id)) throw new TypeError(\"Field group field ids must be unique\");\n    ids.add(field.id);\n  }\n  if (descriptor.error !== undefined) {\n    requireText(descriptor.error.message, \"error\");\n    const affected = descriptor.error.fieldIds;\n    // A typo or removed field must not silently lose its validation feedback.\n    // Products update the visible error with their dynamic field list atomically.\n    if (!Array.isArray(affected) || new Set(affected).size !== affected.length || affected.some(id => !ids.has(id))) {\n      throw new TypeError(\"Field group error must reference distinct current field ids\");\n    }\n  }\n  const disabled = descriptor.disabled ?? false;\n  return Object.freeze({\n    label: descriptor.label,\n    description: descriptor.description,\n    error: descriptor.error?.message,\n    disabled,\n    fields: Object.freeze(descriptor.fields.map(field => {\n      const groupError = descriptor.error?.fieldIds.includes(field.id) ? descriptor.error.message : undefined;\n      const support: ResolvedFieldGroupMember[\"support\"][number][] = [];\n      if (descriptor.description !== undefined) support.push({ scope: \"group\", kind: \"description\", text: descriptor.description });\n      if (field.description !== undefined) support.push({ scope: \"field\", kind: \"description\", text: field.description });\n      if (field.error !== undefined) support.push({ scope: \"field\", kind: \"error\", text: field.error });\n      if (groupError !== undefined) support.push({ scope: \"group\", kind: \"error\", text: groupError });\n      return Object.freeze({ id: field.id, label: field.label, groupLabel: descriptor.label,\n        // Group unlock restores independently disabled members; it never enables them.\n        disabled: disabled || (field.disabled ?? false), invalid: field.error !== undefined || groupError !== undefined,\n        support: Object.freeze(support.map(message => Object.freeze(message))) });\n    })),\n  });\n}\n"]}

package/dist/gooey-navigation.d.ts

@@ -1,8 +1,26 @@
-export type TabsAppearance = "standard" | "gooey";
+export type TabsAppearance = "standard" | "slide" | "gooey";
 export type GooeyIndicatorRect = Readonly<{
     x: number;
     width: number;
 }>;
+/** A product's explicit appearance wins; vertical tabs keep the canonical line.
+ * Plain profile sliding is not an implicit request for elastic gooey stretching. */
+export declare function resolveTabsAppearance(appearance: TabsAppearance | undefined, selectionMotion?: "none" | "slide", orientation?: "horizontal" | "vertical"): TabsAppearance;
+/** Both renderers interpolate measured bounds without changing selection or panels. */
+export declare function resolveTabIndicator(from: GooeyIndicatorRect, to: GooeyIndicatorRect, appearance: "slide" | "gooey"): {
+    readonly duration: 320;
+    readonly input: readonly [0, 0.45, 1];
+    readonly x: readonly [number, number, number];
+    readonly width: readonly [number, number, number];
+} | {
+    readonly duration: 200;
+    readonly input: readonly [0, 1];
+    readonly x: readonly [number, number];
+    readonly width: readonly [number, number];
+};
+/** Capture the current JS-driver frame before cancellation so rapid input starts
+ * where the indicator is visible, rather than jumping to the abandoned target. */
+export declare function sampleTabIndicator(recipe: ReturnType<typeof resolveTabIndicator>, progress: number): GooeyIndicatorRect;
 /** Stretch only the selected indicator; tab hit targets and text never move. */
 export declare function resolveGooeyIndicator(from: GooeyIndicatorRect, to: GooeyIndicatorRect): {
     readonly duration: 320;

package/dist/gooey-navigation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gooey-navigation.d.ts","sourceRoot":"","sources":["../src/gooey-navigation.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,OAAO,CAAC;AAClD,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AACxE,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,kBAAkB,EAAE,EAAE,EAAE,kBAAkB;;;;;EAMrF"}
+{"version":3,"file":"gooey-navigation.d.ts","sourceRoot":"","sources":["../src/gooey-navigation.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,cAAc,GAAG,UAAU,GAAG,OAAO,GAAG,OAAO,CAAC;AAC5D,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAExE;oFACoF;AACpF,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,cAAc,GAAG,SAAS,EACtC,eAAe,GAAE,MAAM,GAAG,OAAgB,EAC1C,WAAW,GAAE,YAAY,GAAG,UAAyB,GACpD,cAAc,CAGhB;AAED,uFAAuF;AACvF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,kBAAkB,EAAE,EAAE,EAAE,kBAAkB,EAAE,UAAU,EAAE,OAAO,GAAG,OAAO;;;;;;;;;;EAOlH;AAED;kFACkF;AAClF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAUvH;AAKD,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,kBAAkB,EAAE,EAAE,EAAE,kBAAkB;;;;;EAMrF"}