@hjmds/design-contracts 1.1.1 → 1.2.0

package/dist/sheet.js.map

@@ -1 +1 @@
-{"version":3,"file":"sheet.js","sourceRoot":"","sources":["../src/sheet.ts"],"names":[],"mappings":"AAsCA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,WAAW,EAAE,IAAI;IACjB,gBAAgB,EAAE,KAAK;IACvB,cAAc,EAAE,IAAI;IACpB,mBAAmB,EAAE,IAAI;IACzB,YAAY,EAAE,KAAK;CACkB,CAAC;AAExC;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,MAA0B,EAC1B,IAAa,EACb,SAA6B,qBAAqB;IAElD,IAAI,MAAM,KAAK,cAAc;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,CAAC,MAAM,CAAC,WAAW;QAAE,OAAO,KAAK,CAAC;IACtC,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,gBAAgB;QAAE,OAAO,KAAK,CAAC;IACnD,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,cAAc,CAAC;IACvD,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QAC7C,OAAO,MAAM,CAAC,mBAAmB,CAAC;IACpC,CAAC;IACD,IAAI,MAAM,KAAK,OAAO;QAAE,OAAO,MAAM,CAAC,YAAY,CAAC;IACnD,OAAO,IAAI,CAAC;AACd,CAAC;AAaD;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,gBAAgB,GAAG,KAAK;IAExB,IAAI,QAAQ,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,IAAI,WAAW,GAAkB,gBAAgB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;IACpE,IAAI,cAAc,GAAG,KAAK,CAAC;IAC3B,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAU,CAAC;IAE3C,OAAO;QACL,IAAI;YACF,IAAI,WAAW,KAAK,IAAI;gBAAE,OAAO,WAAW,CAAC;YAC7C,QAAQ,IAAI,CAAC,CAAC;YACd,WAAW,GAAG,QAAQ,CAAC;YACvB,cAAc,GAAG,KAAK,CAAC;YACvB,OAAO,WAAW,CAAC;QACrB,CAAC;QACD,YAAY;YACV,IAAI,WAAW,KAAK,IAAI;gBAAE,OAAO,IAAI,CAAC;YACtC,MAAM,KAAK,GAAG,WAAW,CAAC;YAC1B,WAAW,GAAG,IAAI,CAAC;YACnB,cAAc,GAAG,KAAK,CAAC;YACvB,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC5B,OAAO,KAAK,CAAC;QACf,CAAC;QACD,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,qBAAqB;YACvD,IAAI,WAAW,KAAK,IAAI,IAAI,cAAc;gBAAE,OAAO,KAAK,CAAC;YACzD,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC;gBAAE,OAAO,KAAK,CAAC;YACzD,cAAc,GAAG,IAAI,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,eAAe,CAAC,KAAK;YACnB,OAAO,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["/** Why an open Sheet is being asked to close. */\nexport type SheetDismissReason =\n  | \"close-action\"\n  | \"escape\"\n  | \"back\"\n  | \"outside\"\n  | \"swipe\"\n  | \"programmatic\";\n\n/**\n * `trigger` only opens a Sheet. Every close reports the concrete dismiss reason\n * so renderers and product analytics do not have to infer it from platform events.\n */\nexport type SheetOpenChangeDetails = Readonly<{\n  reason: \"trigger\" | SheetDismissReason;\n}>;\n\n/** User-dismiss policy. A controlled owner may always close programmatically. */\nexport type SheetDismissPolicy = Readonly<{\n  dismissible: boolean;\n  dismissWhileBusy: boolean;\n  outsideDismiss: boolean;\n  escapeOrBackDismiss: boolean;\n  swipeDismiss: boolean;\n}>;\n\nexport type SheetOpenState =\n  | Readonly<{\n      open: boolean;\n      defaultOpen?: never;\n      onOpenChange(open: boolean, detail: SheetOpenChangeDetails): void;\n    }>\n  | Readonly<{\n      open?: never;\n      defaultOpen?: boolean;\n      onOpenChange?: (open: boolean, detail: SheetOpenChangeDetails) => void;\n    }>;\n\nexport const sheetBehaviorDefaults = {\n  dismissible: true,\n  dismissWhileBusy: false,\n  outsideDismiss: true,\n  escapeOrBackDismiss: true,\n  swipeDismiss: false,\n} as const satisfies SheetDismissPolicy;\n\n/**\n * Resolves an attempted close without platform knowledge. Programmatic close is\n * intentionally an owner override: a controlled `open={false}` cannot be vetoed\n * by a renderer, even while the Sheet is busy or not user-dismissible.\n */\nexport function canDismissSheet(\n  reason: SheetDismissReason,\n  busy: boolean,\n  policy: SheetDismissPolicy = sheetBehaviorDefaults,\n): boolean {\n  if (reason === \"programmatic\") return true;\n  if (!policy.dismissible) return false;\n  if (busy && !policy.dismissWhileBusy) return false;\n  if (reason === \"outside\") return policy.outsideDismiss;\n  if (reason === \"escape\" || reason === \"back\") {\n    return policy.escapeOrBackDismiss;\n  }\n  if (reason === \"swipe\") return policy.swipeDismiss;\n  return true;\n}\n\nexport type SheetLifecycle = Readonly<{\n  open(): number;\n  beginDismiss(): number | null;\n  requestClose(\n    reason: SheetDismissReason,\n    busy: boolean,\n    policy?: SheetDismissPolicy,\n  ): boolean;\n  completeDismiss(cycle: number): boolean;\n}>;\n\n/**\n * Makes persistent native Modal renderers settle each visible cycle once.\n * Platform adapters still decide when native dismissal has actually completed.\n */\nexport function createSheetLifecycle(\n  initiallyVisible = false,\n): SheetLifecycle {\n  let sequence = initiallyVisible ? 1 : 0;\n  let activeCycle: number | null = initiallyVisible ? sequence : null;\n  let closeRequested = false;\n  const dismissingCycles = new Set<number>();\n\n  return {\n    open() {\n      if (activeCycle !== null) return activeCycle;\n      sequence += 1;\n      activeCycle = sequence;\n      closeRequested = false;\n      return activeCycle;\n    },\n    beginDismiss() {\n      if (activeCycle === null) return null;\n      const cycle = activeCycle;\n      activeCycle = null;\n      closeRequested = false;\n      dismissingCycles.add(cycle);\n      return cycle;\n    },\n    requestClose(reason, busy, policy = sheetBehaviorDefaults) {\n      if (activeCycle === null || closeRequested) return false;\n      if (!canDismissSheet(reason, busy, policy)) return false;\n      closeRequested = true;\n      return true;\n    },\n    completeDismiss(cycle) {\n      return dismissingCycles.delete(cycle);\n    },\n  };\n}\n"]}
+{"version":3,"file":"sheet.js","sourceRoot":"","sources":["../src/sheet.ts"],"names":[],"mappings":"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","sourcesContent":["/** Why an open Sheet is being asked to close. */\nexport type SheetDismissReason =\n  | \"close-action\"\n  | \"escape\"\n  | \"back\"\n  | \"outside\"\n  | \"swipe\"\n  | \"programmatic\";\n\n/**\n * `trigger` only opens a Sheet. Every close reports the concrete dismiss reason\n * so renderers and product analytics do not have to infer it from platform events.\n */\nexport type SheetOpenChangeDetails = Readonly<{\n  reason: \"trigger\" | SheetDismissReason;\n}>;\n\n/** User-dismiss policy. A controlled owner may always close programmatically. */\nexport type SheetDismissPolicy = Readonly<{\n  dismissible: boolean;\n  dismissWhileBusy: boolean;\n  outsideDismiss: boolean;\n  escapeOrBackDismiss: boolean;\n  swipeDismiss: boolean;\n}>;\n\nexport type SheetOpenState =\n  | Readonly<{\n      open: boolean;\n      defaultOpen?: never;\n      onOpenChange(open: boolean, detail: SheetOpenChangeDetails): void;\n    }>\n  | Readonly<{\n      open?: never;\n      defaultOpen?: boolean;\n      onOpenChange?: (open: boolean, detail: SheetOpenChangeDetails) => void;\n    }>;\n\nexport const sheetBehaviorDefaults = {\n  dismissible: true,\n  dismissWhileBusy: false,\n  outsideDismiss: true,\n  escapeOrBackDismiss: true,\n  swipeDismiss: false,\n} as const satisfies SheetDismissPolicy;\n\n/**\n * Resolves an attempted close without platform knowledge. Programmatic close is\n * intentionally an owner override: a controlled `open={false}` cannot be vetoed\n * by a renderer, even while the Sheet is busy or not user-dismissible.\n */\nexport function canDismissSheet(\n  reason: SheetDismissReason,\n  busy: boolean,\n  policy: SheetDismissPolicy = sheetBehaviorDefaults,\n): boolean {\n  if (reason === \"programmatic\") return true;\n  if (!policy.dismissible) return false;\n  if (busy && !policy.dismissWhileBusy) return false;\n  if (reason === \"outside\") return policy.outsideDismiss;\n  if (reason === \"escape\" || reason === \"back\") {\n    return policy.escapeOrBackDismiss;\n  }\n  if (reason === \"swipe\") return policy.swipeDismiss;\n  return true;\n}\n\nexport type SheetLifecycle = Readonly<{\n  open(): number;\n  beginDismiss(): number | null;\n  requestClose(\n    reason: SheetDismissReason,\n    busy: boolean,\n    policy?: SheetDismissPolicy,\n  ): boolean;\n  completeDismiss(cycle: number): boolean;\n}>;\n\n/**\n * Makes persistent native Modal renderers settle each visible cycle once.\n * Platform adapters still decide when native dismissal has actually completed.\n */\nexport function createSheetLifecycle(\n  initiallyVisible = false,\n): SheetLifecycle {\n  let sequence = initiallyVisible ? 1 : 0;\n  let activeCycle: number | null = initiallyVisible ? sequence : null;\n  let closeRequested = false;\n  const dismissingCycles = new Set<number>();\n\n  return {\n    open() {\n      if (activeCycle !== null) return activeCycle;\n      sequence += 1;\n      activeCycle = sequence;\n      closeRequested = false;\n      return activeCycle;\n    },\n    beginDismiss() {\n      if (activeCycle === null) return null;\n      const cycle = activeCycle;\n      activeCycle = null;\n      closeRequested = false;\n      dismissingCycles.add(cycle);\n      return cycle;\n    },\n    requestClose(reason, busy, policy = sheetBehaviorDefaults) {\n      if (activeCycle === null || closeRequested) return false;\n      if (!canDismissSheet(reason, busy, policy)) return false;\n      closeRequested = true;\n      return true;\n    },\n    completeDismiss(cycle) {\n      return dismissingCycles.delete(cycle);\n    },\n  };\n}\n\n/**\n * 사용자가 시트 높이를 바꾸는 축이다. `sheetRecipe.sizes`는 제품이 여는 높이를 정하고,\n * 이것은 열린 뒤 **사용자가** 단계를 옮기는 문제다 — 지도 위 목록처럼 \"조금 보기 ↔ 크게\n * 보기\"가 필요한 화면이 그 자리다.\n *\n * `auto`는 단계에 들어가지 않는다. 내용이 정하는 높이라 \"다음 단계\"가 정의되지 않는다.\n *\n * **드래그 물리는 여기 없다.** 이 계약은 단계 목록과 \"다음/이전 단계가 무엇인가\"만 갖고,\n * 손가락 속도·관성·고무줄은 넣지 않았다 — 실제 제품 화면 없이 그 값을 정하면 기기에서\n * 다시 다 고치게 된다. 대신 **핸들이 접근 가능한 컨트롤**이라 키보드·보조기기에서도\n * 단계를 옮길 수 있다. 제스처는 제품이 얹고, 결과를 같은 `onDetentChange`로 보낸다.\n */\nexport type SheetDetent = \"medium\" | \"large\" | \"full\";\n\nexport const sheetDetentOrder = [\"medium\", \"large\", \"full\"] as const satisfies readonly SheetDetent[];\n\nexport function validateSheetDetents(detents: readonly SheetDetent[]): void {\n  if (detents.length === 0) {\n    throw new RangeError(\"Sheet detents must not be empty\");\n  }\n  const seen = new Set<SheetDetent>();\n  for (const detent of detents) {\n    if (!sheetDetentOrder.includes(detent)) {\n      throw new TypeError(`Unsupported Sheet detent: ${String(detent)}`);\n    }\n    if (seen.has(detent)) throw new TypeError(`Duplicate Sheet detent: ${detent}`);\n    seen.add(detent);\n  }\n  const ordered = [...detents].sort(\n    (left, right) => sheetDetentOrder.indexOf(left) - sheetDetentOrder.indexOf(right),\n  );\n  if (ordered.some((detent, index) => detent !== detents[index])) {\n    /*\n      정렬을 대신 해 주지 않는 이유: 순서가 곧 \"다음 단계\"의 의미라서, 제품이 적은 순서와\n      실제 이동 순서가 다르면 디버깅할 수 없는 화면이 된다.\n    */\n    throw new TypeError(\"Sheet detents must be listed from smallest to largest\");\n  }\n}\n\nexport function resolveNextSheetDetent(\n  detents: readonly SheetDetent[],\n  current: SheetDetent,\n  direction: \"expand\" | \"collapse\",\n): SheetDetent | null {\n  validateSheetDetents(detents);\n  const index = detents.indexOf(current);\n  if (index === -1) {\n    throw new RangeError(`Sheet current detent is not in the list: ${current}`);\n  }\n  const next = direction === \"expand\" ? index + 1 : index - 1;\n  /** 끝에서는 `null`이다 — renderer가 \"더 갈 수 없다\"를 컨트롤 상태로 표현한다. */\n  return next < 0 || next >= detents.length ? null : detents[next]!;\n}\n\n"]}

package/dist/sidebar.d.ts

@@ -0,0 +1,168 @@
+import type { LinkDestination } from "./link.js";
+/**
+ * 데스크톱 웹의 세로 내비게이션. 관리자 화면·문서·작업 도구처럼 넓은 화면에서 좌우로
+ * 나뉜 셸의 왼쪽이다.
+ *
+ * `BottomNavigation`과 같은 문제를 푸는 다른 표면이 아니다 — 두 축이 다르다.
+ * BottomNavigation은 **3~5개 최상위 목적지**를 모바일 하단에 고정하고 그룹이 없다.
+ * Sidebar는 **그룹이 있는 긴 목록**이고 접힌다. 한 컴포넌트의 `orientation` 축으로
+ * 합치면 "그룹이 있는 하단 탭바"라는 존재하지 않는 조합이 타입에 생긴다.
+ *
+ * `Layout`의 sidebar 영역과도 다르다. Layout은 **자리**(폭·순서·반응형 규칙)를 갖고
+ * 내용을 모른다. 이 계약은 그 자리에 들어가는 **내비게이션 자체**다.
+ */
+export type SidebarItemDescriptor<Id extends string = string> = Readonly<{
+    id: Id;
+    label: string;
+    destination?: LinkDestination;
+    /** 접힌 상태에서도 보이는 상태 수치. Badge/CounterBadge가 그린다. */
+    badgeCount?: number;
+    disabled?: boolean;
+}>;
+export type SidebarGroupDescriptor<Id extends string = string, GroupId extends string = string> = Readonly<{
+    id: GroupId;
+    /** 그룹 제목. 없으면 구분선만 있는 묶음이다. */
+    label?: string;
+    items: readonly SidebarItemDescriptor<Id>[];
+}>;
+export type SidebarDescriptor<Id extends string = string, GroupId extends string = string> = Readonly<{
+    accessibilityLabel: string;
+    groups: readonly SidebarGroupDescriptor<Id, GroupId>[];
+    /** 현재 위치. 링크 내비게이션의 `aria-current`가 된다. */
+    currentId: Id | null;
+}>;
+export declare function validateSidebarDescriptor<Id extends string, GroupId extends string>(descriptor: SidebarDescriptor<Id, GroupId>): void;
+/**
+ * 접힘은 **표시 밀도**이지 내용이 아니다. 접혀도 항목은 모두 남고 라벨만 숨는다 —
+ * 접을 때 항목을 빼면 "접었더니 메뉴가 사라졌다"가 되고, 그건 다른 컴포넌트다.
+ * 라벨이 숨으면 아이콘만으로는 이름을 알 수 없으므로 renderer가 접근성 이름을 유지한다.
+ */
+export declare const sidebarDefaults: {
+    readonly collapsed: false;
+};
+export declare const sidebarRecipe: {
+    readonly slots: readonly ["root", "group", "groupLabel", "item", "label", "badge", "toggle"];
+    readonly defaults: {
+        readonly collapsed: false;
+    };
+    readonly widths: {
+        readonly expanded: 260;
+        readonly collapsed: 72;
+    };
+    readonly background: Readonly<{
+        source: "theme";
+        key: "surfaceAlt";
+        alpha?: number;
+    }>;
+    readonly border: Readonly<{
+        source: "theme";
+        key: "border";
+        alpha?: number;
+    }>;
+    readonly borderWidth: 1;
+    readonly paddingVertical: 12;
+    readonly paddingHorizontal: 8;
+    readonly gap: 4;
+    readonly groupGap: 16;
+    readonly groupLabel: {
+        readonly color: Readonly<{
+            source: "theme";
+            key: "textMuted";
+            alpha?: number;
+        }>;
+        readonly textVariant: "label";
+        readonly paddingHorizontal: 12;
+        readonly paddingVertical: 4;
+    };
+    readonly item: {
+        readonly minHeight: 44;
+        readonly paddingHorizontal: 12;
+        readonly gap: 12;
+        readonly radius: "md";
+        readonly label: {
+            readonly color: Readonly<{
+                source: "theme";
+                key: "textBody";
+                alpha?: number;
+            }>;
+            readonly textVariant: "body";
+        };
+        readonly description: {
+            readonly color: Readonly<{
+                source: "theme";
+                key: "textMuted";
+                alpha?: number;
+            }>;
+            readonly textVariant: "label";
+        };
+        readonly highlightedBackground: Readonly<{
+            source: "theme";
+            key: "text";
+            alpha?: number;
+        }>;
+        readonly focus: {
+            readonly color: Readonly<{
+                source: "theme";
+                key: "contentBrand";
+                alpha?: number;
+            }>;
+            readonly width: 2;
+            readonly offset: 2;
+        };
+        readonly selectedBackground: Readonly<{
+            source: "theme";
+            key: "primary";
+            alpha?: number;
+        }>;
+        readonly selectedIndicator: Readonly<{
+            source: "theme";
+            key: "contentBrand";
+            alpha?: number;
+        }>;
+        readonly danger: Readonly<{
+            source: "theme";
+            key: "danger";
+            alpha?: number;
+        }>;
+    };
+    readonly itemRadius: 12;
+    readonly itemMinHeight: 44;
+    readonly states: {
+        readonly focus: {
+            readonly color: Readonly<{
+                source: "theme";
+                key: "contentBrand";
+                alpha?: number;
+            }>;
+            readonly width: 2;
+            readonly offset: 2;
+        };
+    };
+};
+export declare const sidebarBehavior: {
+    readonly controlled: readonly ["collapsed", "defaultCollapsed", "onCollapsedChange"];
+    readonly inputs: readonly ["groups", "currentId", "accessibilityLabel"];
+    readonly events: readonly ["onNavigate"];
+    readonly defaults: {
+        readonly collapsed: false;
+    };
+    readonly stateAxes: {
+        readonly availability: readonly ["enabled", "disabled"];
+        readonly value: readonly ["selected"];
+        readonly interaction: readonly ["idle", "hover", "focusVisible", "pressed"];
+    };
+    readonly web: {
+        readonly roles: readonly ["navigation", "list", "listitem", "link", "button"];
+        readonly keyboard: readonly ["Tab", "Enter"];
+        /** Each item is a link in document order; no roving focus and no arrow-key grid. */
+        readonly focus: "native";
+    };
+    /** Web-only: a phone uses BottomNavigation, and a native tablet split view is a navigator concern. */
+    readonly native: {
+        readonly roles: readonly [];
+        readonly states: readonly [];
+        readonly actions: readonly [];
+    };
+    readonly scenarios: readonly ["the-current-item-is-announced-with-aria-current-not-only-painted", "collapsing-hides-labels-but-keeps-every-item-and-its-accessible-name", "groups-are-real-list-groupings-with-their-own-label-not-visual-dividers-only", "an-item-badge-stays-visible-while-collapsed-because-it-is-the-reason-to-look", "bottom-navigation-owns-the-three-to-five-destination-mobile-case-this-contract-never-adds-it", "layout-owns-where-the-sidebar-sits-this-contract-owns-what-is-inside-it"];
+};
+//# sourceMappingURL=sidebar.d.ts.map

package/dist/sidebar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar.d.ts","sourceRoot":"","sources":["../src/sidebar.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAIjD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,qBAAqB,CAAC,EAAE,SAAS,MAAM,GAAG,MAAM,IAAI,QAAQ,CAAC;IACvE,EAAE,EAAE,EAAE,CAAC;IACP,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC,CAAC;AAEH,MAAM,MAAM,sBAAsB,CAChC,EAAE,SAAS,MAAM,GAAG,MAAM,EAC1B,OAAO,SAAS,MAAM,GAAG,MAAM,IAC7B,QAAQ,CAAC;IACX,EAAE,EAAE,OAAO,CAAC;IACZ,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,qBAAqB,CAAC,EAAE,CAAC,EAAE,CAAC;CAC7C,CAAC,CAAC;AAEH,MAAM,MAAM,iBAAiB,CAC3B,EAAE,SAAS,MAAM,GAAG,MAAM,EAC1B,OAAO,SAAS,MAAM,GAAG,MAAM,IAC7B,QAAQ,CAAC;IACX,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,SAAS,sBAAsB,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,CAAC;IACvD,2CAA2C;IAC3C,SAAS,EAAE,EAAE,GAAG,IAAI,CAAC;CACtB,CAAC,CAAC;AAQH,wBAAgB,yBAAyB,CAAC,EAAE,SAAS,MAAM,EAAE,OAAO,SAAS,MAAM,EACjF,UAAU,EAAE,iBAAiB,CAAC,EAAE,EAAE,OAAO,CAAC,GACzC,IAAI,CA4BN;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe;;CAEyB,CAAC;AAEtD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCzB,CAAC;AAEF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;QAaxB,oFAAoF;;;IAGtF,sGAAsG;;;;;;;CAUnE,CAAC"}

package/dist/sidebar.js

@@ -0,0 +1,98 @@
+import { collectionItemContract, focusIndicatorContract } from "./component-contracts.js";
+import { control, radius, spacing, stroke } from "./foundations.js";
+import { semanticColors } from "./semantic-colors.js";
+function assertNonEmpty(value, field) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new TypeError(`Sidebar ${field} must not be empty`);
+    }
+}
+export function validateSidebarDescriptor(descriptor) {
+    assertNonEmpty(descriptor.accessibilityLabel, "accessibilityLabel");
+    if (!Array.isArray(descriptor.groups) || descriptor.groups.length === 0) {
+        throw new RangeError("Sidebar must contain at least one group");
+    }
+    const itemIds = new Set();
+    const groupIds = new Set();
+    for (const group of descriptor.groups) {
+        assertNonEmpty(group.id, "group id");
+        if (groupIds.has(group.id))
+            throw new TypeError(`Duplicate Sidebar group id: ${group.id}`);
+        groupIds.add(group.id);
+        if (group.label !== undefined)
+            assertNonEmpty(group.label, `group ${group.id} label`);
+        if (!Array.isArray(group.items) || group.items.length === 0) {
+            throw new RangeError(`Sidebar group ${group.id} must contain at least one item`);
+        }
+        for (const item of group.items) {
+            assertNonEmpty(item.id, "item id");
+            assertNonEmpty(item.label, `item ${item.id} label`);
+            if (itemIds.has(item.id))
+                throw new TypeError(`Duplicate Sidebar item id: ${item.id}`);
+            itemIds.add(item.id);
+            if (item.badgeCount !== undefined && (!Number.isInteger(item.badgeCount) || item.badgeCount < 0)) {
+                throw new RangeError(`Sidebar item ${item.id} badgeCount must be a non-negative integer`);
+            }
+        }
+    }
+    if (descriptor.currentId !== null && !itemIds.has(descriptor.currentId)) {
+        throw new RangeError(`Sidebar currentId does not match any item: ${String(descriptor.currentId)}`);
+    }
+}
+/**
+ * 접힘은 **표시 밀도**이지 내용이 아니다. 접혀도 항목은 모두 남고 라벨만 숨는다 —
+ * 접을 때 항목을 빼면 "접었더니 메뉴가 사라졌다"가 되고, 그건 다른 컴포넌트다.
+ * 라벨이 숨으면 아이콘만으로는 이름을 알 수 없으므로 renderer가 접근성 이름을 유지한다.
+ */
+export const sidebarDefaults = {
+    collapsed: false,
+};
+export const sidebarRecipe = {
+    slots: ["root", "group", "groupLabel", "item", "label", "badge", "toggle"],
+    defaults: sidebarDefaults,
+    widths: { expanded: 260, collapsed: 72 },
+    background: semanticColors.surface.sunken,
+    border: semanticColors.border.default,
+    borderWidth: stroke.default,
+    paddingVertical: spacing.sm,
+    paddingHorizontal: spacing.xs,
+    gap: spacing.xxs,
+    groupGap: spacing.md,
+    groupLabel: {
+        color: semanticColors.content.secondary,
+        textVariant: "label",
+        paddingHorizontal: spacing.sm,
+        paddingVertical: spacing.xxs,
+    },
+    item: collectionItemContract,
+    itemRadius: radius.md,
+    itemMinHeight: control.minTouchTarget,
+    states: { focus: focusIndicatorContract },
+};
+export const sidebarBehavior = {
+    controlled: ["collapsed", "defaultCollapsed", "onCollapsedChange"],
+    inputs: ["groups", "currentId", "accessibilityLabel"],
+    events: ["onNavigate"],
+    defaults: sidebarDefaults,
+    stateAxes: {
+        availability: ["enabled", "disabled"],
+        value: ["selected"],
+        interaction: ["idle", "hover", "focusVisible", "pressed"],
+    },
+    web: {
+        roles: ["navigation", "list", "listitem", "link", "button"],
+        keyboard: ["Tab", "Enter"],
+        /** Each item is a link in document order; no roving focus and no arrow-key grid. */
+        focus: "native",
+    },
+    /** Web-only: a phone uses BottomNavigation, and a native tablet split view is a navigator concern. */
+    native: { roles: [], states: [], actions: [] },
+    scenarios: [
+        "the-current-item-is-announced-with-aria-current-not-only-painted",
+        "collapsing-hides-labels-but-keeps-every-item-and-its-accessible-name",
+        "groups-are-real-list-groupings-with-their-own-label-not-visual-dividers-only",
+        "an-item-badge-stays-visible-while-collapsed-because-it-is-the-reason-to-look",
+        "bottom-navigation-owns-the-three-to-five-destination-mobile-case-this-contract-never-adds-it",
+        "layout-owns-where-the-sidebar-sits-this-contract-owns-what-is-inside-it",
+    ],
+};
+//# sourceMappingURL=sidebar.js.map

package/dist/sidebar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidebar.js","sourceRoot":"","sources":["../src/sidebar.ts"],"names":[],"mappings":"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","sourcesContent":["import type { BehaviorContract } from \"./behaviors.js\";\nimport type { ColorReference } from \"./color-references.js\";\nimport { collectionItemContract, focusIndicatorContract } from \"./component-contracts.js\";\nimport type { LinkDestination } from \"./link.js\";\nimport { control, radius, spacing, stroke } from \"./foundations.js\";\nimport { semanticColors } from \"./semantic-colors.js\";\n\n/**\n * 데스크톱 웹의 세로 내비게이션. 관리자 화면·문서·작업 도구처럼 넓은 화면에서 좌우로\n * 나뉜 셸의 왼쪽이다.\n *\n * `BottomNavigation`과 같은 문제를 푸는 다른 표면이 아니다 — 두 축이 다르다.\n * BottomNavigation은 **3~5개 최상위 목적지**를 모바일 하단에 고정하고 그룹이 없다.\n * Sidebar는 **그룹이 있는 긴 목록**이고 접힌다. 한 컴포넌트의 `orientation` 축으로\n * 합치면 \"그룹이 있는 하단 탭바\"라는 존재하지 않는 조합이 타입에 생긴다.\n *\n * `Layout`의 sidebar 영역과도 다르다. Layout은 **자리**(폭·순서·반응형 규칙)를 갖고\n * 내용을 모른다. 이 계약은 그 자리에 들어가는 **내비게이션 자체**다.\n */\nexport type SidebarItemDescriptor<Id extends string = string> = Readonly<{\n  id: Id;\n  label: string;\n  destination?: LinkDestination;\n  /** 접힌 상태에서도 보이는 상태 수치. Badge/CounterBadge가 그린다. */\n  badgeCount?: number;\n  disabled?: boolean;\n}>;\n\nexport type SidebarGroupDescriptor<\n  Id extends string = string,\n  GroupId extends string = string,\n> = Readonly<{\n  id: GroupId;\n  /** 그룹 제목. 없으면 구분선만 있는 묶음이다. */\n  label?: string;\n  items: readonly SidebarItemDescriptor<Id>[];\n}>;\n\nexport type SidebarDescriptor<\n  Id extends string = string,\n  GroupId extends string = string,\n> = Readonly<{\n  accessibilityLabel: string;\n  groups: readonly SidebarGroupDescriptor<Id, GroupId>[];\n  /** 현재 위치. 링크 내비게이션의 `aria-current`가 된다. */\n  currentId: Id | null;\n}>;\n\nfunction assertNonEmpty(value: string, field: string): void {\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    throw new TypeError(`Sidebar ${field} must not be empty`);\n  }\n}\n\nexport function validateSidebarDescriptor<Id extends string, GroupId extends string>(\n  descriptor: SidebarDescriptor<Id, GroupId>,\n): void {\n  assertNonEmpty(descriptor.accessibilityLabel, \"accessibilityLabel\");\n  if (!Array.isArray(descriptor.groups) || descriptor.groups.length === 0) {\n    throw new RangeError(\"Sidebar must contain at least one group\");\n  }\n  const itemIds = new Set<Id>();\n  const groupIds = new Set<GroupId>();\n  for (const group of descriptor.groups) {\n    assertNonEmpty(group.id, \"group id\");\n    if (groupIds.has(group.id)) throw new TypeError(`Duplicate Sidebar group id: ${group.id}`);\n    groupIds.add(group.id);\n    if (group.label !== undefined) assertNonEmpty(group.label, `group ${group.id} label`);\n    if (!Array.isArray(group.items) || group.items.length === 0) {\n      throw new RangeError(`Sidebar group ${group.id} must contain at least one item`);\n    }\n    for (const item of group.items) {\n      assertNonEmpty(item.id, \"item id\");\n      assertNonEmpty(item.label, `item ${item.id} label`);\n      if (itemIds.has(item.id)) throw new TypeError(`Duplicate Sidebar item id: ${item.id}`);\n      itemIds.add(item.id);\n      if (item.badgeCount !== undefined && (!Number.isInteger(item.badgeCount) || item.badgeCount < 0)) {\n        throw new RangeError(`Sidebar item ${item.id} badgeCount must be a non-negative integer`);\n      }\n    }\n  }\n  if (descriptor.currentId !== null && !itemIds.has(descriptor.currentId)) {\n    throw new RangeError(`Sidebar currentId does not match any item: ${String(descriptor.currentId)}`);\n  }\n}\n\n/**\n * 접힘은 **표시 밀도**이지 내용이 아니다. 접혀도 항목은 모두 남고 라벨만 숨는다 —\n * 접을 때 항목을 빼면 \"접었더니 메뉴가 사라졌다\"가 되고, 그건 다른 컴포넌트다.\n * 라벨이 숨으면 아이콘만으로는 이름을 알 수 없으므로 renderer가 접근성 이름을 유지한다.\n */\nexport const sidebarDefaults = {\n  collapsed: false,\n} as const satisfies Readonly<{ collapsed: boolean }>;\n\nexport const sidebarRecipe = {\n  slots: [\"root\", \"group\", \"groupLabel\", \"item\", \"label\", \"badge\", \"toggle\"] as const,\n  defaults: sidebarDefaults,\n  widths: { expanded: 260, collapsed: 72 },\n  background: semanticColors.surface.sunken,\n  border: semanticColors.border.default,\n  borderWidth: stroke.default,\n  paddingVertical: spacing.sm,\n  paddingHorizontal: spacing.xs,\n  gap: spacing.xxs,\n  groupGap: spacing.md,\n  groupLabel: {\n    color: semanticColors.content.secondary,\n    textVariant: \"label\" as const,\n    paddingHorizontal: spacing.sm,\n    paddingVertical: spacing.xxs,\n  },\n  item: collectionItemContract,\n  itemRadius: radius.md,\n  itemMinHeight: control.minTouchTarget,\n  states: { focus: focusIndicatorContract },\n} as const satisfies {\n  slots: readonly [\"root\", \"group\", \"groupLabel\", \"item\", \"label\", \"badge\", \"toggle\"];\n  defaults: { collapsed: boolean };\n  widths: { expanded: number; collapsed: number };\n  background: ColorReference;\n  border: ColorReference;\n  borderWidth: number;\n  paddingVertical: number;\n  paddingHorizontal: number;\n  gap: number;\n  groupGap: number;\n  groupLabel: { color: ColorReference; textVariant: \"label\"; paddingHorizontal: number; paddingVertical: number };\n  item: typeof collectionItemContract;\n  itemRadius: number;\n  itemMinHeight: number;\n  states: { focus: typeof focusIndicatorContract };\n};\n\nexport const sidebarBehavior = {\n  controlled: [\"collapsed\", \"defaultCollapsed\", \"onCollapsedChange\"],\n  inputs: [\"groups\", \"currentId\", \"accessibilityLabel\"],\n  events: [\"onNavigate\"],\n  defaults: sidebarDefaults,\n  stateAxes: {\n    availability: [\"enabled\", \"disabled\"],\n    value: [\"selected\"],\n    interaction: [\"idle\", \"hover\", \"focusVisible\", \"pressed\"],\n  },\n  web: {\n    roles: [\"navigation\", \"list\", \"listitem\", \"link\", \"button\"],\n    keyboard: [\"Tab\", \"Enter\"],\n    /** Each item is a link in document order; no roving focus and no arrow-key grid. */\n    focus: \"native\",\n  },\n  /** Web-only: a phone uses BottomNavigation, and a native tablet split view is a navigator concern. */\n  native: { roles: [], states: [], actions: [] },\n  scenarios: [\n    \"the-current-item-is-announced-with-aria-current-not-only-painted\",\n    \"collapsing-hides-labels-but-keeps-every-item-and-its-accessible-name\",\n    \"groups-are-real-list-groupings-with-their-own-label-not-visual-dividers-only\",\n    \"an-item-badge-stays-visible-while-collapsed-because-it-is-the-reason-to-look\",\n    \"bottom-navigation-owns-the-three-to-five-destination-mobile-case-this-contract-never-adds-it\",\n    \"layout-owns-where-the-sidebar-sits-this-contract-owns-what-is-inside-it\",\n  ],\n} as const satisfies BehaviorContract;\n"]}

package/dist/skip-nav.d.ts

@@ -0,0 +1,67 @@
+/**
+ * 반복되는 머리 부분을 건너뛰고 본문으로 바로 가는 링크. WCAG 2.4.1(Bypass Blocks)이
+ * 요구하는 것이고, 키보드·스위치 사용자가 매 화면에서 내비게이션 20개를 지나지 않게 한다.
+ *
+ * `VisuallyHidden`으로 직접 만들 수 있어 보이지만 그러면 **가장 중요한 절반이 빠진다**:
+ * 이 링크는 숨어 있다가 **포커스를 받으면 반드시 보여야** 한다. 숨긴 채로 두면 포커스가
+ * 화면 밖으로 사라지는 것과 같아서 WCAG 2.4.7(Focus Visible) 위반이 된다. 그 "숨었다가
+ * 포커스에서 나타난다"가 이 계약의 전부다.
+ *
+ * Web 전용이다. 네이티브에는 건너뛸 문서 흐름이 없고 화면 리더가 rotor로 이동한다.
+ */
+export type SkipNavDescriptor = Readonly<{
+    /** 본문 컨테이너의 id. 링크는 `#id`로 이동하고 그 요소가 포커스를 받는다. */
+    targetId: string;
+    /** 현지화된 문구. renderer가 만들지 않는다. */
+    label: string;
+}>;
+export declare function validateSkipNavDescriptor(descriptor: SkipNavDescriptor): void;
+export declare const skipNavRecipe: {
+    readonly slots: readonly ["root"];
+    readonly minHeight: 44;
+    readonly paddingHorizontal: 16;
+    readonly radius: 12;
+    readonly background: Readonly<{
+        source: "theme";
+        key: "primary";
+        alpha?: number;
+    }>;
+    readonly color: Readonly<{
+        source: "theme";
+        key: "onPrimary";
+        alpha?: number;
+    }>;
+    /** 포커스를 받으면 화면 좌상단에 겹쳐 나타난다. 레이아웃을 밀지 않는다. */
+    readonly offset: 12;
+    readonly states: {
+        readonly focus: {
+            readonly color: Readonly<{
+                source: "theme";
+                key: "contentBrand";
+                alpha?: number;
+            }>;
+            readonly width: 2;
+            readonly offset: 2;
+        };
+    };
+};
+export declare const skipNavBehavior: {
+    readonly controlled: readonly [];
+    readonly inputs: readonly ["targetId", "label"];
+    readonly stateAxes: {
+        readonly interaction: readonly ["idle", "focusVisible"];
+    };
+    readonly web: {
+        readonly roles: readonly ["link"];
+        readonly keyboard: readonly ["Tab", "Enter"];
+        readonly focus: "native";
+    };
+    /** No native surface: there is no document flow to bypass. */
+    readonly native: {
+        readonly roles: readonly [];
+        readonly states: readonly [];
+        readonly actions: readonly [];
+    };
+    readonly scenarios: readonly ["hidden-until-focused-and-always-visible-once-focused", "it-is-the-first-tab-stop-on-the-page-or-it-solves-nothing", "activating-it-moves-focus-into-the-target-not-only-the-scroll-position", "a-target-id-written-with-a-leading-hash-is-rejected-instead-of-silently-doubled"];
+};
+//# sourceMappingURL=skip-nav.d.ts.map

package/dist/skip-nav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skip-nav.d.ts","sourceRoot":"","sources":["../src/skip-nav.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACvC,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAAC;AAEH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAiB7E;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;IAOxB,8CAA8C;;;;;;;;;;;;;CAY/C,CAAC;AAEF,eAAO,MAAM,eAAe;;;;;;;;;;;IAK1B,8DAA8D;;;;;;;CAQ3B,CAAC"}

package/dist/skip-nav.js

@@ -0,0 +1,47 @@
+import { focusIndicatorContract } from "./component-contracts.js";
+import { control, radius, spacing } from "./foundations.js";
+import { semanticColors } from "./semantic-colors.js";
+export function validateSkipNavDescriptor(descriptor) {
+    if (descriptor === null || typeof descriptor !== "object") {
+        throw new TypeError("SkipNav descriptor must be an object");
+    }
+    if (typeof descriptor.targetId !== "string" || descriptor.targetId.trim().length === 0) {
+        throw new TypeError("SkipNav targetId must not be empty");
+    }
+    if (descriptor.targetId.startsWith("#")) {
+        /*
+          제품이 `#main`을 넘기면 링크가 `##main`이 되어 조용히 깨진다. 잘라내 주는 대신
+          거절하는 이유는 두 표기가 섞이면 어느 쪽이 맞는지 아무도 모르게 되기 때문이다.
+        */
+        throw new TypeError("SkipNav targetId must be a bare id without '#'");
+    }
+    if (typeof descriptor.label !== "string" || descriptor.label.trim().length === 0) {
+        throw new TypeError("SkipNav label must not be empty");
+    }
+}
+export const skipNavRecipe = {
+    slots: ["root"],
+    minHeight: control.minTouchTarget,
+    paddingHorizontal: spacing.md,
+    radius: radius.md,
+    background: semanticColors.action.brand.background,
+    color: semanticColors.action.brand.content,
+    /** 포커스를 받으면 화면 좌상단에 겹쳐 나타난다. 레이아웃을 밀지 않는다. */
+    offset: spacing.sm,
+    states: { focus: focusIndicatorContract },
+};
+export const skipNavBehavior = {
+    controlled: [],
+    inputs: ["targetId", "label"],
+    stateAxes: { interaction: ["idle", "focusVisible"] },
+    web: { roles: ["link"], keyboard: ["Tab", "Enter"], focus: "native" },
+    /** No native surface: there is no document flow to bypass. */
+    native: { roles: [], states: [], actions: [] },
+    scenarios: [
+        "hidden-until-focused-and-always-visible-once-focused",
+        "it-is-the-first-tab-stop-on-the-page-or-it-solves-nothing",
+        "activating-it-moves-focus-into-the-target-not-only-the-scroll-position",
+        "a-target-id-written-with-a-leading-hash-is-rejected-instead-of-silently-doubled",
+    ],
+};
+//# sourceMappingURL=skip-nav.js.map

package/dist/skip-nav.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skip-nav.js","sourceRoot":"","sources":["../src/skip-nav.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAoBtD,MAAM,UAAU,yBAAyB,CAAC,UAA6B;IACrE,IAAI,UAAU,KAAK,IAAI,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC1D,MAAM,IAAI,SAAS,CAAC,sCAAsC,CAAC,CAAC;IAC9D,CAAC;IACD,IAAI,OAAO,UAAU,CAAC,QAAQ,KAAK,QAAQ,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvF,MAAM,IAAI,SAAS,CAAC,oCAAoC,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxC;;;UAGE;QACF,MAAM,IAAI,SAAS,CAAC,gDAAgD,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,OAAO,UAAU,CAAC,KAAK,KAAK,QAAQ,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjF,MAAM,IAAI,SAAS,CAAC,iCAAiC,CAAC,CAAC;IACzD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,KAAK,EAAE,CAAC,MAAM,CAAU;IACxB,SAAS,EAAE,OAAO,CAAC,cAAc;IACjC,iBAAiB,EAAE,OAAO,CAAC,EAAE;IAC7B,MAAM,EAAE,MAAM,CAAC,EAAE;IACjB,UAAU,EAAE,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU;IAClD,KAAK,EAAE,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO;IAC1C,8CAA8C;IAC9C,MAAM,EAAE,OAAO,CAAC,EAAE;IAClB,MAAM,EAAE,EAAE,KAAK,EAAE,sBAAsB,EAAE;CAU1C,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,UAAU,EAAE,EAAE;IACd,MAAM,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,SAAS,EAAE,EAAE,WAAW,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE;IACpD,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE;IACrE,8DAA8D;IAC9D,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;IAC9C,SAAS,EAAE;QACT,sDAAsD;QACtD,2DAA2D;QAC3D,wEAAwE;QACxE,iFAAiF;KAClF;CACkC,CAAC","sourcesContent":["import type { BehaviorContract } from \"./behaviors.js\";\nimport type { ColorReference } from \"./color-references.js\";\nimport { focusIndicatorContract } from \"./component-contracts.js\";\nimport { control, radius, spacing } from \"./foundations.js\";\nimport { semanticColors } from \"./semantic-colors.js\";\n\n/**\n * 반복되는 머리 부분을 건너뛰고 본문으로 바로 가는 링크. WCAG 2.4.1(Bypass Blocks)이\n * 요구하는 것이고, 키보드·스위치 사용자가 매 화면에서 내비게이션 20개를 지나지 않게 한다.\n *\n * `VisuallyHidden`으로 직접 만들 수 있어 보이지만 그러면 **가장 중요한 절반이 빠진다**:\n * 이 링크는 숨어 있다가 **포커스를 받으면 반드시 보여야** 한다. 숨긴 채로 두면 포커스가\n * 화면 밖으로 사라지는 것과 같아서 WCAG 2.4.7(Focus Visible) 위반이 된다. 그 \"숨었다가\n * 포커스에서 나타난다\"가 이 계약의 전부다.\n *\n * Web 전용이다. 네이티브에는 건너뛸 문서 흐름이 없고 화면 리더가 rotor로 이동한다.\n */\nexport type SkipNavDescriptor = Readonly<{\n  /** 본문 컨테이너의 id. 링크는 `#id`로 이동하고 그 요소가 포커스를 받는다. */\n  targetId: string;\n  /** 현지화된 문구. renderer가 만들지 않는다. */\n  label: string;\n}>;\n\nexport function validateSkipNavDescriptor(descriptor: SkipNavDescriptor): void {\n  if (descriptor === null || typeof descriptor !== \"object\") {\n    throw new TypeError(\"SkipNav descriptor must be an object\");\n  }\n  if (typeof descriptor.targetId !== \"string\" || descriptor.targetId.trim().length === 0) {\n    throw new TypeError(\"SkipNav targetId must not be empty\");\n  }\n  if (descriptor.targetId.startsWith(\"#\")) {\n    /*\n      제품이 `#main`을 넘기면 링크가 `##main`이 되어 조용히 깨진다. 잘라내 주는 대신\n      거절하는 이유는 두 표기가 섞이면 어느 쪽이 맞는지 아무도 모르게 되기 때문이다.\n    */\n    throw new TypeError(\"SkipNav targetId must be a bare id without '#'\");\n  }\n  if (typeof descriptor.label !== \"string\" || descriptor.label.trim().length === 0) {\n    throw new TypeError(\"SkipNav label must not be empty\");\n  }\n}\n\nexport const skipNavRecipe = {\n  slots: [\"root\"] as const,\n  minHeight: control.minTouchTarget,\n  paddingHorizontal: spacing.md,\n  radius: radius.md,\n  background: semanticColors.action.brand.background,\n  color: semanticColors.action.brand.content,\n  /** 포커스를 받으면 화면 좌상단에 겹쳐 나타난다. 레이아웃을 밀지 않는다. */\n  offset: spacing.sm,\n  states: { focus: focusIndicatorContract },\n} as const satisfies {\n  slots: readonly [\"root\"];\n  minHeight: number;\n  paddingHorizontal: number;\n  radius: number;\n  background: ColorReference;\n  color: ColorReference;\n  offset: number;\n  states: { focus: typeof focusIndicatorContract };\n};\n\nexport const skipNavBehavior = {\n  controlled: [],\n  inputs: [\"targetId\", \"label\"],\n  stateAxes: { interaction: [\"idle\", \"focusVisible\"] },\n  web: { roles: [\"link\"], keyboard: [\"Tab\", \"Enter\"], focus: \"native\" },\n  /** No native surface: there is no document flow to bypass. */\n  native: { roles: [], states: [], actions: [] },\n  scenarios: [\n    \"hidden-until-focused-and-always-visible-once-focused\",\n    \"it-is-the-first-tab-stop-on-the-page-or-it-solves-nothing\",\n    \"activating-it-moves-focus-into-the-target-not-only-the-scroll-position\",\n    \"a-target-id-written-with-a-leading-hash-is-rejected-instead-of-silently-doubled\",\n  ],\n} as const satisfies BehaviorContract;\n"]}

package/dist/tags-input.d.ts

@@ -0,0 +1,157 @@
+/**
+ * 자유 입력으로 여러 값을 모으는 필드 — 해시태그, 초대할 사람, 검색 필터.
+ *
+ * Combobox와 다르다. Combobox는 **주어진 목록에서 고른다**. TagsInput은 목록이 없거나
+ * 있어도 목록 밖의 값을 만들 수 있다. 그래서 Combobox에 `multiple` 축을 붙이는 대신
+ * 별도로 둔다 — 합치면 "목록에 없는 값을 고를 수 있는 Select"라는 모순이 생긴다.
+ * (제품이 후보 목록을 함께 보여 주고 싶으면 이 필드와 Combobox의 listbox를 조합한다.)
+ *
+ * 이 계약이 소유하는 것은 **언제 태그가 확정되는가**와 **빈 입력에서 지우면 무엇이
+ * 지워지는가** 둘이다. 중복 허용 여부·최대 개수·글자 규칙은 제품 정책이라 판정 결과를
+ * 받기만 한다.
+ */
+export type TagsInputCommitKey = "Enter" | "Comma" | "Space" | "Blur";
+/**
+ * 후보 목록. Combobox의 listbox 계약을 **이 필드 안에서** 쓰는 형태다.
+ *
+ * "Combobox에 multiple을 붙이자"가 아니라 여기로 온 이유: Combobox의 값은 목록 안의
+ * 키 하나이고 이 필드의 값은 문자열 배열이다. 값 모양이 다른 둘을 한 컴포넌트에 넣으면
+ * 모든 소비자가 매번 좁히기를 해야 한다. 자유 입력이 이미 여기 있으므로 후보를 여기에
+ * 더하는 쪽이 값 하나로 끝난다.
+ *
+ * 필터링은 제품이 한다 — 이 계약은 "무엇을 보여줄지"가 아니라 "고른 것을 어떻게
+ * 확정할지"만 안다.
+ */
+export type TagsInputSuggestion = Readonly<{
+    id: string;
+    label: string;
+    /** 확정될 문자열. 생략하면 `label`. */
+    value?: string;
+    disabled?: boolean;
+}>;
+/**
+ * 활성 후보를 방향키로 옮긴 결과. 목록 끝에서 순환한다 — 후보가 보통 짧아서 끝에
+ * 막히면 반대 끝까지 다시 내려가야 한다.
+ */
+export declare function resolveTagsInputActiveSuggestion(suggestions: readonly TagsInputSuggestion[], currentId: string | null, direction: "next" | "previous"): string | null;
+export declare const tagsInputBehaviorDefaults: {
+    /**
+     * Enter만 기본이다. 쉼표·공백은 언어에 따라 값의 일부다(한국어 태그에 공백이 흔하다).
+     * 제품이 자기 도메인을 알 때 켠다.
+     */
+    readonly commitKeys: readonly TagsInputCommitKey[];
+    /** 빈 입력에서 Backspace는 마지막 태그를 **선택**만 한다. 한 번 더 눌러야 지운다. */
+    readonly backspaceRemovesLastTag: false;
+};
+export type TagsInputRejectionReason = "empty" | "duplicate" | "limit" | "invalid";
+export type TagsInputCommitResult = Readonly<{
+    accepted: boolean;
+    /** 정리된 값(앞뒤 공백 제거). 거절돼도 제품이 문구에 쓸 수 있게 돌려준다. */
+    value: string;
+    reason?: TagsInputRejectionReason;
+}>;
+export type TagsInputPolicy = Readonly<{
+    /** 같은 값을 다시 넣을 수 있는가. 기본은 막는다. */
+    allowDuplicates?: boolean;
+    maxTags?: number;
+    /** 제품 도메인 규칙. 실패 사유는 `invalid` 하나로 합쳐 돌려준다. */
+    isValid?: (value: string) => boolean;
+}>;
+/**
+ * 태그 하나를 확정할 수 있는지 판정한다. 값을 바꾸지 않고 결과만 돌려준다 —
+ * 실제 상태 갱신은 renderer가, 사용자에게 보여 줄 문장은 제품이 만든다.
+ */
+export declare function resolveTagsInputCommit(current: readonly string[], rawValue: string, policy?: TagsInputPolicy): TagsInputCommitResult;
+/** 태그 하나를 뺀 목록. 같은 값이 여러 개면 해당 위치 하나만 지운다. */
+export declare function removeTagAt(current: readonly string[], index: number): readonly string[];
+export declare const tagsInputRecipe: {
+    readonly slots: readonly ["root", "frame", "tag", "remove", "input"];
+    readonly defaults: {
+        readonly commitKeys: readonly TagsInputCommitKey[];
+    };
+    readonly frame: {
+        readonly minHeight: 44;
+        readonly paddingHorizontal: 16;
+        readonly paddingVertical: 4;
+        readonly gap: 8;
+        readonly border: Readonly<{
+            source: "theme";
+            key: "textMuted";
+            alpha?: number;
+        }>;
+        readonly background: Readonly<{
+            source: "theme";
+            key: "surface";
+            alpha?: number;
+        }>;
+    };
+    readonly tag: {
+        readonly minHeight: 28;
+        readonly paddingHorizontal: 8;
+        readonly gap: 4;
+        readonly background: Readonly<{
+            source: "theme";
+            key: "surfaceAlt";
+            alpha?: number;
+        }>;
+        readonly color: Readonly<{
+            source: "theme";
+            key: "textBody";
+            alpha?: number;
+        }>;
+    };
+    /** 삭제 버튼은 태그보다 작아도 되지만 포인터 타깃은 공용 최소값을 지킨다. */
+    readonly remove: {
+        readonly minTouchTarget: 44;
+        readonly color: Readonly<{
+            source: "theme";
+            key: "textMuted";
+            alpha?: number;
+        }>;
+    };
+    readonly selectedTagOutline: Readonly<{
+        source: "theme";
+        key: "contentBrand";
+        alpha?: number;
+    }>;
+    readonly states: {
+        readonly focus: {
+            readonly color: Readonly<{
+                source: "theme";
+                key: "contentBrand";
+                alpha?: number;
+            }>;
+            readonly width: 2;
+            readonly offset: 2;
+        };
+    };
+};
+export declare const tagsInputBehavior: {
+    readonly controlled: readonly ["tags", "defaultTags", "onTagsChange"];
+    readonly inputs: readonly ["policy", "commitKeys", "label", "removeLabel"];
+    /**
+     * `onDraftChange`가 없으면 제품이 후보를 거를 수 없다 — 무엇을 입력 중인지 모르기
+     * 때문이다. 후보 목록을 계약에 넣는 순간 이 이벤트도 함께 필요하다.
+     */
+    readonly events: readonly ["onReject", "onDraftChange"];
+    readonly defaults: {
+        readonly backspaceRemovesLastTag: false;
+    };
+    readonly stateAxes: {
+        readonly availability: readonly ["enabled", "disabled"];
+        readonly value: readonly ["empty", "filled"];
+        readonly validation: readonly ["valid", "invalid"];
+    };
+    readonly web: {
+        readonly roles: readonly ["combobox", "listbox", "option", "button", "list", "listitem"];
+        readonly keyboard: readonly ["Enter", "Backspace", "ArrowUp", "ArrowDown", "ArrowLeft", "ArrowRight", "Escape", "Tab"];
+        readonly focus: "native";
+    };
+    readonly native: {
+        readonly roles: readonly ["button"];
+        readonly states: readonly ["disabled"];
+        readonly actions: readonly ["commit", "remove"];
+    };
+    readonly scenarios: readonly ["enter-commits-the-trimmed-value-and-clears-the-input", "an-empty-or-whitespace-only-value-is-never-committed", "duplicates-are-rejected-by-default-and-the-reason-is-reported-not-swallowed", "backspace-in-an-empty-input-selects-the-last-tag-before-a-second-press-removes-it", "every-tag-carries-its-own-remove-control-with-a-localized-name", "the-policy-judges-and-the-product-writes-the-sentence-the-user-reads", "a-candidate-list-lives-in-this-field-because-the-value-shape-is-this-fields-not-comboboxs", "enter-commits-the-active-candidate-when-one-is-highlighted-and-the-typed-text-otherwise", "candidate-filtering-belongs-to-the-product-the-contract-only-commits-the-choice"];
+};
+//# sourceMappingURL=tags-input.d.ts.map

package/dist/tags-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tags-input.d.ts","sourceRoot":"","sources":["../src/tags-input.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAC;AAEtE;;;;;;;;;;GAUG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC,CAAC;AAEH;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,SAAS,mBAAmB,EAAE,EAC3C,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,SAAS,EAAE,MAAM,GAAG,UAAU,GAC7B,MAAM,GAAG,IAAI,CAOf;AAED,eAAO,MAAM,yBAAyB;IACpC;;;OAGG;yBACsB,SAAS,kBAAkB,EAAE;IACtD,2DAA2D;;CAEnD,CAAC;AAEX,MAAM,MAAM,wBAAwB,GAAG,OAAO,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;AAEnF,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IAC3C,QAAQ,EAAE,OAAO,CAAC;IAClB,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,wBAAwB,CAAC;CACnC,CAAC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACrC,kCAAkC;IAClC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;CACtC,CAAC,CAAC;AAEH;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,eAAoB,GAC3B,qBAAqB,CAavB;AAED,8CAA8C;AAC9C,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAKxF;AAED,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAkB1B,+CAA+C;;;;;;;;;;;;;;;;;;;;;;;;;CAmBhD,CAAC;AAEF,eAAO,MAAM,iBAAiB;;;IAG5B;;;OAGG;;;;;;;;;;;;;;;;;;;;;CAyBgC,CAAC"}