@nldd/design-system 0.8.63 → 0.8.65

package/dist/utilities/codemirror/codemirror-element.d.ts

@@ -0,0 +1,66 @@
+import { LitElement } from 'lit';
+import { EditorView } from '@codemirror/view';
+import { type Compartment, type Extension } from '@codemirror/state';
+/**
+ * Shared base for design-system editors built on CodeMirror 6
+ * (nldd-code-editor, nldd-code-viewer, nldd-text-editor).
+ *
+ * It owns the EditorView lifecycle, mounts the view inside the component's
+ * shadow root (so CodeMirror's generated styles and selection stay scoped),
+ * and offers small helpers for document and compartment updates. Subclasses
+ * provide the parent element and the extension set; everything component
+ * specific (form association, public attributes, events) lives there.
+ */
+export declare abstract class NLDDCodeMirrorElement extends LitElement {
+    protected view?: EditorView;
+    /** True once the view has been mounted at least once — drives re-mount on reconnect. */
+    private _hasMounted;
+    /** Document captured on disconnect so a re-mount restores the live content. */
+    private _preservedDoc?;
+    /** The shadow-DOM element the EditorView mounts into. */
+    protected abstract getEditorParent(): HTMLElement | null | undefined;
+    /** The full extension set for the initial EditorState. */
+    protected abstract buildExtensions(): Extension[];
+    /** Current document text, or '' before the view exists. */
+    protected get doc(): string;
+    protected mountEditor(initialDoc: string): void;
+    /**
+     * Per-mount setup hook, called right after the view is created — on the
+     * initial mount (from the subclass `firstUpdated`) and on every re-mount
+     * after a detach/reattach. Subclasses (re)attach observers, DOM listeners
+     * and language grammars here so they survive being moved in the DOM.
+     * Default: no-op.
+     */
+    protected onEditorMounted(): void;
+    /**
+     * The document to seed the view with on a re-mount after a detach/reattach.
+     * Defaults to the document captured on disconnect — correct for editors,
+     * whose live view is the source of truth. A subclass whose source of truth
+     * lives elsewhere (e.g. the viewer, backed by its slot) overrides this to
+     * return that live text so a reattach with changed content isn't stale.
+     */
+    protected getRemountDoc(): string;
+    protected destroyEditor(): void;
+    /** Replace the whole document (used by the `value` property setter). */
+    protected setDoc(text: string): void;
+    /** Swap a single compartment at runtime (language, readonly, wrap, …). */
+    protected reconfigure(compartment: Compartment, extension: Extension): void;
+    /**
+     * Focus the editor itself, not the host. delegatesFocus handles a click or tab
+     * into the host, but a programmatic host.focus() is routed straight to
+     * CodeMirror here, whose contenteditable delegatesFocus does not reliably
+     * target.
+     */
+    focus(): void;
+    /**
+     * Focus the editor and place the caret on the line nearest a viewport point.
+     * Lets a wrapping composition forward clicks from its own padding —
+     * `editor.focusFromPoint(event.clientX, event.clientY)` — so a layout
+     * container can own the surrounding space without the editor knowing about
+     * it. No-op on a non-editable view.
+     */
+    focusFromPoint(x: number, y: number): void;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+}
+//# sourceMappingURL=codemirror-element.d.ts.map

package/dist/utilities/codemirror/codemirror-element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codemirror-element.d.ts","sourceRoot":"","sources":["../../../src/utilities/codemirror/codemirror-element.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAe,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAElF;;;;;;;;;GASG;AACH,8BAAsB,qBAAsB,SAAQ,UAAU;IAC7D,SAAS,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAE5B,wFAAwF;IACxF,OAAO,CAAC,WAAW,CAAS;IAE5B,+EAA+E;IAC/E,OAAO,CAAC,aAAa,CAAC,CAAS;IAE/B,yDAAyD;IACzD,SAAS,CAAC,QAAQ,CAAC,eAAe,IAAI,WAAW,GAAG,IAAI,GAAG,SAAS;IAEpE,0DAA0D;IAC1D,SAAS,CAAC,QAAQ,CAAC,eAAe,IAAI,SAAS,EAAE;IAEjD,2DAA2D;IAC3D,SAAS,KAAK,GAAG,IAAI,MAAM,CAE1B;IAED,SAAS,CAAC,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAa/C;;;;;;OAMG;IACH,SAAS,CAAC,eAAe,IAAI,IAAI;IAEjC;;;;;;OAMG;IACH,SAAS,CAAC,aAAa,IAAI,MAAM;IAIjC,SAAS,CAAC,aAAa,IAAI,IAAI;IAK/B,wEAAwE;IACxE,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMpC,0EAA0E;IAC1E,SAAS,CAAC,WAAW,CAAC,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;IAI3E;;;;;OAKG;IACM,KAAK,IAAI,IAAI;IAItB;;;;;;OAMG;IACH,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAajC,iBAAiB,IAAI,IAAI;IAYzB,oBAAoB,IAAI,IAAI;CAOrC"}

package/dist/utilities/codemirror/codemirror-element.js

@@ -0,0 +1,121 @@
+import { LitElement } from 'lit';
+import { EditorView } from '@codemirror/view';
+import { EditorState } from '@codemirror/state';
+/**
+ * Shared base for design-system editors built on CodeMirror 6
+ * (nldd-code-editor, nldd-code-viewer, nldd-text-editor).
+ *
+ * It owns the EditorView lifecycle, mounts the view inside the component's
+ * shadow root (so CodeMirror's generated styles and selection stay scoped),
+ * and offers small helpers for document and compartment updates. Subclasses
+ * provide the parent element and the extension set; everything component
+ * specific (form association, public attributes, events) lives there.
+ */
+export class NLDDCodeMirrorElement extends LitElement {
+    constructor() {
+        super(...arguments);
+        /** True once the view has been mounted at least once — drives re-mount on reconnect. */
+        this._hasMounted = false;
+    }
+    /** Current document text, or '' before the view exists. */
+    get doc() {
+        return this.view ? this.view.state.doc.toString() : '';
+    }
+    mountEditor(initialDoc) {
+        const parent = this.getEditorParent();
+        if (!parent || this.view)
+            return;
+        this.view = new EditorView({
+            state: EditorState.create({ doc: initialDoc, extensions: this.buildExtensions() }),
+            parent,
+            // Mount in the shadow root so getSelection()/focus stay scoped and
+            // CodeMirror's StyleModule injects into this root, not the document.
+            root: this.shadowRoot ?? undefined,
+        });
+        this._hasMounted = true;
+    }
+    /**
+     * Per-mount setup hook, called right after the view is created — on the
+     * initial mount (from the subclass `firstUpdated`) and on every re-mount
+     * after a detach/reattach. Subclasses (re)attach observers, DOM listeners
+     * and language grammars here so they survive being moved in the DOM.
+     * Default: no-op.
+     */
+    onEditorMounted() { }
+    /**
+     * The document to seed the view with on a re-mount after a detach/reattach.
+     * Defaults to the document captured on disconnect — correct for editors,
+     * whose live view is the source of truth. A subclass whose source of truth
+     * lives elsewhere (e.g. the viewer, backed by its slot) overrides this to
+     * return that live text so a reattach with changed content isn't stale.
+     */
+    getRemountDoc() {
+        return this._preservedDoc ?? '';
+    }
+    destroyEditor() {
+        this.view?.destroy();
+        this.view = undefined;
+    }
+    /** Replace the whole document (used by the `value` property setter). */
+    setDoc(text) {
+        const view = this.view;
+        if (!view || view.state.doc.toString() === text)
+            return;
+        view.dispatch({ changes: { from: 0, to: view.state.doc.length, insert: text } });
+    }
+    /** Swap a single compartment at runtime (language, readonly, wrap, …). */
+    reconfigure(compartment, extension) {
+        this.view?.dispatch({ effects: compartment.reconfigure(extension) });
+    }
+    /**
+     * Focus the editor itself, not the host. delegatesFocus handles a click or tab
+     * into the host, but a programmatic host.focus() is routed straight to
+     * CodeMirror here, whose contenteditable delegatesFocus does not reliably
+     * target.
+     */
+    focus() {
+        this.view?.focus();
+    }
+    /**
+     * Focus the editor and place the caret on the line nearest a viewport point.
+     * Lets a wrapping composition forward clicks from its own padding —
+     * `editor.focusFromPoint(event.clientX, event.clientY)` — so a layout
+     * container can own the surrounding space without the editor knowing about
+     * it. No-op on a non-editable view.
+     */
+    focusFromPoint(x, y) {
+        const view = this.view;
+        if (!view)
+            return;
+        // No caret to move on a read-only/disabled view — a direct call is a
+        // genuine no-op (matches this comment; also covers the read-only viewer
+        // and text-editor). Callers that forward padding clicks already guard on
+        // state.readOnly, but a bare focusFromPoint() must not move the caret.
+        if (view.state.readOnly)
+            return;
+        const pos = view.posAtCoords({ x, y }, false) ?? view.state.doc.length;
+        view.dispatch({ selection: { anchor: pos } });
+        view.focus();
+    }
+    connectedCallback() {
+        super.connectedCallback();
+        // A detach/reattach — Vue <KeepAlive>, a moved subtree, a <details> toggle —
+        // runs disconnectedCallback (which destroyed the view) without re-running
+        // Lit's one-shot firstUpdated. Rebuild the view from the preserved document
+        // so the editor comes back populated instead of blank until a page reload.
+        if (this._hasMounted && !this.view) {
+            this.mountEditor(this.getRemountDoc());
+            if (this.view)
+                this.onEditorMounted();
+        }
+    }
+    disconnectedCallback() {
+        super.disconnectedCallback();
+        // Capture the live document before the view is torn down so a later
+        // re-mount (see connectedCallback) restores exactly what was on screen.
+        if (this.view)
+            this._preservedDoc = this.doc;
+        this.destroyEditor();
+    }
+}
+//# sourceMappingURL=codemirror-element.js.map

package/dist/utilities/codemirror/codemirror-element.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codemirror-element.js","sourceRoot":"","sources":["../../../src/utilities/codemirror/codemirror-element.ts"],"names":[],"mappings":"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"}

package/dist/utilities/codemirror/languages.d.ts

@@ -0,0 +1,4 @@
+import { LanguageSupport } from '@codemirror/language';
+export declare function isLanguageSupported(name: string): boolean;
+export declare function loadLanguage(name: string): Promise<LanguageSupport> | undefined;
+//# sourceMappingURL=languages.d.ts.map

package/dist/utilities/codemirror/languages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"languages.d.ts","sourceRoot":"","sources":["../../../src/utilities/codemirror/languages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAkB,MAAM,sBAAsB,CAAC;AA4BvE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,GAAG,SAAS,CAc/E"}

package/dist/utilities/codemirror/languages.js

@@ -0,0 +1,39 @@
+import { LanguageSupport, StreamLanguage } from '@codemirror/language';
+const loaders = {
+    json: async () => (await import('@codemirror/lang-json')).json(),
+    yaml: async () => (await import('@codemirror/lang-yaml')).yaml(),
+    javascript: async () => (await import('@codemirror/lang-javascript')).javascript(),
+    typescript: async () => (await import('@codemirror/lang-javascript')).javascript({ typescript: true }),
+    css: async () => (await import('@codemirror/lang-css')).css(),
+    html: async () => (await import('@codemirror/lang-html')).html(),
+    xml: async () => (await import('@codemirror/lang-xml')).xml(),
+    python: async () => (await import('@codemirror/lang-python')).python(),
+    rust: async () => (await import('@codemirror/lang-rust')).rust(),
+    sql: async () => (await import('@codemirror/lang-sql')).sql(),
+    markdown: async () => (await import('@codemirror/lang-markdown')).markdown(),
+    // No official lang-* package — wrap the legacy StreamLanguage modes.
+    bash: async () => new LanguageSupport(StreamLanguage.define((await import('@codemirror/legacy-modes/mode/shell')).shell)),
+    toml: async () => new LanguageSupport(StreamLanguage.define((await import('@codemirror/legacy-modes/mode/toml')).toml)),
+    gherkin: async () => new LanguageSupport(StreamLanguage.define((await import('@codemirror/legacy-modes/mode/gherkin')).gherkin)),
+};
+const cache = new Map();
+export function isLanguageSupported(name) {
+    return Object.prototype.hasOwnProperty.call(loaders, name);
+}
+export function loadLanguage(name) {
+    const loader = loaders[name];
+    if (!loader)
+        return undefined;
+    let pending = cache.get(name);
+    if (!pending) {
+        // Drop the cache entry on failure so a later attempt can retry
+        // (e.g. a transient chunk-load failure on a flaky network).
+        pending = loader().catch((err) => {
+            cache.delete(name);
+            throw err;
+        });
+        cache.set(name, pending);
+    }
+    return pending;
+}
+//# sourceMappingURL=languages.js.map

package/dist/utilities/codemirror/languages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"languages.js","sourceRoot":"","sources":["../../../src/utilities/codemirror/languages.ts"],"names":[],"mappings":"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"}

package/dist/utilities/codemirror/theme.d.ts

@@ -0,0 +1,4 @@
+import type { Extension } from '@codemirror/state';
+/** Theme + syntax highlighting as one extension, shared by all DS editors. */
+export declare const nlddCodeMirrorTheme: Extension;
+//# sourceMappingURL=theme.d.ts.map

package/dist/utilities/codemirror/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../src/utilities/codemirror/theme.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAkFnD,8EAA8E;AAC9E,eAAO,MAAM,mBAAmB,EAAE,SAA2D,CAAC"}

package/dist/utilities/codemirror/theme.js

@@ -0,0 +1,84 @@
+import { EditorView } from '@codemirror/view';
+import { HighlightStyle, syntaxHighlighting } from '@codemirror/language';
+import { tags as t } from '@lezer/highlight';
+/* CodeMirror's generated theme styles mount into the same root as the view
+ * (the component's shadow root). CSS custom properties inherit across the
+ * shadow boundary, so every var(--…) below resolves against settings.css and
+ * adapts to light/dark mode automatically. Background and padding are left to
+ * the host component (the box/simple variant owns the framing). */
+const baseTheme = EditorView.theme({
+    '&': {
+        height: '100%',
+        color: 'var(--semantics-content-color)',
+        backgroundColor: 'transparent',
+    },
+    '&.cm-focused': {
+        // The focus ring lives on the host (.code-editor:focus-within).
+        outline: 'none',
+    },
+    '.cm-scroller': {
+        fontFamily: 'inherit',
+        lineHeight: 'inherit',
+        overflow: 'auto',
+    },
+    '.cm-content': {
+        padding: '0',
+        caretColor: 'var(--semantics-content-color)',
+    },
+    '.cm-line': {
+        padding: '0',
+    },
+    '.cm-cursor, .cm-dropCursor': {
+        borderLeftColor: 'var(--semantics-content-color)',
+    },
+    '.cm-placeholder': {
+        color: 'var(--semantics-input-fields-placeholder-color)',
+    },
+    // A solid selection colour. accent-150/250 are themselves light-dark; the
+    // outer light-dark() picks the lighter step in light mode and the darker step
+    // in dark mode (the accent scale inverts), keeping the selection subtle.
+    // The focused selector matches CodeMirror's own deep one so our colour wins on
+    // equal specificity — otherwise CM's light base theme paints the focused
+    // selection lavender, unreadable on a dark surface.
+    '&.cm-focused > .cm-scroller > .cm-selectionLayer .cm-selectionBackground, .cm-selectionBackground, .cm-content ::selection': {
+        backgroundColor: 'light-dark(var(--primitives-color-accent-150), var(--primitives-color-accent-250))',
+    },
+    '.cm-gutters': {
+        border: 'none',
+        backgroundColor: 'transparent',
+        color: 'var(--semantics-input-fields-placeholder-color)',
+    },
+    // Breathing room between the line-number gutter and the code (VS Code-like).
+    '.cm-lineNumbers .cm-gutterElement': {
+        padding: '0 var(--primitives-space-16) 0 var(--primitives-space-8)',
+    },
+    '.cm-activeLine, .cm-activeLineGutter': {
+        backgroundColor: 'transparent',
+    },
+});
+/* Token colors reuse the existing code-viewer palette so the editor and the
+ * read-only viewer highlight identically with one source of truth. */
+const highlightStyle = HighlightStyle.define([
+    { tag: [t.comment, t.lineComment, t.blockComment, t.docComment], color: 'var(--components-code-viewer-token-comment-color)', fontStyle: 'italic' },
+    { tag: [t.keyword, t.modifier, t.controlKeyword, t.operatorKeyword], color: 'var(--components-code-viewer-token-keyword-color)' },
+    { tag: [t.string, t.special(t.string), t.character], color: 'var(--components-code-viewer-token-string-color)' },
+    { tag: [t.number, t.integer, t.float], color: 'var(--components-code-viewer-token-number-color)' },
+    { tag: t.bool, color: 'var(--components-code-viewer-token-boolean-color)' },
+    { tag: t.null, color: 'var(--components-code-viewer-token-null-color)' },
+    { tag: [t.function(t.variableName), t.function(t.propertyName)], color: 'var(--components-code-viewer-token-function-color)' },
+    { tag: [t.className, t.typeName, t.namespace], color: 'var(--components-code-viewer-token-class-color)' },
+    { tag: [t.propertyName, t.attributeName], color: 'var(--components-code-viewer-token-property-color)' },
+    { tag: [t.punctuation, t.separator, t.bracket], color: 'var(--components-code-viewer-token-punctuation-color)' },
+    { tag: t.operator, color: 'var(--components-code-viewer-token-operator-color)' },
+    { tag: t.tagName, color: 'var(--components-code-viewer-token-tag-color)' },
+    { tag: t.attributeValue, color: 'var(--components-code-viewer-token-attr-value-color)' },
+    { tag: t.variableName, color: 'var(--components-code-viewer-token-variable-color)' },
+    { tag: [t.constant(t.variableName), t.standard(t.variableName)], color: 'var(--components-code-viewer-token-constant-color)' },
+    { tag: t.regexp, color: 'var(--components-code-viewer-token-regex-color)' },
+    { tag: t.url, color: 'var(--components-code-viewer-token-url-color)' },
+    { tag: t.strong, fontWeight: 'bold' },
+    { tag: t.emphasis, fontStyle: 'italic' },
+]);
+/** Theme + syntax highlighting as one extension, shared by all DS editors. */
+export const nlddCodeMirrorTheme = [baseTheme, syntaxHighlighting(highlightStyle)];
+//# sourceMappingURL=theme.js.map

package/dist/utilities/codemirror/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../../src/utilities/codemirror/theme.ts"],"names":[],"mappings":"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"}

package/dist/utilities/dismiss-from-title-bar.d.ts

@@ -0,0 +1,19 @@
+/**
+ * True when a bubbling `dismiss` event originates from an `nldd-top-title-bar`'s
+ * close button.
+ *
+ * Overlay containers (`nldd-sheet`, `nldd-window`) listen for bubbling `dismiss`
+ * events to close themselves. But nested components fire their own `dismiss` for
+ * their own element — an `nldd-token`'s remove button, an `nldd-banner`, an
+ * `nldd-document-tab-bar` — and those must NOT close the container. Only the
+ * container's own top-title-bar dismiss should. This shared check keeps that rule
+ * identical across every overlay container.
+ *
+ * Limitation: it matches ANY nldd-top-title-bar in the composed path, not
+ * specifically the container's own. That is correct for today's one-title-bar-per
+ * -container usage; a nested composition with more than one title bar (a sheet
+ * inside a sheet, each with its own) would need the inner container to
+ * stopPropagation on its own dismiss so it doesn't also reach the outer one.
+ */
+export declare function isDismissFromTitleBar(e: Event): boolean;
+//# sourceMappingURL=dismiss-from-title-bar.d.ts.map

package/dist/utilities/dismiss-from-title-bar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dismiss-from-title-bar.d.ts","sourceRoot":"","sources":["../../src/utilities/dismiss-from-title-bar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,KAAK,GAAG,OAAO,CAIvD"}

package/dist/utilities/dismiss-from-title-bar.js

@@ -0,0 +1,21 @@
+/**
+ * True when a bubbling `dismiss` event originates from an `nldd-top-title-bar`'s
+ * close button.
+ *
+ * Overlay containers (`nldd-sheet`, `nldd-window`) listen for bubbling `dismiss`
+ * events to close themselves. But nested components fire their own `dismiss` for
+ * their own element — an `nldd-token`'s remove button, an `nldd-banner`, an
+ * `nldd-document-tab-bar` — and those must NOT close the container. Only the
+ * container's own top-title-bar dismiss should. This shared check keeps that rule
+ * identical across every overlay container.
+ *
+ * Limitation: it matches ANY nldd-top-title-bar in the composed path, not
+ * specifically the container's own. That is correct for today's one-title-bar-per
+ * -container usage; a nested composition with more than one title bar (a sheet
+ * inside a sheet, each with its own) would need the inner container to
+ * stopPropagation on its own dismiss so it doesn't also reach the outer one.
+ */
+export function isDismissFromTitleBar(e) {
+    return e.composedPath().some((t) => t instanceof Element && t.tagName.toLowerCase() === 'nldd-top-title-bar');
+}
+//# sourceMappingURL=dismiss-from-title-bar.js.map

package/dist/utilities/dismiss-from-title-bar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dismiss-from-title-bar.js","sourceRoot":"","sources":["../../src/utilities/dismiss-from-title-bar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,qBAAqB,CAAC,CAAQ;IAC7C,OAAO,CAAC,CAAC,YAAY,EAAE,CAAC,IAAI,CAC3B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,YAAY,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,oBAAoB,CAC/E,CAAC;AACH,CAAC"}

package/dist/utilities/reflect-non-default.d.ts

@@ -0,0 +1,30 @@
+import type { ComplexAttributeConverter } from 'lit';
+/**
+ * A Lit attribute converter for a reflected enum property whose DEFAULT value
+ * should not appear in the DOM.
+ *
+ * It reflects any non-default value to the attribute (so `:host([prop="x"])`
+ * styling and framework property binding keep working), but maps the default to
+ * *no* attribute (`toAttribute` returns null), so the DOM isn't polluted with a
+ * redundant `prop="<default>"` on every instance.
+ *
+ * Pair it with `reflect: true`. The component's default styling must then live
+ * on the bare `:host` (not `:host([prop="<default>"])`), since a default-valued
+ * element carries no attribute to select on.
+ *
+ * Known edge: if markup writes the default *explicitly* (e.g. `<nldd-button
+ * size="md">`), `fromAttribute` resolves the property to the value it already
+ * holds, so Lit's default `hasChanged` sees no change, schedules no update, and
+ * `toAttribute` never runs to strip the attribute — so that one authored default
+ * attribute stays in the DOM. Visual behavior is unaffected (styling keys off the
+ * bare `:host`); it only matters to code matching `[prop="<default>"]`, which
+ * should read the property instead. Not worth a fragile `hasChanged` workaround.
+ *
+ * @example
+ * ```ts
+ * @property({ reflect: true, converter: reflectNonDefault<Size>('md') })
+ * size: Size = 'md';
+ * ```
+ */
+export declare function reflectNonDefault<T extends string>(defaultValue: T): ComplexAttributeConverter<T>;
+//# sourceMappingURL=reflect-non-default.d.ts.map

package/dist/utilities/reflect-non-default.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflect-non-default.d.ts","sourceRoot":"","sources":["../../src/utilities/reflect-non-default.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,KAAK,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,yBAAyB,CAAC,CAAC,CAAC,CAKjG"}

package/dist/utilities/reflect-non-default.js

@@ -0,0 +1,34 @@
+/**
+ * A Lit attribute converter for a reflected enum property whose DEFAULT value
+ * should not appear in the DOM.
+ *
+ * It reflects any non-default value to the attribute (so `:host([prop="x"])`
+ * styling and framework property binding keep working), but maps the default to
+ * *no* attribute (`toAttribute` returns null), so the DOM isn't polluted with a
+ * redundant `prop="<default>"` on every instance.
+ *
+ * Pair it with `reflect: true`. The component's default styling must then live
+ * on the bare `:host` (not `:host([prop="<default>"])`), since a default-valued
+ * element carries no attribute to select on.
+ *
+ * Known edge: if markup writes the default *explicitly* (e.g. `<nldd-button
+ * size="md">`), `fromAttribute` resolves the property to the value it already
+ * holds, so Lit's default `hasChanged` sees no change, schedules no update, and
+ * `toAttribute` never runs to strip the attribute — so that one authored default
+ * attribute stays in the DOM. Visual behavior is unaffected (styling keys off the
+ * bare `:host`); it only matters to code matching `[prop="<default>"]`, which
+ * should read the property instead. Not worth a fragile `hasChanged` workaround.
+ *
+ * @example
+ * ```ts
+ * @property({ reflect: true, converter: reflectNonDefault<Size>('md') })
+ * size: Size = 'md';
+ * ```
+ */
+export function reflectNonDefault(defaultValue) {
+    return {
+        fromAttribute: (value) => (value === null ? defaultValue : value),
+        toAttribute: (value) => (value === defaultValue ? null : value),
+    };
+}
+//# sourceMappingURL=reflect-non-default.js.map

package/dist/utilities/reflect-non-default.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reflect-non-default.js","sourceRoot":"","sources":["../../src/utilities/reflect-non-default.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,iBAAiB,CAAmB,YAAe;IAClE,OAAO;QACN,aAAa,EAAE,CAAC,KAAoB,EAAK,EAAE,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAE,KAAW,CAAC;QAC1F,WAAW,EAAE,CAAC,KAAQ,EAAiB,EAAE,CAAC,CAAC,KAAK,KAAK,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;KACjF,CAAC;AACH,CAAC"}