@kerfjs/ui 4.4.1 → 4.5.0-beta.1

package/dist/catalog.js

@@ -0,0 +1,377 @@
+import { Pane } from './chunk-JRKSK2HX.js';
+import { Toolbar } from './chunk-SYDMYBPG.js';
+import { ToolbarControlGroup } from './chunk-5VTB2BKP.js';
+import { ListHeader } from './chunk-PSKN344N.js';
+import { ListItem } from './chunk-FEAMR7S4.js';
+import { List } from './chunk-J5BFYY7Q.js';
+import { filterDataAttributes } from './chunk-SRSJO5QE.js';
+
+
+import { LucideIcon } from './chunk-W2FK7ZNY.js';
+import { PanelLeftClose, Waypoints, ExternalLink, Moon, Sun, PanelLeftOpen } from 'lucide';
+import { jsxs, jsx, Fragment } from 'kerfjs/jsx-runtime';
+
+function findEntry(sections, id) {
+  for (const section of sections) {
+    for (const entry of section.entries) if (entry.id === id) return entry;
+  }
+  return void 0;
+}
+function catalogEntryTags(tags) {
+  if (!tags?.length) return void 0;
+  return /* @__PURE__ */ jsx("span", { class: "kui-catalog__tags", children: tags.map((tag) => /* @__PURE__ */ jsx("span", { class: "kui-catalog__tag", children: tag })) });
+}
+function relatedMenuItems(related, selectAction) {
+  const groups = [];
+  for (const entry of related)
+    if (!groups.includes(entry.group)) groups.push(entry.group);
+  const nodes = [];
+  groups.forEach((group, index) => {
+    if (index > 0) nodes.push(/* @__PURE__ */ jsx("wa-divider", {}));
+    nodes.push(/* @__PURE__ */ jsx("small", { class: "kui-catalog__related-heading", children: group }));
+    for (const entry of related) {
+      if (entry.group === group)
+        nodes.push(
+          /* @__PURE__ */ jsx("wa-dropdown-item", { "data-action": selectAction, "data-item-id": entry.id, children: entry.name })
+        );
+    }
+  });
+  return nodes;
+}
+function Catalog({
+  brand,
+  sections,
+  active,
+  content,
+  collapsed = false,
+  theme,
+  headerActions,
+  secondarySections,
+  sidebarFooter,
+  status,
+  geometryOverlay,
+  selectAction = "catalog-select",
+  toggleSidebarAction = "catalog-toggle-sidebar",
+  toggleThemeAction = "catalog-toggle-theme",
+  toggleSecondaryAction = "catalog-toggle-secondary",
+  className = ""
+}) {
+  const selected = findEntry(sections, active) ?? (secondarySections ? findEntry(secondarySections.sections, active) : void 0);
+  const name = selected?.name ?? "";
+  const nextTheme = theme === "dark" ? "light" : "dark";
+  const resources = selected?.resources ?? [];
+  const related = selected?.related ?? [];
+  return /* @__PURE__ */ jsxs(
+    "main",
+    {
+      class: `kui-catalog ${className}`.trim(),
+      "data-component": "catalog",
+      "data-sidebar-collapsed": String(collapsed),
+      "data-geometry-overlay": geometryOverlay === void 0 ? void 0 : String(geometryOverlay),
+      children: [
+        /* @__PURE__ */ jsx(
+          Pane,
+          {
+            element: "aside",
+            className: "kui-catalog__sidebar",
+            label: `${brand.title} catalog`,
+            contentElement: "nav",
+            contentLabel: `${brand.title} components`,
+            separators: ["inline-end"],
+            headerClassName: "kui-catalog__brand",
+            header: /* @__PURE__ */ jsxs(Fragment, { children: [
+              /* @__PURE__ */ jsx(
+                Toolbar,
+                {
+                  label: `${brand.title} catalog header`,
+                  dividerSides: "",
+                  leading: /* @__PURE__ */ jsxs(
+                    ToolbarControlGroup,
+                    {
+                      appearance: "borderless",
+                      className: "kui-catalog__identity",
+                      children: [
+                        brand.logoUrl ? /* @__PURE__ */ jsx("img", { class: "kui-catalog__mark", src: brand.logoUrl, alt: "" }) : /* @__PURE__ */ jsx(Fragment, {}),
+                        /* @__PURE__ */ jsx("h1", { children: brand.title })
+                      ]
+                    }
+                  ),
+                  trailing: /* @__PURE__ */ jsx(ToolbarControlGroup, { appearance: "borderless", single: true, children: /* @__PURE__ */ jsx(
+                    "button",
+                    {
+                      type: "button",
+                      "data-action": toggleSidebarAction,
+                      "aria-label": `Collapse ${brand.title} catalog`,
+                      children: /* @__PURE__ */ jsx(LucideIcon, { icon: PanelLeftClose, name: "panel-left-close" })
+                    }
+                  ) })
+                }
+              ),
+              brand.subtitle ? /* @__PURE__ */ jsx("p", { class: "kui-catalog__subtitle", children: brand.subtitle }) : /* @__PURE__ */ jsx(Fragment, {})
+            ] }),
+            children: /* @__PURE__ */ jsxs(Fragment, { children: [
+              sections.map((section) => /* @__PURE__ */ jsxs("section", { class: "kui-catalog__group", children: [
+                /* @__PURE__ */ jsx(ListHeader, { label: section.category }),
+                /* @__PURE__ */ jsx(List, { className: "kui-catalog__items", children: section.entries.map((entry) => /* @__PURE__ */ jsx(
+                  ListItem,
+                  {
+                    action: selectAction,
+                    itemId: entry.id,
+                    label: entry.name,
+                    trailing: catalogEntryTags(entry.tags),
+                    selected: active === entry.id,
+                    title: entry.description,
+                    multiline: true
+                  }
+                )) })
+              ] })),
+              secondarySections ? /* @__PURE__ */ jsxs("section", { class: "kui-catalog__group kui-catalog__group--secondary", children: [
+                secondarySections.collapsible ? /* @__PURE__ */ jsx(
+                  ListHeader,
+                  {
+                    label: secondarySections.label,
+                    toggle: true,
+                    expanded: Boolean(secondarySections.expanded),
+                    action: toggleSecondaryAction
+                  }
+                ) : /* @__PURE__ */ jsx(ListHeader, { label: secondarySections.label }),
+                !secondarySections.collapsible || secondarySections.expanded ? /* @__PURE__ */ jsx("div", { class: "kui-catalog__secondary", "data-catalog-secondary": true, children: secondarySections.sections.map((section) => /* @__PURE__ */ jsxs("section", { class: "kui-catalog__secondary-group", children: [
+                  /* @__PURE__ */ jsx("h3", { class: "kui-catalog__secondary-heading", children: section.category }),
+                  /* @__PURE__ */ jsx(List, { className: "kui-catalog__items", children: section.entries.map((entry) => /* @__PURE__ */ jsx(
+                    ListItem,
+                    {
+                      action: selectAction,
+                      itemId: entry.id,
+                      label: entry.name,
+                      trailing: catalogEntryTags(entry.tags),
+                      selected: active === entry.id,
+                      title: entry.description,
+                      multiline: true
+                    }
+                  )) })
+                ] })) }) : /* @__PURE__ */ jsx(Fragment, {})
+              ] }) : /* @__PURE__ */ jsx(Fragment, {}),
+              sidebarFooter ?? /* @__PURE__ */ jsx(Fragment, {})
+            ] })
+          }
+        ),
+        /* @__PURE__ */ jsx(
+          Pane,
+          {
+            element: "article",
+            className: "kui-catalog__detail",
+            contentElement: "section",
+            contentLabel: `${name} preview`,
+            contentClassName: "kui-catalog__stage",
+            headerClassName: "kui-catalog__header",
+            header: /* @__PURE__ */ jsxs(Fragment, { children: [
+              /* @__PURE__ */ jsx(
+                Toolbar,
+                {
+                  label: `${name} header`,
+                  dividerSides: "",
+                  leading: /* @__PURE__ */ jsxs(Fragment, { children: [
+                    collapsed ? /* @__PURE__ */ jsx(ToolbarControlGroup, { appearance: "borderless", single: true, children: /* @__PURE__ */ jsx(
+                      "button",
+                      {
+                        type: "button",
+                        "data-action": toggleSidebarAction,
+                        "aria-label": `Expand ${brand.title} catalog`,
+                        children: /* @__PURE__ */ jsx(
+                          LucideIcon,
+                          {
+                            icon: PanelLeftOpen,
+                            name: "panel-left-open"
+                          }
+                        )
+                      }
+                    ) }) : /* @__PURE__ */ jsx(Fragment, {}),
+                    /* @__PURE__ */ jsx(
+                      ToolbarControlGroup,
+                      {
+                        appearance: "borderless",
+                        className: "kui-catalog__title",
+                        children: /* @__PURE__ */ jsx("h2", { children: name })
+                      }
+                    )
+                  ] }),
+                  trailing: /* @__PURE__ */ jsxs("div", { class: "kui-catalog__header-actions", children: [
+                    headerActions,
+                    theme ? /* @__PURE__ */ jsx(
+                      ToolbarControlGroup,
+                      {
+                        className: "kui-catalog__settings",
+                        label: "Catalog display",
+                        children: /* @__PURE__ */ jsxs(
+                          "button",
+                          {
+                            type: "button",
+                            "data-action": toggleThemeAction,
+                            "aria-label": `Use ${nextTheme} theme`,
+                            "data-theme-preview": theme,
+                            children: [
+                              nextTheme === "dark" ? /* @__PURE__ */ jsx(LucideIcon, { icon: Moon, name: "moon" }) : /* @__PURE__ */ jsx(LucideIcon, { icon: Sun, name: "sun" }),
+                              /* @__PURE__ */ jsx("span", { children: nextTheme === "dark" ? "Dark" : "Light" })
+                            ]
+                          }
+                        )
+                      }
+                    ) : /* @__PURE__ */ jsx(Fragment, {})
+                  ] })
+                }
+              ),
+              selected?.description ? /* @__PURE__ */ jsx("p", { class: "kui-catalog__description kui-content-item", children: selected.description }) : /* @__PURE__ */ jsx(Fragment, {})
+            ] }),
+            footerClassName: "kui-catalog__footer",
+            footer: /* @__PURE__ */ jsxs(Fragment, { children: [
+              status ? /* @__PURE__ */ jsx("div", { class: "kui-catalog__status", children: status }) : /* @__PURE__ */ jsx(Fragment, {}),
+              /* @__PURE__ */ jsx(
+                Toolbar,
+                {
+                  label: `${name} resources`,
+                  dividerSides: "",
+                  leading: resources.length > 0 ? /* @__PURE__ */ jsx(
+                    "nav",
+                    {
+                      class: "kui-catalog__resources",
+                      "aria-label": `${name} resources`,
+                      children: /* @__PURE__ */ jsx(
+                        ToolbarControlGroup,
+                        {
+                          className: "kui-catalog__resource-group",
+                          label: `${name} resources`,
+                          children: resources.map((resource) => /* @__PURE__ */ jsxs(
+                            "a",
+                            {
+                              class: "kui-catalog__resource",
+                              href: resource.href,
+                              target: "_blank",
+                              rel: "noopener noreferrer",
+                              "aria-label": `${name}: ${resource.label} (opens in new tab)`,
+                              children: [
+                                /* @__PURE__ */ jsx(
+                                  LucideIcon,
+                                  {
+                                    icon: ExternalLink,
+                                    name: "external-link"
+                                  }
+                                ),
+                                /* @__PURE__ */ jsx("span", { children: resource.label }),
+                                resource.detail ? /* @__PURE__ */ jsx("code", { children: resource.detail }) : /* @__PURE__ */ jsx(Fragment, {})
+                              ]
+                            }
+                          ))
+                        }
+                      )
+                    }
+                  ) : /* @__PURE__ */ jsx(Fragment, {}),
+                  trailing: related.length > 0 ? /* @__PURE__ */ jsx("div", { class: "kui-catalog__related", "data-catalog-related": true, children: /* @__PURE__ */ jsx(
+                    ToolbarControlGroup,
+                    {
+                      single: true,
+                      className: "kui-catalog__related-group",
+                      label: "Related entries",
+                      children: /* @__PURE__ */ jsxs(
+                        "wa-dropdown",
+                        {
+                          class: "kui-catalog__related-menu",
+                          placement: "top-end",
+                          "data-key": `kui-catalog-related-${active}`,
+                          "data-morph-skip-children": true,
+                          children: [
+                            /* @__PURE__ */ jsx("wa-button", { slot: "trigger", appearance: "plain", "with-caret": true, children: /* @__PURE__ */ jsxs("span", { class: "kui-catalog__related-trigger", children: [
+                              /* @__PURE__ */ jsx(LucideIcon, { icon: Waypoints, name: "waypoints" }),
+                              /* @__PURE__ */ jsx("span", { class: "kui-catalog__related-label", children: "Component" })
+                            ] }) }),
+                            relatedMenuItems(related, selectAction)
+                          ]
+                        }
+                      )
+                    }
+                  ) }) : /* @__PURE__ */ jsx(Fragment, {})
+                }
+              )
+            ] }),
+            children: /* @__PURE__ */ jsxs("div", { class: "kui-catalog__canvas", children: [
+              content,
+              geometryOverlay !== void 0 ? /* @__PURE__ */ jsx(
+                "div",
+                {
+                  class: "kui-catalog__geometry-overlay",
+                  "data-catalog-geometry-overlay": true,
+                  "data-morph-skip-children": true,
+                  "aria-hidden": "true"
+                }
+              ) : /* @__PURE__ */ jsx(Fragment, {})
+            ] })
+          }
+        )
+      ]
+    }
+  );
+}
+var catalogExampleProtectedAttributes = /* @__PURE__ */ new Set([
+  "data-catalog-example",
+  "data-catalog-example-stack",
+  "data-catalog-example-label",
+  "data-catalog-example-note",
+  "data-align"
+]);
+function CatalogExample({
+  label,
+  note,
+  align = "none",
+  rootAttributes = {},
+  className = "",
+  children
+}) {
+  const safeRootAttributes = filterDataAttributes(
+    rootAttributes,
+    catalogExampleProtectedAttributes
+  );
+  return /* @__PURE__ */ jsxs(
+    "section",
+    {
+      ...safeRootAttributes,
+      class: `kui-catalog-example ${className}`.trim(),
+      "data-catalog-example": true,
+      "data-align": align,
+      children: [
+        label !== void 0 ? /* @__PURE__ */ jsx(
+          ListHeader,
+          {
+            label,
+            rootAttributes: { "data-catalog-example-label": "" }
+          }
+        ) : /* @__PURE__ */ jsx(Fragment, {}),
+        note !== void 0 ? /* @__PURE__ */ jsx("p", { class: "kui-catalog-example__note", "data-catalog-example-note": true, children: note }) : /* @__PURE__ */ jsx(Fragment, {}),
+        children
+      ]
+    }
+  );
+}
+function CatalogExampleStack({
+  label,
+  rootAttributes = {},
+  className = "",
+  children
+}) {
+  const safeRootAttributes = filterDataAttributes(
+    rootAttributes,
+    catalogExampleProtectedAttributes
+  );
+  return /* @__PURE__ */ jsx(
+    "section",
+    {
+      ...safeRootAttributes,
+      class: `kui-catalog-example-stack ${className}`.trim(),
+      "data-catalog-example-stack": true,
+      "aria-label": label,
+      children
+    }
+  );
+}
+
+export { Catalog, CatalogExample, CatalogExampleStack };
+
+//# sourceMappingURL=catalog.js.map

package/dist/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/catalog.tsx"],"names":[],"mappings":"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","file":"catalog.js","sourcesContent":["import type { SafeHtml } from 'kerfjs';\nimport {\n  ExternalLink,\n  Moon,\n  PanelLeftClose,\n  PanelLeftOpen,\n  Sun,\n  Waypoints,\n} from 'lucide';\n\nimport { filterDataAttributes } from './extension-attributes.js';\nimport { List } from './list.js';\nimport { ListHeader } from './list-header.js';\nimport { ListItem } from './list-item.js';\nimport { LucideIcon } from './lucide-icon.js';\nimport { Pane } from './pane.js';\nimport { Toolbar } from './toolbar.js';\nimport { ToolbarControlGroup } from './toolbar-control-group.js';\n\n/** A reference link shown in the detail footer for the active entry. */\nexport interface CatalogResource {\n  label: string;\n  href: string;\n  /** Optional monospace detail (e.g. a file path) shown after the label. */\n  detail?: string;\n}\n\n/** A related entry offered in the detail footer's \"Related entries\" popup menu. */\nexport interface CatalogRelated {\n  id: string;\n  name: string;\n  /** Group heading in the menu, e.g. \"Uses\" / \"Used by\". */\n  group: string;\n}\n\nexport interface CatalogEntry {\n  id: string;\n  name: string;\n  description?: string;\n  /** Short metadata tags shown at the trailing edge of the sidebar row. */\n  tags?: readonly string[];\n  resources?: readonly CatalogResource[];\n  related?: readonly CatalogRelated[];\n}\n\nexport interface CatalogSection {\n  category: string;\n  entries: readonly CatalogEntry[];\n}\n\n/**\n * A secondary group of sections shown below the primary sidebar sections with a\n * quieter \"ecosystem\" treatment (e.g. third-party components). Optionally\n * collapsible — the app owns `expanded` and toggles it from `wireCatalog`'s\n * `onToggleSecondary`.\n */\nexport interface CatalogSecondaryGroup {\n  label: string;\n  sections: readonly CatalogSection[];\n  /** When true, the group's label is a disclosure toggle controlling `expanded`. */\n  collapsible?: boolean;\n  /** Whether the group is expanded (controlled). Ignored unless `collapsible`. */\n  expanded?: boolean;\n}\n\nexport interface CatalogBrand {\n  title: string;\n  subtitle?: string;\n  /** Logo image URL (rendered decorative). Omit for a text-only brand. */\n  logoUrl?: string;\n}\n\nexport interface CatalogProps {\n  brand: CatalogBrand;\n  sections: readonly CatalogSection[];\n  /** The controlled active entry id — the app owns this signal. */\n  active: string;\n  /** The rendered preview for the active entry; the app computes it from `active`. */\n  content: SafeHtml;\n  /** Whether the sidebar is collapsed (controlled). */\n  collapsed?: boolean;\n  /** Current theme; when set, a theme toggle is shown that switches to the opposite. Omit to hide it. */\n  theme?: 'light' | 'dark';\n  /** Extra header controls placed before the theme toggle (each a `ToolbarControlGroup`). */\n  headerActions?: SafeHtml;\n  /** A secondary \"ecosystem\" group of sections below the primary category groups. */\n  secondarySections?: CatalogSecondaryGroup;\n  /** Extra sidebar content below the category groups (and the secondary group). */\n  sidebarFooter?: SafeHtml;\n  /** Status line content shown at the start of the detail footer. */\n  status?: SafeHtml;\n  /**\n   * Whether to highlight specimens' computed borders (or transparent outer\n   * bounds) and non-zero margins. Pass a boolean (rather than omitting the\n   * prop) when the active entry can switch between component and composition\n   * previews; `wireCatalogGeometryOverlay` keeps the overlay synchronized.\n   */\n  geometryOverlay?: boolean;\n  selectAction?: string;\n  toggleSidebarAction?: string;\n  toggleThemeAction?: string;\n  /** Action fired by the secondary group's disclosure toggle (when collapsible). */\n  toggleSecondaryAction?: string;\n  className?: string;\n}\n\nfunction findEntry(\n  sections: readonly CatalogSection[],\n  id: string,\n): CatalogEntry | undefined {\n  for (const section of sections) {\n    for (const entry of section.entries) if (entry.id === id) return entry;\n  }\n  return undefined;\n}\n\nfunction catalogEntryTags(\n  tags: readonly string[] | undefined,\n): SafeHtml | undefined {\n  if (!tags?.length) return undefined;\n  return (\n    <span class=\"kui-catalog__tags\">\n      {tags.map((tag) => (\n        <span class=\"kui-catalog__tag\">{tag}</span>\n      ))}\n    </span>\n  );\n}\n\n/**\n * Render the related entries as a `wa-dropdown` popup-menu body: a heading per\n * `group` (first-seen order) followed by that group's entries, each a navigable\n * item carrying the same `selectAction` the sidebar items use, so a chosen entry\n * routes through the one `wireCatalog` select handler.\n */\nfunction relatedMenuItems(\n  related: readonly CatalogRelated[],\n  selectAction: string,\n): SafeHtml[] {\n  const groups: string[] = [];\n  for (const entry of related)\n    if (!groups.includes(entry.group)) groups.push(entry.group);\n  const nodes: SafeHtml[] = [];\n  groups.forEach((group, index) => {\n    if (index > 0) nodes.push(<wa-divider></wa-divider>);\n    nodes.push(<small class=\"kui-catalog__related-heading\">{group}</small>);\n    for (const entry of related) {\n      if (entry.group === group)\n        nodes.push(\n          <wa-dropdown-item data-action={selectAction} data-item-id={entry.id}>\n            {entry.name}\n          </wa-dropdown-item>,\n        );\n    }\n  });\n  return nodes;\n}\n\n/**\n * A reusable component-catalog shell: a collapsible category sidebar, a titled\n * detail stage that renders the active entry's preview, and a footer with\n * reference links and a related-entry popup menu. Built entirely from public\n * `@kerfjs/ui` primitives. Controlled and stateless — the app owns the `active`,\n * `collapsed`, and `theme` signals and computes `content` from `active` in its own\n * render; wire the sidebar/collapse/theme actions with `wireCatalog`.\n */\nexport function Catalog({\n  brand,\n  sections,\n  active,\n  content,\n  collapsed = false,\n  theme,\n  headerActions,\n  secondarySections,\n  sidebarFooter,\n  status,\n  geometryOverlay,\n  selectAction = 'catalog-select',\n  toggleSidebarAction = 'catalog-toggle-sidebar',\n  toggleThemeAction = 'catalog-toggle-theme',\n  toggleSecondaryAction = 'catalog-toggle-secondary',\n  className = '',\n}: CatalogProps) {\n  const selected =\n    findEntry(sections, active) ??\n    (secondarySections\n      ? findEntry(secondarySections.sections, active)\n      : undefined);\n  const name = selected?.name ?? '';\n  const nextTheme = theme === 'dark' ? 'light' : 'dark';\n  const resources = selected?.resources ?? [];\n  const related = selected?.related ?? [];\n\n  return (\n    <main\n      class={`kui-catalog ${className}`.trim()}\n      data-component=\"catalog\"\n      data-sidebar-collapsed={String(collapsed)}\n      data-geometry-overlay={\n        geometryOverlay === undefined ? undefined : String(geometryOverlay)\n      }\n    >\n      <Pane\n        element=\"aside\"\n        className=\"kui-catalog__sidebar\"\n        label={`${brand.title} catalog`}\n        contentElement=\"nav\"\n        contentLabel={`${brand.title} components`}\n        separators={['inline-end']}\n        headerClassName=\"kui-catalog__brand\"\n        header={\n          <>\n            <Toolbar\n              label={`${brand.title} catalog header`}\n              dividerSides=\"\"\n              leading={\n                <ToolbarControlGroup\n                  appearance=\"borderless\"\n                  className=\"kui-catalog__identity\"\n                >\n                  {brand.logoUrl ? (\n                    <img class=\"kui-catalog__mark\" src={brand.logoUrl} alt=\"\" />\n                  ) : (\n                    <></>\n                  )}\n                  <h1>{brand.title}</h1>\n                </ToolbarControlGroup>\n              }\n              trailing={\n                <ToolbarControlGroup appearance=\"borderless\" single>\n                  <button\n                    type=\"button\"\n                    data-action={toggleSidebarAction}\n                    aria-label={`Collapse ${brand.title} catalog`}\n                  >\n                    <LucideIcon icon={PanelLeftClose} name=\"panel-left-close\" />\n                  </button>\n                </ToolbarControlGroup>\n              }\n            />\n            {brand.subtitle ? (\n              <p class=\"kui-catalog__subtitle\">{brand.subtitle}</p>\n            ) : (\n              <></>\n            )}\n          </>\n        }\n      >\n        <>\n          {sections.map((section) => (\n            <section class=\"kui-catalog__group\">\n              <ListHeader label={section.category} />\n              <List className=\"kui-catalog__items\">\n                {section.entries.map((entry) => (\n                  <ListItem\n                    action={selectAction}\n                    itemId={entry.id}\n                    label={entry.name}\n                    trailing={catalogEntryTags(entry.tags)}\n                    selected={active === entry.id}\n                    title={entry.description}\n                    multiline\n                  />\n                ))}\n              </List>\n            </section>\n          ))}\n          {secondarySections ? (\n            <section class=\"kui-catalog__group kui-catalog__group--secondary\">\n              {secondarySections.collapsible ? (\n                <ListHeader\n                  label={secondarySections.label}\n                  toggle\n                  expanded={Boolean(secondarySections.expanded)}\n                  action={toggleSecondaryAction}\n                />\n              ) : (\n                <ListHeader label={secondarySections.label} />\n              )}\n              {!secondarySections.collapsible || secondarySections.expanded ? (\n                <div class=\"kui-catalog__secondary\" data-catalog-secondary>\n                  {secondarySections.sections.map((section) => (\n                    <section class=\"kui-catalog__secondary-group\">\n                      <h3 class=\"kui-catalog__secondary-heading\">\n                        {section.category}\n                      </h3>\n                      <List className=\"kui-catalog__items\">\n                        {section.entries.map((entry) => (\n                          <ListItem\n                            action={selectAction}\n                            itemId={entry.id}\n                            label={entry.name}\n                            trailing={catalogEntryTags(entry.tags)}\n                            selected={active === entry.id}\n                            title={entry.description}\n                            multiline\n                          />\n                        ))}\n                      </List>\n                    </section>\n                  ))}\n                </div>\n              ) : (\n                <></>\n              )}\n            </section>\n          ) : (\n            <></>\n          )}\n          {sidebarFooter ?? <></>}\n        </>\n      </Pane>\n      <Pane\n        element=\"article\"\n        className=\"kui-catalog__detail\"\n        contentElement=\"section\"\n        contentLabel={`${name} preview`}\n        contentClassName=\"kui-catalog__stage\"\n        headerClassName=\"kui-catalog__header\"\n        header={\n          <>\n            <Toolbar\n              label={`${name} header`}\n              dividerSides=\"\"\n              leading={\n                <>\n                  {collapsed ? (\n                    <ToolbarControlGroup appearance=\"borderless\" single>\n                      <button\n                        type=\"button\"\n                        data-action={toggleSidebarAction}\n                        aria-label={`Expand ${brand.title} catalog`}\n                      >\n                        <LucideIcon\n                          icon={PanelLeftOpen}\n                          name=\"panel-left-open\"\n                        />\n                      </button>\n                    </ToolbarControlGroup>\n                  ) : (\n                    <></>\n                  )}\n                  <ToolbarControlGroup\n                    appearance=\"borderless\"\n                    className=\"kui-catalog__title\"\n                  >\n                    <h2>{name}</h2>\n                  </ToolbarControlGroup>\n                </>\n              }\n              trailing={\n                <div class=\"kui-catalog__header-actions\">\n                  {headerActions}\n                  {theme ? (\n                    <ToolbarControlGroup\n                      className=\"kui-catalog__settings\"\n                      label=\"Catalog display\"\n                    >\n                      <button\n                        type=\"button\"\n                        data-action={toggleThemeAction}\n                        aria-label={`Use ${nextTheme} theme`}\n                        data-theme-preview={theme}\n                      >\n                        {nextTheme === 'dark' ? (\n                          <LucideIcon icon={Moon} name=\"moon\" />\n                        ) : (\n                          <LucideIcon icon={Sun} name=\"sun\" />\n                        )}\n                        <span>{nextTheme === 'dark' ? 'Dark' : 'Light'}</span>\n                      </button>\n                    </ToolbarControlGroup>\n                  ) : (\n                    <></>\n                  )}\n                </div>\n              }\n            />\n            {selected?.description ? (\n              <p class=\"kui-catalog__description kui-content-item\">\n                {selected.description}\n              </p>\n            ) : (\n              <></>\n            )}\n          </>\n        }\n        footerClassName=\"kui-catalog__footer\"\n        footer={\n          <>\n            {status ? <div class=\"kui-catalog__status\">{status}</div> : <></>}\n            <Toolbar\n              label={`${name} resources`}\n              dividerSides=\"\"\n              leading={\n                resources.length > 0 ? (\n                  <nav\n                    class=\"kui-catalog__resources\"\n                    aria-label={`${name} resources`}\n                  >\n                    <ToolbarControlGroup\n                      className=\"kui-catalog__resource-group\"\n                      label={`${name} resources`}\n                    >\n                      {resources.map((resource) => (\n                        <a\n                          class=\"kui-catalog__resource\"\n                          href={resource.href}\n                          target=\"_blank\"\n                          rel=\"noopener noreferrer\"\n                          aria-label={`${name}: ${resource.label} (opens in new tab)`}\n                        >\n                          <LucideIcon\n                            icon={ExternalLink}\n                            name=\"external-link\"\n                          />\n                          <span>{resource.label}</span>\n                          {resource.detail ? (\n                            <code>{resource.detail}</code>\n                          ) : (\n                            <></>\n                          )}\n                        </a>\n                      ))}\n                    </ToolbarControlGroup>\n                  </nav>\n                ) : (\n                  <></>\n                )\n              }\n              trailing={\n                related.length > 0 ? (\n                  <div class=\"kui-catalog__related\" data-catalog-related>\n                    <ToolbarControlGroup\n                      single\n                      className=\"kui-catalog__related-group\"\n                      label=\"Related entries\"\n                    >\n                      <wa-dropdown\n                        class=\"kui-catalog__related-menu\"\n                        placement=\"top-end\"\n                        data-key={`kui-catalog-related-${active}`}\n                        data-morph-skip-children\n                      >\n                        <wa-button slot=\"trigger\" appearance=\"plain\" with-caret>\n                          <span class=\"kui-catalog__related-trigger\">\n                            <LucideIcon icon={Waypoints} name=\"waypoints\" />\n                            <span class=\"kui-catalog__related-label\">\n                              Component\n                            </span>\n                          </span>\n                        </wa-button>\n                        {relatedMenuItems(related, selectAction)}\n                      </wa-dropdown>\n                    </ToolbarControlGroup>\n                  </div>\n                ) : (\n                  <></>\n                )\n              }\n            />\n          </>\n        }\n      >\n        <div class=\"kui-catalog__canvas\">\n          {content}\n          {geometryOverlay !== undefined ? (\n            <div\n              class=\"kui-catalog__geometry-overlay\"\n              data-catalog-geometry-overlay\n              data-morph-skip-children\n              aria-hidden=\"true\"\n            />\n          ) : (\n            <></>\n          )}\n        </div>\n      </Pane>\n    </main>\n  );\n}\n\n/**\n * How a {@link CatalogExample}'s content aligns its visible left edge with the\n * example's `ListHeader` label (which sits 16px in — 8px title + 8px label):\n * - `'glyph'` — a bare glyph/text specimen with no inline geometry insets the full 16px.\n * - `'inline-control'` — a control that already carries ~8px of its own inline padding insets 8px so its content lands on the same line.\n * - `'none'` — a content-item / composition that owns its geometry and already aligns; no inset (default).\n */\nexport type CatalogExampleAlign = 'glyph' | 'inline-control' | 'none';\n\nconst catalogExampleProtectedAttributes = new Set([\n  'data-catalog-example',\n  'data-catalog-example-stack',\n  'data-catalog-example-label',\n  'data-catalog-example-note',\n  'data-align',\n]);\n\ntype CatalogExampleRootAttributes = Readonly<\n  Record<`data-${string}`, string | undefined> & {\n    'data-catalog-example'?: never;\n    'data-catalog-example-stack'?: never;\n    'data-catalog-example-label'?: never;\n    'data-catalog-example-note'?: never;\n    'data-align'?: never;\n  }\n>;\n\ntype CatalogExampleStackRootAttributes = Readonly<\n  Record<`data-${string}`, string | undefined> & {\n    'data-catalog-example'?: never;\n    'data-catalog-example-stack'?: never;\n    'data-catalog-example-label'?: never;\n    'data-catalog-example-note'?: never;\n    'data-align'?: never;\n  }\n>;\n\nexport interface CatalogExampleProps {\n  /** The example's label, shown as a `ListHeader` above the specimen. Omit for a bare specimen. */\n  label?: string;\n  /** Optional explanatory note between the label and the specimen. */\n  note?: SafeHtml | string;\n  /** Alignment inset for the specimen — see {@link CatalogExampleAlign}. Default `'none'`. */\n  align?: CatalogExampleAlign;\n  /** Safe authoring `data-*` metadata for the rendered section. Helper-owned structural attributes remain protected. */\n  rootAttributes?: CatalogExampleRootAttributes;\n  className?: string;\n  children?: SafeHtml | readonly SafeHtml[];\n}\n\n/**\n * One labeled example in a catalog preview: a `ListHeader` label, an optional\n * note, and the specimen. `align` insets the specimen so its visible left edge\n * lines up with the label text, encoding the catalog's alignment rules as a\n * first-class prop instead of per-demo CSS. The inset is published as the\n * `--kui-catalog-example-align` custom property so a debug overlay can exclude it\n * from a specimen's measured margin.\n */\nexport function CatalogExample({\n  label,\n  note,\n  align = 'none',\n  rootAttributes = {},\n  className = '',\n  children,\n}: CatalogExampleProps) {\n  const safeRootAttributes = filterDataAttributes(\n    rootAttributes,\n    catalogExampleProtectedAttributes,\n  );\n  return (\n    <section\n      {...safeRootAttributes}\n      class={`kui-catalog-example ${className}`.trim()}\n      data-catalog-example\n      data-align={align}\n    >\n      {label !== undefined ? (\n        <ListHeader\n          label={label}\n          rootAttributes={{ 'data-catalog-example-label': '' }}\n        />\n      ) : (\n        <></>\n      )}\n      {note !== undefined ? (\n        <p class=\"kui-catalog-example__note\" data-catalog-example-note>\n          {note}\n        </p>\n      ) : (\n        <></>\n      )}\n      {children}\n    </section>\n  );\n}\n\nexport interface CatalogExampleStackProps {\n  /** Accessible label for the stack region. */\n  label?: string;\n  /** Safe authoring `data-*` metadata for the rendered stack. Helper-owned structural attributes remain protected. */\n  rootAttributes?: CatalogExampleStackRootAttributes;\n  className?: string;\n  children?: SafeHtml | readonly SafeHtml[];\n}\n\n/**\n * A vertically-stacked group of {@link CatalogExample}s with the catalog's\n * example rhythm. The semantic `section` becomes a named `region` when `label`\n * is supplied; an unlabeled stack remains an ordinary grouping.\n */\nexport function CatalogExampleStack({\n  label,\n  rootAttributes = {},\n  className = '',\n  children,\n}: CatalogExampleStackProps) {\n  const safeRootAttributes = filterDataAttributes(\n    rootAttributes,\n    catalogExampleProtectedAttributes,\n  );\n  return (\n    <section\n      {...safeRootAttributes}\n      class={`kui-catalog-example-stack ${className}`.trim()}\n      data-catalog-example-stack\n      aria-label={label}\n    >\n      {children}\n    </section>\n  );\n}\n"]}

package/dist/chunk-5VTB2BKP.js

@@ -0,0 +1,35 @@
+import { jsx } from 'kerfjs/jsx-runtime';
+
+// src/toolbar-control-group.tsx
+function ToolbarControlGroup({
+  children,
+  label,
+  className = "",
+  expanded = false,
+  single = false,
+  appearance = "contained",
+  tone = "default",
+  buttonAppearance = "plain",
+  shape = "pill"
+}) {
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      class: `kui-toolbar-control-group ${className}`.trim(),
+      "data-component": "toolbar-control-group",
+      role: label ? "group" : void 0,
+      "aria-label": label,
+      "data-appearance": appearance,
+      "data-tone": tone,
+      "data-button-appearance": buttonAppearance,
+      "data-expanded": String(expanded),
+      "data-single": String(single),
+      "data-shape": shape,
+      children
+    }
+  );
+}
+
+export { ToolbarControlGroup };
+
+//# sourceMappingURL=chunk-5VTB2BKP.js.map

package/dist/chunk-5VTB2BKP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/toolbar-control-group.tsx"],"names":[],"mappings":";;;AAoBO,SAAS,mBAAA,CAAoB;AAAA,EAClC,QAAA;AAAA,EACA,KAAA;AAAA,EACA,SAAA,GAAY,EAAA;AAAA,EACZ,QAAA,GAAW,KAAA;AAAA,EACX,MAAA,GAAS,KAAA;AAAA,EACT,UAAA,GAAa,WAAA;AAAA,EACb,IAAA,GAAO,SAAA;AAAA,EACP,gBAAA,GAAmB,OAAA;AAAA,EACnB,KAAA,GAAQ;AACV,CAAA,EAA6B;AAC3B,EAAA,uBACE,GAAA;AAAA,IAAC,KAAA;AAAA,IAAA;AAAA,MACC,KAAA,EAAO,CAAA,0BAAA,EAA6B,SAAS,CAAA,CAAA,CAAG,IAAA,EAAK;AAAA,MACrD,gBAAA,EAAe,uBAAA;AAAA,MACf,IAAA,EAAM,QAAQ,OAAA,GAAU,MAAA;AAAA,MACxB,YAAA,EAAY,KAAA;AAAA,MACZ,iBAAA,EAAiB,UAAA;AAAA,MACjB,WAAA,EAAW,IAAA;AAAA,MACX,wBAAA,EAAwB,gBAAA;AAAA,MACxB,eAAA,EAAe,OAAO,QAAQ,CAAA;AAAA,MAC9B,aAAA,EAAa,OAAO,MAAM,CAAA;AAAA,MAC1B,YAAA,EAAY,KAAA;AAAA,MAEX;AAAA;AAAA,GACH;AAEJ","file":"chunk-5VTB2BKP.js","sourcesContent":["import type { SafeHtml } from 'kerfjs';\n\nexport type ToolbarControlGroupAppearance = 'contained' | 'borderless';\nexport type ToolbarControlGroupTone = 'default' | 'dark';\nexport type ToolbarControlGroupButtonAppearance = 'plain' | 'push';\nexport type ToolbarControlGroupShape = 'pill' | 'rounded';\n\nexport interface ToolbarControlGroupProps {\n  children: SafeHtml | SafeHtml[];\n  label?: string;\n  className?: string;\n  expanded?: boolean;\n  single?: boolean;\n  appearance?: ToolbarControlGroupAppearance;\n  tone?: ToolbarControlGroupTone;\n  buttonAppearance?: ToolbarControlGroupButtonAppearance;\n  /** Corner shape: fully round `pill` (default) or a softer `rounded` rectangle. */\n  shape?: ToolbarControlGroupShape;\n}\n\nexport function ToolbarControlGroup({\n  children,\n  label,\n  className = '',\n  expanded = false,\n  single = false,\n  appearance = 'contained',\n  tone = 'default',\n  buttonAppearance = 'plain',\n  shape = 'pill',\n}: ToolbarControlGroupProps) {\n  return (\n    <div\n      class={`kui-toolbar-control-group ${className}`.trim()}\n      data-component=\"toolbar-control-group\"\n      role={label ? 'group' : undefined}\n      aria-label={label}\n      data-appearance={appearance}\n      data-tone={tone}\n      data-button-appearance={buttonAppearance}\n      data-expanded={String(expanded)}\n      data-single={String(single)}\n      data-shape={shape}\n    >\n      {children}\n    </div>\n  );\n}\n"]}

package/dist/chunk-6WTETUZ6.js

@@ -0,0 +1,21 @@
+import { jsx } from 'kerfjs/jsx-runtime';
+
+// src/loading-spinner.tsx
+function LoadingSpinner({ className = "", label }) {
+  return /* @__PURE__ */ jsx(
+    "svg",
+    {
+      class: `kui-loading-spinner ${className}`.trim(),
+      "data-component": "loading-spinner",
+      viewBox: "0 0 24 24",
+      role: label ? "img" : void 0,
+      "aria-label": label,
+      "aria-hidden": label ? void 0 : "true",
+      children: /* @__PURE__ */ jsx("path", { d: "M12,4a8,8,0,0,1,7.89,6.7A1.53,1.53,0,0,0,21.38,12h0a1.5,1.5,0,0,0,1.48-1.75,11,11,0,0,0-21.72,0A1.5,1.5,0,0,0,2.62,12h0a1.53,1.53,0,0,0,1.49-1.3A8,8,0,0,1,12,4Z" })
+    }
+  );
+}
+
+export { LoadingSpinner };
+
+//# sourceMappingURL=chunk-6WTETUZ6.js.map

package/dist/chunk-6WTETUZ6.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/loading-spinner.tsx"],"names":[],"mappings":";;;AAMO,SAAS,cAAA,CAAe,EAAE,SAAA,GAAY,EAAA,EAAI,OAAM,EAAwB;AAC7E,EAAA,uBACE,GAAA;AAAA,IAAC,KAAA;AAAA,IAAA;AAAA,MACC,KAAA,EAAO,CAAA,oBAAA,EAAuB,SAAS,CAAA,CAAA,CAAG,IAAA,EAAK;AAAA,MAC/C,gBAAA,EAAe,iBAAA;AAAA,MACf,OAAA,EAAQ,WAAA;AAAA,MACR,IAAA,EAAM,QAAQ,KAAA,GAAQ,MAAA;AAAA,MACtB,YAAA,EAAY,KAAA;AAAA,MACZ,aAAA,EAAa,QAAQ,MAAA,GAAY,MAAA;AAAA,MAEjC,QAAA,kBAAA,GAAA,CAAC,MAAA,EAAA,EAAK,CAAA,EAAE,kKAAA,EAAmK;AAAA;AAAA,GAC7K;AAEJ","file":"chunk-6WTETUZ6.js","sourcesContent":["export interface LoadingSpinnerProps {\n  className?: string;\n  label?: string;\n}\n\n/** Stable viewBox-centered progress ring based on svg-spinners' MIT-licensed 180-ring. */\nexport function LoadingSpinner({ className = '', label }: LoadingSpinnerProps) {\n  return (\n    <svg\n      class={`kui-loading-spinner ${className}`.trim()}\n      data-component=\"loading-spinner\"\n      viewBox=\"0 0 24 24\"\n      role={label ? 'img' : undefined}\n      aria-label={label}\n      aria-hidden={label ? undefined : 'true'}\n    >\n      <path d=\"M12,4a8,8,0,0,1,7.89,6.7A1.53,1.53,0,0,0,21.38,12h0a1.5,1.5,0,0,0,1.48-1.75,11,11,0,0,0-21.72,0A1.5,1.5,0,0,0,2.62,12h0a1.53,1.53,0,0,0,1.49-1.3A8,8,0,0,1,12,4Z\"></path>\n    </svg>\n  );\n}\n"]}