@deepfuture/dui-components 0.0.15 → 0.0.17

package/README.md

@@ -146,6 +146,36 @@ DUI uses CSS custom properties for theming. Toggle dark mode by adding `class="d
 </body>
 ```
 
+## Templates
+
+Pre-composed UI patterns built from DUI components — ready-to-use cards, feed items, and other building blocks. Templates are theme-scoped: they use the default theme's variant vocabulary and tokens, so they adapt automatically to dark mode and custom token overrides.
+
+```bash
+npm install @deepfuture/dui-theme-default-templates
+```
+
+```typescript
+import { DuiFeedItem } from "@deepfuture/dui-theme-default-templates/feed";
+
+applyTheme({
+  theme: defaultTheme,
+  components: [DuiFeedItem],  // dependencies (DuiBadge, etc.) auto-register
+});
+```
+
+```html
+<dui-feed-item
+  title="Earthquake detected"
+  subtitle="USGS Pacific Northwest"
+  timestamp="2 min ago"
+  category="Seismic"
+  severity="high"
+  description="Magnitude 4.2 recorded near Portland, OR."
+></dui-feed-item>
+```
+
+Templates declare their component dependencies via `static dependencies` — `applyTheme` auto-registers them, so you don't need to import `DuiBadge` separately.
+
 ## Packages
 
 | Package | Purpose |
@@ -153,6 +183,7 @@ DUI uses CSS custom properties for theming. Toggle dark mode by adding `class="d
 | [`@deepfuture/dui-core`](https://www.npmjs.com/package/@deepfuture/dui-core) | `applyTheme()`, event factory, base styles |
 | [`@deepfuture/dui-components`](https://www.npmjs.com/package/@deepfuture/dui-components) | Unstyled component classes |
 | [`@deepfuture/dui-theme-default`](https://www.npmjs.com/package/@deepfuture/dui-theme-default) | Design tokens + aesthetic styles |
+| [`@deepfuture/dui-theme-default-templates`](https://www.npmjs.com/package/@deepfuture/dui-theme-default-templates) | Pre-composed UI patterns for the default theme |
 | [`@deepfuture/dui-cdn`](https://www.npmjs.com/package/@deepfuture/dui-cdn) | Pre-bundled CDN build (all deps inlined) |
 
 ## Dev Tools
@@ -177,6 +208,7 @@ See **[Inspector docs](docs/inspector.md)** for the full API reference and usage
 - **[Live Docs](https://deepfuturenow.github.io/dui/)** — interactive demos for every component
 - [Architecture](docs/architecture.md) — mental model, package responsibilities, design decisions
 - [Creating Components](docs/creating-components.md) — guide for adding new components
+- [Creating Templates](docs/creating-templates.md) — guide for building theme-scoped templates
 - [Theming](docs/theming.md) — theme system, design tokens, writing component styles
 - [Consuming](docs/consuming.md) — integrating DUI into an app
 - [Inspector](docs/inspector.md) — runtime inspection, mutation API, and visual editor

package/accordion/accordion-item.js

@@ -67,29 +67,12 @@ const styles = css `
     cursor: default;
   }
 
-  [part="indicator"] {
-    flex-shrink: 0;
-  }
-
   [part="panel"] {
     overflow: hidden;
+    contain: content;
     transition-property: height;
   }
 `;
-// Inline chevron-down SVG to avoid icon component dependency
-const chevronSvg = html `<svg
-  part="indicator"
-  width="16"
-  height="16"
-  viewBox="0 0 24 24"
-  fill="none"
-  stroke="currentColor"
-  stroke-width="2"
-  stroke-linecap="round"
-  stroke-linejoin="round"
->
-  <path d="m6 9 6 6 6-6" />
-</svg>`;
 let DuiAccordionItem = (() => {
     let _classSuper = LitElement;
     let _value_decorators;
@@ -291,7 +274,6 @@ let DuiAccordionItem = (() => {
             @keydown=${this.#onKeyDown}
           >
             <slot name="trigger"></slot>
-            ${chevronSvg}
           </button>
         </h3>
         ${shouldRender

package/all.d.ts

@@ -62,6 +62,8 @@ export { DuiMenubar };
 export type { MenubarContext } from "./menubar/index.js";
 import { DuiNumberField } from "./number-field/index.js";
 export { DuiNumberField };
+import { DuiStepper } from "./stepper/index.js";
+export { DuiStepper };
 import { DuiPopover, DuiPopoverTrigger, DuiPopoverPopup, DuiPopoverClose } from "./popover/index.js";
 export { DuiPopover, DuiPopoverTrigger, DuiPopoverPopup, DuiPopoverClose, };
 export type { PopoverOpenChangeDetail, PopoverContext, PopoverSide, } from "./popover/index.js";
@@ -83,6 +85,8 @@ export { DuiSelect };
 export type { SelectOption } from "./select/index.js";
 import { DuiSeparator } from "./separator/index.js";
 export { DuiSeparator };
+import { DuiSplitButton } from "./split-button/index.js";
+export { DuiSplitButton };
 import { DuiSidebarProvider, DuiSidebar, DuiSidebarTrigger, DuiSidebarContent, DuiSidebarHeader, DuiSidebarFooter, DuiSidebarGroup, DuiSidebarGroupLabel, DuiSidebarMenu, DuiSidebarMenuItem, DuiSidebarMenuButton, DuiSidebarSeparator, DuiSidebarInset } from "./sidebar/index.js";
 export { DuiSidebarProvider, DuiSidebar, DuiSidebarTrigger, DuiSidebarContent, DuiSidebarHeader, DuiSidebarFooter, DuiSidebarGroup, DuiSidebarGroupLabel, DuiSidebarMenu, DuiSidebarMenuItem, DuiSidebarMenuButton, DuiSidebarSeparator, DuiSidebarInset, };
 export type { SidebarContext } from "./sidebar/index.js";

package/all.js

@@ -71,6 +71,9 @@ export { DuiMenubar };
 // --- Number Field ---
 import { DuiNumberField } from "./number-field/index.js";
 export { DuiNumberField };
+// --- Stepper ---
+import { DuiStepper } from "./stepper/index.js";
+export { DuiStepper };
 // --- Popover ---
 import { DuiPopover, DuiPopoverTrigger, DuiPopoverPopup, DuiPopoverClose, } from "./popover/index.js";
 export { DuiPopover, DuiPopoverTrigger, DuiPopoverPopup, DuiPopoverClose, };
@@ -95,6 +98,9 @@ export { DuiSelect };
 // --- Separator ---
 import { DuiSeparator } from "./separator/index.js";
 export { DuiSeparator };
+// --- Split Button ---
+import { DuiSplitButton } from "./split-button/index.js";
+export { DuiSplitButton };
 // --- Sidebar ---
 import { DuiSidebarProvider, DuiSidebar, DuiSidebarTrigger, DuiSidebarContent, DuiSidebarHeader, DuiSidebarFooter, DuiSidebarGroup, DuiSidebarGroupLabel, DuiSidebarMenu, DuiSidebarMenuItem, DuiSidebarMenuButton, DuiSidebarSeparator, DuiSidebarInset, } from "./sidebar/index.js";
 export { DuiSidebarProvider, DuiSidebar, DuiSidebarTrigger, DuiSidebarContent, DuiSidebarHeader, DuiSidebarFooter, DuiSidebarGroup, DuiSidebarGroupLabel, DuiSidebarMenu, DuiSidebarMenuItem, DuiSidebarMenuButton, DuiSidebarSeparator, DuiSidebarInset, };
@@ -171,6 +177,7 @@ export const allComponents = [
     DuiMenuItem,
     DuiMenubar,
     DuiNumberField,
+    DuiStepper,
     DuiPopover,
     DuiPopoverTrigger,
     DuiPopoverPopup,
@@ -185,6 +192,7 @@ export const allComponents = [
     DuiScrollArea,
     DuiSelect,
     DuiSeparator,
+    DuiSplitButton,
     DuiSidebarProvider,
     DuiSidebar,
     DuiSidebarTrigger,

package/card-grid/card-grid.d.ts

@@ -0,0 +1,17 @@
+import { LitElement, type TemplateResult } from "lit";
+/**
+ * `<dui-card-grid>` — A responsive grid layout for cards and panels.
+ *
+ * Distributes children into equal-width columns that collapse at narrow
+ * container widths. Use `columns` to set the maximum column count.
+ *
+ * @slot - Grid children (cards, panels, or any block content).
+ * @csspart root - The grid container element.
+ */
+export declare class DuiCardGrid extends LitElement {
+    static tagName: "dui-card-grid";
+    static styles: import("lit").CSSResult[];
+    /** Maximum number of columns (1–4). Responsive breakpoints reduce this automatically. */
+    accessor columns: string;
+    render(): TemplateResult;
+}

package/card-grid/card-grid.js

@@ -0,0 +1,110 @@
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+import { css, html, LitElement } from "lit";
+import { property } from "lit/decorators.js";
+import { base } from "@deepfuture/dui-core/base";
+/** Structural styles only — layout CSS. */
+const styles = css `
+  :host {
+    display: block;
+    min-width: 100%;
+  }
+
+  [part="root"] {
+    display: grid;
+    grid-template-columns: repeat(var(--_columns, 3), 1fr);
+    box-sizing: border-box;
+  }
+
+  :host([columns="1"]) { --_columns: 1; }
+  :host([columns="2"]) { --_columns: 2; }
+  :host([columns="3"]) { --_columns: 3; }
+  :host([columns="4"]) { --_columns: 4; }
+
+  /* Responsive collapse: narrow viewports reduce columns */
+  @media (max-width: 768px) {
+    :host([columns="3"]) { --_columns: 2; }
+    :host([columns="4"]) { --_columns: 2; }
+  }
+
+  @media (max-width: 480px) {
+    :host([columns="2"]),
+    :host([columns="3"]),
+    :host([columns="4"]) {
+      --_columns: 1;
+    }
+  }
+`;
+/**
+ * `<dui-card-grid>` — A responsive grid layout for cards and panels.
+ *
+ * Distributes children into equal-width columns that collapse at narrow
+ * container widths. Use `columns` to set the maximum column count.
+ *
+ * @slot - Grid children (cards, panels, or any block content).
+ * @csspart root - The grid container element.
+ */
+let DuiCardGrid = (() => {
+    let _classSuper = LitElement;
+    let _columns_decorators;
+    let _columns_initializers = [];
+    let _columns_extraInitializers = [];
+    return class DuiCardGrid extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _columns_decorators = [property({ reflect: true })];
+            __esDecorate(this, null, _columns_decorators, { kind: "accessor", name: "columns", static: false, private: false, access: { has: obj => "columns" in obj, get: obj => obj.columns, set: (obj, value) => { obj.columns = value; } }, metadata: _metadata }, _columns_initializers, _columns_extraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        static tagName = "dui-card-grid";
+        static styles = [base, styles];
+        #columns_accessor_storage = __runInitializers(this, _columns_initializers, "3");
+        /** Maximum number of columns (1–4). Responsive breakpoints reduce this automatically. */
+        get columns() { return this.#columns_accessor_storage; }
+        set columns(value) { this.#columns_accessor_storage = value; }
+        render() {
+            return html `
+      <div part="root">
+        <slot></slot>
+      </div>
+    `;
+        }
+        constructor() {
+            super(...arguments);
+            __runInitializers(this, _columns_extraInitializers);
+        }
+    };
+})();
+export { DuiCardGrid };

package/card-grid/index.d.ts

@@ -0,0 +1,3 @@
+import { DuiCardGrid } from "./card-grid.js";
+export { DuiCardGrid };
+export declare const cardGridFamily: (typeof DuiCardGrid)[];

package/card-grid/index.js

@@ -0,0 +1,3 @@
+import { DuiCardGrid } from "./card-grid.js";
+export { DuiCardGrid };
+export const cardGridFamily = [DuiCardGrid];

package/collapsible/collapsible.js

@@ -65,29 +65,17 @@ const styles = css `
     cursor: default;
   }
 
-  [part="indicator"] {
-    flex-shrink: 0;
+  slot[name="trigger"] {
+    flex: 1;
+    min-width: 0;
   }
 
   [part="panel"] {
     overflow: hidden;
+    contain: content;
     transition-property: height;
   }
 `;
-// Inline chevron-down SVG to avoid icon component dependency
-const chevronSvg = html `<svg
-  part="indicator"
-  width="16"
-  height="16"
-  viewBox="0 0 24 24"
-  fill="none"
-  stroke="currentColor"
-  stroke-width="2"
-  stroke-linecap="round"
-  stroke-linejoin="round"
->
-  <path d="m6 9 6 6 6-6" />
-</svg>`;
 let DuiCollapsible = (() => {
     let _classSuper = LitElement;
     let _open_decorators;
@@ -276,7 +264,6 @@ let DuiCollapsible = (() => {
         @click=${this.#onClick}
       >
         <slot name="trigger"></slot>
-        ${chevronSvg}
       </button>
       ${shouldRender
                 ? html `

package/command/command-empty.js

@@ -42,7 +42,7 @@ const styles = css `
     display: block;
   }
 
-  :host([data-hidden]) {
+  :host([data-hidden]) .Empty {
     display: none;
   }
 

package/command/command-group.js

@@ -45,7 +45,7 @@ const styles = css `
     display: block;
   }
 
-  :host([data-hidden]) {
+  :host([data-hidden]) .Group {
     display: none;
   }
 

package/command/command-item.js

@@ -45,7 +45,7 @@ const styles = css `
     display: block;
   }
 
-  :host([data-hidden]) {
+  :host([data-hidden]) .Item {
     display: none;
   }
 

package/number-field/index.d.ts

@@ -1,3 +1,3 @@
-import { DuiNumberField, valueChangeEvent } from "./number-field.js";
-export { DuiNumberField, valueChangeEvent };
+import { DuiNumberField, valueChangeEvent, valueCommittedEvent } from "./number-field.js";
+export { DuiNumberField, valueChangeEvent, valueCommittedEvent };
 export declare const numberFieldFamily: (typeof DuiNumberField)[];

package/number-field/index.js

@@ -1,3 +1,3 @@
-import { DuiNumberField, valueChangeEvent } from "./number-field.js";
-export { DuiNumberField, valueChangeEvent };
+import { DuiNumberField, valueChangeEvent, valueCommittedEvent, } from "./number-field.js";
+export { DuiNumberField, valueChangeEvent, valueCommittedEvent };
 export const numberFieldFamily = [DuiNumberField];

package/number-field/number-field.d.ts

@@ -5,14 +5,24 @@ export declare const valueChangeEvent: (detail: {
 }) => CustomEvent<{
     value: number;
 }>;
+export declare const valueCommittedEvent: (detail: {
+    value: number;
+}) => CustomEvent<{
+    value: number;
+}>;
 /**
- * `<dui-number-field>` — A numeric input with increment/decrement buttons.
+ * `<dui-number-field>` — A numeric input with optional label, icon,
+ * unit suffix, drag-to-scrub behavior, and precision formatting.
+ *
+ * For simple step-up/step-down with buttons, use `<dui-stepper>` instead.
  *
  * @csspart root - The outer container.
+ * @csspart label - Label text element.
+ * @csspart icon - Icon slot wrapper.
  * @csspart input - The text input element.
- * @csspart decrement - The decrement button.
- * @csspart increment - The increment button.
+ * @csspart unit - Unit suffix element.
  * @fires value-change - Fired when value changes. Detail: { value: number }
+ * @fires value-committed - Fired on pointerup (end of drag), blur, or Enter. Detail: { value: number }
  */
 export declare class DuiNumberField extends LitElement {
     #private;
@@ -29,6 +39,17 @@ export declare class DuiNumberField extends LitElement {
     accessor readOnly: boolean;
     accessor required: boolean;
     accessor name: string | undefined;
+    accessor label: string;
+    accessor labelPosition: string;
+    accessor iconPosition: string;
+    accessor unit: string;
+    accessor precision: number | undefined;
+    accessor scrubLabel: boolean;
+    accessor scrubValue: boolean;
+    accessor scrubField: boolean;
+    accessor clickLabel: boolean;
+    accessor clickValue: boolean;
+    accessor clickField: boolean;
     accessor _fieldCtx: FieldContext;
     connectedCallback(): void;
     willUpdate(): void;