@kerfjs/ui 5.0.0-beta.7 → 5.0.0-beta.71

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

@@ -1,7 +1,9 @@
 import '../styles/foundation.css';
-import '../styles/skeleton.css';
+import '../styles/lucide-icon.css';
 import '../styles/toolbar.css';
+import '../styles/loading-spinner.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/segmented-control.js

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

package/dist/browser/select.js

@@ -1,4 +1,5 @@
 import '../styles/foundation.css';
+import '../styles/badge.css';
 import '../styles/lucide-icon.css';
 import '../styles/skeleton.css';
 import '../styles/select.css';

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,11 @@
+import '../styles/foundation.css';
+import '../styles/lucide-icon.css';
+import '../styles/toolbar.css';
+import '../styles/loading-spinner.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,4 +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-control-group.js

@@ -1,3 +1,4 @@
 import '../styles/foundation.css';
+import '../styles/loading-spinner.css';
 import '../styles/toolbar-control-group.css';
 export * from '../toolbar-control-group.js';

package/dist/browser/workbench.js

@@ -0,0 +1,14 @@
+import '../styles/foundation.css';
+import '../styles/resizable-region.css';
+import '../styles/floating-toolbar.css';
+import '../styles/list.css';
+import '../styles/lucide-icon.css';
+import '../styles/toolbar.css';
+import '../styles/loading-spinner.css';
+import '../styles/toolbar-control-group.css';
+import '../styles/skeleton.css';
+import '../styles/toolbar-text.css';
+import '../styles/nav-stack.css';
+import '../styles/pane.css';
+import '../styles/workbench.css';
+export * from '../workbench.js';

package/dist/catalog-resources.d.ts

@@ -0,0 +1,48 @@
+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 './nav-stack.js';
+import './toolbar-text.js';
+import './resizable-region.js';
+import './panel-toolbar-DDKh4uKd.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"]}

package/dist/catalog.d.ts

@@ -0,0 +1,92 @@
+import * as kerfjs from 'kerfjs';
+import { SafeHtml } from 'kerfjs';
+import { a as CatalogProps } from './types-BuHELdXR.js';
+export { b as CatalogBrand, c as CatalogEntry, d as CatalogRelated, C as CatalogResource, e as CatalogSecondaryGroup, f as CatalogSection, g as CatalogStageRootAttributes } from './types-BuHELdXR.js';
+import { K as KerfUiContent } from './semantic-content-BbzjvSu9.js';
+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 './nav-stack.js';
+import './toolbar-text.js';
+import './resizable-region.js';
+import './panel-toolbar-DDKh4uKd.js';
+import './lucide-icon.js';
+import 'lucide';
+
+/**
+ * Controlled, stateless component-catalog shell: a `Workbench` whose left rail
+ * is the catalog navigation and whose work area is the active entry — its
+ * toolbar, description, preview stage, and resource footer. The sidebar's
+ * standard toggle moves into the entry toolbar while it is collapsed, and on
+ * a small screen the sidebar overlays the stage like any Workbench rail.
+ */
+declare function Catalog({ id, brand, sections, active, content, collapsed, theme, headerActions, secondarySections, sidebarFooter, status, geometryOverlay, stageRootAttributes, selectAction, toggleSidebarAction, toggleThemeAction, toggleSecondaryAction, headerPlacement, footerPlacement, sidebar, mainToolbar, footerToolbar, className, slot, }: CatalogProps): kerfjs.SafeHtml;
+
+/** How a specimen aligns its visible edge with its `ListHeader` label. */
+type CatalogExampleAlign = 'glyph' | 'inline-control' | 'text-trigger' | 'none';
+interface CatalogExampleViewport {
+    layout?: 'grid' | 'flex' | 'flex-column';
+    width?: 'full' | 'compact' | 'medium' | 'wide' | 'text' | 'control';
+    /** Fixed specimen height; `app` frames an application-sized recipe or layout.
+     *  A fixed height is definite, so a child that fills with `height: 100%`
+     *  (a horizontal `ResizableRegion`, say) spans the whole frame. */
+    height?: 'short' | 'reduced' | 'medium' | 'tall' | 'app';
+    /** A minimum the frame may grow past. It is not a definite height: a child
+     *  sized with `height: 100%` falls back to its content height, so use
+     *  `height` when the specimen must fill the frame. */
+    minHeight?: 'short' | 'medium';
+    frame?: 'solid' | 'dashed';
+    surface?: 'default' | 'lowered';
+    overflow?: 'hidden' | 'auto-x';
+    responsive?: 'roomy-only';
+    shadow?: boolean;
+    /** Public component custom properties applied to the specimen viewport. */
+    tokens?: Readonly<Record<`--${string}`, string>>;
+}
+type CatalogExampleRootAttributes = Readonly<Record<`data-${string}`, string | undefined> & {
+    'data-catalog-example'?: never;
+    'data-catalog-example-stack'?: never;
+    'data-catalog-example-label'?: never;
+    'data-catalog-example-note'?: never;
+    'data-align'?: never;
+}>;
+interface CatalogExampleProps {
+    label?: string;
+    note?: SafeHtml | string;
+    align?: CatalogExampleAlign;
+    /** Optional catalog-owned constraints for demonstrating layout components. */
+    viewport?: CatalogExampleViewport;
+    /** Replacement guidance shown when a roomy-only viewport is hidden. */
+    compactFallback?: SafeHtml | string;
+    rootAttributes?: CatalogExampleRootAttributes;
+    className?: string;
+    children?: KerfUiContent;
+    /** Native named-slot assignment when composed inside a web component. */
+    slot?: string;
+}
+/** A labeled catalog specimen with optional explanatory text and alignment. */
+declare function CatalogExample({ label, note, align, viewport, compactFallback, rootAttributes, className, children, slot, }: CatalogExampleProps): SafeHtml;
+
+type CatalogExampleStackRootAttributes = Readonly<Record<`data-${string}`, string | undefined> & {
+    'data-catalog-example'?: never;
+    'data-catalog-example-stack'?: never;
+    'data-catalog-example-label'?: never;
+    'data-catalog-example-note'?: never;
+    'data-align'?: never;
+}>;
+interface CatalogExampleStackProps {
+    label?: string;
+    rootAttributes?: CatalogExampleStackRootAttributes;
+    className?: string;
+    children?: KerfUiContent;
+    /** Native named-slot assignment when composed inside a web component. */
+    slot?: string;
+}
+/** A vertically stacked group of catalog examples. */
+declare function CatalogExampleStack({ label, rootAttributes, className, children, slot, }: CatalogExampleStackProps): kerfjs.SafeHtml;
+
+export { Catalog, CatalogExample, type CatalogExampleAlign, type CatalogExampleProps, CatalogExampleStack, type CatalogExampleStackProps, type CatalogExampleViewport, CatalogProps };