@deepfuture/dui-components 0.0.16 → 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,30 +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;
@@ -292,7 +274,6 @@ let DuiAccordionItem = (() => {
             @keydown=${this.#onKeyDown}
           >
             <slot name="trigger"></slot>
-            ${chevronSvg}
           </button>
         </h3>
         ${shouldRender

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,8 +65,9 @@ const styles = css `
     cursor: default;
   }
 
-  [part="indicator"] {
-    flex-shrink: 0;
+  slot[name="trigger"] {
+    flex: 1;
+    min-width: 0;
   }
 
   [part="panel"] {
@@ -75,20 +76,6 @@ const styles = css `
     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;
@@ -277,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepfuture/dui-components",
-  "version": "0.0.16",
+  "version": "0.0.17",
   "description": "DUI unstyled web components — structural CSS only, themed via applyTheme()",
   "type": "module",
   "license": "MIT",
@@ -174,6 +174,10 @@
       "import": "./split-button/index.js",
       "types": "./split-button/index.d.ts"
     },
+    "./card-grid": {
+      "import": "./card-grid/index.js",
+      "types": "./card-grid/index.d.ts"
+    },
     "./all": {
       "import": "./all.js",
       "types": "./all.d.ts"
@@ -186,7 +190,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@deepfuture/dui-core": "0.0.16",
+    "@deepfuture/dui-core": "0.0.17",
     "lit": "^3.3.2",
     "@lit/context": "^1.1.3"
   },

package/popover/popover-popup.js

@@ -46,6 +46,10 @@ import { FloatingPortalController } from "@deepfuture/dui-core/floating-portal-c
 import { renderArrow, } from "@deepfuture/dui-core/floating-popup-utils";
 const hostStyles = css `
   :host {
+    display: contents;
+  }
+
+  .slot-wrapper {
     display: none;
   }
 `;
@@ -198,7 +202,7 @@ let DuiPopoverPopup = (() => {
             this.#portal.offset = this.#ctx.value?.sideOffset ?? 8;
         }
         render() {
-            return html `<slot></slot>`;
+            return html `<div class="slot-wrapper"><slot></slot></div>`;
         }
     };
 })();

package/preview-card/preview-card-popup.js

@@ -46,6 +46,10 @@ import { FloatingPortalController } from "@deepfuture/dui-core/floating-portal-c
 import { renderArrow, } from "@deepfuture/dui-core/floating-popup-utils";
 const hostStyles = css `
   :host {
+    display: contents;
+  }
+
+  .slot-wrapper {
     display: none;
   }
 `;
@@ -186,7 +190,7 @@ let DuiPreviewCardPopup = (() => {
             this.#portal.offset = this.#ctx.value?.sideOffset ?? 8;
         }
         render() {
-            return html `<slot></slot>`;
+            return html `<div class="slot-wrapper"><slot></slot></div>`;
         }
     };
 })();

package/tabs/tabs-panel.d.ts

@@ -1,5 +1,5 @@
 /** Ported from original DUI: deep-future-app/app/client/components/dui/tabs */
-import { LitElement, nothing, type TemplateResult } from "lit";
+import { LitElement, type TemplateResult } from "lit";
 import { type TabsContext } from "./tabs-context.js";
 /**
  * Content panel for a tab. Shown when the matching tab is active.
@@ -14,5 +14,5 @@ export declare class DuiTabsPanel extends LitElement {
     accessor keepMounted: boolean;
     accessor _ctx: TabsContext;
     willUpdate(): void;
-    render(): TemplateResult | typeof nothing;
+    render(): TemplateResult;
 }

package/tabs/tabs-panel.js

@@ -43,7 +43,11 @@ const styles = css `
     display: block;
   }
 
-  :host([data-hidden]) {
+  .wrapper {
+    display: contents;
+  }
+
+  .wrapper[hidden] {
     display: none;
   }
 
@@ -51,10 +55,6 @@ const styles = css `
     position: relative;
     outline: 0;
   }
-
-  [part="panel"][hidden] {
-    display: none;
-  }
 `;
 /**
  * Content panel for a tab. Shown when the matching tab is active.
@@ -107,17 +107,11 @@ let DuiTabsPanel = (() => {
         }
         render() {
             const isActive = this.#isActive;
-            if (!isActive && !this.keepMounted) {
-                return nothing;
-            }
             return html `
-      <div
-        part="panel"
-        role="tabpanel"
-        ?hidden=${!isActive}
-        tabindex="0"
-      >
-        <slot></slot>
+      <div class="wrapper" ?hidden=${!isActive}>
+        ${isActive || this.keepMounted
+                ? html `<div part="panel" role="tabpanel" tabindex="0"><slot></slot></div>`
+                : nothing}
       </div>
     `;
         }

package/tooltip/tooltip-popup.js

@@ -46,6 +46,10 @@ import { FloatingPortalController } from "@deepfuture/dui-core/floating-portal-c
 import { renderArrow, } from "@deepfuture/dui-core/floating-popup-utils";
 const hostStyles = css `
   :host {
+    display: contents;
+  }
+
+  .slot-wrapper {
     display: none;
   }
 `;
@@ -178,7 +182,7 @@ let DuiTooltipPopup = (() => {
             this.#portal.offset = this.#ctx.value?.sideOffset ?? 6;
         }
         render() {
-            return html `<slot></slot>`;
+            return html `<div class="slot-wrapper"><slot></slot></div>`;
         }
     };
 })();