@hjmds/design-contracts 0.8.2

package/dist/component-definitions.d.ts

@@ -0,0 +1,135 @@
+import { type ComponentCatalogEntry, type ComponentCategory, type ComponentName, type ComponentPlatform, type ComponentStatus, type ComponentSurface as CatalogComponentSurface, type ComponentSurfaceStatus as CatalogComponentSurfaceStatus, type RecipeName } from "./catalog.js";
+import type { BehaviorName } from "./behaviors.js";
+export type ComponentKind = "primitive" | "component" | "provider" | "utility";
+/** Kept here as aliases for existing `component-definitions` consumers. */
+export type ComponentSurface = CatalogComponentSurface;
+export type ComponentSurfaceStatus = CatalogComponentSurfaceStatus;
+/** Stable IDs survive display-name and category changes. */
+export declare const componentIds: {
+    readonly Text: "text";
+    readonly Icon: "icon";
+    readonly Surface: "surface";
+    readonly Divider: "divider";
+    readonly Section: "section";
+    readonly Stack: "stack";
+    readonly Grid: "grid";
+    readonly Layout: "layout";
+    readonly Masonry: "masonry";
+    readonly Splitter: "splitter";
+    readonly Button: "button";
+    readonly IconButton: "icon-button";
+    readonly Link: "link";
+    readonly BottomCTA: "bottom-cta";
+    readonly FloatingActionButton: "floating-action-button";
+    readonly Field: "field";
+    readonly SearchField: "search-field";
+    readonly TextArea: "text-area";
+    readonly PasswordField: "password-field";
+    readonly OtpField: "otp-field";
+    readonly Checkbox: "checkbox";
+    readonly Radio: "radio";
+    readonly CheckboxGroup: "checkbox-group";
+    readonly RadioGroup: "radio-group";
+    readonly Switch: "switch";
+    readonly Chip: "chip";
+    readonly SegmentedControl: "segmented-control";
+    readonly Slider: "slider";
+    readonly NumberField: "number-field";
+    readonly Select: "select";
+    readonly Combobox: "combobox";
+    readonly DatePicker: "date-picker";
+    readonly TimePicker: "time-picker";
+    readonly ColorPicker: "color-picker";
+    readonly FilePicker: "file-picker";
+    readonly Cascader: "cascader";
+    readonly Form: "form";
+    readonly Mentions: "mentions";
+    readonly Rating: "rating";
+    readonly TransferList: "transfer-list";
+    readonly TreeSelect: "tree-select";
+    readonly UploadItem: "upload-item";
+    readonly Tabs: "tabs";
+    readonly TopBar: "top-bar";
+    readonly BottomNavigation: "bottom-navigation";
+    readonly Breadcrumb: "breadcrumb";
+    readonly Pagination: "pagination";
+    readonly LoadMore: "load-more";
+    readonly Steps: "steps";
+    readonly Menu: "menu";
+    readonly Anchor: "anchor";
+    readonly Avatar: "avatar";
+    readonly Badge: "badge";
+    readonly CounterBadge: "counter-badge";
+    readonly Card: "card";
+    readonly List: "list";
+    readonly ListRow: "list-row";
+    readonly VirtualList: "virtual-list";
+    readonly Accordion: "accordion";
+    readonly Statistic: "statistic";
+    readonly Timeline: "timeline";
+    readonly DataTable: "data-table";
+    readonly Tree: "tree";
+    readonly Calendar: "calendar";
+    readonly Carousel: "carousel";
+    readonly DescriptionList: "description-list";
+    readonly Image: "image";
+    readonly QRCode: "qr-code";
+    readonly Tag: "tag";
+    readonly Tour: "tour";
+    readonly EmptyState: "empty-state";
+    readonly Notice: "notice";
+    readonly Progress: "progress";
+    readonly Spinner: "spinner";
+    readonly Skeleton: "skeleton";
+    readonly Result: "result";
+    readonly Toast: "toast";
+    readonly Watermark: "watermark";
+    readonly Dialog: "dialog";
+    readonly AlertDialog: "alert-dialog";
+    readonly Sheet: "sheet";
+    readonly SidePanel: "side-panel";
+    readonly Popover: "popover";
+    readonly ConfirmPopover: "confirm-popover";
+    readonly Tooltip: "tooltip";
+    readonly CommandPalette: "command-palette";
+    readonly Affix: "affix";
+    readonly AppProvider: "app-provider";
+    readonly BorderBeam: "border-beam";
+    readonly DesignSystemProvider: "design-system-provider";
+    readonly Utility: "utility";
+};
+export type ComponentId = (typeof componentIds)[ComponentName];
+export type ComponentDefinition = Readonly<{
+    id: ComponentId;
+    name: ComponentName;
+    category: ComponentCategory;
+    kind: ComponentKind;
+    contract: Readonly<{
+        status: ComponentStatus;
+        recipes: readonly RecipeName[];
+        behaviors: readonly BehaviorName[];
+        roadmap?: ComponentCatalogEntry["roadmap"];
+    }>;
+    surfaces: Readonly<{
+        parity: ComponentPlatform;
+        web: Readonly<{
+            status: ComponentSurfaceStatus;
+        }>;
+        native: Readonly<{
+            status: ComponentSurfaceStatus;
+        }>;
+    }>;
+    docs: Readonly<{
+        /** New stable documentation key. Legacy Showcase IDs remain supported during migration. */
+        storyId: `components/${ComponentId}`;
+        aliases: readonly string[];
+    }>;
+}>;
+/**
+ * Backward-compatible normalized view over the v0.2 catalog. New consumers
+ * should prefer this shape so a component can evolve to multiple recipes,
+ * behaviors, and different Web/Native maturity without another API rewrite.
+ */
+export declare const componentDefinitions: readonly ComponentDefinition[];
+export declare function getComponentDefinition(idOrName: ComponentId | ComponentName): ComponentDefinition | undefined;
+//# sourceMappingURL=component-definitions.d.ts.map

package/dist/component-definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-definitions.d.ts","sourceRoot":"","sources":["../src/component-definitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,gBAAgB,IAAI,uBAAuB,EAChD,KAAK,sBAAsB,IAAI,6BAA6B,EAC5D,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;AAC/E,2EAA2E;AAC3E,MAAM,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;AACvD,MAAM,MAAM,sBAAsB,GAAG,6BAA6B,CAAC;AAEnE,4DAA4D;AAC5D,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4FmC,CAAC;AAE7D,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,aAAa,CAAC,CAAC;AAE/D,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACzC,EAAE,EAAE,WAAW,CAAC;IAChB,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,QAAQ,CAAC;QACjB,MAAM,EAAE,eAAe,CAAC;QACxB,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;QAC/B,SAAS,EAAE,SAAS,YAAY,EAAE,CAAC;QACnC,OAAO,CAAC,EAAE,qBAAqB,CAAC,SAAS,CAAC,CAAC;KAC5C,CAAC,CAAC;IACH,QAAQ,EAAE,QAAQ,CAAC;QACjB,MAAM,EAAE,iBAAiB,CAAC;QAC1B,GAAG,EAAE,QAAQ,CAAC;YAAE,MAAM,EAAE,sBAAsB,CAAA;SAAE,CAAC,CAAC;QAClD,MAAM,EAAE,QAAQ,CAAC;YAAE,MAAM,EAAE,sBAAsB,CAAA;SAAE,CAAC,CAAC;KACtD,CAAC,CAAC;IACH,IAAI,EAAE,QAAQ,CAAC;QACb,2FAA2F;QAC3F,OAAO,EAAE,cAAc,WAAW,EAAE,CAAC;QACrC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;KAC5B,CAAC,CAAC;CACJ,CAAC,CAAC;AAeH;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,mBAAmB,EAyB7D,CAAC;AAEH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,WAAW,GAAG,aAAa,GACpC,mBAAmB,GAAG,SAAS,CAIjC"}

package/dist/component-definitions.js

@@ -0,0 +1,142 @@
+import { componentCatalog, getComponentSurfaceStatus, } from "./catalog.js";
+/** Stable IDs survive display-name and category changes. */
+export const componentIds = {
+    Text: "text",
+    Icon: "icon",
+    Surface: "surface",
+    Divider: "divider",
+    Section: "section",
+    Stack: "stack",
+    Grid: "grid",
+    Layout: "layout",
+    Masonry: "masonry",
+    Splitter: "splitter",
+    Button: "button",
+    IconButton: "icon-button",
+    Link: "link",
+    BottomCTA: "bottom-cta",
+    FloatingActionButton: "floating-action-button",
+    Field: "field",
+    SearchField: "search-field",
+    TextArea: "text-area",
+    PasswordField: "password-field",
+    OtpField: "otp-field",
+    Checkbox: "checkbox",
+    Radio: "radio",
+    CheckboxGroup: "checkbox-group",
+    RadioGroup: "radio-group",
+    Switch: "switch",
+    Chip: "chip",
+    SegmentedControl: "segmented-control",
+    Slider: "slider",
+    NumberField: "number-field",
+    Select: "select",
+    Combobox: "combobox",
+    DatePicker: "date-picker",
+    TimePicker: "time-picker",
+    ColorPicker: "color-picker",
+    FilePicker: "file-picker",
+    Cascader: "cascader",
+    Form: "form",
+    Mentions: "mentions",
+    Rating: "rating",
+    TransferList: "transfer-list",
+    TreeSelect: "tree-select",
+    UploadItem: "upload-item",
+    Tabs: "tabs",
+    TopBar: "top-bar",
+    BottomNavigation: "bottom-navigation",
+    Breadcrumb: "breadcrumb",
+    Pagination: "pagination",
+    LoadMore: "load-more",
+    Steps: "steps",
+    Menu: "menu",
+    Anchor: "anchor",
+    Avatar: "avatar",
+    Badge: "badge",
+    CounterBadge: "counter-badge",
+    Card: "card",
+    List: "list",
+    ListRow: "list-row",
+    VirtualList: "virtual-list",
+    Accordion: "accordion",
+    Statistic: "statistic",
+    Timeline: "timeline",
+    DataTable: "data-table",
+    Tree: "tree",
+    Calendar: "calendar",
+    Carousel: "carousel",
+    DescriptionList: "description-list",
+    Image: "image",
+    QRCode: "qr-code",
+    Tag: "tag",
+    Tour: "tour",
+    EmptyState: "empty-state",
+    Notice: "notice",
+    Progress: "progress",
+    Spinner: "spinner",
+    Skeleton: "skeleton",
+    Result: "result",
+    Toast: "toast",
+    Watermark: "watermark",
+    Dialog: "dialog",
+    AlertDialog: "alert-dialog",
+    Sheet: "sheet",
+    SidePanel: "side-panel",
+    Popover: "popover",
+    ConfirmPopover: "confirm-popover",
+    Tooltip: "tooltip",
+    CommandPalette: "command-palette",
+    Affix: "affix",
+    AppProvider: "app-provider",
+    BorderBeam: "border-beam",
+    DesignSystemProvider: "design-system-provider",
+    Utility: "utility",
+};
+const kindByCategory = {
+    foundation: "primitive",
+    layout: "primitive",
+    action: "component",
+    input: "component",
+    navigation: "component",
+    "data-display": "component",
+    feedback: "component",
+    overlay: "component",
+    provider: "provider",
+    utility: "utility",
+};
+/**
+ * Backward-compatible normalized view over the v0.2 catalog. New consumers
+ * should prefer this shape so a component can evolve to multiple recipes,
+ * behaviors, and different Web/Native maturity without another API rewrite.
+ */
+export const componentDefinitions = componentCatalog.map((rawEntry) => {
+    const entry = rawEntry;
+    const name = entry.name;
+    const id = componentIds[name];
+    return {
+        id,
+        name,
+        category: entry.category,
+        kind: kindByCategory[entry.category],
+        contract: {
+            status: entry.status,
+            recipes: entry.recipe ? [entry.recipe] : [],
+            behaviors: entry.behavior ? [entry.behavior] : [],
+            roadmap: entry.roadmap,
+        },
+        surfaces: {
+            parity: entry.platform,
+            web: { status: getComponentSurfaceStatus(entry, "web") },
+            native: { status: getComponentSurfaceStatus(entry, "native") },
+        },
+        docs: {
+            storyId: `components/${id}`,
+            aliases: entry.aliases ?? [],
+        },
+    };
+});
+export function getComponentDefinition(idOrName) {
+    return componentDefinitions.find((definition) => definition.id === idOrName || definition.name === idOrName);
+}
+//# sourceMappingURL=component-definitions.js.map

package/dist/component-definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-definitions.js","sourceRoot":"","sources":["../src/component-definitions.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  componentCatalog,\n  getComponentSurfaceStatus,\n  type ComponentCatalogEntry,\n  type ComponentCategory,\n  type ComponentName,\n  type ComponentPlatform,\n  type ComponentStatus,\n  type ComponentSurface as CatalogComponentSurface,\n  type ComponentSurfaceStatus as CatalogComponentSurfaceStatus,\n  type RecipeName,\n} from \"./catalog.js\";\nimport type { BehaviorName } from \"./behaviors.js\";\n\nexport type ComponentKind = \"primitive\" | \"component\" | \"provider\" | \"utility\";\n/** Kept here as aliases for existing `component-definitions` consumers. */\nexport type ComponentSurface = CatalogComponentSurface;\nexport type ComponentSurfaceStatus = CatalogComponentSurfaceStatus;\n\n/** Stable IDs survive display-name and category changes. */\nexport const componentIds = {\n  Text: \"text\",\n  Icon: \"icon\",\n  Surface: \"surface\",\n  Divider: \"divider\",\n  Section: \"section\",\n  Stack: \"stack\",\n  Grid: \"grid\",\n  Layout: \"layout\",\n  Masonry: \"masonry\",\n  Splitter: \"splitter\",\n  Button: \"button\",\n  IconButton: \"icon-button\",\n  Link: \"link\",\n  BottomCTA: \"bottom-cta\",\n  FloatingActionButton: \"floating-action-button\",\n  Field: \"field\",\n  SearchField: \"search-field\",\n  TextArea: \"text-area\",\n  PasswordField: \"password-field\",\n  OtpField: \"otp-field\",\n  Checkbox: \"checkbox\",\n  Radio: \"radio\",\n  CheckboxGroup: \"checkbox-group\",\n  RadioGroup: \"radio-group\",\n  Switch: \"switch\",\n  Chip: \"chip\",\n  SegmentedControl: \"segmented-control\",\n  Slider: \"slider\",\n  NumberField: \"number-field\",\n  Select: \"select\",\n  Combobox: \"combobox\",\n  DatePicker: \"date-picker\",\n  TimePicker: \"time-picker\",\n  ColorPicker: \"color-picker\",\n  FilePicker: \"file-picker\",\n  Cascader: \"cascader\",\n  Form: \"form\",\n  Mentions: \"mentions\",\n  Rating: \"rating\",\n  TransferList: \"transfer-list\",\n  TreeSelect: \"tree-select\",\n  UploadItem: \"upload-item\",\n  Tabs: \"tabs\",\n  TopBar: \"top-bar\",\n  BottomNavigation: \"bottom-navigation\",\n  Breadcrumb: \"breadcrumb\",\n  Pagination: \"pagination\",\n  LoadMore: \"load-more\",\n  Steps: \"steps\",\n  Menu: \"menu\",\n  Anchor: \"anchor\",\n  Avatar: \"avatar\",\n  Badge: \"badge\",\n  CounterBadge: \"counter-badge\",\n  Card: \"card\",\n  List: \"list\",\n  ListRow: \"list-row\",\n  VirtualList: \"virtual-list\",\n  Accordion: \"accordion\",\n  Statistic: \"statistic\",\n  Timeline: \"timeline\",\n  DataTable: \"data-table\",\n  Tree: \"tree\",\n  Calendar: \"calendar\",\n  Carousel: \"carousel\",\n  DescriptionList: \"description-list\",\n  Image: \"image\",\n  QRCode: \"qr-code\",\n  Tag: \"tag\",\n  Tour: \"tour\",\n  EmptyState: \"empty-state\",\n  Notice: \"notice\",\n  Progress: \"progress\",\n  Spinner: \"spinner\",\n  Skeleton: \"skeleton\",\n  Result: \"result\",\n  Toast: \"toast\",\n  Watermark: \"watermark\",\n  Dialog: \"dialog\",\n  AlertDialog: \"alert-dialog\",\n  Sheet: \"sheet\",\n  SidePanel: \"side-panel\",\n  Popover: \"popover\",\n  ConfirmPopover: \"confirm-popover\",\n  Tooltip: \"tooltip\",\n  CommandPalette: \"command-palette\",\n  Affix: \"affix\",\n  AppProvider: \"app-provider\",\n  BorderBeam: \"border-beam\",\n  DesignSystemProvider: \"design-system-provider\",\n  Utility: \"utility\",\n} as const satisfies Readonly<Record<ComponentName, string>>;\n\nexport type ComponentId = (typeof componentIds)[ComponentName];\n\nexport type ComponentDefinition = Readonly<{\n  id: ComponentId;\n  name: ComponentName;\n  category: ComponentCategory;\n  kind: ComponentKind;\n  contract: Readonly<{\n    status: ComponentStatus;\n    recipes: readonly RecipeName[];\n    behaviors: readonly BehaviorName[];\n    roadmap?: ComponentCatalogEntry[\"roadmap\"];\n  }>;\n  surfaces: Readonly<{\n    parity: ComponentPlatform;\n    web: Readonly<{ status: ComponentSurfaceStatus }>;\n    native: Readonly<{ status: ComponentSurfaceStatus }>;\n  }>;\n  docs: Readonly<{\n    /** New stable documentation key. Legacy Showcase IDs remain supported during migration. */\n    storyId: `components/${ComponentId}`;\n    aliases: readonly string[];\n  }>;\n}>;\n\nconst kindByCategory: Readonly<Record<ComponentCategory, ComponentKind>> = {\n  foundation: \"primitive\",\n  layout: \"primitive\",\n  action: \"component\",\n  input: \"component\",\n  navigation: \"component\",\n  \"data-display\": \"component\",\n  feedback: \"component\",\n  overlay: \"component\",\n  provider: \"provider\",\n  utility: \"utility\",\n};\n\n/**\n * Backward-compatible normalized view over the v0.2 catalog. New consumers\n * should prefer this shape so a component can evolve to multiple recipes,\n * behaviors, and different Web/Native maturity without another API rewrite.\n */\nexport const componentDefinitions: readonly ComponentDefinition[] = componentCatalog.map((rawEntry) => {\n  const entry: ComponentCatalogEntry = rawEntry;\n  const name = entry.name as ComponentName;\n  const id = componentIds[name];\n  return {\n    id,\n    name,\n    category: entry.category,\n    kind: kindByCategory[entry.category],\n    contract: {\n      status: entry.status,\n      recipes: entry.recipe ? [entry.recipe] : [],\n      behaviors: entry.behavior ? [entry.behavior] : [],\n      roadmap: entry.roadmap,\n    },\n    surfaces: {\n      parity: entry.platform,\n      web: { status: getComponentSurfaceStatus(entry, \"web\") },\n      native: { status: getComponentSurfaceStatus(entry, \"native\") },\n    },\n    docs: {\n      storyId: `components/${id}`,\n      aliases: entry.aliases ?? [],\n    },\n  };\n});\n\nexport function getComponentDefinition(\n  idOrName: ComponentId | ComponentName,\n): ComponentDefinition | undefined {\n  return componentDefinitions.find(\n    (definition) => definition.id === idOrName || definition.name === idOrName,\n  );\n}\n"]}