@hjmds/design-contracts 1.6.0 → 1.8.0

package/dist/internal/thinking-orb/web.js

@@ -0,0 +1,92 @@
+// Indexed reads are bounded by the populated array length or modulo; assertions preserve upstream geometry.
+// Adapted from Thinking Orbs de85557 (MIT); see THIRD_PARTY_NOTICES.md.
+// Web: a constellation wires itself — the "connecting" state. Nodes drift
+// on the sphere under slow value noise; any pair closer than `thr` grows an
+// edge, and bright packets run along randomly re-picked node pairs.
+import { fibDir, finalizeFrame, frac, hashD, lerp, makeProj, radiusScale, vnoise } from './core.js';
+export const frameWeb = (size, t, o) => {
+    const cx = size / 2;
+    const cy = size / 2;
+    const R = (size / 2) * 0.8 * (o.spread ?? 1);
+    // note the projector carries the radius as its scale, so node vectors stay
+    // unit-length and distances below are in unit-sphere space
+    const pt = makeProj(t * 0.12, 0.32, cx, cy, R);
+    const rs = radiusScale(size, o.rsPow ?? 0.6);
+    const nodeN = o.nodeN ?? 30;
+    const thr = o.thr ?? 0.72;
+    const nodeR = o.nodeR ?? 1.4;
+    const nodeRDepth = o.nodeRDepth ?? 1.8;
+    // nodes: fib lattice + slow noise wander, renormalised to the surface
+    const nodes = [];
+    for (let i = 0; i < nodeN; i++) {
+        const d = fibDir(i, nodeN);
+        const x = d[0] + 0.3 * (vnoise(i * 0.31 + 9, t * 0.24) - 0.5) * 2;
+        const y = d[1] + 0.3 * (vnoise(i * 0.53 + 27, t * 0.21) - 0.5) * 2;
+        const z = d[2] + 0.3 * (vnoise(i * 0.77 + 55, t * 0.27) - 0.5) * 2;
+        const l = Math.sqrt(x * x + y * y + z * z);
+        nodes.push([x / l, y / l, z / l]);
+    }
+    const lines = [];
+    const dots = [];
+    // edges between close neighbours, alpha by proximity + depth
+    for (let i = 0; i < nodeN; i++) {
+        for (let j = i + 1; j < nodeN; j++) {
+            const dx = nodes[i][0] - nodes[j][0];
+            const dy = nodes[i][1] - nodes[j][1];
+            const dz = nodes[i][2] - nodes[j][2];
+            const dist = Math.sqrt(dx * dx + dy * dy + dz * dz);
+            if (dist >= thr)
+                continue;
+            const [x1, y1, z1] = pt(nodes[i][0], nodes[i][1], nodes[i][2]);
+            const [x2, y2, z2] = pt(nodes[j][0], nodes[j][1], nodes[j][2]);
+            const depth = ((z1 + z2) / 2 + 1) / 2;
+            lines.push({
+                x1,
+                y1,
+                x2,
+                y2,
+                white: 0.42,
+                a: (1 - dist / thr) * (0.3 + 0.55 * depth),
+                w: Math.max(0.6, (o.lineW ?? 0.8) * rs)
+            });
+        }
+    }
+    for (let i = 0; i < nodeN; i++) {
+        const [px, py, z] = pt(nodes[i][0], nodes[i][1], nodes[i][2]);
+        const depth = (z + 1) / 2;
+        const pulse = 1 + 0.25 * Math.sin(t * 1.4 + i * 2.7);
+        dots.push({
+            x: px,
+            y: py,
+            z,
+            r: (nodeR + nodeRDepth * depth) * pulse * rs,
+            white: 0.55 - 0.45 * depth
+        });
+    }
+    // signals: bright packets running between paired nodes
+    const signals = o.signals ?? 5;
+    for (let s = 0; s < signals; s++) {
+        const seg = Math.floor(t * 0.55 + s * 7.31);
+        const a = Math.floor(hashD(seg, s * 3.1 + 1.7) * nodeN);
+        const b = Math.floor(hashD(seg, s * 5.7 + 4.2) * nodeN);
+        if (a === b)
+            continue;
+        const f = frac(t * 0.55 + s * 7.31);
+        const x = lerp(nodes[a][0], nodes[b][0], f);
+        const y = lerp(nodes[a][1], nodes[b][1], f);
+        const z = lerp(nodes[a][2], nodes[b][2], f);
+        const l = Math.max(1e-6, Math.sqrt(x * x + y * y + z * z));
+        const [px, py, zr] = pt(x / l, y / l, z / l);
+        const depth = (zr + 1) / 2;
+        dots.push({
+            x: px,
+            y: py,
+            z: zr,
+            r: (nodeR * 1.5 + nodeRDepth * depth) * rs,
+            white: 0.05,
+            a: 0.5 + 0.5 * depth
+        });
+    }
+    return finalizeFrame(dots, lines, o.rMin);
+};
+//# sourceMappingURL=web.js.map

package/dist/internal/thinking-orb/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../../src/internal/thinking-orb/web.ts"],"names":[],"mappings":"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","sourcesContent":["// Indexed reads are bounded by the populated array length or modulo; assertions preserve upstream geometry.\n// Adapted from Thinking Orbs de85557 (MIT); see THIRD_PARTY_NOTICES.md.\n// Web: a constellation wires itself — the \"connecting\" state. Nodes drift\n// on the sphere under slow value noise; any pair closer than `thr` grows an\n// edge, and bright packets run along randomly re-picked node pairs.\n\nimport type { Dot, Line, ModeFrame } from './types.js';\nimport { fibDir, finalizeFrame, frac, hashD, lerp, makeProj, radiusScale, vnoise } from './core.js';\n\nexport const frameWeb: ModeFrame = (size, t, o) => {\n  const cx = size / 2;\n  const cy = size / 2;\n  const R = (size / 2) * 0.8 * (o.spread ?? 1);\n  // note the projector carries the radius as its scale, so node vectors stay\n  // unit-length and distances below are in unit-sphere space\n  const pt = makeProj(t * 0.12, 0.32, cx, cy, R);\n  const rs = radiusScale(size, o.rsPow ?? 0.6);\n\n  const nodeN = o.nodeN ?? 30;\n  const thr = o.thr ?? 0.72;\n  const nodeR = o.nodeR ?? 1.4;\n  const nodeRDepth = o.nodeRDepth ?? 1.8;\n\n  // nodes: fib lattice + slow noise wander, renormalised to the surface\n  const nodes: Array<[number, number, number]> = [];\n  for (let i = 0; i < nodeN; i++) {\n    const d = fibDir(i, nodeN);\n    const x = d[0] + 0.3 * (vnoise(i * 0.31 + 9, t * 0.24) - 0.5) * 2;\n    const y = d[1] + 0.3 * (vnoise(i * 0.53 + 27, t * 0.21) - 0.5) * 2;\n    const z = d[2] + 0.3 * (vnoise(i * 0.77 + 55, t * 0.27) - 0.5) * 2;\n    const l = Math.sqrt(x * x + y * y + z * z);\n    nodes.push([x / l, y / l, z / l]);\n  }\n\n  const lines: Line[] = [];\n  const dots: Dot[] = [];\n\n  // edges between close neighbours, alpha by proximity + depth\n  for (let i = 0; i < nodeN; i++) {\n    for (let j = i + 1; j < nodeN; j++) {\n      const dx = nodes[i]![0] - nodes[j]![0];\n      const dy = nodes[i]![1] - nodes[j]![1];\n      const dz = nodes[i]![2] - nodes[j]![2];\n      const dist = Math.sqrt(dx * dx + dy * dy + dz * dz);\n      if (dist >= thr) continue;\n      const [x1, y1, z1] = pt(nodes[i]![0], nodes[i]![1], nodes[i]![2]);\n      const [x2, y2, z2] = pt(nodes[j]![0], nodes[j]![1], nodes[j]![2]);\n      const depth = ((z1 + z2) / 2 + 1) / 2;\n      lines.push({\n        x1,\n        y1,\n        x2,\n        y2,\n        white: 0.42,\n        a: (1 - dist / thr) * (0.3 + 0.55 * depth),\n        w: Math.max(0.6, (o.lineW ?? 0.8) * rs)\n      });\n    }\n  }\n\n  for (let i = 0; i < nodeN; i++) {\n    const [px, py, z] = pt(nodes[i]![0], nodes[i]![1], nodes[i]![2]);\n    const depth = (z + 1) / 2;\n    const pulse = 1 + 0.25 * Math.sin(t * 1.4 + i * 2.7);\n    dots.push({\n      x: px,\n      y: py,\n      z,\n      r: (nodeR + nodeRDepth * depth) * pulse * rs,\n      white: 0.55 - 0.45 * depth\n    });\n  }\n\n  // signals: bright packets running between paired nodes\n  const signals = o.signals ?? 5;\n  for (let s = 0; s < signals; s++) {\n    const seg = Math.floor(t * 0.55 + s * 7.31);\n    const a = Math.floor(hashD(seg, s * 3.1 + 1.7) * nodeN);\n    const b = Math.floor(hashD(seg, s * 5.7 + 4.2) * nodeN);\n    if (a === b) continue;\n    const f = frac(t * 0.55 + s * 7.31);\n    const x = lerp(nodes[a]![0], nodes[b]![0], f);\n    const y = lerp(nodes[a]![1], nodes[b]![1], f);\n    const z = lerp(nodes[a]![2], nodes[b]![2], f);\n    const l = Math.max(1e-6, Math.sqrt(x * x + y * y + z * z));\n    const [px, py, zr] = pt(x / l, y / l, z / l);\n    const depth = (zr + 1) / 2;\n    dots.push({\n      x: px,\n      y: py,\n      z: zr,\n      r: (nodeR * 1.5 + nodeRDepth * depth) * rs,\n      white: 0.05,\n      a: 0.5 + 0.5 * depth\n    });\n  }\n\n  return finalizeFrame(dots, lines, o.rMin);\n};\n"]}

package/dist/masonry.d.ts

@@ -0,0 +1,17 @@
+/** Height-driven packing preserves source order; DOM/native reading order never follows columns. */
+export declare function resolveMasonryLayout(heights: readonly number[], width: number, columns?: number, gap?: number): {
+    items: {
+        top: number;
+        left: number;
+        width: number;
+        height: number;
+    }[];
+    height: number;
+    itemWidth: number;
+};
+export declare const masonryRecipe: {
+    readonly layout: "shortest-column";
+    readonly readingOrder: "source";
+    readonly maxColumns: 12;
+};
+//# sourceMappingURL=masonry.d.ts.map

package/dist/masonry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"masonry.d.ts","sourceRoot":"","sources":["../src/masonry.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,SAAI,EAAE,GAAG,SAAK;;;;;;;;;EAYpG;AACD,eAAO,MAAM,aAAa;;;;CAAiF,CAAC"}

package/dist/masonry.js

@@ -0,0 +1,18 @@
+/** Height-driven packing preserves source order; DOM/native reading order never follows columns. */
+export function resolveMasonryLayout(heights, width, columns = 2, gap = 12) {
+    if (!Number.isFinite(width) || width <= 0 || !Number.isInteger(columns) || columns < 1 || columns > 12 || !Number.isFinite(gap) || gap < 0)
+        throw new TypeError("Invalid Masonry geometry");
+    const itemWidth = (width - gap * (columns - 1)) / columns;
+    if (itemWidth <= 0 || heights.some(height => !Number.isFinite(height) || height <= 0))
+        throw new TypeError("Masonry items need positive dimensions");
+    const ends = Array(columns).fill(0);
+    const items = heights.map(height => {
+        const column = ends.indexOf(Math.min(...ends));
+        const top = ends[column];
+        ends[column] = top + height + gap;
+        return { top, left: column * (itemWidth + gap), width: itemWidth, height };
+    });
+    return { items, height: heights.length ? Math.max(...ends) - gap : 0, itemWidth };
+}
+export const masonryRecipe = { layout: "shortest-column", readingOrder: "source", maxColumns: 12 };
+//# sourceMappingURL=masonry.js.map

package/dist/masonry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"masonry.js","sourceRoot":"","sources":["../src/masonry.ts"],"names":[],"mappings":"AAAA,oGAAoG;AACpG,MAAM,UAAU,oBAAoB,CAAC,OAA0B,EAAE,KAAa,EAAE,OAAO,GAAG,CAAC,EAAE,GAAG,GAAG,EAAE;IACnG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,IAAI,OAAO,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,0BAA0B,CAAC,CAAC;IAC5L,MAAM,SAAS,GAAG,CAAC,KAAK,GAAG,GAAG,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;IAC1D,IAAI,SAAS,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,SAAS,CAAC,wCAAwC,CAAC,CAAC;IACrJ,MAAM,IAAI,GAAG,KAAK,CAAS,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAE,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,GAAG,GAAG,GAAG,MAAM,GAAG,GAAG,CAAC;QAClC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,SAAS,GAAG,GAAG,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAC7E,CAAC,CAAC,CAAC;IACH,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;AACpF,CAAC;AACD,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,MAAM,EAAE,iBAAiB,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAW,CAAC","sourcesContent":["/** Height-driven packing preserves source order; DOM/native reading order never follows columns. */\nexport function resolveMasonryLayout(heights: readonly number[], width: number, columns = 2, gap = 12) {\n  if (!Number.isFinite(width) || width <= 0 || !Number.isInteger(columns) || columns < 1 || columns > 12 || !Number.isFinite(gap) || gap < 0) throw new TypeError(\"Invalid Masonry geometry\");\n  const itemWidth = (width - gap * (columns - 1)) / columns;\n  if (itemWidth <= 0 || heights.some(height => !Number.isFinite(height) || height <= 0)) throw new TypeError(\"Masonry items need positive dimensions\");\n  const ends = Array<number>(columns).fill(0);\n  const items = heights.map(height => {\n    const column = ends.indexOf(Math.min(...ends));\n    const top = ends[column]!;\n    ends[column] = top + height + gap;\n    return { top, left: column * (itemWidth + gap), width: itemWidth, height };\n  });\n  return { items, height: heights.length ? Math.max(...ends) - gap : 0, itemWidth };\n}\nexport const masonryRecipe = { layout: \"shortest-column\", readingOrder: \"source\", maxColumns: 12 } as const;\n"]}

package/dist/menubar.d.ts

@@ -40,7 +40,7 @@ export declare const menubarRecipe: {
         }>;
         readonly openBackground: Readonly<{
             source: "theme";
-            key: "primary";
+            key: "bg";
             alpha?: number;
         }>;
     };
@@ -67,7 +67,7 @@ export declare const menubarRecipe: {
         };
         readonly highlightedBackground: Readonly<{
             source: "theme";
-            key: "text";
+            key: "bg";
             alpha?: number;
         }>;
         readonly focus: {
@@ -81,7 +81,7 @@ export declare const menubarRecipe: {
         };
         readonly selectedBackground: Readonly<{
             source: "theme";
-            key: "primary";
+            key: "bg";
             alpha?: number;
         }>;
         readonly selectedIndicator: Readonly<{

package/dist/menubar.js

@@ -47,7 +47,7 @@ export const menubarRecipe = {
         paddingHorizontal: spacing.sm,
         radius: radius.sm,
         color: semanticColors.content.body,
-        openBackground: semanticColors.interaction.selected,
+        openBackground: semanticColors.canvas,
     },
     item: collectionItemContract,
     states: { focus: focusIndicatorContract },

package/dist/menubar.js.map

@@ -1 +1 @@
-{"version":3,"file":"menubar.js","sourceRoot":"","sources":["../src/menubar.ts"],"names":[],"mappings":"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","sourcesContent":["import type { BehaviorContract, MenuItemDescriptor } from \"./behaviors.js\";\nimport type { ColorReference } from \"./color-references.js\";\nimport { collectionItemContract, focusIndicatorContract } from \"./component-contracts.js\";\nimport { control, radius, spacing } from \"./foundations.js\";\nimport { semanticColors } from \"./semantic-colors.js\";\n\n/**\n * 데스크톱 앱의 가로 메뉴 막대 — 파일·편집·보기처럼 항상 같은 자리에 있는 메뉴들.\n *\n * `Menu` 여러 개를 나란히 놓는 것과 다르다. 막대는 **하나의 키보드 단위**다: 메뉴가\n * 열린 상태에서 좌우 방향키를 누르면 옆 메뉴로 **넘어가고**(닫았다 여는 것이 아니라),\n * 한 번에 하나만 열린다. 독립된 Menu 세 개로는 그 이동이 성립하지 않는다.\n *\n * `Tabs`와도 다르다. Tabs는 화면을 바꾸고 선택 상태가 남는다. Menubar는 행동을 실행하고\n * 아무것도 선택되지 않은 상태로 돌아간다.\n */\nexport type MenubarMenuDescriptor<\n  Key extends string = string,\n  MenuKey extends string = string,\n> = Readonly<{\n  id: MenuKey;\n  label: string;\n  items: readonly MenuItemDescriptor<Key>[];\n  disabled?: boolean;\n}>;\n\nexport type MenubarDescriptor<\n  Key extends string = string,\n  MenuKey extends string = string,\n> = Readonly<{\n  accessibilityLabel: string;\n  menus: readonly MenubarMenuDescriptor<Key, MenuKey>[];\n}>;\n\nfunction assertNonEmpty(value: string, field: string): void {\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    throw new TypeError(`Menubar ${field} must not be empty`);\n  }\n}\n\nexport function validateMenubarDescriptor<Key extends string, MenuKey extends string>(\n  descriptor: MenubarDescriptor<Key, MenuKey>,\n): void {\n  assertNonEmpty(descriptor.accessibilityLabel, \"accessibilityLabel\");\n  if (!Array.isArray(descriptor.menus) || descriptor.menus.length === 0) {\n    throw new RangeError(\"Menubar must contain at least one menu\");\n  }\n  const menuIds = new Set<MenuKey>();\n  for (const menu of descriptor.menus) {\n    assertNonEmpty(menu.id, \"menu id\");\n    assertNonEmpty(menu.label, `menu ${menu.id} label`);\n    if (menuIds.has(menu.id)) throw new TypeError(`Duplicate Menubar menu id: ${menu.id}`);\n    menuIds.add(menu.id);\n    if (!Array.isArray(menu.items) || menu.items.length === 0) {\n      throw new RangeError(`Menubar menu ${menu.id} must contain at least one item`);\n    }\n  }\n}\n\n/**\n * 좌우 이동은 **비활성 메뉴를 건너뛰고 순환**한다. 막대 끝에서 멈추면 사용자가 방향을\n * 바꿔 되돌아와야 하는데, 항목이 대여섯 개뿐인 가로 막대에서는 순환이 더 짧다.\n */\nexport function resolveMenubarNavigation<Key extends string, MenuKey extends string>(\n  descriptor: MenubarDescriptor<Key, MenuKey>,\n  currentId: MenuKey,\n  direction: \"next\" | \"previous\",\n): MenuKey {\n  validateMenubarDescriptor(descriptor);\n  const enabled = descriptor.menus.filter((menu) => menu.disabled !== true);\n  if (enabled.length === 0) return currentId;\n  const index = enabled.findIndex((menu) => menu.id === currentId);\n  if (index === -1) return enabled[0]!.id;\n  const next = direction === \"next\" ? index + 1 : index - 1;\n  return enabled[(next + enabled.length) % enabled.length]!.id;\n}\n\nexport const menubarRecipe = {\n  slots: [\"root\", \"menu\", \"label\", \"panel\", \"item\"] as const,\n  minHeight: control.minTouchTarget,\n  gap: spacing.xxs,\n  paddingHorizontal: spacing.xs,\n  label: {\n    paddingHorizontal: spacing.sm,\n    radius: radius.sm,\n    color: semanticColors.content.body,\n    openBackground: semanticColors.interaction.selected,\n  },\n  item: collectionItemContract,\n  states: { focus: focusIndicatorContract },\n} as const satisfies {\n  slots: readonly [\"root\", \"menu\", \"label\", \"panel\", \"item\"];\n  minHeight: number;\n  gap: number;\n  paddingHorizontal: number;\n  label: { paddingHorizontal: number; radius: number; color: ColorReference; openBackground: ColorReference };\n  item: typeof collectionItemContract;\n  states: { focus: typeof focusIndicatorContract };\n};\n\nexport const menubarBehavior = {\n  controlled: [\"openMenuId\", \"defaultOpenMenuId\", \"onOpenMenuIdChange\"],\n  inputs: [\"menus\", \"accessibilityLabel\"],\n  events: [\"onAction\"],\n  stateAxes: {\n    availability: [\"enabled\", \"disabled\"],\n    value: [\"open\", \"closed\"],\n    interaction: [\"idle\", \"hover\", \"focusVisible\"],\n  },\n  web: {\n    roles: [\"menubar\", \"menuitem\", \"menu\"],\n    keyboard: [\"ArrowLeft\", \"ArrowRight\", \"ArrowDown\", \"ArrowUp\", \"Home\", \"End\", \"Enter\", \"Space\", \"Escape\"],\n    focus: \"roving\",\n    dismiss: [\"escape\", \"outside\"],\n  },\n  /** Web-only: a phone has no always-present menu bar, and a native app bar is the OS's. */\n  native: { roles: [], states: [], actions: [] },\n  scenarios: [\n    \"left-and-right-move-between-menus-while-one-is-open-instead-of-closing-and-reopening\",\n    \"exactly-one-menu-is-open-at-a-time-which-three-independent-menus-cannot-guarantee\",\n    \"disabled-menus-are-skipped-by-navigation-and-cycling-is-shorter-than-stopping-at-the-end\",\n    \"the-bar-is-a-single-tab-stop-with-roving-focus-not-one-stop-per-menu\",\n    \"activating-an-item-runs-an-action-and-leaves-nothing-selected-unlike-tabs\",\n  ],\n} as const satisfies BehaviorContract;\n"]}
+{"version":3,"file":"menubar.js","sourceRoot":"","sources":["../src/menubar.ts"],"names":[],"mappings":"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","sourcesContent":["import type { BehaviorContract, MenuItemDescriptor } from \"./behaviors.js\";\nimport type { ColorReference } from \"./color-references.js\";\nimport { collectionItemContract, focusIndicatorContract } from \"./component-contracts.js\";\nimport { control, radius, spacing } from \"./foundations.js\";\nimport { semanticColors } from \"./semantic-colors.js\";\n\n/**\n * 데스크톱 앱의 가로 메뉴 막대 — 파일·편집·보기처럼 항상 같은 자리에 있는 메뉴들.\n *\n * `Menu` 여러 개를 나란히 놓는 것과 다르다. 막대는 **하나의 키보드 단위**다: 메뉴가\n * 열린 상태에서 좌우 방향키를 누르면 옆 메뉴로 **넘어가고**(닫았다 여는 것이 아니라),\n * 한 번에 하나만 열린다. 독립된 Menu 세 개로는 그 이동이 성립하지 않는다.\n *\n * `Tabs`와도 다르다. Tabs는 화면을 바꾸고 선택 상태가 남는다. Menubar는 행동을 실행하고\n * 아무것도 선택되지 않은 상태로 돌아간다.\n */\nexport type MenubarMenuDescriptor<\n  Key extends string = string,\n  MenuKey extends string = string,\n> = Readonly<{\n  id: MenuKey;\n  label: string;\n  items: readonly MenuItemDescriptor<Key>[];\n  disabled?: boolean;\n}>;\n\nexport type MenubarDescriptor<\n  Key extends string = string,\n  MenuKey extends string = string,\n> = Readonly<{\n  accessibilityLabel: string;\n  menus: readonly MenubarMenuDescriptor<Key, MenuKey>[];\n}>;\n\nfunction assertNonEmpty(value: string, field: string): void {\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    throw new TypeError(`Menubar ${field} must not be empty`);\n  }\n}\n\nexport function validateMenubarDescriptor<Key extends string, MenuKey extends string>(\n  descriptor: MenubarDescriptor<Key, MenuKey>,\n): void {\n  assertNonEmpty(descriptor.accessibilityLabel, \"accessibilityLabel\");\n  if (!Array.isArray(descriptor.menus) || descriptor.menus.length === 0) {\n    throw new RangeError(\"Menubar must contain at least one menu\");\n  }\n  const menuIds = new Set<MenuKey>();\n  for (const menu of descriptor.menus) {\n    assertNonEmpty(menu.id, \"menu id\");\n    assertNonEmpty(menu.label, `menu ${menu.id} label`);\n    if (menuIds.has(menu.id)) throw new TypeError(`Duplicate Menubar menu id: ${menu.id}`);\n    menuIds.add(menu.id);\n    if (!Array.isArray(menu.items) || menu.items.length === 0) {\n      throw new RangeError(`Menubar menu ${menu.id} must contain at least one item`);\n    }\n  }\n}\n\n/**\n * 좌우 이동은 **비활성 메뉴를 건너뛰고 순환**한다. 막대 끝에서 멈추면 사용자가 방향을\n * 바꿔 되돌아와야 하는데, 항목이 대여섯 개뿐인 가로 막대에서는 순환이 더 짧다.\n */\nexport function resolveMenubarNavigation<Key extends string, MenuKey extends string>(\n  descriptor: MenubarDescriptor<Key, MenuKey>,\n  currentId: MenuKey,\n  direction: \"next\" | \"previous\",\n): MenuKey {\n  validateMenubarDescriptor(descriptor);\n  const enabled = descriptor.menus.filter((menu) => menu.disabled !== true);\n  if (enabled.length === 0) return currentId;\n  const index = enabled.findIndex((menu) => menu.id === currentId);\n  if (index === -1) return enabled[0]!.id;\n  const next = direction === \"next\" ? index + 1 : index - 1;\n  return enabled[(next + enabled.length) % enabled.length]!.id;\n}\n\nexport const menubarRecipe = {\n  slots: [\"root\", \"menu\", \"label\", \"panel\", \"item\"] as const,\n  minHeight: control.minTouchTarget,\n  gap: spacing.xxs,\n  paddingHorizontal: spacing.xs,\n  label: {\n    paddingHorizontal: spacing.sm,\n    radius: radius.sm,\n    color: semanticColors.content.body,\n    openBackground: semanticColors.canvas,\n  },\n  item: collectionItemContract,\n  states: { focus: focusIndicatorContract },\n} as const satisfies {\n  slots: readonly [\"root\", \"menu\", \"label\", \"panel\", \"item\"];\n  minHeight: number;\n  gap: number;\n  paddingHorizontal: number;\n  label: { paddingHorizontal: number; radius: number; color: ColorReference; openBackground: ColorReference };\n  item: typeof collectionItemContract;\n  states: { focus: typeof focusIndicatorContract };\n};\n\nexport const menubarBehavior = {\n  controlled: [\"openMenuId\", \"defaultOpenMenuId\", \"onOpenMenuIdChange\"],\n  inputs: [\"menus\", \"accessibilityLabel\"],\n  events: [\"onAction\"],\n  stateAxes: {\n    availability: [\"enabled\", \"disabled\"],\n    value: [\"open\", \"closed\"],\n    interaction: [\"idle\", \"hover\", \"focusVisible\"],\n  },\n  web: {\n    roles: [\"menubar\", \"menuitem\", \"menu\"],\n    keyboard: [\"ArrowLeft\", \"ArrowRight\", \"ArrowDown\", \"ArrowUp\", \"Home\", \"End\", \"Enter\", \"Space\", \"Escape\"],\n    focus: \"roving\",\n    dismiss: [\"escape\", \"outside\"],\n  },\n  /** Web-only: a phone has no always-present menu bar, and a native app bar is the OS's. */\n  native: { roles: [], states: [], actions: [] },\n  scenarios: [\n    \"left-and-right-move-between-menus-while-one-is-open-instead-of-closing-and-reopening\",\n    \"exactly-one-menu-is-open-at-a-time-which-three-independent-menus-cannot-guarantee\",\n    \"disabled-menus-are-skipped-by-navigation-and-cycling-is-shorter-than-stopping-at-the-end\",\n    \"the-bar-is-a-single-tab-stop-with-roving-focus-not-one-stop-per-menu\",\n    \"activating-an-item-runs-an-action-and-leaves-nothing-selected-unlike-tabs\",\n  ],\n} as const satisfies BehaviorContract;\n"]}

package/dist/number-field.d.ts

@@ -81,12 +81,12 @@ export declare const numberFieldRecipe: {
     readonly frame: {
         readonly background: Readonly<{
             source: "theme";
-            key: "surface";
+            key: "bg";
             alpha?: number;
         }>;
         readonly border: Readonly<{
             source: "theme";
-            key: "textMuted";
+            key: "borderControl";
             alpha?: number;
         }>;
         readonly focusBorder: Readonly<{

package/dist/otp-field.d.ts

@@ -91,7 +91,7 @@ export declare const otpFieldRecipe: {
     readonly slot: {
         readonly border: Readonly<{
             source: "theme";
-            key: "textMuted";
+            key: "borderControl";
             alpha?: number;
         }>;
         readonly focusBorder: Readonly<{

package/dist/password-field.d.ts

@@ -58,12 +58,12 @@ export declare const passwordFieldRecipe: {
     readonly frame: {
         readonly background: Readonly<{
             source: "theme";
-            key: "surface";
+            key: "bg";
             alpha?: number;
         }>;
         readonly border: Readonly<{
             source: "theme";
-            key: "textMuted";
+            key: "borderControl";
             alpha?: number;
         }>;
         readonly focusBorder: Readonly<{

package/dist/popover.d.ts

@@ -63,14 +63,13 @@ export type PopoverDismissPolicy = Readonly<{
     focusOutDismiss: boolean;
 }>;
 /**
- * 무엇이 popover를 여는가. `press`가 기본이고 `hover`는 **읽기 전용 미리보기**
- * (다른 시스템의 HoverCard)를 위한 축이다.
+ * 무엇이 popover를 여는가. `press`가 기본이고 `hover`는 포인터의 추가 진입
+ * 방식이다. hover를 켜도 press 경로를 유지해야 키보드·터치 사용자가 같은
+ * 콘텐츠에 도달할 수 있다.
  *
- * 별도 컴포넌트를 만들지 않은 이유: 표면·초점·dismiss·충돌 회피가 전부 같고 다른 것은
- * 여는 방법 하나뿐이다. 두 컴포넌트로 나누면 그 네 가지가 두 벌이 된다.
- *
- * 대신 `hover`에는 제약이 붙는다 — hover로만 열리는 내용에 **행동을 두면 안 된다**.
- * 포인터가 없는 사용자는 그 행동에 닿을 수 없기 때문이다. 미리보기는 읽기 전용이다.
+ * 별도 HoverCard는 검토했지만 표면·초점·dismiss·충돌 회피 계약은 같고 여는
+ * 방식만 하나 더하는 것이므로 컴포넌트를 나누지 않는다. hover는 지나가는 포인터에
+ * 바로 반응하지 않도록 지연되며, click/키보드/터치 경로를 대체하지 않는다.
  */
 export type PopoverOpenOn = "press" | "hover";
 export declare const popoverBehaviorDefaults: {
@@ -163,5 +162,5 @@ export declare const popoverRecipe: {
  * src/behaviors.ts). Kept here, not there, so this module stays self-contained
  * per the authoring brief.
  */
-export declare const popoverBehaviorScenarios: readonly ["focus-enters-surface-on-open", "escape-closes-and-restores-trigger-focus", "outside-pointer-close-does-not-cancel-the-original-interaction", "tabbing-past-last-focusable-child-closes-without-trapping", "controlled-owner-programmatic-close-always-wins", "close-action-inside-content-closes-exactly-once", "trigger-while-open-does-not-reopen", "one-visible-popover-per-trigger"];
+export declare const popoverBehaviorScenarios: readonly ["focus-enters-surface-on-open", "escape-closes-and-restores-trigger-focus", "outside-pointer-close-does-not-cancel-the-original-interaction", "tabbing-past-last-focusable-child-closes-without-trapping", "optional-hover-opens-after-delay-and-survives-pointer-crossing", "hover-mode-retains-press-activation-for-touch-and-keyboard", "controlled-owner-programmatic-close-always-wins", "close-action-inside-content-closes-exactly-once", "trigger-while-open-does-not-reopen", "one-visible-popover-per-trigger"];
 //# sourceMappingURL=popover.d.ts.map

package/dist/popover.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"popover.d.ts","sourceRoot":"","sources":["../src/popover.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAC;AAClE,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAC5B,cAAc,GACd,iBAAiB,GACjB,eAAe,GACf,QAAQ,GACR,cAAc,CAAC;AAEnB;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,oBAAoB,CAAC;AAEvE,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC;IAC9C,MAAM,EAAE,uBAAuB,CAAC;CACjC,CAAC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACvC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAC/C,SAAS,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,YAAY,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;CAG6C,CAAC;AAEpF;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC,CAAC;AAEH;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,OAAO,CAAC;AAE9C,eAAO,MAAM,uBAAuB;qBACf,aAAa;;;;;CAK6C,CAAC;AAEhF,+CAA+C;AAC/C,eAAO,MAAM,iBAAiB;;;CAAqC,CAAC;AAEpE,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAAC;IAChD,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,CAAC,EAAE,KAAK,CAAC;IACpB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAAC;CACtE,CAAC,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,QAAQ,CAAC;IAClD,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,CACb,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,wBAAwB,KAC9B,IAAI,CAAC;CACX,CAAC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GACxB,0BAA0B,GAC1B,4BAA4B,CAAC;AAEjC,6FAA6F;AAC7F,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,CAAC,cAAc,CAAC,CAAC;AAuBpE,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI,CA6B7E;AAED,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,iBAAiB,GAC5B,yBAAyB,CAS3B;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAgCtE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,oBAAoB,EAC5B,MAAM,GAAE,oBAA8C,GACrD,OAAO,CAOT;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkBzB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,qYAS3B,CAAC"}
+{"version":3,"file":"popover.d.ts","sourceRoot":"","sources":["../src/popover.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAC;AAClE,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,MAAM,oBAAoB,GAC5B,cAAc,GACd,iBAAiB,GACjB,eAAe,GACf,QAAQ,GACR,cAAc,CAAC;AAEnB;;;;;GAKG;AACH,MAAM,MAAM,uBAAuB,GAAG,SAAS,GAAG,oBAAoB,CAAC;AAEvE,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC;IAC9C,MAAM,EAAE,uBAAuB,CAAC;CACjC,CAAC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACvC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAC/C,SAAS,EAAE,gBAAgB,CAAC;IAC5B,KAAK,EAAE,YAAY,CAAC;IACpB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,CAAC,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;CAG6C,CAAC;AAEpF;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,OAAO,CAAC;AAE9C,eAAO,MAAM,uBAAuB;qBACf,aAAa;;;;;CAK6C,CAAC;AAEhF,+CAA+C;AAC/C,eAAO,MAAM,iBAAiB;;;CAAqC,CAAC;AAEpE,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAAC;IAChD,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,CAAC,EAAE,KAAK,CAAC;IACpB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAAC;CACtE,CAAC,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,QAAQ,CAAC;IAClD,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,CACb,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,wBAAwB,KAC9B,IAAI,CAAC;CACX,CAAC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GACxB,0BAA0B,GAC1B,4BAA4B,CAAC;AAEjC,6FAA6F;AAC7F,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,CAAC,cAAc,CAAC,CAAC;AAuBpE,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI,CA6B7E;AAED,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,iBAAiB,GAC5B,yBAAyB,CAS3B;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAgCtE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,oBAAoB,EAC5B,MAAM,GAAE,oBAA8C,GACrD,OAAO,CAOT;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkBzB,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,qgBAW3B,CAAC"}

package/dist/popover.js

@@ -132,6 +132,8 @@ export const popoverBehaviorScenarios = [
     "escape-closes-and-restores-trigger-focus",
     "outside-pointer-close-does-not-cancel-the-original-interaction",
     "tabbing-past-last-focusable-child-closes-without-trapping",
+    "optional-hover-opens-after-delay-and-survives-pointer-crossing",
+    "hover-mode-retains-press-activation-for-touch-and-keyboard",
     "controlled-owner-programmatic-close-always-wins",
     "close-action-inside-content-closes-exactly-once",
     "trigger-while-open-does-not-reopen",

package/dist/popover.js.map

@@ -1 +1 @@
-{"version":3,"file":"popover.js","sourceRoot":"","sources":["../src/popover.ts"],"names":[],"mappings":"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","sourcesContent":["import { floatingSurfaceContract } from \"./component-contracts.js\";\nimport { motionPreset, spacing } from \"./foundations.js\";\n\n/**\n * Popover is the third corner of a triangle with Tooltip and Menu — all three\n * are \"a floating surface anchored to a trigger.\" Tooltip is explicitly\n * plain-text and never receives focus (docs/tooltip.md: \"interactive\n * Popover로 확장하지 않는다\"). Menu is a collection of actionable items with\n * its own role/keyboard table (behaviorRegistry.menu). Popover is what is left:\n * arbitrary *interactive* content (a small form, rich text with a link, a\n * mixed layout) that is neither a single plain sentence nor an item list.\n * Focus entering the surface is the decisive, testable difference from\n * Tooltip — everything else here (dismiss reasons, non-modal posture) follows\n * from that one fact.\n */\nexport type PopoverPlacement = \"top\" | \"bottom\" | \"start\" | \"end\";\nexport type PopoverAlign = \"start\" | \"center\" | \"end\";\n\n/**\n * Popover is non-modal: it does not trap focus like Dialog/Sheet and does not\n * block the rest of the page. So its dismiss vocabulary is deliberately\n * narrower than SheetDismissReason — no \"back\" or \"swipe\" (this is a web-only\n * surface), but it adds \"outside-focus\" because, unlike a modal, Tab can\n * legitimately carry focus out of a non-modal surface and that departure is\n * itself a dismiss signal distinct from a pointer click outside.\n */\nexport type PopoverDismissReason =\n  | \"close-action\"\n  | \"outside-pointer\"\n  | \"outside-focus\"\n  | \"escape\"\n  | \"programmatic\";\n\n/**\n * 여는 사유는 `\"trigger\"`다. Sheet·SidePanel·CommandPalette가 모두 이 이름을 쓰고,\n * `\"trigger-activation\"`은 `src/tooltip.ts`에서 **닫는** 사유(열려 있는 툴팁의\n * 트리거를 눌러 닫는다)로 이미 쓰이고 있다. 한 문자열이 여는 뜻과 닫는 뜻을 겸하면\n * 렌더러가 조용히 반대로 처리한다 — 컴파일러는 둘 다 유효한 문자열로만 본다.\n */\nexport type PopoverOpenChangeReason = \"trigger\" | PopoverDismissReason;\n\nexport type PopoverOpenChangeDetails = Readonly<{\n  reason: PopoverOpenChangeReason;\n}>;\n\nexport type PopoverDescriptor = Readonly<{\n  placement?: PopoverPlacement;\n  align?: PopoverAlign;\n  /**\n   * Optional explicit accessible name. A renderer must connect its visible\n   * heading with aria-labelledby; a heading alone does not name a dialog.\n   */\n  accessibilityLabel?: string;\n}>;\n\nexport type ResolvedPopoverDescriptor = Readonly<{\n  placement: PopoverPlacement;\n  align: PopoverAlign;\n  accessibilityLabel?: string;\n}>;\n\nexport const popoverDescriptorDefaults = {\n  placement: \"bottom\",\n  align: \"start\",\n} as const satisfies Readonly<{ placement: PopoverPlacement; align: PopoverAlign }>;\n\n/**\n * A controlled owner's programmatic close always wins, exactly like\n * SheetDismissPolicy/canDismissSheet. Popover has no `busy` axis: unlike\n * Sheet/AlertDialog it is not modal, so there is no global \"block every\n * dismiss\" state to defend — a form inside the content that wants to ignore\n * Escape while submitting makes that call itself, at the content level.\n */\nexport type PopoverDismissPolicy = Readonly<{\n  dismissible: boolean;\n  outsideDismiss: boolean;\n  escapeDismiss: boolean;\n  focusOutDismiss: boolean;\n}>;\n\n/**\n * 무엇이 popover를 여는가. `press`가 기본이고 `hover`는 **읽기 전용 미리보기**\n * (다른 시스템의 HoverCard)를 위한 축이다.\n *\n * 별도 컴포넌트를 만들지 않은 이유: 표면·초점·dismiss·충돌 회피가 전부 같고 다른 것은\n * 여는 방법 하나뿐이다. 두 컴포넌트로 나누면 그 네 가지가 두 벌이 된다.\n *\n * 대신 `hover`에는 제약이 붙는다 — hover로만 열리는 내용에 **행동을 두면 안 된다**.\n * 포인터가 없는 사용자는 그 행동에 닿을 수 없기 때문이다. 미리보기는 읽기 전용이다.\n */\nexport type PopoverOpenOn = \"press\" | \"hover\";\n\nexport const popoverBehaviorDefaults = {\n  openOn: \"press\" as PopoverOpenOn,\n  dismissible: true,\n  outsideDismiss: true,\n  escapeDismiss: true,\n  focusOutDismiss: true,\n} as const satisfies PopoverDismissPolicy & Readonly<{ openOn: PopoverOpenOn }>;\n\n/** hover로 열 때의 지연. 지나가는 포인터마다 열리면 화면이 깜빡인다. */\nexport const popoverHoverDelay = { open: 300, close: 150 } as const;\n\nexport type ControlledPopoverOpenState = Readonly<{\n  open: boolean;\n  defaultOpen?: never;\n  onOpenChange(open: boolean, details: PopoverOpenChangeDetails): void;\n}>;\n\nexport type UncontrolledPopoverOpenState = Readonly<{\n  open?: never;\n  defaultOpen?: boolean;\n  onOpenChange?: (\n    open: boolean,\n    details: PopoverOpenChangeDetails,\n  ) => void;\n}>;\n\nexport type PopoverOpenState =\n  | ControlledPopoverOpenState\n  | UncontrolledPopoverOpenState;\n\n/** Products own what page-change caused this; Popover only needs \"did it happen and how.\" */\nexport type PopoverChangeHandler = PopoverOpenState[\"onOpenChange\"];\n\nconst placements = new Set<PopoverPlacement>([\"top\", \"bottom\", \"start\", \"end\"]);\nconst alignments = new Set<PopoverAlign>([\"start\", \"center\", \"end\"]);\nconst descriptorKeys = new Set([\"placement\", \"align\", \"accessibilityLabel\"]);\nconst openStateKeys = new Set([\"open\", \"defaultOpen\", \"onOpenChange\"]);\n\nfunction isObject(value: unknown): value is Readonly<Record<string, unknown>> {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction rejectUnknownKeys(\n  value: Readonly<Record<string, unknown>>,\n  allowed: ReadonlySet<string>,\n  field: string,\n): void {\n  for (const key of Object.keys(value)) {\n    if (!allowed.has(key)) {\n      throw new TypeError(`Unsupported Popover ${field} field: ${key}`);\n    }\n  }\n}\n\nexport function validatePopoverDescriptor(descriptor: PopoverDescriptor): void {\n  if (!isObject(descriptor)) {\n    throw new TypeError(\"Popover descriptor must be an object\");\n  }\n  rejectUnknownKeys(descriptor, descriptorKeys, \"descriptor\");\n  if (\n    descriptor.placement !== undefined &&\n    !placements.has(descriptor.placement)\n  ) {\n    throw new TypeError(\n      `Unsupported Popover placement: ${String(descriptor.placement)}`,\n    );\n  }\n  if (descriptor.align !== undefined && !alignments.has(descriptor.align)) {\n    throw new TypeError(`Unsupported Popover align: ${String(descriptor.align)}`);\n  }\n  if (descriptor.accessibilityLabel !== undefined) {\n    if (\n      typeof descriptor.accessibilityLabel !== \"string\" ||\n      descriptor.accessibilityLabel.trim().length === 0\n    ) {\n      throw new TypeError(\"Popover accessibilityLabel must not be empty\");\n    }\n    if (descriptor.accessibilityLabel !== descriptor.accessibilityLabel.trim()) {\n      throw new TypeError(\n        \"Popover accessibilityLabel must not start or end with whitespace\",\n      );\n    }\n  }\n}\n\nexport function resolvePopoverDescriptor(\n  descriptor: PopoverDescriptor,\n): ResolvedPopoverDescriptor {\n  validatePopoverDescriptor(descriptor);\n  return {\n    placement: descriptor.placement ?? popoverDescriptorDefaults.placement,\n    align: descriptor.align ?? popoverDescriptorDefaults.align,\n    ...(descriptor.accessibilityLabel !== undefined\n      ? { accessibilityLabel: descriptor.accessibilityLabel }\n      : {}),\n  };\n}\n\nexport function validatePopoverOpenState(state: PopoverOpenState): void {\n  if (!isObject(state)) {\n    throw new TypeError(\"Popover open state must be an object\");\n  }\n  rejectUnknownKeys(state, openStateKeys, \"open state\");\n  const runtime = state as Readonly<Record<string, unknown>>;\n  const hasOpen = Object.prototype.hasOwnProperty.call(runtime, \"open\");\n  const hasDefaultOpen = Object.prototype.hasOwnProperty.call(\n    runtime,\n    \"defaultOpen\",\n  );\n  if (hasOpen) {\n    if (typeof runtime.open !== \"boolean\") {\n      throw new TypeError(\"Popover open must be a boolean\");\n    }\n    if (hasDefaultOpen) {\n      throw new TypeError(\"Controlled Popover must not provide defaultOpen\");\n    }\n    if (typeof runtime.onOpenChange !== \"function\") {\n      throw new TypeError(\"Controlled Popover must provide onOpenChange\");\n    }\n    return;\n  }\n  if (hasDefaultOpen && typeof runtime.defaultOpen !== \"boolean\") {\n    throw new TypeError(\"Popover defaultOpen must be a boolean\");\n  }\n  if (\n    runtime.onOpenChange !== undefined &&\n    typeof runtime.onOpenChange !== \"function\"\n  ) {\n    throw new TypeError(\"Popover onOpenChange must be a function\");\n  }\n}\n\n/**\n * Resolves an attempted close without platform knowledge, mirroring\n * canDismissSheet. Programmatic close is always an owner override.\n */\nexport function canDismissPopover(\n  reason: PopoverDismissReason,\n  policy: PopoverDismissPolicy = popoverBehaviorDefaults,\n): boolean {\n  if (reason === \"programmatic\") return true;\n  if (!policy.dismissible) return false;\n  if (reason === \"outside-pointer\") return policy.outsideDismiss;\n  if (reason === \"outside-focus\") return policy.focusOutDismiss;\n  if (reason === \"escape\") return policy.escapeDismiss;\n  return true;\n}\n\n/**\n * Positioning boundary is identical to Tooltip's: HJM owns preferred\n * placement, spacing, and motion; DOM measurement, portal, flip/shift, and\n * RTL logical-to-physical translation stay in the product Web renderer's\n * private AnchoredOverlay (see docs/tooltip.md \"Positioning boundary\"). This\n * module never exposes that internal tool, so Popover cannot regress Tooltip's\n * \"no public collision/portal API\" boundary.\n */\nexport const popoverRecipe = {\n  slots: [\"trigger\", \"content\", \"arrow\", \"closeAction\"] as const,\n  surface: floatingSurfaceContract,\n  arrow: { size: spacing.xxs, offset: spacing.xxs },\n  sideOffset: spacing.xs,\n  collisionPadding: spacing.xs,\n  minWidth: 240,\n  maxWidth: 360,\n  transition: { enter: motionPreset.enter, exit: motionPreset.exit },\n} as const satisfies {\n  slots: readonly string[];\n  surface: typeof floatingSurfaceContract;\n  arrow: { size: number; offset: number };\n  sideOffset: number;\n  collisionPadding: number;\n  minWidth: number;\n  maxWidth: number;\n  transition: { enter: typeof motionPreset.enter; exit: typeof motionPreset.exit };\n};\n\n/**\n * Literal scenario names for behaviorRegistry.popover (lead wires into\n * src/behaviors.ts). Kept here, not there, so this module stays self-contained\n * per the authoring brief.\n */\nexport const popoverBehaviorScenarios = [\n  \"focus-enters-surface-on-open\",\n  \"escape-closes-and-restores-trigger-focus\",\n  \"outside-pointer-close-does-not-cancel-the-original-interaction\",\n  \"tabbing-past-last-focusable-child-closes-without-trapping\",\n  \"controlled-owner-programmatic-close-always-wins\",\n  \"close-action-inside-content-closes-exactly-once\",\n  \"trigger-while-open-does-not-reopen\",\n  \"one-visible-popover-per-trigger\",\n] as const;\n"]}
+{"version":3,"file":"popover.js","sourceRoot":"","sources":["../src/popover.ts"],"names":[],"mappings":"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","sourcesContent":["import { floatingSurfaceContract } from \"./component-contracts.js\";\nimport { motionPreset, spacing } from \"./foundations.js\";\n\n/**\n * Popover is the third corner of a triangle with Tooltip and Menu — all three\n * are \"a floating surface anchored to a trigger.\" Tooltip is explicitly\n * plain-text and never receives focus (docs/tooltip.md: \"interactive\n * Popover로 확장하지 않는다\"). Menu is a collection of actionable items with\n * its own role/keyboard table (behaviorRegistry.menu). Popover is what is left:\n * arbitrary *interactive* content (a small form, rich text with a link, a\n * mixed layout) that is neither a single plain sentence nor an item list.\n * Focus entering the surface is the decisive, testable difference from\n * Tooltip — everything else here (dismiss reasons, non-modal posture) follows\n * from that one fact.\n */\nexport type PopoverPlacement = \"top\" | \"bottom\" | \"start\" | \"end\";\nexport type PopoverAlign = \"start\" | \"center\" | \"end\";\n\n/**\n * Popover is non-modal: it does not trap focus like Dialog/Sheet and does not\n * block the rest of the page. So its dismiss vocabulary is deliberately\n * narrower than SheetDismissReason — no \"back\" or \"swipe\" (this is a web-only\n * surface), but it adds \"outside-focus\" because, unlike a modal, Tab can\n * legitimately carry focus out of a non-modal surface and that departure is\n * itself a dismiss signal distinct from a pointer click outside.\n */\nexport type PopoverDismissReason =\n  | \"close-action\"\n  | \"outside-pointer\"\n  | \"outside-focus\"\n  | \"escape\"\n  | \"programmatic\";\n\n/**\n * 여는 사유는 `\"trigger\"`다. Sheet·SidePanel·CommandPalette가 모두 이 이름을 쓰고,\n * `\"trigger-activation\"`은 `src/tooltip.ts`에서 **닫는** 사유(열려 있는 툴팁의\n * 트리거를 눌러 닫는다)로 이미 쓰이고 있다. 한 문자열이 여는 뜻과 닫는 뜻을 겸하면\n * 렌더러가 조용히 반대로 처리한다 — 컴파일러는 둘 다 유효한 문자열로만 본다.\n */\nexport type PopoverOpenChangeReason = \"trigger\" | PopoverDismissReason;\n\nexport type PopoverOpenChangeDetails = Readonly<{\n  reason: PopoverOpenChangeReason;\n}>;\n\nexport type PopoverDescriptor = Readonly<{\n  placement?: PopoverPlacement;\n  align?: PopoverAlign;\n  /**\n   * Optional explicit accessible name. A renderer must connect its visible\n   * heading with aria-labelledby; a heading alone does not name a dialog.\n   */\n  accessibilityLabel?: string;\n}>;\n\nexport type ResolvedPopoverDescriptor = Readonly<{\n  placement: PopoverPlacement;\n  align: PopoverAlign;\n  accessibilityLabel?: string;\n}>;\n\nexport const popoverDescriptorDefaults = {\n  placement: \"bottom\",\n  align: \"start\",\n} as const satisfies Readonly<{ placement: PopoverPlacement; align: PopoverAlign }>;\n\n/**\n * A controlled owner's programmatic close always wins, exactly like\n * SheetDismissPolicy/canDismissSheet. Popover has no `busy` axis: unlike\n * Sheet/AlertDialog it is not modal, so there is no global \"block every\n * dismiss\" state to defend — a form inside the content that wants to ignore\n * Escape while submitting makes that call itself, at the content level.\n */\nexport type PopoverDismissPolicy = Readonly<{\n  dismissible: boolean;\n  outsideDismiss: boolean;\n  escapeDismiss: boolean;\n  focusOutDismiss: boolean;\n}>;\n\n/**\n * 무엇이 popover를 여는가. `press`가 기본이고 `hover`는 포인터의 추가 진입\n * 방식이다. hover를 켜도 press 경로를 유지해야 키보드·터치 사용자가 같은\n * 콘텐츠에 도달할 수 있다.\n *\n * 별도 HoverCard는 검토했지만 표면·초점·dismiss·충돌 회피 계약은 같고 여는\n * 방식만 하나 더하는 것이므로 컴포넌트를 나누지 않는다. hover는 지나가는 포인터에\n * 바로 반응하지 않도록 지연되며, click/키보드/터치 경로를 대체하지 않는다.\n */\nexport type PopoverOpenOn = \"press\" | \"hover\";\n\nexport const popoverBehaviorDefaults = {\n  openOn: \"press\" as PopoverOpenOn,\n  dismissible: true,\n  outsideDismiss: true,\n  escapeDismiss: true,\n  focusOutDismiss: true,\n} as const satisfies PopoverDismissPolicy & Readonly<{ openOn: PopoverOpenOn }>;\n\n/** hover로 열 때의 지연. 지나가는 포인터마다 열리면 화면이 깜빡인다. */\nexport const popoverHoverDelay = { open: 300, close: 150 } as const;\n\nexport type ControlledPopoverOpenState = Readonly<{\n  open: boolean;\n  defaultOpen?: never;\n  onOpenChange(open: boolean, details: PopoverOpenChangeDetails): void;\n}>;\n\nexport type UncontrolledPopoverOpenState = Readonly<{\n  open?: never;\n  defaultOpen?: boolean;\n  onOpenChange?: (\n    open: boolean,\n    details: PopoverOpenChangeDetails,\n  ) => void;\n}>;\n\nexport type PopoverOpenState =\n  | ControlledPopoverOpenState\n  | UncontrolledPopoverOpenState;\n\n/** Products own what page-change caused this; Popover only needs \"did it happen and how.\" */\nexport type PopoverChangeHandler = PopoverOpenState[\"onOpenChange\"];\n\nconst placements = new Set<PopoverPlacement>([\"top\", \"bottom\", \"start\", \"end\"]);\nconst alignments = new Set<PopoverAlign>([\"start\", \"center\", \"end\"]);\nconst descriptorKeys = new Set([\"placement\", \"align\", \"accessibilityLabel\"]);\nconst openStateKeys = new Set([\"open\", \"defaultOpen\", \"onOpenChange\"]);\n\nfunction isObject(value: unknown): value is Readonly<Record<string, unknown>> {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction rejectUnknownKeys(\n  value: Readonly<Record<string, unknown>>,\n  allowed: ReadonlySet<string>,\n  field: string,\n): void {\n  for (const key of Object.keys(value)) {\n    if (!allowed.has(key)) {\n      throw new TypeError(`Unsupported Popover ${field} field: ${key}`);\n    }\n  }\n}\n\nexport function validatePopoverDescriptor(descriptor: PopoverDescriptor): void {\n  if (!isObject(descriptor)) {\n    throw new TypeError(\"Popover descriptor must be an object\");\n  }\n  rejectUnknownKeys(descriptor, descriptorKeys, \"descriptor\");\n  if (\n    descriptor.placement !== undefined &&\n    !placements.has(descriptor.placement)\n  ) {\n    throw new TypeError(\n      `Unsupported Popover placement: ${String(descriptor.placement)}`,\n    );\n  }\n  if (descriptor.align !== undefined && !alignments.has(descriptor.align)) {\n    throw new TypeError(`Unsupported Popover align: ${String(descriptor.align)}`);\n  }\n  if (descriptor.accessibilityLabel !== undefined) {\n    if (\n      typeof descriptor.accessibilityLabel !== \"string\" ||\n      descriptor.accessibilityLabel.trim().length === 0\n    ) {\n      throw new TypeError(\"Popover accessibilityLabel must not be empty\");\n    }\n    if (descriptor.accessibilityLabel !== descriptor.accessibilityLabel.trim()) {\n      throw new TypeError(\n        \"Popover accessibilityLabel must not start or end with whitespace\",\n      );\n    }\n  }\n}\n\nexport function resolvePopoverDescriptor(\n  descriptor: PopoverDescriptor,\n): ResolvedPopoverDescriptor {\n  validatePopoverDescriptor(descriptor);\n  return {\n    placement: descriptor.placement ?? popoverDescriptorDefaults.placement,\n    align: descriptor.align ?? popoverDescriptorDefaults.align,\n    ...(descriptor.accessibilityLabel !== undefined\n      ? { accessibilityLabel: descriptor.accessibilityLabel }\n      : {}),\n  };\n}\n\nexport function validatePopoverOpenState(state: PopoverOpenState): void {\n  if (!isObject(state)) {\n    throw new TypeError(\"Popover open state must be an object\");\n  }\n  rejectUnknownKeys(state, openStateKeys, \"open state\");\n  const runtime = state as Readonly<Record<string, unknown>>;\n  const hasOpen = Object.prototype.hasOwnProperty.call(runtime, \"open\");\n  const hasDefaultOpen = Object.prototype.hasOwnProperty.call(\n    runtime,\n    \"defaultOpen\",\n  );\n  if (hasOpen) {\n    if (typeof runtime.open !== \"boolean\") {\n      throw new TypeError(\"Popover open must be a boolean\");\n    }\n    if (hasDefaultOpen) {\n      throw new TypeError(\"Controlled Popover must not provide defaultOpen\");\n    }\n    if (typeof runtime.onOpenChange !== \"function\") {\n      throw new TypeError(\"Controlled Popover must provide onOpenChange\");\n    }\n    return;\n  }\n  if (hasDefaultOpen && typeof runtime.defaultOpen !== \"boolean\") {\n    throw new TypeError(\"Popover defaultOpen must be a boolean\");\n  }\n  if (\n    runtime.onOpenChange !== undefined &&\n    typeof runtime.onOpenChange !== \"function\"\n  ) {\n    throw new TypeError(\"Popover onOpenChange must be a function\");\n  }\n}\n\n/**\n * Resolves an attempted close without platform knowledge, mirroring\n * canDismissSheet. Programmatic close is always an owner override.\n */\nexport function canDismissPopover(\n  reason: PopoverDismissReason,\n  policy: PopoverDismissPolicy = popoverBehaviorDefaults,\n): boolean {\n  if (reason === \"programmatic\") return true;\n  if (!policy.dismissible) return false;\n  if (reason === \"outside-pointer\") return policy.outsideDismiss;\n  if (reason === \"outside-focus\") return policy.focusOutDismiss;\n  if (reason === \"escape\") return policy.escapeDismiss;\n  return true;\n}\n\n/**\n * Positioning boundary is identical to Tooltip's: HJM owns preferred\n * placement, spacing, and motion; DOM measurement, portal, flip/shift, and\n * RTL logical-to-physical translation stay in the product Web renderer's\n * private AnchoredOverlay (see docs/tooltip.md \"Positioning boundary\"). This\n * module never exposes that internal tool, so Popover cannot regress Tooltip's\n * \"no public collision/portal API\" boundary.\n */\nexport const popoverRecipe = {\n  slots: [\"trigger\", \"content\", \"arrow\", \"closeAction\"] as const,\n  surface: floatingSurfaceContract,\n  arrow: { size: spacing.xxs, offset: spacing.xxs },\n  sideOffset: spacing.xs,\n  collisionPadding: spacing.xs,\n  minWidth: 240,\n  maxWidth: 360,\n  transition: { enter: motionPreset.enter, exit: motionPreset.exit },\n} as const satisfies {\n  slots: readonly string[];\n  surface: typeof floatingSurfaceContract;\n  arrow: { size: number; offset: number };\n  sideOffset: number;\n  collisionPadding: number;\n  minWidth: number;\n  maxWidth: number;\n  transition: { enter: typeof motionPreset.enter; exit: typeof motionPreset.exit };\n};\n\n/**\n * Literal scenario names for behaviorRegistry.popover (lead wires into\n * src/behaviors.ts). Kept here, not there, so this module stays self-contained\n * per the authoring brief.\n */\nexport const popoverBehaviorScenarios = [\n  \"focus-enters-surface-on-open\",\n  \"escape-closes-and-restores-trigger-focus\",\n  \"outside-pointer-close-does-not-cancel-the-original-interaction\",\n  \"tabbing-past-last-focusable-child-closes-without-trapping\",\n  \"optional-hover-opens-after-delay-and-survives-pointer-crossing\",\n  \"hover-mode-retains-press-activation-for-touch-and-keyboard\",\n  \"controlled-owner-programmatic-close-always-wins\",\n  \"close-action-inside-content-closes-exactly-once\",\n  \"trigger-while-open-does-not-reopen\",\n  \"one-visible-popover-per-trigger\",\n] as const;\n"]}

package/dist/qr-code-recipe.d.ts

@@ -0,0 +1,7 @@
+export declare const qrCodeRecipe: {
+    readonly quietZone: 4;
+    readonly minModuleSize: 2;
+    readonly foreground: "#000000";
+    readonly background: "#ffffff";
+};
+//# sourceMappingURL=qr-code-recipe.d.ts.map

package/dist/qr-code-recipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qr-code-recipe.d.ts","sourceRoot":"","sources":["../src/qr-code-recipe.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY;;;;;CAA4F,CAAC"}

package/dist/qr-code-recipe.js

@@ -0,0 +1,2 @@
+export const qrCodeRecipe = { quietZone: 4, minModuleSize: 2, foreground: "#000000", background: "#ffffff" };
+//# sourceMappingURL=qr-code-recipe.js.map

package/dist/qr-code-recipe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qr-code-recipe.js","sourceRoot":"","sources":["../src/qr-code-recipe.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,SAAS,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAW,CAAC","sourcesContent":["export const qrCodeRecipe = { quietZone: 4, minModuleSize: 2, foreground: \"#000000\", background: \"#ffffff\" } as const;\n"]}

package/dist/qr-code.d.ts

@@ -0,0 +1,16 @@
+export type QRErrorCorrection = "L" | "M" | "Q" | "H";
+/** Pure encoding: hosts render the same matrix without image/network dependencies. */
+export type QREncoder = (type: 0, level: QRErrorCorrection) => {
+    addData(value: string, mode: "Byte"): void;
+    make(): void;
+    getModuleCount(): number;
+    isDark(row: number, column: number): boolean;
+};
+export declare function createQRMatrix(value: string, encode: QREncoder, level?: QRErrorCorrection): {
+    count: number;
+    cells: boolean[][];
+    quietZone: 4;
+};
+export declare function qrPath(matrix: ReturnType<typeof createQRMatrix>): string;
+export { qrCodeRecipe } from "./qr-code-recipe.js";
+//# sourceMappingURL=qr-code.d.ts.map

package/dist/qr-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qr-code.d.ts","sourceRoot":"","sources":["../src/qr-code.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AACtD,sFAAsF;AACtF,MAAM,MAAM,SAAS,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,iBAAiB,KAAK;IAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,IAAI,IAAI,CAAC;IAAC,cAAc,IAAI,MAAM,CAAC;IAAC,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAEpM,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,GAAE,iBAAuB;;;;EAoB9F;AACD,wBAAgB,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,UAE/D;AACD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/qr-code.js

@@ -0,0 +1,37 @@
+// Encoding is injected by renderers so the neutral contracts package stays dependency-free.
+export function createQRMatrix(value, encode, level = "M") {
+    if (!value.trim() || !["L", "M", "Q", "H"].includes(level))
+        throw new TypeError("QRCode needs a value and valid error correction level");
+    const code = encode(0, level);
+    // Encode UTF-8 explicitly: the upstream default truncates non-Latin strings to bytes.
+    // Hermes hosts need not provide TextEncoder; preserve UTF-8 without a global polyfill.
+    const bytes = [];
+    for (const character of value) {
+        const raw = character.codePointAt(0);
+        const code = raw >= 0xd800 && raw <= 0xdfff ? 0xfffd : raw;
+        if (code < 0x80)
+            bytes.push(code);
+        else if (code < 0x800)
+            bytes.push(0xc0 | (code >> 6), 0x80 | (code & 63));
+        else if (code < 0x10000)
+            bytes.push(0xe0 | (code >> 12), 0x80 | ((code >> 6) & 63), 0x80 | (code & 63));
+        else
+            bytes.push(0xf0 | (code >> 18), 0x80 | ((code >> 12) & 63), 0x80 | ((code >> 6) & 63), 0x80 | (code & 63));
+    }
+    const binary = bytes.map(byte => String.fromCharCode(byte)).join("");
+    code.addData(binary, "Byte");
+    try {
+        code.make();
+    }
+    catch {
+        throw new RangeError("QRCode value exceeds the selected encoding capacity");
+    }
+    const count = code.getModuleCount();
+    const cells = Array.from({ length: count }, (_, row) => Array.from({ length: count }, (_, column) => code.isDark(row, column)));
+    return { count, cells, quietZone: 4 };
+}
+export function qrPath(matrix) {
+    return matrix.cells.flatMap((row, y) => row.flatMap((dark, x) => dark ? [`M${x + 4},${y + 4}h1v1h-1z`] : [])).join("");
+}
+export { qrCodeRecipe } from "./qr-code-recipe.js";
+//# sourceMappingURL=qr-code.js.map

package/dist/qr-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qr-code.js","sourceRoot":"","sources":["../src/qr-code.ts"],"names":[],"mappings":"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","sourcesContent":["export type QRErrorCorrection = \"L\" | \"M\" | \"Q\" | \"H\";\n/** Pure encoding: hosts render the same matrix without image/network dependencies. */\nexport type QREncoder = (type: 0, level: QRErrorCorrection) => { addData(value: string, mode: \"Byte\"): void; make(): void; getModuleCount(): number; isDark(row: number, column: number): boolean };\n// Encoding is injected by renderers so the neutral contracts package stays dependency-free.\nexport function createQRMatrix(value: string, encode: QREncoder, level: QRErrorCorrection = \"M\") {\n  if (!value.trim() || ![\"L\", \"M\", \"Q\", \"H\"].includes(level)) throw new TypeError(\"QRCode needs a value and valid error correction level\");\n  const code = encode(0, level);\n  // Encode UTF-8 explicitly: the upstream default truncates non-Latin strings to bytes.\n  // Hermes hosts need not provide TextEncoder; preserve UTF-8 without a global polyfill.\n  const bytes: number[] = [];\n  for (const character of value) {\n    const raw = character.codePointAt(0)!;\n    const code = raw >= 0xd800 && raw <= 0xdfff ? 0xfffd : raw;\n    if (code < 0x80) bytes.push(code);\n    else if (code < 0x800) bytes.push(0xc0 | (code >> 6), 0x80 | (code & 63));\n    else if (code < 0x10000) bytes.push(0xe0 | (code >> 12), 0x80 | ((code >> 6) & 63), 0x80 | (code & 63));\n    else bytes.push(0xf0 | (code >> 18), 0x80 | ((code >> 12) & 63), 0x80 | ((code >> 6) & 63), 0x80 | (code & 63));\n  }\n  const binary = bytes.map(byte => String.fromCharCode(byte)).join(\"\");\n  code.addData(binary, \"Byte\");\n  try { code.make(); } catch { throw new RangeError(\"QRCode value exceeds the selected encoding capacity\"); }\n  const count = code.getModuleCount();\n  const cells = Array.from({ length: count }, (_, row) => Array.from({ length: count }, (_, column) => code.isDark(row, column)));\n  return { count, cells, quietZone: 4 as const };\n}\nexport function qrPath(matrix: ReturnType<typeof createQRMatrix>) {\n  return matrix.cells.flatMap((row, y) => row.flatMap((dark, x) => dark ? [`M${x + 4},${y + 4}h1v1h-1z`] : [])).join(\"\");\n}\nexport { qrCodeRecipe } from \"./qr-code-recipe.js\";\n"]}

package/dist/semantic-colors.d.ts

@@ -121,7 +121,7 @@ export declare const semanticColors: {
         readonly neutral: {
             readonly background: Readonly<{
                 source: "theme";
-                key: "surfaceAlt";
+                key: "bg";
                 alpha?: number;
             }>;
             readonly content: Readonly<{

package/dist/semantic-colors.js

@@ -36,7 +36,7 @@ export const semanticColors = {
             content: themeColor("onPrimary"),
         },
         neutral: {
-            background: themeColor("surfaceAlt"),
+            background: themeColor("bg"),
             content: themeColor("text"),
             // A control outline is a border role. `textSub` made a resting neutral
             // action read heavier than the selected control beside it.

package/dist/semantic-colors.js.map

@@ -1 +1 @@
-{"version":3,"file":"semantic-colors.js","sourceRoot":"","sources":["../src/semantic-colors.ts"],"names":[],"mappings":"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","sourcesContent":["import { accentColor, themeColor } from \"./color-references.js\";\n\n/**\n * Stable role aliases above the legacy ThemeColors key set. New recipes should\n * prefer these roles so the underlying theme shape can evolve independently.\n */\nexport const semanticColors = {\n  canvas: themeColor(\"bg\"),\n  surface: {\n    default: themeColor(\"surface\"),\n    sunken: themeColor(\"surfaceAlt\"),\n    raised: themeColor(\"bg\"),\n    brand: themeColor(\"surfaceAccent\"),\n  },\n  content: {\n    primary: themeColor(\"text\"),\n    body: themeColor(\"textBody\"),\n    secondary: themeColor(\"textMuted\"),\n    tertiary: themeColor(\"textSub\"),\n    decorative: themeColor(\"textWeak\"),\n    brand: themeColor(\"contentBrand\"),\n    danger: themeColor(\"danger\"),\n    inverse: themeColor(\"onPrimary\"),\n  },\n  border: {\n    subtle: themeColor(\"border\", 0.7),\n    default: themeColor(\"border\"),\n    /** Resting outline of an interactive control. */\n    control: themeColor(\"borderControl\"),\n    strong: themeColor(\"textWeak\"),\n    focus: themeColor(\"contentBrand\"),\n    danger: themeColor(\"danger\"),\n  },\n  action: {\n    brand: {\n      background: themeColor(\"primary\"),\n      content: themeColor(\"onPrimary\"),\n    },\n    neutral: {\n      background: themeColor(\"surfaceAlt\"),\n      content: themeColor(\"text\"),\n      // A control outline is a border role. `textSub` made a resting neutral\n      // action read heavier than the selected control beside it.\n      border: themeColor(\"borderControl\"),\n    },\n    danger: {\n      background: themeColor(\"dangerFill\"),\n      content: themeColor(\"onDanger\"),\n    },\n  },\n  feedback: {\n    info: {\n      foreground: accentColor(\"info\"),\n      background: accentColor(\"info\", 0.1),\n      badgeBackground: accentColor(\"info\", 0.1),\n      border: accentColor(\"info\", 0.3),\n    },\n    success: {\n      foreground: accentColor(\"success\"),\n      background: accentColor(\"success\", 0.1),\n      badgeBackground: accentColor(\"success\", 0.1),\n      border: accentColor(\"success\", 0.3),\n    },\n    warning: {\n      foreground: accentColor(\"warning\"),\n      background: accentColor(\"warning\", 0.1),\n      badgeBackground: accentColor(\"warning\", 0.1),\n      border: accentColor(\"warning\", 0.3),\n    },\n    attention: {\n      foreground: accentColor(\"attention\"),\n      background: accentColor(\"attention\", 0.1),\n      badgeBackground: accentColor(\"attention\", 0.1),\n      border: accentColor(\"attention\", 0.3),\n    },\n    danger: {\n      foreground: themeColor(\"danger\"),\n      background: themeColor(\"danger\", 0.1),\n      badgeBackground: themeColor(\"danger\", 0.1),\n      border: themeColor(\"danger\", 0.3),\n    },\n  },\n  interaction: {\n    hover: themeColor(\"text\", 0.06),\n    focus: themeColor(\"contentBrand\", 0.08),\n    pressed: themeColor(\"text\", 0.1),\n    selected: themeColor(\"primary\", 0.1),\n  },\n} as const;\n"]}
+{"version":3,"file":"semantic-colors.js","sourceRoot":"","sources":["../src/semantic-colors.ts"],"names":[],"mappings":"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","sourcesContent":["import { accentColor, themeColor } from \"./color-references.js\";\n\n/**\n * Stable role aliases above the legacy ThemeColors key set. New recipes should\n * prefer these roles so the underlying theme shape can evolve independently.\n */\nexport const semanticColors = {\n  canvas: themeColor(\"bg\"),\n  surface: {\n    default: themeColor(\"surface\"),\n    sunken: themeColor(\"surfaceAlt\"),\n    raised: themeColor(\"bg\"),\n    brand: themeColor(\"surfaceAccent\"),\n  },\n  content: {\n    primary: themeColor(\"text\"),\n    body: themeColor(\"textBody\"),\n    secondary: themeColor(\"textMuted\"),\n    tertiary: themeColor(\"textSub\"),\n    decorative: themeColor(\"textWeak\"),\n    brand: themeColor(\"contentBrand\"),\n    danger: themeColor(\"danger\"),\n    inverse: themeColor(\"onPrimary\"),\n  },\n  border: {\n    subtle: themeColor(\"border\", 0.7),\n    default: themeColor(\"border\"),\n    /** Resting outline of an interactive control. */\n    control: themeColor(\"borderControl\"),\n    strong: themeColor(\"textWeak\"),\n    focus: themeColor(\"contentBrand\"),\n    danger: themeColor(\"danger\"),\n  },\n  action: {\n    brand: {\n      background: themeColor(\"primary\"),\n      content: themeColor(\"onPrimary\"),\n    },\n    neutral: {\n      background: themeColor(\"bg\"),\n      content: themeColor(\"text\"),\n      // A control outline is a border role. `textSub` made a resting neutral\n      // action read heavier than the selected control beside it.\n      border: themeColor(\"borderControl\"),\n    },\n    danger: {\n      background: themeColor(\"dangerFill\"),\n      content: themeColor(\"onDanger\"),\n    },\n  },\n  feedback: {\n    info: {\n      foreground: accentColor(\"info\"),\n      background: accentColor(\"info\", 0.1),\n      badgeBackground: accentColor(\"info\", 0.1),\n      border: accentColor(\"info\", 0.3),\n    },\n    success: {\n      foreground: accentColor(\"success\"),\n      background: accentColor(\"success\", 0.1),\n      badgeBackground: accentColor(\"success\", 0.1),\n      border: accentColor(\"success\", 0.3),\n    },\n    warning: {\n      foreground: accentColor(\"warning\"),\n      background: accentColor(\"warning\", 0.1),\n      badgeBackground: accentColor(\"warning\", 0.1),\n      border: accentColor(\"warning\", 0.3),\n    },\n    attention: {\n      foreground: accentColor(\"attention\"),\n      background: accentColor(\"attention\", 0.1),\n      badgeBackground: accentColor(\"attention\", 0.1),\n      border: accentColor(\"attention\", 0.3),\n    },\n    danger: {\n      foreground: themeColor(\"danger\"),\n      background: themeColor(\"danger\", 0.1),\n      badgeBackground: themeColor(\"danger\", 0.1),\n      border: themeColor(\"danger\", 0.3),\n    },\n  },\n  interaction: {\n    hover: themeColor(\"text\", 0.06),\n    focus: themeColor(\"contentBrand\", 0.08),\n    pressed: themeColor(\"text\", 0.1),\n    selected: themeColor(\"primary\", 0.1),\n  },\n} as const;\n"]}

package/dist/showcase.d.ts

@@ -56,7 +56,7 @@ export declare const showcaseEnvironmentMatrix: readonly [{
 }];
 /** Bridges documentation fixtures to the same environment contract products consume. */
 export declare function getShowcaseEnvironmentInput(environment: ShowcaseEnvironment): DesignSystemEnvironmentInput;
-export type ShowcaseScenarioId = "contract" | "default" | "dark" | "long-copy" | "large-text" | "rtl" | "reduced-motion" | "accessibility" | "keyboard" | "platform-parity";
+export type ShowcaseScenarioId = "contract" | "default" | "dark" | "long-copy" | "large-text" | "rtl" | "reduced-motion" | "accessibility" | "keyboard" | "native-actions" | "platform-parity";
 export type ShowcaseSurface = "contract" | "web" | "native";
 export type ShowcaseScenario = Readonly<{
     id: ShowcaseScenarioId;
@@ -99,6 +99,10 @@ export declare const showcaseScenarios: readonly [{
     readonly id: "keyboard";
     readonly label: "Keyboard";
     readonly description: "Focus order and documented keyboard behavior run as interaction tests.";
+}, {
+    readonly id: "native-actions";
+    readonly label: "Native actions";
+    readonly description: "Accessible host actions and their state transitions run against the Native renderer.";
 }, {
     readonly id: "platform-parity";
     readonly label: "Web / Native parity";

package/dist/showcase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"showcase.d.ts","sourceRoot":"","sources":["../src/showcase.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"showcase.d.ts","sourceRoot":"","sources":["../src/showcase.ts"],"names":[],"mappings":"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"}