@kerfjs/ui 5.0.0-beta.6 → 5.0.0-beta.61

package/analyzer/selectors.mjs

@@ -0,0 +1,212 @@
+/**
+ * Selector parsing shared by the package stylesheet ownership check
+ * (`scripts/lib/css-ownership.mjs`, `npm run check:css-ownership`) and the
+ * downstream component-ownership diagnostics in `kerf-ui-analyze`
+ * (`component-ownership.mjs`). Pure string work over one selector list: no
+ * PostCSS, no filesystem. One copy means the package rule and the consumer
+ * rule agree on which compound a selector styles.
+ */
+
+export function ownsClass(rootClass, candidate) {
+  return (
+    candidate === rootClass ||
+    candidate.startsWith(`${rootClass}__`) ||
+    candidate.startsWith(`${rootClass}--`)
+  );
+}
+
+/**
+ * Split a selector list into its complex selectors, and each complex selector
+ * into compounds, ignoring commas and combinators nested inside parentheses,
+ * attribute brackets, or quotes. Each compound records the combinator that
+ * joins it to the previous one (`''` for the first).
+ */
+export function complexSelectorParts(selectorList) {
+  const selectors = [];
+  let compounds = [];
+  let current = '';
+  let combinator = '';
+  let pending = '';
+  let depth = 0;
+  let quote = null;
+  const endCompound = () => {
+    if (current.trim()) {
+      compounds.push({ combinator, compound: current.trim() });
+      combinator = '';
+    }
+    current = '';
+  };
+  for (const char of selectorList) {
+    if (quote) {
+      current += char;
+      if (char === quote) quote = null;
+    } else if (char === '"' || char === "'") {
+      quote = char;
+      current += char;
+    } else if (char === '(' || char === '[') {
+      depth += 1;
+      current += char;
+    } else if (char === ')' || char === ']') {
+      depth -= 1;
+      current += char;
+    } else if (depth === 0 && char === ',') {
+      endCompound();
+      selectors.push(compounds);
+      compounds = [];
+      pending = '';
+    } else if (depth === 0 && /[\s>+~]/.test(char)) {
+      const hadCompound = current.trim() !== '';
+      endCompound();
+      if (/[>+~]/.test(char)) pending = char;
+      else if (!pending && (hadCompound || compounds.length > 0)) pending = ' ';
+    } else {
+      if (!current && compounds.length > 0) {
+        combinator = pending || ' ';
+        pending = '';
+      }
+      current += char;
+    }
+  }
+  endCompound();
+  selectors.push(compounds);
+  return selectors;
+}
+
+/** Complex selectors as arrays of compound strings. */
+export function complexSelectors(selectorList) {
+  return complexSelectorParts(selectorList).map((parts) =>
+    parts.map(({ compound }) => compound),
+  );
+}
+
+export function kuiClasses(selector) {
+  return [...selector.matchAll(/\.((?:kui)-[a-z0-9_-]+)/gi)].map(
+    ([, name]) => name,
+  );
+}
+
+/** Every class name a selector names, in any namespace. */
+export function classNames(selector) {
+  return [...selector.matchAll(/\.(-?[_a-zA-Z][_a-zA-Z0-9-]*)/g)].map(
+    ([, name]) => name,
+  );
+}
+
+export function dataComponents(selector) {
+  return [
+    ...selector.matchAll(
+      /\[data-component\s*=\s*["']?([a-z0-9-]+)["']?\s*\]/gi,
+    ),
+  ].map(([, name]) => name);
+}
+
+/**
+ * Remove the arguments of every pseudo-class named in `names` from a
+ * compound, keeping the empty call.
+ */
+export function withoutPseudoArguments(compound, names) {
+  const opener = new RegExp(`^:(?:${names.join('|')})\\(`, 'i');
+  let result = '';
+  let skipDepth = 0;
+  for (let index = 0; index < compound.length; index += 1) {
+    if (skipDepth === 0) {
+      const match = opener.exec(compound.slice(index));
+      if (match) {
+        result += match[0];
+        skipDepth = 1;
+        index += match[0].length - 1;
+      } else result += compound[index];
+    } else if (compound[index] === '(') skipDepth += 1;
+    else if (compound[index] === ')') {
+      skipDepth -= 1;
+      if (skipDepth === 0) result += ')';
+    }
+  }
+  return result;
+}
+
+/**
+ * Remove the arguments of every `:has()` and `:not()` in a compound. A parent
+ * may key its own styles on a composed child's state
+ * (`:has(> .kui-select[open])`) or exclude a kerf child it does not own
+ * (`wa-dropdown:not(.kui-popup-menu)`): neither styles that child.
+ */
+export function withoutRelationalArguments(compound) {
+  return withoutPseudoArguments(compound, ['has', 'not']);
+}
+
+/** The top-level arguments of each `:name(...)` call in a compound. */
+export function pseudoArguments(compound, name) {
+  const args = [];
+  const opener = new RegExp(`:${name}\\(`, 'gi');
+  for (const match of compound.matchAll(opener)) {
+    let depth = 1;
+    let index = match.index + match[0].length;
+    const start = index;
+    for (; index < compound.length && depth > 0; index += 1) {
+      if (compound[index] === '(') depth += 1;
+      else if (compound[index] === ')') depth -= 1;
+    }
+    args.push(compound.slice(start, index - 1));
+  }
+  return args;
+}
+
+export function splitTopLevel(list) {
+  const parts = [];
+  let depth = 0;
+  let current = '';
+  for (const char of list) {
+    if (char === '(' || char === '[') depth += 1;
+    else if (char === ')' || char === ']') depth -= 1;
+    if (char === ',' && depth === 0) {
+      parts.push(current.trim());
+      current = '';
+    } else current += char;
+  }
+  if (current.trim()) parts.push(current.trim());
+  return parts;
+}
+
+/**
+ * The element types a subject compound can match: its own type selector and
+ * the subject types inside its `:is()` / `:where()` arguments. `null` means the
+ * compound places no type constraint (universal).
+ */
+export function subjectTypes(compound) {
+  const bare = withoutPseudoArguments(compound, [
+    'has',
+    'not',
+    'is',
+    'where',
+    'part',
+    'nth-child',
+    'nth-last-child',
+    'nth-of-type',
+    'nth-last-of-type',
+  ]);
+  const own = /^([a-z][a-z0-9-]*)/i.exec(bare);
+  if (own) return [own[1].toLowerCase()];
+  const types = [];
+  for (const name of ['is', 'where']) {
+    for (const args of pseudoArguments(
+      withoutRelationalArguments(compound),
+      name,
+    )) {
+      for (const arg of splitTopLevel(args)) {
+        const parts = complexSelectors(arg)[0] ?? [];
+        const last = parts.at(-1);
+        if (!last) return null;
+        const inner = subjectTypes(last);
+        if (inner === null) {
+          // A class-only argument constrains nothing by type, but it names an
+          // element that must carry that class.
+          if (kuiClasses(withoutRelationalArguments(last)).length > 0) continue;
+          return null;
+        }
+        types.push(...inner);
+      }
+    }
+  }
+  return types.length > 0 ? types : null;
+}

package/dist/app-tab.d.ts

@@ -1,4 +1,5 @@
 import { SafeHtml } from 'kerfjs';
+import { K as KerfUiContent } from './semantic-content-BbzjvSu9.js';
 
 type AppTabRootAttributes = Readonly<Record<`data-${string}`, string | undefined> & {
     'data-component'?: never;
@@ -7,22 +8,58 @@ type AppTabRootAttributes = Readonly<Record<`data-${string}`, string | undefined
     'data-selected'?: never;
     'data-tab-dragging'?: never;
     'data-tab-drop-position'?: never;
+    'data-attention'?: never;
+    'data-drop-target'?: never;
+    'data-name-overflow'?: never;
+    'data-pinned'?: never;
 }>;
+type AppTabPresentation = 'pill' | 'segmented' | 'icon-only';
+type AppTabSize = 'default' | 'compact';
+type AppTabNameOverflow = 'ellipsis' | 'visible';
 interface AppTabProps {
     id: string;
     name: string;
     selected?: boolean;
+    /** Emphasize the visible tab name with the attention color token. */
+    attention?: boolean;
+    /** Highlight this tab as the target of a drag over its content. */
+    dropTarget?: boolean;
+    /** Keep the leading tab visible within its TabBar tablist while peers scroll. */
+    pinned?: boolean;
     closable?: boolean;
     draggable?: boolean;
-    leading?: SafeHtml;
-    trailing?: SafeHtml;
+    leading?: KerfUiContent;
+    trailing?: KerfUiContent;
+    /** Visual treatment within a TabBar. Icon-only tabs retain `name` as their accessible name. */
+    presentation?: AppTabPresentation;
+    /** Compact tabs use the 32px application-rail height. */
+    size?: AppTabSize;
+    /** Maximum visible label width in CSS pixels before ellipsis. */
+    labelMaxWidth?: number;
+    /** Keep the full name visible for an inline loading treatment. */
+    nameOverflow?: AppTabNameOverflow;
     /** Decorative dormant content for the close button. Must not contain interactive descendants. */
     closeIcon?: SafeHtml;
     selectAction?: string;
     closeAction?: string;
     className?: string;
+    /** Render as an unanimated loading skeleton, disabling select/close and dragging. */
+    placeholder?: boolean;
+    /**
+     * Named and still opening: the tab is known but its content is loading.
+     * Keeps `name` visible in the quiet text color and as the tab's accessible
+     * name, shows `trailing` (for example a `LoadingSpinner`), and marks the
+     * tab `aria-busy`. Unlike `placeholder` it stays selectable — the
+     * application shows placeholder content in its panel until loading
+     * completes — while close and dragging stay disabled. Same pill geometry
+     * as the live tab, so swapping it in place does not shift the bar.
+     * `placeholder` wins when both are set.
+     */
+    pending?: boolean;
     rootAttributes?: AppTabRootAttributes;
+    /** Native named-slot assignment when composed inside a web component. */
+    slot?: string;
 }
-declare function AppTab({ id, name, selected, closable, draggable, leading, trailing, closeIcon, selectAction, closeAction, className, rootAttributes }: AppTabProps): SafeHtml;
+declare function AppTab({ id, name, selected, attention, dropTarget, pinned, closable, draggable, leading, trailing, presentation, size, labelMaxWidth, nameOverflow, closeIcon, selectAction, closeAction, className, placeholder, pending, rootAttributes, slot, }: AppTabProps): SafeHtml;
 
-export { AppTab, type AppTabProps };
+export { AppTab, type AppTabNameOverflow, type AppTabPresentation, type AppTabProps, type AppTabSize };

package/dist/app-tab.js

@@ -1,4 +1,6 @@
-export { AppTab } from './chunk-XZXRLY5Q.js';
+export { AppTab } from './chunk-Q6YU3BT7.js';
+
+
 
 
 //# sourceMappingURL=app-tab.js.map

package/dist/badge.d.ts

@@ -0,0 +1,52 @@
+import { SafeHtml } from 'kerfjs';
+
+type BadgeTone = 'neutral' | 'brand' | 'pop' | 'success' | 'warning' | 'danger';
+type BadgeAppearance = 'quiet' | 'solid' | 'outline';
+type BadgeShape = 'pill' | 'rounded';
+/** Size of a text badge. A text-free dot is the separate `size: 'dot'` form. */
+type BadgeSize = 'compact' | 'default';
+interface BadgeCommonProps {
+    tone?: BadgeTone;
+    className?: string;
+    /** Native named-slot assignment when composed inside a web component. */
+    slot?: string;
+}
+/** A badge that shows a short status, count, or category as visible text. */
+interface BadgeTextProps extends BadgeCommonProps {
+    children: SafeHtml | string | number;
+    appearance?: BadgeAppearance;
+    shape?: BadgeShape;
+    size?: BadgeSize;
+    /** Optional accessible name when the visible content is abbreviated. */
+    label?: string;
+    /** Hide a repeated visual badge from assistive technology. */
+    ariaHidden?: boolean;
+}
+/** A labeled dot, announced as an image with its own accessible name. */
+interface BadgeDotLabeled {
+    /** Accessible name for the dot, for example `"New activity"`. */
+    label: string;
+    ariaHidden?: false;
+}
+/** A decorative dot whose meaning the owning component already announces. */
+interface BadgeDotDecorative {
+    label?: never;
+    ariaHidden: true;
+}
+/**
+ * A text-free status dot (the iOS "new content" dot): a small solid circle in
+ * the badge's tone. It has no visible text, so it must either carry its own
+ * accessible `label` (exposed as an image) or be `ariaHidden` because the
+ * surrounding component already folds its meaning into an accessible name.
+ */
+type BadgeDotProps = BadgeCommonProps & {
+    size: 'dot';
+    children?: never;
+    appearance?: never;
+    shape?: never;
+} & (BadgeDotLabeled | BadgeDotDecorative);
+type BadgeProps = BadgeTextProps | BadgeDotProps;
+/** Compact, non-interactive metadata whose tone, emphasis, and shape are configured by props. */
+declare function Badge(props: BadgeProps): SafeHtml;
+
+export { Badge, type BadgeAppearance, type BadgeDotProps, type BadgeProps, type BadgeShape, type BadgeSize, type BadgeTextProps, type BadgeTone };

package/dist/badge.js

@@ -0,0 +1,3 @@
+export { Badge } from './chunk-MP2GDBQZ.js';
+
+//# sourceMappingURL=badge.js.map

package/dist/badge.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"badge.js"}

package/dist/browser/app-tab.js

@@ -1,3 +1,4 @@
 import '../styles/foundation.css';
+import '../styles/skeleton.css';
 import '../styles/app-tab.css';
 export * from '../app-tab.js';

package/dist/browser/badge.js

@@ -0,0 +1,3 @@
+import '../styles/foundation.css';
+import '../styles/badge.css';
+export * from '../badge.js';

package/dist/browser/catalog.js

@@ -0,0 +1,25 @@
+import '../styles/foundation.css';
+import '../styles/list.css';
+import '../styles/list-inset-text.css';
+import '../styles/lucide-icon.css';
+import '../styles/text.css';
+import '../styles/toolbar-control-group.css';
+import '../styles/skeleton.css';
+import '../styles/toolbar-text.css';
+import '../styles/resizable-region.css';
+import '../styles/floating-toolbar.css';
+import '../styles/pane.css';
+import '../styles/toolbar.css';
+import '../styles/workbench.css';
+import '../styles/popup-menu.css';
+import '../styles/row.css';
+import '../styles/badge.css';
+import '../styles/disclosure-arrow.css';
+import '../styles/list-header.css';
+import '../styles/loading-spinner.css';
+import '../styles/list-item.css';
+import '../styles/catalog/components/catalog-stage.css';
+import '../styles/catalog/components/catalog.css';
+import '../styles/catalog/components/catalog-example.css';
+import '../styles/catalog/components/catalog-example-stack.css';
+export * from '../catalog.js';

package/dist/browser/chip.js

@@ -0,0 +1,3 @@
+import '../styles/foundation.css';
+import '../styles/chip.css';
+export * from '../chip.js';

package/dist/browser/collapsible-panel.js

@@ -0,0 +1,7 @@
+import '../styles/foundation.css';
+import '../styles/lucide-icon.css';
+import '../styles/pane.css';
+import '../styles/toolbar.css';
+import '../styles/toolbar-control-group.css';
+import '../styles/collapsible-panel.css';
+export * from '../collapsible-panel.js';

package/dist/browser/content-item.js

@@ -0,0 +1,3 @@
+import '../styles/foundation.css';
+import '../styles/content-item.css';
+export * from '../content-item.js';

package/dist/browser/floating-toolbar.js

@@ -0,0 +1,3 @@
+import '../styles/foundation.css';
+import '../styles/floating-toolbar.css';
+export * from '../floating-toolbar.js';

package/dist/browser/grid.js

@@ -0,0 +1,3 @@
+import '../styles/foundation.css';
+import '../styles/grid.css';
+export * from '../grid.js';

package/dist/browser/list-action-row.js

@@ -0,0 +1,5 @@
+import '../styles/foundation.css';
+import '../styles/loading-spinner.css';
+import '../styles/skeleton.css';
+import '../styles/list-action-row.css';
+export * from '../list-action-row.js';

package/dist/browser/list-header.js

@@ -0,0 +1,8 @@
+import '../styles/foundation.css';
+import '../styles/badge.css';
+import '../styles/lucide-icon.css';
+import '../styles/disclosure-arrow.css';
+import '../styles/skeleton.css';
+import '../styles/text.css';
+import '../styles/list-header.css';
+export * from '../list-header.js';

package/dist/browser/list-inset-control.js

@@ -0,0 +1,3 @@
+import '../styles/foundation.css';
+import '../styles/list-inset-control.css';
+export * from '../list-inset-control.js';

package/dist/browser/list-inset-text.js

@@ -0,0 +1,3 @@
+import '../styles/foundation.css';
+import '../styles/list-inset-text.css';
+export * from '../list-inset-text.js';

package/dist/browser/list-item.js

@@ -0,0 +1,5 @@
+import '../styles/foundation.css';
+import '../styles/loading-spinner.css';
+import '../styles/skeleton.css';
+import '../styles/list-item.css';
+export * from '../list-item.js';

package/dist/browser/list.js

@@ -0,0 +1,3 @@
+import '../styles/foundation.css';
+import '../styles/list.css';
+export * from '../list.js';

package/dist/browser/{panel-header.js → nav-stack.js}

@@ -1,6 +1,8 @@
 import '../styles/foundation.css';
+import '../styles/lucide-icon.css';
 import '../styles/toolbar.css';
 import '../styles/toolbar-control-group.css';
+import '../styles/skeleton.css';
 import '../styles/toolbar-text.css';
-import '../styles/panel-header.css';
-export * from '../panel-header.js';
+import '../styles/nav-stack.css';
+export * from '../nav-stack.js';

package/dist/browser/pane.js

@@ -0,0 +1,3 @@
+import '../styles/foundation.css';
+import '../styles/pane.css';
+export * from '../pane.js';

package/dist/browser/popup-menu.js

@@ -0,0 +1,3 @@
+import '../styles/foundation.css';
+import '../styles/popup-menu.css';
+export * from '../popup-menu.js';

package/dist/browser/row.js

@@ -0,0 +1,3 @@
+import '../styles/foundation.css';
+import '../styles/row.css';
+export * from '../row.js';

package/dist/browser/select.js

@@ -1,4 +1,6 @@
 import '../styles/foundation.css';
+import '../styles/badge.css';
 import '../styles/lucide-icon.css';
+import '../styles/skeleton.css';
 import '../styles/select.css';
 export * from '../select.js';

package/dist/browser/skeleton.js

@@ -0,0 +1,3 @@
+import '../styles/foundation.css';
+import '../styles/skeleton.css';
+export * from '../skeleton.js';

package/dist/browser/spacer.js

@@ -0,0 +1,3 @@
+import '../styles/foundation.css';
+import '../styles/spacer.css';
+export * from '../spacer.js';

package/dist/browser/split-view.js

@@ -0,0 +1,10 @@
+import '../styles/foundation.css';
+import '../styles/lucide-icon.css';
+import '../styles/toolbar.css';
+import '../styles/toolbar-control-group.css';
+import '../styles/skeleton.css';
+import '../styles/toolbar-text.css';
+import '../styles/nav-stack.css';
+import '../styles/resizable-region.css';
+import '../styles/split-view.css';
+export * from '../split-view.js';

package/dist/browser/state-banner.js

@@ -1,3 +1,5 @@
 import '../styles/foundation.css';
+import '../styles/badge.css';
+import '../styles/skeleton.css';
 import '../styles/state-banner.css';
 export * from '../state-banner.js';

package/dist/browser/sunken-panel.js

@@ -0,0 +1,3 @@
+import '../styles/foundation.css';
+import '../styles/sunken-panel.css';
+export * from '../sunken-panel.js';

package/dist/browser/surface-scaffold.js

@@ -0,0 +1,3 @@
+import '../styles/foundation.css';
+import '../styles/surface-scaffold.css';
+export * from '../surface-scaffold.js';

package/dist/browser/tab-scaffold.js

@@ -0,0 +1,4 @@
+import '../styles/foundation.css';
+import '../styles/badge.css';
+import '../styles/tab-scaffold.css';
+export * from '../tab-scaffold.js';

package/dist/browser/text.js

@@ -0,0 +1,3 @@
+import '../styles/foundation.css';
+import '../styles/text.css';
+export * from '../text.js';

package/dist/browser/toolbar-text.js

@@ -1,3 +1,4 @@
 import '../styles/foundation.css';
+import '../styles/skeleton.css';
 import '../styles/toolbar-text.css';
 export * from '../toolbar-text.js';

package/dist/browser/value-table.js

@@ -1,3 +1,4 @@
 import '../styles/foundation.css';
+import '../styles/skeleton.css';
 import '../styles/value-table.css';
 export * from '../value-table.js';

package/dist/browser/workbench.js

@@ -0,0 +1,10 @@
+import '../styles/foundation.css';
+import '../styles/resizable-region.css';
+import '../styles/floating-toolbar.css';
+import '../styles/list.css';
+import '../styles/pane.css';
+import '../styles/lucide-icon.css';
+import '../styles/toolbar.css';
+import '../styles/toolbar-control-group.css';
+import '../styles/workbench.css';
+export * from '../workbench.js';

package/dist/catalog-resources.d.ts

@@ -0,0 +1,46 @@
+import { C as CatalogResource } from './types-BuHELdXR.js';
+import './semantic-content-BbzjvSu9.js';
+import 'kerfjs';
+import './toolbar.js';
+import './pane.js';
+import './sides-BPSWde0A.js';
+import './workbench.js';
+import './list.js';
+import './css-values.js';
+import './flex-alignment-4ms8ZbV8.js';
+import './resizable-region.js';
+import './panel-toolbar-DqwtBxQL.js';
+import './lucide-icon.js';
+import 'lucide';
+
+/**
+ * Standard resource labels for a Kerf catalog detail footer. Keep these labels
+ * stable across catalogs so people and AI-generated integrations see the same
+ * choices in the same vocabulary.
+ */
+type CatalogResourceKind = 'demoSource' | 'componentSource' | 'designTemplate' | 'guidance' | 'integrationGuidance';
+type CatalogGuidanceKind = 'guidance' | 'integrationGuidance';
+interface CatalogResourceTarget {
+    href: string;
+    /** Optional monospace detail, normally the repository-relative source path. */
+    detail?: string;
+}
+interface CatalogResourcesInput {
+    /** Required source for the runnable demonstration. */
+    demoSource: CatalogResourceTarget;
+    /** Source for the production component; omit for recipes and integrations. */
+    componentSource?: CatalogResourceTarget;
+    /** Optional design-tool template associated with the component. */
+    designTemplate?: CatalogResourceTarget;
+    /** Required UI or integration guidance. */
+    guidance: CatalogResourceTarget;
+    /** Use `integrationGuidance` when the component implementation is upstream. */
+    guidanceKind?: CatalogGuidanceKind;
+}
+/**
+ * Build the standard catalog resource group in its canonical order: demo,
+ * component, optional design template, then guidance.
+ */
+declare function catalogResources(input: CatalogResourcesInput): CatalogResource[];
+
+export { type CatalogGuidanceKind, type CatalogResourceKind, type CatalogResourceTarget, type CatalogResourcesInput, catalogResources };

package/dist/catalog-resources.js

@@ -0,0 +1,22 @@
+// src/catalog-resources.ts
+function catalogResources(input) {
+  const resources = [
+    { label: "Demo source", ...input.demoSource }
+  ];
+  if (input.componentSource)
+    resources.push({
+      label: "Component source",
+      ...input.componentSource
+    });
+  if (input.designTemplate)
+    resources.push({ label: "Design template", ...input.designTemplate });
+  resources.push({
+    label: input.guidanceKind === "integrationGuidance" ? "Integration guidance" : "Guidance",
+    ...input.guidance
+  });
+  return resources;
+}
+
+export { catalogResources };
+
+//# sourceMappingURL=catalog-resources.js.map

package/dist/catalog-resources.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/catalog-resources.ts"],"names":[],"mappings":";AAuCO,SAAS,iBACd,KAAA,EACmB;AACnB,EAAA,MAAM,SAAA,GAA+B;AAAA,IACnC,EAAE,KAAA,EAAO,aAAA,EAAe,GAAG,MAAM,UAAA;AAAW,GAC9C;AACA,EAAA,IAAI,KAAA,CAAM,eAAA;AACR,IAAA,SAAA,CAAU,IAAA,CAAK;AAAA,MACb,KAAA,EAAO,kBAAA;AAAA,MACP,GAAG,KAAA,CAAM;AAAA,KACV,CAAA;AACH,EAAA,IAAI,KAAA,CAAM,cAAA;AACR,IAAA,SAAA,CAAU,KAAK,EAAE,KAAA,EAAO,mBAAmB,GAAG,KAAA,CAAM,gBAAgB,CAAA;AACtE,EAAA,SAAA,CAAU,IAAA,CAAK;AAAA,IACb,KAAA,EACE,KAAA,CAAM,YAAA,KAAiB,qBAAA,GACnB,sBAAA,GACA,UAAA;AAAA,IACN,GAAG,KAAA,CAAM;AAAA,GACV,CAAA;AACD,EAAA,OAAO,SAAA;AACT","file":"catalog-resources.js","sourcesContent":["import type { CatalogResource } from './catalog.js';\n\n/**\n * Standard resource labels for a Kerf catalog detail footer. Keep these labels\n * stable across catalogs so people and AI-generated integrations see the same\n * choices in the same vocabulary.\n */\nexport type CatalogResourceKind =\n  | 'demoSource'\n  | 'componentSource'\n  | 'designTemplate'\n  | 'guidance'\n  | 'integrationGuidance';\n\nexport type CatalogGuidanceKind = 'guidance' | 'integrationGuidance';\n\nexport interface CatalogResourceTarget {\n  href: string;\n  /** Optional monospace detail, normally the repository-relative source path. */\n  detail?: string;\n}\n\nexport interface CatalogResourcesInput {\n  /** Required source for the runnable demonstration. */\n  demoSource: CatalogResourceTarget;\n  /** Source for the production component; omit for recipes and integrations. */\n  componentSource?: CatalogResourceTarget;\n  /** Optional design-tool template associated with the component. */\n  designTemplate?: CatalogResourceTarget;\n  /** Required UI or integration guidance. */\n  guidance: CatalogResourceTarget;\n  /** Use `integrationGuidance` when the component implementation is upstream. */\n  guidanceKind?: CatalogGuidanceKind;\n}\n\n/**\n * Build the standard catalog resource group in its canonical order: demo,\n * component, optional design template, then guidance.\n */\nexport function catalogResources(\n  input: CatalogResourcesInput,\n): CatalogResource[] {\n  const resources: CatalogResource[] = [\n    { label: 'Demo source', ...input.demoSource },\n  ];\n  if (input.componentSource)\n    resources.push({\n      label: 'Component source',\n      ...input.componentSource,\n    });\n  if (input.designTemplate)\n    resources.push({ label: 'Design template', ...input.designTemplate });\n  resources.push({\n    label:\n      input.guidanceKind === 'integrationGuidance'\n        ? 'Integration guidance'\n        : 'Guidance',\n    ...input.guidance,\n  });\n  return resources;\n}\n"]}