@hjmds/design-contracts 0.8.2

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["export {\n  getIconDirectionality,\n  getIconTransform,\n  resolveIconDescriptor,\n  semanticIconNames,\n  validateIconDescriptor,\n  type DecorativeIconDescriptor,\n  type IconDescriptor,\n  type IconDirection,\n  type IconDirectionality,\n  type IconTransform,\n  type InformativeIconDescriptor,\n  type ResolvedIconDescriptor,\n  type SemanticIconName,\n} from \"./icon.js\";\n\nexport {\n  resolveLinkDescriptor,\n  validateLinkDescriptor,\n  validateLinkDestination,\n  type ExternalLinkDestination,\n  type InternalLinkDestination,\n  type LinkDescriptor,\n  type LinkDestination,\n  type LinkIconDescriptor,\n  type ResolvedLinkDescriptor,\n  type ResolvedLinkIconDescriptor,\n} from \"./link.js\";\n\nexport {\n  bottomNavigationBehaviorDefaults,\n  resolveBottomNavigationActivation,\n  resolveBottomNavigationConfiguration,\n  resolveBottomNavigationDescriptor,\n  resolveBottomNavigationItem,\n  validateBottomNavigationConfiguration,\n  validateBottomNavigationDescriptor,\n  type BottomNavigationActivation,\n  type BottomNavigationConfiguration,\n  type BottomNavigationCounterBadge,\n  type BottomNavigationDescriptor,\n  type BottomNavigationDirection,\n  type BottomNavigationIconDescriptor,\n  type BottomNavigationItemDescriptor,\n  type BottomNavigationKeyboardBehavior,\n  type ResolvedBottomNavigationCounterBadge,\n  type ResolvedBottomNavigationConfiguration,\n  type ResolvedBottomNavigationDescriptor,\n  type ResolvedBottomNavigationIconDescriptor,\n  type ResolvedBottomNavigationItemDescriptor,\n} from \"./bottom-navigation.js\";\n\nexport {\n  resolveTooltipDescriptor,\n  tooltipBehaviorDefaults,\n  tooltipDescriptorDefaults,\n  validateTooltipDescriptor,\n  validateTooltipOpenState,\n  type ControlledTooltipOpenState,\n  type ResolvedTooltipDescriptor,\n  type TooltipAlign,\n  type TooltipDescriptor,\n  type TooltipOpenChangeDetails,\n  type TooltipOpenChangeReason,\n  type TooltipOpenState,\n  type TooltipPlacement,\n  type UncontrolledTooltipOpenState,\n} from \"./tooltip.js\";\n\nexport {\n  alertDialogBehaviorDefaults,\n  canDismissAlertDialog,\n  createAlertDialogSession,\n  getAlertDialogInitialFocus,\n  validateAlertDialogRequest,\n  type AlertDialogAsyncState,\n  type AlertDialogCancelReason,\n  type AlertDialogConfirmAction,\n  type AlertDialogDismissReason,\n  type AlertDialogInitialFocus,\n  type AlertDialogMode,\n  type AlertDialogOpenChangeReason,\n  type AlertDialogOpenState,\n  type AlertDialogPhase,\n  type AlertDialogRequest,\n  type AlertDialogResult,\n  type AlertDialogSession,\n} from \"./alert-dialog.js\";\n\nexport {\n  canDismissSheet,\n  createSheetLifecycle,\n  sheetBehaviorDefaults,\n  type SheetDismissPolicy,\n  type SheetDismissReason,\n  type SheetLifecycle,\n  type SheetOpenChangeDetails,\n  type SheetOpenState,\n} from \"./sheet.js\";\n\nexport {\n  createToastSession,\n  createToastStore,\n  resolveToastAnnouncement,\n  resolveToastDescriptor,\n  resolveToastDuration,\n  toastBehaviorDefaults,\n  validateToastDescriptor,\n  type ResolvedToastActionDescriptor,\n  type ResolvedToastDescriptor,\n  type ToastActionDescriptor,\n  type ToastAnnouncement,\n  type ToastAnnouncementPriority,\n  type ToastDescriptor,\n  type ToastDismissReason,\n  type ToastDuplicatePolicy,\n  type ToastId,\n  type ToastOverflowPolicy,\n  type ToastPauseReason,\n  type ToastPhase,\n  type ToastPublishOptions,\n  type ToastPublishResult,\n  type ToastSession,\n  type ToastSessionSnapshot,\n  type ToastStore,\n  type ToastStoreOptions,\n  type ToastStoreSnapshot,\n  type ToastTimerSnapshot,\n  type ToastTimerStatus,\n  type ToastTimerUpdatePolicy,\n} from \"./toast.js\";\n\nexport {\n  resolveStatisticDescriptor,\n  statisticDefaults,\n  statisticTrendMarks,\n  validateStatisticDescriptor,\n  validateStatisticGroup,\n  type ResolvedStatisticDescriptor,\n  type ResolvedStatisticTrendDescriptor,\n  type StatisticDescriptor,\n  type StatisticGroupDescriptor,\n  type StatisticTrendDescriptor,\n  type StatisticTrendDirection,\n  type StatisticTrendTone,\n} from \"./statistic.js\";\n\nexport {\n  canRequestLoadMore,\n  createLoadMoreController,\n  loadMoreBehaviorDefaults,\n  validateLoadMoreDescriptor,\n  validateLoadMoreLabels,\n  validateLoadMoreState,\n  type LoadMoreCompleteState,\n  type LoadMoreController,\n  type LoadMoreControllerOptions,\n  type LoadMoreControllerSnapshot,\n  type LoadMoreDescriptor,\n  type LoadMoreErrorState,\n  type LoadMoreLabels,\n  type LoadMoreLoadingState,\n  type LoadMoreMode,\n  type LoadMoreReadyState,\n  type LoadMoreRequest,\n  type LoadMoreRequestHandler,\n  type LoadMoreRequestOutcome,\n  type LoadMoreRequestReason,\n  type LoadMoreState,\n} from \"./load-more.js\";\n\nexport {\n  collectionValidationDefaults,\n  flattenCollectionItems,\n  getCollectionNavigationIntent,\n  getCollectionNavigationTarget,\n  getCollectionTypeaheadMatch,\n  isComboboxResultCurrent,\n  reconcileSelectSelection,\n  resolveComboboxSelectedItem,\n  resolveCollectionItem,\n  resolveSelectSelectedItem,\n  validateCollection,\n  type CollectionNavigationIntent,\n  type CollectionSource,\n  type SelectCollectionSectionDescriptor,\n  type SelectCollectionSource,\n  type CollectionTypeaheadOptions,\n  type CollectionValidationOptions,\n  type ComboboxCollectionState,\n  type ComboboxState,\n  type ReconcileSelectOptions,\n  type SelectCollectionState,\n  type SelectConfiguration,\n  type SelectLabel,\n  type SelectOpenChangeReason,\n  type SelectOpenState,\n  type SelectState,\n} from \"./collection.js\";\n\nexport {\n  ACCENTS,\n  THEMES,\n  accentFill,\n  accentTint,\n  brandGradient,\n  isThemePreference,\n  onAccentFill,\n  onBrandGradient,\n  withAlpha,\n  type AccentTone,\n  type ResolvedTheme,\n  type ThemeColors,\n  type ThemePreference,\n} from \"./colors.js\";\n\nexport {\n  backdrop,\n  breakpoint,\n  control,\n  easing,\n  fontFamily,\n  fontWeight,\n  glyph,\n  heading,\n  layer,\n  layout,\n  letterSpacing,\n  motion,\n  motionPreset,\n  numeric,\n  opacity,\n  overlay,\n  radius,\n  scrim,\n  shadow,\n  spacing,\n  spring,\n  stateLayer,\n  stroke,\n  typography,\n  type BackdropReference,\n  type FontFamily,\n  type FontWeight,\n  type FontWeightValue,\n  type GlyphSize,\n  type HeadingLevel,\n  type LetterSpacing,\n  type NumericVariant,\n  type ReducedMotionBehavior,\n  type TextVariant,\n} from \"./foundations.js\";\n\nexport {\n  resolveResponsiveValue,\n  resolveWindowClass,\n  validateResponsiveValue,\n  windowClassOrder,\n  type ResponsiveValue,\n  type WindowClass,\n} from \"./responsive.js\";\n\nexport {\n  gridDefaults,\n  gridGaps,\n  gridRecipe,\n  resolveGridLayout,\n  validateGridDescriptor,\n  type GridDescriptor,\n  type GridGap,\n  type GridGapToken,\n  type ResolveGridLayoutOptions,\n  type ResolvedGridLayout,\n} from \"./grid.js\";\n\nexport {\n  accordionRecipe,\n  alertDialogRecipe,\n  avatarRecipe,\n  badgeRecipe,\n  bottomNavigationRecipe,\n  bottomCtaRecipe,\n  buttonRecipe,\n  cardRecipe,\n  chipRecipe,\n  comboboxRecipe,\n  counterBadgeRecipe,\n  dialogRecipe,\n  dividerRecipe,\n  emptyStateRecipe,\n  fieldRecipe,\n  formatCounterBadgeCount,\n  iconButtonRecipe,\n  iconRecipe,\n  linkRecipe,\n  listRecipe,\n  listRowRecipe,\n  loadMoreRecipe,\n  menuRecipe,\n  noticeRecipe,\n  progressRecipe,\n  searchFieldRecipe,\n  selectRecipe,\n  selectionGroupRecipe,\n  sectionRecipe,\n  segmentedControlRecipe,\n  selectionControlRecipe,\n  sheetRecipe,\n  skeletonRecipe,\n  spinnerRecipe,\n  surfaceDefaults,\n  surfaceGeometry,\n  stackRecipe,\n  statisticRecipe,\n  surfaceRecipe,\n  switchRecipe,\n  tabsRecipe,\n  textRecipe,\n  toastRecipe,\n  tooltipRecipe,\n  topBarRecipe,\n  type AccordionDensity,\n  type AlertDialogTone,\n  type AvatarShape,\n  type AvatarSize,\n  type BadgeSize,\n  type BadgeTone,\n  type BadgeVariant,\n  type BottomNavigationDensity,\n  type BottomNavigationDistribution,\n  type BottomNavigationPresentation,\n  type ButtonSize,\n  type ButtonTone,\n  type CardHeadingLevel,\n  type ChipSize,\n  type SelectDensity,\n  type SelectSize,\n  type CounterBadgeSize,\n  type CounterBadgeTone,\n  type CounterBadgeVariant,\n  type DialogSize,\n  type FieldShape,\n  type FieldVariant,\n  type IconButtonShape,\n  type IconButtonSize,\n  type IconTone,\n  type IconWeight,\n  type LinkTone,\n  type LinkVariant,\n  type LoadMoreDensity,\n  type ListRowDensity,\n  type MenuDensity,\n  type MenuItemTone,\n  type NoticeTone,\n  type ProgressSize,\n  type ProgressTone,\n  type SearchFieldSize,\n  type SegmentedControlSize,\n  type SelectionControlKind,\n  type SelectionControlPresentation,\n  type SelectionControlSize,\n  type SelectionGroupOrientation,\n  type SelectionGroupPresentation,\n  type SpinnerSize,\n  type SpinnerTone,\n  type StackAlign,\n  type StackAxis,\n  type StackGap,\n  type StackJustify,\n  type StatisticDensity,\n  type StatisticPresentation,\n  type SurfaceTone,\n  type SurfacePadding,\n  type SurfaceRadius,\n  type SwitchSize,\n  type TabSize,\n  type TabsLayout,\n  type TabsOverflow,\n  type TextEmphasis,\n  type TextTone,\n  type ToastPlacement,\n  type ToastTone,\n  type ToastToneMark,\n} from \"./recipes.js\";\n\nexport {\n  accentColor,\n  resolveColorReference,\n  solidAccentColor,\n  themeColor,\n  type AccentColorReference,\n  type AccentFillReference,\n  type ColorReference,\n  type ColorReferencePalette,\n  type ThemeColorReference,\n} from \"./color-references.js\";\n\nexport {\n  componentCatalog,\n  getComponentSurfaceStatus,\n  recipeRegistry,\n  summarizeComponentRoadmap,\n  type ComponentCatalogEntry,\n  type ComponentCategory,\n  type ComponentName,\n  type ComponentPlatform,\n  type ComponentRoadmap,\n  type ComponentRoadmapState,\n  type ComponentSurface,\n  type ComponentSurfaceMaturity,\n  type ComponentSurfaceStatus,\n  type ComponentStatus,\n  type RecipeName,\n} from \"./catalog.js\";\n\nexport { designSystemVersion } from \"./version.js\";\n\nexport {\n  antDesignReferenceComponents,\n  antDesignReferenceSystem,\n  getAntDesignReferencesFor,\n  summarizeAntDesignCoverage,\n  type AntDesignCategory,\n  type AntDesignComponentName,\n  type AntDesignReferenceComponent,\n  type ReferenceCoverageSummary,\n  type ReferenceRelationship,\n} from \"./component-references.js\";\n\nexport {\n  componentDefinitions,\n  componentIds,\n  getComponentDefinition,\n  type ComponentDefinition,\n  type ComponentId,\n  type ComponentKind,\n} from \"./component-definitions.js\";\n\nexport { semanticColors } from \"./semantic-colors.js\";\n\nexport {\n  behaviorRegistry,\n  checkboxBehaviorDefaults,\n  comboboxBehaviorDefaults,\n  getCheckboxNextState,\n  getRadioNavigationTarget,\n  getSelectionNavigationIntent,\n  getTabNavigationIntent,\n  getTabNavigationTarget,\n  reconcileCheckboxSelection,\n  reconcileRadioSelection,\n  radioGroupBehaviorDefaults,\n  resolveInitialRadioValue,\n  resolveControlAccessibleName,\n  resolveRadioTabStop,\n  resolveInitialTabValue,\n  selectionGroupBehaviorDefaults,\n  selectBehaviorDefaults,\n  tabsBehaviorDefaults,\n  toggleCheckboxSelection,\n  validateCheckboxSelection,\n  validateRadioSelection,\n  validateSelectionItems,\n  type AsyncCollectionState,\n  type AvailabilityState,\n  type BehaviorContract,\n  type BehaviorName,\n  type BehaviorStateAxis,\n  type CollectionItemDescriptor,\n  type CollectionItemTone,\n  type CollectionKey,\n  type CollectionSectionDescriptor,\n  type MenuItemDescriptor,\n  type MenuSectionDescriptor,\n  type CollectionSelectionModel,\n  type ComboboxCommitReason,\n  type ComboboxFiltering,\n  type ComboboxInput,\n  type ControlledComboboxInput,\n  type ControlledSelectSelection,\n  type ControlledCheckboxGroupSelection,\n  type ControlledCheckboxState,\n  type ControlledRadioGroupSelection,\n  type ContentState,\n  type ControlledTabsSelection,\n  type InteractionState,\n  type MixedCheckboxActivation,\n  type MultipleSelectionModel,\n  type NativeAccessibilityState,\n  type NoSelectionModel,\n  type SingleSelectionModel,\n  type SelectItemDescriptor,\n  type SelectSelection,\n  type CheckboxGroupSelection,\n  type CheckboxSelection,\n  type CheckboxState,\n  type RadioGroupSelection,\n  type SelectionDirection,\n  type SelectionGroupLabel,\n  type SelectionItemDescriptor,\n  type SelectionNavigationIntent,\n  type SelectionOrientation,\n  type TabDescriptor,\n  type TabNavigationIntent,\n  type TabsActivationMode,\n  type TabsDirection,\n  type TabsMountPolicy,\n  type TabsOrientation,\n  type TabsPanelMode,\n  type TabsSelection,\n  type UncontrolledTabsSelection,\n  type UncontrolledComboboxInput,\n  type UncontrolledSelectSelection,\n  type UncontrolledCheckboxGroupSelection,\n  type UncontrolledCheckboxState,\n  type UncontrolledRadioGroupSelection,\n  type ValidationState,\n  type ValueState,\n  type WebKeyboardKey,\n} from \"./behaviors.js\";\n\nexport {\n  collectionItemContract,\n  fieldFrameContract,\n  floatingSurfaceContract,\n  focusIndicatorContract,\n  formSupportContract,\n} from \"./component-contracts.js\";\n\nexport {\n  assertShowcaseCoverage,\n  createShowcaseCoverage,\n  createShowcaseManifest,\n  getRequiredShowcaseScenarios,\n  getRequiredShowcaseEvidence,\n  getRequiredShowcaseSurfaces,\n  getShowcaseEnvironmentInput,\n  getShowcaseStoryId,\n  showcaseEnvironmentMatrix,\n  showcaseManifest,\n  showcaseScenarios,\n  summarizeShowcaseMaturity,\n  type ShowcaseComponentEntry,\n  type ShowcaseCoverageEntry,\n  type ShowcaseDirection,\n  type ShowcaseEnvironment,\n  type ShowcaseEvidenceEntry,\n  type ShowcaseEvidenceRequirement,\n  type ShowcaseMotionPreference,\n  type ShowcaseScenario,\n  type ShowcaseScenarioId,\n  type ShowcaseSurface,\n  type ShowcaseTextScale,\n  type ShowcaseTheme,\n} from \"./showcase.js\";\n\nexport {\n  assertShowcaseStoryIds,\n  compareShowcaseStoryIds,\n  createDesignSystemEvidence,\n  createDesignSystemEvidenceCoverage,\n  defineDesignSystemEvidence,\n  designSystemEvidenceSchemaVersion,\n  getShowcaseStoryIdsForSurface,\n  toShowcaseEvidenceEntries,\n  type DesignSystemEvidenceItem,\n  type DesignSystemEvidenceManifest,\n  type DesignSystemEvidenceSource,\n  type DesignSystemEvidenceSourceKind,\n  type ShowcaseStoryIdComparison,\n} from \"./evidence.js\";\n\n/*\n  Batch 2 — 계약과 recipe가 준비된 컴포넌트.\n\n  catalog의 status는 여전히 `planned`다. 로드맵의 maturity gate가 `planned → beta` 승격에\n  **실제 제품 vertical slice 한 번**을 요구하므로, 계약이 준비된 것과 검증된 것을 섞지\n  않는다. 여기 있는 심볼은 제품이 renderer를 붙일 수 있다는 뜻이고, 붙여서 검증되면\n  그때 리드가 catalog를 올린다.\n*/\nexport * from \"./breadcrumb.js\";\nexport * from \"./calendar.js\";\nexport * from \"./carousel.js\";\nexport * from \"./command-palette.js\";\nexport * from \"./design-system-provider.js\";\nexport * from \"./floating-action-button.js\";\nexport * from \"./content-state.js\";\nexport * from \"./data-table.js\";\nexport * from \"./mentions.js\";\nexport * from \"./transfer-list.js\";\nexport * from \"./tour.js\";\nexport * from \"./layout.js\";\nexport * from \"./otp-field.js\";\nexport * from \"./password-field.js\";\nexport * from \"./splitter.js\";\nexport * from \"./tree-select.js\";\nexport * from \"./date-picker.js\";\nexport * from \"./side-panel.js\";\nexport * from \"./file-picker.js\";\nexport * from \"./pagination.js\";\nexport * from \"./popover.js\";\nexport * from \"./upload-item.js\";\nexport * from \"./timeline.js\";\nexport * from \"./tree.js\";\nexport * from \"./steps.js\";\nexport * from \"./number-field.js\";\nexport * from \"./slider.js\";\nexport * from \"./form.js\";\nexport * from \"./tag.js\";\nexport * from \"./description-list.js\";\nexport * from \"./result.js\";\nexport * from \"./image.js\";\n"]}

package/dist/layout.d.ts

@@ -0,0 +1,118 @@
+/**
+ * `Layout` (alias `AppShell`) does NOT own header or footer chrome — that is
+ * already `TopBar` (native, beta) and `BottomNavigation` (adaptive, beta).
+ * What is left after subtracting those: ordered regions, a sidebar that is
+ * either always-visible chrome or a dismissible overlay, and Web-only
+ * landmark composition (one `main` plus a required skip link whenever
+ * repeated navigation precedes it). The overlay case reuses `SidePanel`
+ * unchanged — see docs/layout.md for why this module does not redeclare
+ * open/dismiss state.
+ */
+export type LayoutSidebarRole = "navigation" | "complementary";
+export type LayoutSidebarMode = "persistent" | "overlay";
+export type LayoutSidebarDescriptor = Readonly<{
+    /** Primary site navigation vs. supplementary content (filters, related items) — independent of `mode`. */
+    role: LayoutSidebarRole;
+    /** `persistent`: always-visible landmark. `overlay`: a `SidePanel` — Layout does not re-contract its open/dismiss lifecycle. */
+    mode: LayoutSidebarMode;
+    label: string;
+}>;
+export type LayoutDescriptor = Readonly<{
+    hasHeader?: boolean;
+    hasFooter?: boolean;
+    sidebar?: LayoutSidebarDescriptor;
+    /** Web-only: required whenever a header or sidebar precedes `main` (WCAG 2.4.1 bypass blocks). */
+    skipLinkLabel?: string;
+}>;
+/**
+ * Cross-platform structure validation. This deliberately does not require a
+ * skip link: Native has no page-landmark or bypass-link equivalent.
+ */
+export declare function validateLayoutRegions(descriptor: LayoutDescriptor): void;
+/** Web landmark validation, including the WCAG 2.4.1 bypass-link invariant. */
+export declare function validateLayoutWebDescriptor(descriptor: LayoutDescriptor): void;
+/**
+ * @deprecated Use `validateLayoutRegions` for shared/Native structure or
+ * `validateLayoutWebDescriptor` for a Web app shell.
+ */
+export declare function validateLayoutDescriptor(descriptor: LayoutDescriptor): void;
+export type LayoutLandmarkRole = "banner" | "navigation" | "complementary" | "main" | "contentinfo";
+/**
+ * Web-only translation: real landmark elements exist there. Native has no
+ * landmark-role equivalent at all (`accessibilityRole` covers headings and
+ * controls, not page regions) — RN renderers instead rely on visual/DOM
+ * order plus `accessibilityViewIsModal` for the overlay sidebar case. That
+ * asymmetry is documented, not papered over with a fake mapping.
+ */
+export declare function resolveLayoutWebLandmarks(descriptor: LayoutDescriptor): readonly LayoutLandmarkRole[];
+/**
+ * Skip link is hidden until it matters — visible only on keyboard focus.
+ * A skip link visible at rest fights identity.md's "조용한 화면 위에 중요한
+ * 순간만 선명하게": for a mouse/touch user it is noise every screen, for a
+ * keyboard user it is the first landmark on the page.
+ */
+export declare const layoutRecipe: {
+    readonly slots: readonly ["root", "skipLink", "header", "sidebar", "main", "footer"];
+    readonly defaults: {};
+    readonly main: {
+        readonly maxWidth: 1200;
+        readonly paddingHorizontal: 20;
+    };
+    readonly sidebar: {
+        readonly width: 280;
+    };
+    readonly skipLink: {
+        readonly visibility: "focus-only";
+        readonly background: Readonly<{
+            source: "theme";
+            key: "primary";
+            alpha?: number;
+        }>;
+        readonly color: Readonly<{
+            source: "theme";
+            key: "onPrimary";
+            alpha?: number;
+        }>;
+        readonly paddingHorizontal: 16;
+        readonly paddingVertical: 12;
+    };
+    readonly states: {
+        readonly focus: {
+            readonly color: Readonly<{
+                source: "theme";
+                key: "contentBrand";
+                alpha?: number;
+            }>;
+            readonly width: 2;
+            readonly offset: 2;
+        };
+    };
+};
+/**
+ * `controlled: []` on purpose: an overlay sidebar's open/dismiss lifecycle
+ * is a `SidePanel` (`src/side-panel.ts`) composed as-is. Redeclaring
+ * `open`/`defaultOpen`/`onOpenChange`/`dismissPolicy` here would be the same
+ * mistake DataTable avoided with Pagination/LoadMore — two places owning
+ * one piece of state that will drift the first time either one changes.
+ */
+export declare const layoutBehavior: {
+    readonly controlled: readonly [];
+    readonly inputs: readonly ["hasHeader", "hasFooter", "sidebar", "skipLinkLabel"];
+    readonly configuration: {
+        readonly "sidebar.mode": readonly ["persistent", "overlay"];
+        readonly "sidebar.role": readonly ["navigation", "complementary"];
+    };
+    readonly stateAxes: {};
+    readonly web: {
+        readonly roles: readonly ["banner", "navigation", "complementary", "main", "contentinfo"];
+        readonly keyboard: readonly ["Tab"];
+        readonly focus: "native";
+    };
+    readonly native: {
+        readonly roles: readonly [];
+        readonly states: readonly [];
+        readonly actions: readonly [];
+    };
+    readonly scenarios: readonly ["exactly-one-main-landmark-exists-per-layout", "web-skip-link-is-required-whenever-a-header-or-sidebar-precedes-main", "sidebar-role-navigation-or-complementary-is-chosen-independent-of-persistent-or-overlay-mode", "overlay-sidebar-reuses-sidepanel-open-state-and-dismiss-policy-unchanged", "header-and-footer-content-is-not-owned-here-compose-topbar-and-bottomnavigation", "skip-link-is-visually-hidden-until-keyboard-focus-reaches-it", "native-has-no-landmark-role-equivalent-translation-relies-on-order-and-accessibilityviewismodal"];
+};
+//# sourceMappingURL=layout.d.ts.map

package/dist/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../src/layout.ts"],"names":[],"mappings":"AAMA;;;;;;;;;GASG;AACH,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,eAAe,CAAC;AAC/D,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,SAAS,CAAC;AAEzD,MAAM,MAAM,uBAAuB,GAAG,QAAQ,CAAC;IAC7C,0GAA0G;IAC1G,IAAI,EAAE,iBAAiB,CAAC;IACxB,gIAAgI;IAChI,IAAI,EAAE,iBAAiB,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IACtC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAClC,kGAAkG;IAClG,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC,CAAC;AAQH;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAcxE;AAED,+EAA+E;AAC/E,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAQ9E;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAE3E;AAED,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,YAAY,GACZ,eAAe,GACf,MAAM,GACN,aAAa,CAAC;AAElB;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,gBAAgB,GAC3B,SAAS,kBAAkB,EAAE,CAQ/B;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BxB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;CAuBU,CAAC"}

package/dist/layout.js

@@ -0,0 +1,118 @@
+import { focusIndicatorContract } from "./component-contracts.js";
+import { layout as layoutFoundation, spacing } from "./foundations.js";
+import { semanticColors } from "./semantic-colors.js";
+function assertNonEmpty(value, field) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new TypeError(`Layout ${field} must not be empty`);
+    }
+}
+/**
+ * Cross-platform structure validation. This deliberately does not require a
+ * skip link: Native has no page-landmark or bypass-link equivalent.
+ */
+export function validateLayoutRegions(descriptor) {
+    if (descriptor.sidebar !== undefined) {
+        const { role, mode, label } = descriptor.sidebar;
+        if (role !== "navigation" && role !== "complementary") {
+            throw new TypeError(`Unsupported Layout sidebar role: ${String(role)}`);
+        }
+        if (mode !== "persistent" && mode !== "overlay") {
+            throw new TypeError(`Unsupported Layout sidebar mode: ${String(mode)}`);
+        }
+        assertNonEmpty(label, "sidebar.label");
+    }
+    if (descriptor.skipLinkLabel !== undefined) {
+        assertNonEmpty(descriptor.skipLinkLabel, "skipLinkLabel");
+    }
+}
+/** Web landmark validation, including the WCAG 2.4.1 bypass-link invariant. */
+export function validateLayoutWebDescriptor(descriptor) {
+    validateLayoutRegions(descriptor);
+    const needsSkipLink = descriptor.hasHeader === true || descriptor.sidebar !== undefined;
+    if (needsSkipLink && descriptor.skipLinkLabel === undefined) {
+        throw new TypeError("Layout requires skipLinkLabel when a header or sidebar region precedes main");
+    }
+}
+/**
+ * @deprecated Use `validateLayoutRegions` for shared/Native structure or
+ * `validateLayoutWebDescriptor` for a Web app shell.
+ */
+export function validateLayoutDescriptor(descriptor) {
+    validateLayoutWebDescriptor(descriptor);
+}
+/**
+ * Web-only translation: real landmark elements exist there. Native has no
+ * landmark-role equivalent at all (`accessibilityRole` covers headings and
+ * controls, not page regions) — RN renderers instead rely on visual/DOM
+ * order plus `accessibilityViewIsModal` for the overlay sidebar case. That
+ * asymmetry is documented, not papered over with a fake mapping.
+ */
+export function resolveLayoutWebLandmarks(descriptor) {
+    validateLayoutWebDescriptor(descriptor);
+    const roles = [];
+    if (descriptor.hasHeader)
+        roles.push("banner");
+    if (descriptor.sidebar)
+        roles.push(descriptor.sidebar.role);
+    roles.push("main");
+    if (descriptor.hasFooter)
+        roles.push("contentinfo");
+    return roles;
+}
+/**
+ * Skip link is hidden until it matters — visible only on keyboard focus.
+ * A skip link visible at rest fights identity.md's "조용한 화면 위에 중요한
+ * 순간만 선명하게": for a mouse/touch user it is noise every screen, for a
+ * keyboard user it is the first landmark on the page.
+ */
+export const layoutRecipe = {
+    slots: ["root", "skipLink", "header", "sidebar", "main", "footer"],
+    defaults: {},
+    main: {
+        maxWidth: layoutFoundation.contentMaxWidth,
+        paddingHorizontal: layoutFoundation.pagePadding.regular,
+    },
+    sidebar: {
+        width: 280,
+    },
+    skipLink: {
+        visibility: "focus-only",
+        background: semanticColors.action.brand.background,
+        color: semanticColors.action.brand.content,
+        paddingHorizontal: spacing.md,
+        paddingVertical: spacing.sm,
+    },
+    states: { focus: focusIndicatorContract },
+};
+/**
+ * `controlled: []` on purpose: an overlay sidebar's open/dismiss lifecycle
+ * is a `SidePanel` (`src/side-panel.ts`) composed as-is. Redeclaring
+ * `open`/`defaultOpen`/`onOpenChange`/`dismissPolicy` here would be the same
+ * mistake DataTable avoided with Pagination/LoadMore — two places owning
+ * one piece of state that will drift the first time either one changes.
+ */
+export const layoutBehavior = {
+    controlled: [],
+    inputs: ["hasHeader", "hasFooter", "sidebar", "skipLinkLabel"],
+    configuration: {
+        "sidebar.mode": ["persistent", "overlay"],
+        "sidebar.role": ["navigation", "complementary"],
+    },
+    stateAxes: {},
+    web: {
+        roles: ["banner", "navigation", "complementary", "main", "contentinfo"],
+        keyboard: ["Tab"],
+        focus: "native",
+    },
+    native: { roles: [], states: [], actions: [] },
+    scenarios: [
+        "exactly-one-main-landmark-exists-per-layout",
+        "web-skip-link-is-required-whenever-a-header-or-sidebar-precedes-main",
+        "sidebar-role-navigation-or-complementary-is-chosen-independent-of-persistent-or-overlay-mode",
+        "overlay-sidebar-reuses-sidepanel-open-state-and-dismiss-policy-unchanged",
+        "header-and-footer-content-is-not-owned-here-compose-topbar-and-bottomnavigation",
+        "skip-link-is-visually-hidden-until-keyboard-focus-reaches-it",
+        "native-has-no-landmark-role-equivalent-translation-relies-on-order-and-accessibilityviewismodal",
+    ],
+};
+//# sourceMappingURL=layout.js.map

package/dist/layout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../src/layout.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ColorReference } from \"./color-references.js\";\nimport type { BehaviorContract } from \"./behaviors.js\";\nimport { focusIndicatorContract } from \"./component-contracts.js\";\nimport { layout as layoutFoundation, spacing } from \"./foundations.js\";\nimport { semanticColors } from \"./semantic-colors.js\";\n\n/**\n * `Layout` (alias `AppShell`) does NOT own header or footer chrome — that is\n * already `TopBar` (native, beta) and `BottomNavigation` (adaptive, beta).\n * What is left after subtracting those: ordered regions, a sidebar that is\n * either always-visible chrome or a dismissible overlay, and Web-only\n * landmark composition (one `main` plus a required skip link whenever\n * repeated navigation precedes it). The overlay case reuses `SidePanel`\n * unchanged — see docs/layout.md for why this module does not redeclare\n * open/dismiss state.\n */\nexport type LayoutSidebarRole = \"navigation\" | \"complementary\";\nexport type LayoutSidebarMode = \"persistent\" | \"overlay\";\n\nexport type LayoutSidebarDescriptor = Readonly<{\n  /** Primary site navigation vs. supplementary content (filters, related items) — independent of `mode`. */\n  role: LayoutSidebarRole;\n  /** `persistent`: always-visible landmark. `overlay`: a `SidePanel` — Layout does not re-contract its open/dismiss lifecycle. */\n  mode: LayoutSidebarMode;\n  label: string;\n}>;\n\nexport type LayoutDescriptor = Readonly<{\n  hasHeader?: boolean;\n  hasFooter?: boolean;\n  sidebar?: LayoutSidebarDescriptor;\n  /** Web-only: required whenever a header or sidebar precedes `main` (WCAG 2.4.1 bypass blocks). */\n  skipLinkLabel?: string;\n}>;\n\nfunction assertNonEmpty(value: string, field: string): void {\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    throw new TypeError(`Layout ${field} must not be empty`);\n  }\n}\n\n/**\n * Cross-platform structure validation. This deliberately does not require a\n * skip link: Native has no page-landmark or bypass-link equivalent.\n */\nexport function validateLayoutRegions(descriptor: LayoutDescriptor): void {\n  if (descriptor.sidebar !== undefined) {\n    const { role, mode, label } = descriptor.sidebar;\n    if (role !== \"navigation\" && role !== \"complementary\") {\n      throw new TypeError(`Unsupported Layout sidebar role: ${String(role)}`);\n    }\n    if (mode !== \"persistent\" && mode !== \"overlay\") {\n      throw new TypeError(`Unsupported Layout sidebar mode: ${String(mode)}`);\n    }\n    assertNonEmpty(label, \"sidebar.label\");\n  }\n  if (descriptor.skipLinkLabel !== undefined) {\n    assertNonEmpty(descriptor.skipLinkLabel, \"skipLinkLabel\");\n  }\n}\n\n/** Web landmark validation, including the WCAG 2.4.1 bypass-link invariant. */\nexport function validateLayoutWebDescriptor(descriptor: LayoutDescriptor): void {\n  validateLayoutRegions(descriptor);\n  const needsSkipLink = descriptor.hasHeader === true || descriptor.sidebar !== undefined;\n  if (needsSkipLink && descriptor.skipLinkLabel === undefined) {\n    throw new TypeError(\n      \"Layout requires skipLinkLabel when a header or sidebar region precedes main\",\n    );\n  }\n}\n\n/**\n * @deprecated Use `validateLayoutRegions` for shared/Native structure or\n * `validateLayoutWebDescriptor` for a Web app shell.\n */\nexport function validateLayoutDescriptor(descriptor: LayoutDescriptor): void {\n  validateLayoutWebDescriptor(descriptor);\n}\n\nexport type LayoutLandmarkRole =\n  | \"banner\"\n  | \"navigation\"\n  | \"complementary\"\n  | \"main\"\n  | \"contentinfo\";\n\n/**\n * Web-only translation: real landmark elements exist there. Native has no\n * landmark-role equivalent at all (`accessibilityRole` covers headings and\n * controls, not page regions) — RN renderers instead rely on visual/DOM\n * order plus `accessibilityViewIsModal` for the overlay sidebar case. That\n * asymmetry is documented, not papered over with a fake mapping.\n */\nexport function resolveLayoutWebLandmarks(\n  descriptor: LayoutDescriptor,\n): readonly LayoutLandmarkRole[] {\n  validateLayoutWebDescriptor(descriptor);\n  const roles: LayoutLandmarkRole[] = [];\n  if (descriptor.hasHeader) roles.push(\"banner\");\n  if (descriptor.sidebar) roles.push(descriptor.sidebar.role);\n  roles.push(\"main\");\n  if (descriptor.hasFooter) roles.push(\"contentinfo\");\n  return roles;\n}\n\n/**\n * Skip link is hidden until it matters — visible only on keyboard focus.\n * A skip link visible at rest fights identity.md's \"조용한 화면 위에 중요한\n * 순간만 선명하게\": for a mouse/touch user it is noise every screen, for a\n * keyboard user it is the first landmark on the page.\n */\nexport const layoutRecipe = {\n  slots: [\"root\", \"skipLink\", \"header\", \"sidebar\", \"main\", \"footer\"] as const,\n  defaults: {},\n  main: {\n    maxWidth: layoutFoundation.contentMaxWidth,\n    paddingHorizontal: layoutFoundation.pagePadding.regular,\n  },\n  sidebar: {\n    width: 280,\n  },\n  skipLink: {\n    visibility: \"focus-only\",\n    background: semanticColors.action.brand.background,\n    color: semanticColors.action.brand.content,\n    paddingHorizontal: spacing.md,\n    paddingVertical: spacing.sm,\n  },\n  states: { focus: focusIndicatorContract },\n} as const satisfies {\n  slots: readonly [\"root\", \"skipLink\", \"header\", \"sidebar\", \"main\", \"footer\"];\n  defaults: Record<string, never>;\n  main: { maxWidth: number; paddingHorizontal: number };\n  sidebar: { width: number };\n  skipLink: {\n    visibility: \"focus-only\";\n    background: ColorReference;\n    color: ColorReference;\n    paddingHorizontal: number;\n    paddingVertical: number;\n  };\n  states: { focus: typeof focusIndicatorContract };\n};\n\n/**\n * `controlled: []` on purpose: an overlay sidebar's open/dismiss lifecycle\n * is a `SidePanel` (`src/side-panel.ts`) composed as-is. Redeclaring\n * `open`/`defaultOpen`/`onOpenChange`/`dismissPolicy` here would be the same\n * mistake DataTable avoided with Pagination/LoadMore — two places owning\n * one piece of state that will drift the first time either one changes.\n */\nexport const layoutBehavior = {\n  controlled: [],\n  inputs: [\"hasHeader\", \"hasFooter\", \"sidebar\", \"skipLinkLabel\"],\n  configuration: {\n    \"sidebar.mode\": [\"persistent\", \"overlay\"],\n    \"sidebar.role\": [\"navigation\", \"complementary\"],\n  },\n  stateAxes: {},\n  web: {\n    roles: [\"banner\", \"navigation\", \"complementary\", \"main\", \"contentinfo\"],\n    keyboard: [\"Tab\"],\n    focus: \"native\",\n  },\n  native: { roles: [], states: [], actions: [] },\n  scenarios: [\n    \"exactly-one-main-landmark-exists-per-layout\",\n    \"web-skip-link-is-required-whenever-a-header-or-sidebar-precedes-main\",\n    \"sidebar-role-navigation-or-complementary-is-chosen-independent-of-persistent-or-overlay-mode\",\n    \"overlay-sidebar-reuses-sidepanel-open-state-and-dismiss-policy-unchanged\",\n    \"header-and-footer-content-is-not-owned-here-compose-topbar-and-bottomnavigation\",\n    \"skip-link-is-visually-hidden-until-keyboard-focus-reaches-it\",\n    \"native-has-no-landmark-role-equivalent-translation-relies-on-order-and-accessibilityviewismodal\",\n  ],\n} as const satisfies BehaviorContract;\n"]}

package/dist/link.d.ts

@@ -0,0 +1,57 @@
+import { type SemanticIconName } from "./icon.js";
+type ForbiddenLinkCommands = Readonly<{
+    /** Unavailable destinations render as text; links are never disabled controls. */
+    disabled?: never;
+    /** Navigation is owned by href and its platform router, not an action callback. */
+    onClick?: never;
+    onPress?: never;
+    /** Downloads are a separate platform workflow. */
+    download?: never;
+    /** Visited is a Web pseudo-state, not cross-platform application state. */
+    visited?: never;
+}>;
+export type InternalLinkDestination = ForbiddenLinkCommands & Readonly<{
+    kind: "internal";
+    href: string;
+}>;
+export type ExternalLinkDestination = ForbiddenLinkCommands & Readonly<{
+    kind: "external";
+    href: string;
+}>;
+export type LinkDestination = InternalLinkDestination | ExternalLinkDestination;
+/**
+ * Link owns icon appearance through linkRecipe. Callers only choose an HJM
+ * semantic mark; size, tone, weight, and directionality cannot drift.
+ */
+export type LinkIconDescriptor = Readonly<{
+    name: SemanticIconName;
+    decorative?: true;
+    accessibilityLabel?: never;
+    size?: never;
+    tone?: never;
+    weight?: never;
+    directionality?: never;
+}>;
+export type ResolvedLinkIconDescriptor = Readonly<{
+    name: SemanticIconName;
+    decorative: true;
+}>;
+export type LinkDescriptor = ForbiddenLinkCommands & Readonly<{
+    label: string;
+    accessibilityLabel?: string;
+    destination: LinkDestination;
+    leadingIcon?: LinkIconDescriptor;
+    trailingIcon?: LinkIconDescriptor;
+}>;
+export type ResolvedLinkDescriptor = Readonly<{
+    label: string;
+    resolvedAccessibilityLabel: string;
+    destination: LinkDestination;
+    leadingIcon: ResolvedLinkIconDescriptor | null;
+    trailingIcon: ResolvedLinkIconDescriptor | null;
+}>;
+export declare function validateLinkDestination(destination: LinkDestination): void;
+export declare function validateLinkDescriptor(descriptor: LinkDescriptor): void;
+export declare function resolveLinkDescriptor(descriptor: LinkDescriptor): ResolvedLinkDescriptor;
+export {};
+//# sourceMappingURL=link.d.ts.map

package/dist/link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../src/link.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,WAAW,CAAC;AAEnB,KAAK,qBAAqB,GAAG,QAAQ,CAAC;IACpC,kFAAkF;IAClF,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,mFAAmF;IACnF,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,KAAK,CAAC;CACjB,CAAC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,qBAAqB,GACzD,QAAQ,CAAC;IACP,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,CAAC;AAEL,MAAM,MAAM,uBAAuB,GAAG,qBAAqB,GACzD,QAAQ,CAAC;IACP,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,CAAC;AAEL,MAAM,MAAM,eAAe,GACvB,uBAAuB,GACvB,uBAAuB,CAAC;AAE5B;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,IAAI,EAAE,gBAAgB,CAAC;IACvB,UAAU,CAAC,EAAE,IAAI,CAAC;IAClB,kBAAkB,CAAC,EAAE,KAAK,CAAC;IAC3B,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,cAAc,CAAC,EAAE,KAAK,CAAC;CACxB,CAAC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAAC;IAChD,IAAI,EAAE,gBAAgB,CAAC;IACvB,UAAU,EAAE,IAAI,CAAC;CAClB,CAAC,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,qBAAqB,GAChD,QAAQ,CAAC;IACP,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,eAAe,CAAC;IAC7B,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,YAAY,CAAC,EAAE,kBAAkB,CAAC;CACnC,CAAC,CAAC;AAEL,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,0BAA0B,EAAE,MAAM,CAAC;IACnC,WAAW,EAAE,eAAe,CAAC;IAC7B,WAAW,EAAE,0BAA0B,GAAG,IAAI,CAAC;IAC/C,YAAY,EAAE,0BAA0B,GAAG,IAAI,CAAC;CACjD,CAAC,CAAC;AA8FH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,eAAe,GAC3B,IAAI,CAcN;AAsBD,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI,CA2BvE;AAQD,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,cAAc,GACzB,sBAAsB,CAaxB"}

package/dist/link.js

@@ -0,0 +1,142 @@
+import { semanticIconNames, } from "./icon.js";
+const externalProtocols = new Set(["https:", "http:", "mailto:", "tel:"]);
+const semanticNames = new Set(semanticIconNames);
+const descriptorKeys = new Set([
+    "label",
+    "accessibilityLabel",
+    "destination",
+    "leadingIcon",
+    "trailingIcon",
+]);
+const destinationKeys = new Set(["kind", "href"]);
+const iconKeys = new Set(["name", "decorative"]);
+function isObject(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function validateCopy(value, field) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new TypeError(`Link ${field} must not be empty`);
+    }
+    if (value !== value.trim()) {
+        throw new TypeError(`Link ${field} must not start or end with whitespace`);
+    }
+}
+function rejectUnknownKeys(value, allowed, field) {
+    for (const key of Object.keys(value)) {
+        if (!allowed.has(key)) {
+            throw new TypeError(`Unsupported ${field} field: ${key}`);
+        }
+    }
+}
+function normalizedCopy(value) {
+    return value.normalize("NFKC").toLocaleLowerCase();
+}
+function validateHref(href, kind) {
+    validateCopy(href, "href");
+    if (/\s/u.test(href)) {
+        throw new TypeError("Link href must encode whitespace");
+    }
+    if (kind === "internal") {
+        if (href.includes("\\")) {
+            throw new TypeError("Internal Link href must not contain backslashes");
+        }
+        if ((href.startsWith("/") && !href.startsWith("//")) ||
+            href.startsWith("?") ||
+            href.startsWith("#")) {
+            return;
+        }
+        throw new TypeError("Internal Link href must be root-relative, query-relative, or a fragment");
+    }
+    let parsed;
+    try {
+        parsed = new URL(href);
+    }
+    catch {
+        throw new TypeError("External Link href must be an absolute URL");
+    }
+    if (!externalProtocols.has(parsed.protocol)) {
+        throw new TypeError(`Unsupported external Link protocol: ${parsed.protocol}`);
+    }
+    if (parsed.username.length > 0 || parsed.password.length > 0) {
+        throw new TypeError("External Link href must not contain credentials");
+    }
+}
+function rejectCommandFields(value) {
+    for (const field of [
+        "disabled",
+        "onClick",
+        "onPress",
+        "download",
+        "visited",
+    ]) {
+        if (Object.prototype.hasOwnProperty.call(value, field)) {
+            throw new TypeError(`Link must not provide ${field}`);
+        }
+    }
+}
+export function validateLinkDestination(destination) {
+    if (!isObject(destination)) {
+        throw new TypeError("Link destination must be an object");
+    }
+    const candidate = destination;
+    rejectCommandFields(candidate);
+    rejectUnknownKeys(candidate, destinationKeys, "Link destination");
+    const kind = candidate.kind;
+    if (kind !== "internal" && kind !== "external") {
+        throw new TypeError(`Unsupported Link destination kind: ${String(kind)}`);
+    }
+    validateHref(candidate.href, kind);
+}
+function validateLinkIcon(icon, field) {
+    if (!isObject(icon)) {
+        throw new TypeError(`Link ${field} must be an icon descriptor`);
+    }
+    const candidate = icon;
+    if (candidate.decorative !== undefined &&
+        candidate.decorative !== true) {
+        throw new TypeError(`Link ${field} must be decorative`);
+    }
+    rejectUnknownKeys(candidate, iconKeys, `Link ${field}`);
+    if (typeof candidate.name !== "string" || !semanticNames.has(candidate.name)) {
+        throw new TypeError(`Link ${field} must use an HJM semantic icon name`);
+    }
+}
+export function validateLinkDescriptor(descriptor) {
+    if (!isObject(descriptor)) {
+        throw new TypeError("Link descriptor must be an object");
+    }
+    const candidate = descriptor;
+    rejectCommandFields(candidate);
+    rejectUnknownKeys(candidate, descriptorKeys, "Link descriptor");
+    validateCopy(descriptor.label, "label");
+    if (descriptor.accessibilityLabel !== undefined) {
+        validateCopy(descriptor.accessibilityLabel, "accessibilityLabel");
+        if (!normalizedCopy(descriptor.accessibilityLabel).includes(normalizedCopy(descriptor.label))) {
+            throw new TypeError("Link accessibilityLabel must include the visible label");
+        }
+    }
+    validateLinkDestination(descriptor.destination);
+    if (descriptor.leadingIcon !== undefined) {
+        validateLinkIcon(descriptor.leadingIcon, "leadingIcon");
+    }
+    if (descriptor.trailingIcon !== undefined) {
+        validateLinkIcon(descriptor.trailingIcon, "trailingIcon");
+    }
+}
+function resolveLinkIcon(icon) {
+    return icon === undefined ? null : { name: icon.name, decorative: true };
+}
+export function resolveLinkDescriptor(descriptor) {
+    validateLinkDescriptor(descriptor);
+    return {
+        label: descriptor.label,
+        resolvedAccessibilityLabel: descriptor.accessibilityLabel ?? descriptor.label,
+        destination: {
+            kind: descriptor.destination.kind,
+            href: descriptor.destination.href,
+        },
+        leadingIcon: resolveLinkIcon(descriptor.leadingIcon),
+        trailingIcon: resolveLinkIcon(descriptor.trailingIcon),
+    };
+}
+//# sourceMappingURL=link.js.map

package/dist/link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.js","sourceRoot":"","sources":["../src/link.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  semanticIconNames,\n  type SemanticIconName,\n} from \"./icon.js\";\n\ntype ForbiddenLinkCommands = Readonly<{\n  /** Unavailable destinations render as text; links are never disabled controls. */\n  disabled?: never;\n  /** Navigation is owned by href and its platform router, not an action callback. */\n  onClick?: never;\n  onPress?: never;\n  /** Downloads are a separate platform workflow. */\n  download?: never;\n  /** Visited is a Web pseudo-state, not cross-platform application state. */\n  visited?: never;\n}>;\n\nexport type InternalLinkDestination = ForbiddenLinkCommands &\n  Readonly<{\n    kind: \"internal\";\n    href: string;\n  }>;\n\nexport type ExternalLinkDestination = ForbiddenLinkCommands &\n  Readonly<{\n    kind: \"external\";\n    href: string;\n  }>;\n\nexport type LinkDestination =\n  | InternalLinkDestination\n  | ExternalLinkDestination;\n\n/**\n * Link owns icon appearance through linkRecipe. Callers only choose an HJM\n * semantic mark; size, tone, weight, and directionality cannot drift.\n */\nexport type LinkIconDescriptor = Readonly<{\n  name: SemanticIconName;\n  decorative?: true;\n  accessibilityLabel?: never;\n  size?: never;\n  tone?: never;\n  weight?: never;\n  directionality?: never;\n}>;\n\nexport type ResolvedLinkIconDescriptor = Readonly<{\n  name: SemanticIconName;\n  decorative: true;\n}>;\n\nexport type LinkDescriptor = ForbiddenLinkCommands &\n  Readonly<{\n    label: string;\n    accessibilityLabel?: string;\n    destination: LinkDestination;\n    leadingIcon?: LinkIconDescriptor;\n    trailingIcon?: LinkIconDescriptor;\n  }>;\n\nexport type ResolvedLinkDescriptor = Readonly<{\n  label: string;\n  resolvedAccessibilityLabel: string;\n  destination: LinkDestination;\n  leadingIcon: ResolvedLinkIconDescriptor | null;\n  trailingIcon: ResolvedLinkIconDescriptor | null;\n}>;\n\nconst externalProtocols = new Set([\"https:\", \"http:\", \"mailto:\", \"tel:\"]);\nconst semanticNames = new Set<string>(semanticIconNames);\nconst descriptorKeys = new Set([\n  \"label\",\n  \"accessibilityLabel\",\n  \"destination\",\n  \"leadingIcon\",\n  \"trailingIcon\",\n]);\nconst destinationKeys = new Set([\"kind\", \"href\"]);\nconst iconKeys = new Set([\"name\", \"decorative\"]);\n\nfunction isObject(value: unknown): value is Readonly<Record<string, unknown>> {\n  return value !== null && typeof value === \"object\" && !Array.isArray(value);\n}\n\nfunction validateCopy(value: unknown, field: string): asserts value is string {\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    throw new TypeError(`Link ${field} must not be empty`);\n  }\n  if (value !== value.trim()) {\n    throw new TypeError(`Link ${field} must not start or end with whitespace`);\n  }\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 ${field} field: ${key}`);\n    }\n  }\n}\n\nfunction normalizedCopy(value: string): string {\n  return value.normalize(\"NFKC\").toLocaleLowerCase();\n}\n\nfunction validateHref(href: unknown, kind: LinkDestination[\"kind\"]): void {\n  validateCopy(href, \"href\");\n  if (/\\s/u.test(href)) {\n    throw new TypeError(\"Link href must encode whitespace\");\n  }\n  if (kind === \"internal\") {\n    if (href.includes(\"\\\\\")) {\n      throw new TypeError(\"Internal Link href must not contain backslashes\");\n    }\n    if (\n      (href.startsWith(\"/\") && !href.startsWith(\"//\")) ||\n      href.startsWith(\"?\") ||\n      href.startsWith(\"#\")\n    ) {\n      return;\n    }\n    throw new TypeError(\n      \"Internal Link href must be root-relative, query-relative, or a fragment\",\n    );\n  }\n\n  let parsed: URL;\n  try {\n    parsed = new URL(href);\n  } catch {\n    throw new TypeError(\"External Link href must be an absolute URL\");\n  }\n  if (!externalProtocols.has(parsed.protocol)) {\n    throw new TypeError(\n      `Unsupported external Link protocol: ${parsed.protocol}`,\n    );\n  }\n  if (parsed.username.length > 0 || parsed.password.length > 0) {\n    throw new TypeError(\"External Link href must not contain credentials\");\n  }\n}\n\nfunction rejectCommandFields(value: Readonly<Record<string, unknown>>): void {\n  for (const field of [\n    \"disabled\",\n    \"onClick\",\n    \"onPress\",\n    \"download\",\n    \"visited\",\n  ] as const) {\n    if (Object.prototype.hasOwnProperty.call(value, field)) {\n      throw new TypeError(`Link must not provide ${field}`);\n    }\n  }\n}\n\nexport function validateLinkDestination(\n  destination: LinkDestination,\n): void {\n  if (!isObject(destination)) {\n    throw new TypeError(\"Link destination must be an object\");\n  }\n  const candidate = destination as Readonly<Record<string, unknown>>;\n  rejectCommandFields(candidate);\n  rejectUnknownKeys(candidate, destinationKeys, \"Link destination\");\n  const kind = candidate.kind;\n  if (kind !== \"internal\" && kind !== \"external\") {\n    throw new TypeError(\n      `Unsupported Link destination kind: ${String(kind)}`,\n    );\n  }\n  validateHref(candidate.href, kind);\n}\n\nfunction validateLinkIcon(\n  icon: LinkIconDescriptor,\n  field: string,\n): void {\n  if (!isObject(icon)) {\n    throw new TypeError(`Link ${field} must be an icon descriptor`);\n  }\n  const candidate = icon as Readonly<Record<string, unknown>>;\n  if (\n    candidate.decorative !== undefined &&\n    candidate.decorative !== true\n  ) {\n    throw new TypeError(`Link ${field} must be decorative`);\n  }\n  rejectUnknownKeys(candidate, iconKeys, `Link ${field}`);\n  if (typeof candidate.name !== \"string\" || !semanticNames.has(candidate.name)) {\n    throw new TypeError(`Link ${field} must use an HJM semantic icon name`);\n  }\n}\n\nexport function validateLinkDescriptor(descriptor: LinkDescriptor): void {\n  if (!isObject(descriptor)) {\n    throw new TypeError(\"Link descriptor must be an object\");\n  }\n  const candidate = descriptor as Readonly<Record<string, unknown>>;\n  rejectCommandFields(candidate);\n  rejectUnknownKeys(candidate, descriptorKeys, \"Link descriptor\");\n  validateCopy(descriptor.label, \"label\");\n  if (descriptor.accessibilityLabel !== undefined) {\n    validateCopy(descriptor.accessibilityLabel, \"accessibilityLabel\");\n    if (\n      !normalizedCopy(descriptor.accessibilityLabel).includes(\n        normalizedCopy(descriptor.label),\n      )\n    ) {\n      throw new TypeError(\n        \"Link accessibilityLabel must include the visible label\",\n      );\n    }\n  }\n  validateLinkDestination(descriptor.destination);\n  if (descriptor.leadingIcon !== undefined) {\n    validateLinkIcon(descriptor.leadingIcon, \"leadingIcon\");\n  }\n  if (descriptor.trailingIcon !== undefined) {\n    validateLinkIcon(descriptor.trailingIcon, \"trailingIcon\");\n  }\n}\n\nfunction resolveLinkIcon(\n  icon: LinkIconDescriptor | undefined,\n): ResolvedLinkIconDescriptor | null {\n  return icon === undefined ? null : { name: icon.name, decorative: true };\n}\n\nexport function resolveLinkDescriptor(\n  descriptor: LinkDescriptor,\n): ResolvedLinkDescriptor {\n  validateLinkDescriptor(descriptor);\n  return {\n    label: descriptor.label,\n    resolvedAccessibilityLabel:\n      descriptor.accessibilityLabel ?? descriptor.label,\n    destination: {\n      kind: descriptor.destination.kind,\n      href: descriptor.destination.href,\n    },\n    leadingIcon: resolveLinkIcon(descriptor.leadingIcon),\n    trailingIcon: resolveLinkIcon(descriptor.trailingIcon),\n  };\n}\n"]}

package/dist/load-more.d.ts

@@ -0,0 +1,64 @@
+export type LoadMoreMode = "automatic" | "manual";
+export type LoadMoreRequestReason = "viewport" | "manual" | "retry";
+export type LoadMoreReadyState = Readonly<{
+    status: "ready";
+    requestKey: string;
+}>;
+export type LoadMoreLoadingState = Readonly<{
+    status: "loading";
+    requestKey: string;
+}>;
+export type LoadMoreErrorState = Readonly<{
+    status: "error";
+    requestKey: string;
+    message: string;
+}>;
+export type LoadMoreCompleteState = Readonly<{
+    status: "complete";
+    requestKey?: never;
+}>;
+/** Existing collection items stay mounted while this footer state changes. */
+export type LoadMoreState = LoadMoreReadyState | LoadMoreLoadingState | LoadMoreErrorState | LoadMoreCompleteState;
+export type LoadMoreRequest = Readonly<{
+    requestKey: string;
+    reason: LoadMoreRequestReason;
+}>;
+export type LoadMoreLabels = Readonly<{
+    loadMore: string;
+    loading: string;
+    retry: string;
+    complete: string;
+}>;
+export type LoadMoreDescriptor = Readonly<{
+    state: LoadMoreState;
+    labels: LoadMoreLabels;
+}>;
+export type LoadMoreRequestHandler = (request: LoadMoreRequest) => Promise<void>;
+export type LoadMoreRequestOutcome = "started" | "blocked-by-mode" | "blocked-by-state" | "already-requesting";
+export type LoadMoreControllerOptions = Readonly<{
+    mode?: LoadMoreMode;
+    onLoadMore: LoadMoreRequestHandler;
+}>;
+export type LoadMoreControllerSnapshot = Readonly<{
+    mode: LoadMoreMode;
+    inFlightRequestKey: string | null;
+    disposed: boolean;
+}>;
+export type LoadMoreController = Readonly<{
+    getSnapshot(): LoadMoreControllerSnapshot;
+    request(state: LoadMoreState, reason: LoadMoreRequestReason): Promise<LoadMoreRequestOutcome>;
+    dispose(): boolean;
+}>;
+export declare const loadMoreBehaviorDefaults: {
+    readonly mode: "automatic";
+};
+export declare function validateLoadMoreState(state: LoadMoreState): void;
+export declare function validateLoadMoreLabels(labels: LoadMoreLabels): void;
+export declare function validateLoadMoreDescriptor(descriptor: LoadMoreDescriptor): void;
+export declare function canRequestLoadMore(state: LoadMoreState, mode: LoadMoreMode, reason: LoadMoreRequestReason): boolean;
+/**
+ * Prevents duplicate and out-of-order page requests without owning collection
+ * data. Query state remains product-owned; this controller only gates events.
+ */
+export declare function createLoadMoreController(options: LoadMoreControllerOptions): LoadMoreController;
+//# sourceMappingURL=load-more.d.ts.map

package/dist/load-more.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-more.d.ts","sourceRoot":"","sources":["../src/load-more.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,QAAQ,CAAC;AAClD,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEpE,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,MAAM,EAAE,SAAS,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IAC3C,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,CAAC,EAAE,KAAK,CAAC;CACpB,CAAC,CAAC;AAEH,8EAA8E;AAC9E,MAAM,MAAM,aAAa,GACrB,kBAAkB,GAClB,oBAAoB,GACpB,kBAAkB,GAClB,qBAAqB,CAAC;AAE1B,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,qBAAqB,CAAC;CAC/B,CAAC,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,KAAK,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,cAAc,CAAC;CACxB,CAAC,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CACnC,OAAO,EAAE,eAAe,KACrB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,MAAM,MAAM,sBAAsB,GAC9B,SAAS,GACT,iBAAiB,GACjB,kBAAkB,GAClB,oBAAoB,CAAC;AAEzB,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAC/C,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,UAAU,EAAE,sBAAsB,CAAC;CACpC,CAAC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAAC;IAChD,IAAI,EAAE,YAAY,CAAC;IACnB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,WAAW,IAAI,0BAA0B,CAAC;IAC1C,OAAO,CACL,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,sBAAsB,CAAC,CAAC;IACnC,OAAO,IAAI,OAAO,CAAC;CACpB,CAAC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;CAEgB,CAAC;AAQtD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAgBhE;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,CAUnE;AAED,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,kBAAkB,GAAG,IAAI,CAG/E;AAED,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE,YAAY,EAClB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAaT;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,yBAAyB,GACjC,kBAAkB,CAkEpB"}