@capillaryjs/capillary-ui 1.0.0-alpha.1

package/colors/README.md

@@ -0,0 +1,63 @@
+# Capillary UI color palettes
+
+Each `<name>/colors.css` file is a replaceable, variable-only palette. It owns
+color anchors and endpoints, not the appearance of a panel, button, input,
+selection, or application surface. Palette files contain no component
+selectors and never import another stylesheet.
+
+Published palettes are `gray`, `green`, `iceblue`, `ocean`, `orange`, `purple`,
+`red`, and `yellow`.
+
+## Palette contract
+
+A palette supplies:
+
+- `--palette-light` and `--palette-dark` endpoints;
+- `--palette-contrast-light` and `--palette-contrast-dark` foregrounds;
+- `--palette-red` and `--palette-green` status primitives;
+- `--palette-primary-500`, `--palette-secondary-500`, and
+  `--palette-neutral-500` anchors.
+
+`themes/base.css` derives the remaining numeric ramp stops, ordinary
+`primary`/`light`/`dark` aliases, and transparent light variants with
+`color-mix()`. A palette may override a
+`--palette-<family>-light-mix` or `--palette-<family>-dark-mix` endpoint when a
+ramp intentionally changes hue.
+
+```css
+@layer palette {
+  :root {
+    --palette-light: #fff;
+    --palette-dark: #111827;
+    --palette-contrast-light: #fff;
+    --palette-contrast-dark: #111827;
+    --palette-red: #c62828;
+    --palette-green: #2e7d32;
+    --palette-primary-500: #2989d8;
+    --palette-secondary-500: #7137a8;
+    --palette-neutral-500: #7892aa;
+  }
+}
+```
+
+Color files must not declare semantic roles such as `--button-*`,
+`--input-*`, or `--panel-*`. The base and active theme map derived palette
+values to those roles.
+
+## Loading and replacement
+
+Load one palette after Capillary UI's base and structural CSS and before the active
+theme:
+
+```ts
+import '@capillaryjs/capillary-ui/colors/iceblue/colors.css'
+```
+
+`capillaryUiColorOptions` lists the built-in files. `ColorPicker` and
+`replaceCapillaryUiStylesheet('colors', option)` replace the link marked
+`data-cap-stylesheet="colors"`; applications own selection and persistence
+policy.
+
+When adding a palette, test its derived ramps and contrast in every supported
+theme, forced-colors mode, and application states that introduce semantic
+status colors.

package/colors/gray/colors.css

@@ -0,0 +1,16 @@
+@charset "utf-8";
+
+@layer palette {
+  :root {
+      --palette-light: #ffffff;
+      --palette-dark: #111827;
+      --palette-contrast-light: var(--palette-light);
+      --palette-contrast-dark: var(--palette-dark);
+      --palette-red: #b3261e;
+      --palette-green: #287a3c;
+
+      --palette-primary-500: #5d6873;
+      --palette-secondary-500: #1769aa;
+      --palette-neutral-500: #858d95;
+  }
+}

package/colors/green/colors.css

@@ -0,0 +1,16 @@
+@charset "utf-8";
+
+@layer palette {
+  :root {
+      --palette-light: #ffffff;
+      --palette-dark: #111827;
+      --palette-contrast-light: var(--palette-light);
+      --palette-contrast-dark: var(--palette-dark);
+      --palette-red: #b3261e;
+      --palette-green: #287a3c;
+
+      --palette-primary-500: #287a3c;
+      --palette-secondary-500: #087f78;
+      --palette-neutral-500: #75947a;
+  }
+}

package/colors/iceblue/colors.css

@@ -0,0 +1,19 @@
+@charset "utf-8";
+
+@layer palette {
+  :root {
+      --palette-light: #ffffff;
+      --palette-dark: #111827;
+      --palette-contrast-light: var(--palette-light);
+      --palette-contrast-dark: var(--palette-dark);
+      --palette-red: #b3261e;
+      --palette-green: #287a3c;
+
+      /* Preserve the legacy Shiny movement from navy through blue to cyan. */
+      --palette-primary-light-mix: #00b9e8;
+      --palette-primary-dark-mix: #00193f;
+      --palette-primary-500: #2989d8;
+      --palette-secondary-500: #7137a8;
+      --palette-neutral-500: #7892aa;
+  }
+}

package/colors/ocean/colors.css

@@ -0,0 +1,16 @@
+@charset "utf-8";
+
+@layer palette {
+  :root {
+      --palette-light: #ffffff;
+      --palette-dark: #111827;
+      --palette-contrast-light: var(--palette-light);
+      --palette-contrast-dark: var(--palette-dark);
+      --palette-red: #b3261e;
+      --palette-green: #287a3c;
+
+      --palette-primary-500: #087f78;
+      --palette-secondary-500: #1769aa;
+      --palette-neutral-500: #668f8a;
+  }
+}

package/colors/orange/colors.css

@@ -0,0 +1,16 @@
+@charset "utf-8";
+
+@layer palette {
+  :root {
+      --palette-light: #ffffff;
+      --palette-dark: #111827;
+      --palette-contrast-light: var(--palette-light);
+      --palette-contrast-dark: var(--palette-dark);
+      --palette-red: #b3261e;
+      --palette-green: #287a3c;
+
+      --palette-primary-500: #a94b00;
+      --palette-secondary-500: #7137a8;
+      --palette-neutral-500: #a87a56;
+  }
+}

package/colors/purple/colors.css

@@ -0,0 +1,16 @@
+@charset "utf-8";
+
+@layer palette {
+  :root {
+      --palette-light: #ffffff;
+      --palette-dark: #111827;
+      --palette-contrast-light: var(--palette-light);
+      --palette-contrast-dark: var(--palette-dark);
+      --palette-red: #b3261e;
+      --palette-green: #287a3c;
+
+      --palette-primary-500: #7137a8;
+      --palette-secondary-500: #1769aa;
+      --palette-neutral-500: #9273a2;
+  }
+}

package/colors/red/colors.css

@@ -0,0 +1,16 @@
+@charset "utf-8";
+
+@layer palette {
+  :root {
+      --palette-light: #ffffff;
+      --palette-dark: #111827;
+      --palette-contrast-light: var(--palette-light);
+      --palette-contrast-dark: var(--palette-dark);
+      --palette-red: #b3261e;
+      --palette-green: #287a3c;
+
+      --palette-primary-500: #b3261e;
+      --palette-secondary-500: #806000;
+      --palette-neutral-500: #a87570;
+  }
+}

package/colors/yellow/colors.css

@@ -0,0 +1,16 @@
+@charset "utf-8";
+
+@layer palette {
+  :root {
+      --palette-light: #ffffff;
+      --palette-dark: #111827;
+      --palette-contrast-light: var(--palette-light);
+      --palette-contrast-dark: var(--palette-dark);
+      --palette-red: #b3261e;
+      --palette-green: #287a3c;
+
+      --palette-primary-500: #806000;
+      --palette-secondary-500: #1769aa;
+      --palette-neutral-500: #998849;
+  }
+}

package/dist/Components/Placeholder.d.ts

@@ -0,0 +1,15 @@
+import { Component } from './component.js';
+import type { ComponentProps } from './component.js';
+import { StatusPresentation } from './status/statusPresentation.js';
+export interface PlaceholderProps extends ComponentProps {
+    width?: number | string;
+}
+/** Deterministic loading placeholder for data components. */
+export declare class Placeholder extends Component<PlaceholderProps> {
+    static liveProps: readonly string[];
+    static dependencies: (typeof StatusPresentation)[];
+    render(): import("@capillaryjs/capillary-ui/jsx-runtime").JSX.Element;
+    static hostName: string;
+    static css: string;
+}
+//# sourceMappingURL=Placeholder.d.ts.map

package/dist/Components/Placeholder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Placeholder.d.ts","sourceRoot":"","sources":["../../src/Components/Placeholder.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAM,MAAM,gBAAgB,CAAA;AAC7C,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,gBAAgB,CAAA;AAClD,OAAO,EAAC,kBAAkB,EAAC,MAAM,gCAAgC,CAAA;AAEjE,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACpD,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAC1B;AAED,6DAA6D;AAC7D,qBAAa,WAAY,SAAQ,SAAS,CAAC,gBAAgB,CAAC;IACxD,OAAgB,SAAS,EAAE,SAAS,MAAM,EAAE,CAAK;IACjD,OAAgB,YAAY,gCAAuB;IACnD,MAAM;IAMN,OAAgB,QAAQ,SAAgB;IAExC,OAAgB,GAAG,SAgClB;CACJ"}

package/dist/Components/app/app.d.ts

@@ -0,0 +1,41 @@
+import { Component } from '../component.js';
+import type { ComponentDependency, ComponentProps, CapillaryUiChild } from '../component.js';
+import { CapillaryUiRuntime } from '../../runtime.js';
+import type { CapillaryUiLayoutDirection } from '../layout/layoutTraits.js';
+/** Viewport sizing policy for a Capillary UI application root. */
+export type CapillaryUiAppSizing = 'embedded' | 'viewport-width' | 'viewport-height' | 'viewport';
+/** Landmark policy for a Capillary UI application root. */
+export type CapillaryUiAppLandmark = 'main' | 'none';
+export interface CapillaryUiAppProps extends ComponentProps {
+    /**
+     * Select the viewport axes claimed by the application shell. Embedded is
+     * sizing-neutral; the other values use Capillary UI's public fill traits.
+     */
+    sizing?: CapillaryUiAppSizing;
+    /** Arrange application-owned root children on the bounded host. */
+    layout?: CapillaryUiLayoutDirection;
+    /**
+     * `main` exposes the app as the document's primary-content landmark.
+     * Embedded applications should select `none`.
+     */
+    landmark?: CapillaryUiAppLandmark;
+}
+/**
+ * A fixed application shell with a `cap-app` host and theme typography.
+ *
+ * Instantiate it with children for a small application, or derive from it and
+ * override `renderContent()` for an application composition root.
+ */
+export declare class CapillaryUiApp extends Component<CapillaryUiAppProps> {
+    mount(parent?: ParentNode | null, before?: Node | null): this;
+    protected renderContent(): CapillaryUiChild;
+    render(): import("@capillaryjs/capillary-ui/jsx-runtime").JSX.Element;
+    static hostName: string;
+    static css: string;
+}
+/**
+ * Register an application root's reachable structural CSS before mounting it.
+ * Presentation assets remain explicit application policy.
+ */
+export declare function mountCapillaryUiApp<TArgs extends unknown[], TApp extends CapillaryUiApp>(runtime: CapillaryUiRuntime, appType: (new (...args: TArgs) => TApp) & ComponentDependency, parent: ParentNode, ...args: TArgs): TApp;
+//# sourceMappingURL=app.d.ts.map

package/dist/Components/app/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../src/Components/app/app.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAM,MAAM,iBAAiB,CAAA;AAC9C,OAAO,KAAK,EAAC,mBAAmB,EAAE,cAAc,EAAE,gBAAgB,EAAC,MAAM,iBAAiB,CAAA;AAC1F,OAAO,EAAC,kBAAkB,EAAC,MAAM,kBAAkB,CAAA;AAEnD,OAAO,KAAK,EAAC,0BAA0B,EAAC,MAAM,2BAA2B,CAAA;AAEzE,kEAAkE;AAClE,MAAM,MAAM,oBAAoB,GAC1B,UAAU,GACV,gBAAgB,GAChB,iBAAiB,GACjB,UAAU,CAAA;AAEhB,2DAA2D;AAC3D,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,MAAM,CAAA;AAEpD,MAAM,WAAW,mBAAoB,SAAQ,cAAc;IACvD;;;OAGG;IACH,MAAM,CAAC,EAAE,oBAAoB,CAAA;IAC7B,mEAAmE;IACnE,MAAM,CAAC,EAAE,0BAA0B,CAAA;IACnC;;;OAGG;IACH,QAAQ,CAAC,EAAE,sBAAsB,CAAA;CACpC;AAED;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,SAAS,CAAC,mBAAmB,CAAC;IACrD,KAAK,CAAC,MAAM,GAAE,UAAU,GAAG,IAAW,EAAE,MAAM,GAAE,IAAI,GAAG,IAAW,GAAG,IAAI;IASlF,SAAS,CAAC,aAAa,IAAI,gBAAgB;IAI3C,MAAM;IA4BN,OAAgB,QAAQ,SAAQ;IAEhC,OAAgB,GAAG,SAUlB;CACJ;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,SAAS,OAAO,EAAE,EAAE,IAAI,SAAS,cAAc,EACpF,OAAO,EAAE,kBAAkB,EAC3B,OAAO,EAAE,CAAC,KAAI,GAAG,IAAI,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,mBAAmB,EAC5D,MAAM,EAAE,UAAU,EAClB,GAAG,IAAI,EAAE,KAAK,GACf,IAAI,CAQN"}

package/dist/Components/component.d.ts

@@ -0,0 +1,256 @@
+import type { EventBubble, FetchStateValue, ReadableEmitter } from '@capillaryjs/capillary';
+import { CapillaryUiRuntime } from '../runtime.js';
+import type { ServiceKey } from '../services.js';
+import type { CapillaryUiLocalization, CapillaryUiMessage, CapillaryUiMessageOverrides } from '../localization.js';
+export declare const Fragment: unique symbol;
+export type Key = string | number;
+export interface ComponentProps {
+    key?: Key | null;
+    children?: CapillaryUiChild | readonly CapillaryUiChild[];
+    class?: string | null;
+    className?: string | null;
+    /** Opt this host into the theme-defined, non-nestable island treatment. */
+    island?: boolean;
+    [name: string]: unknown;
+}
+export type Ref<TNode extends Node = Node> = ((value: TNode | null) => void) | {
+    current: TNode | null;
+};
+export type FunctionComponent<TProps extends ComponentProps = ComponentProps> = (props: TProps) => CapillaryUiChild;
+export type ComponentConstructor<TProps extends ComponentProps = ComponentProps, TInstance extends Component<TProps> = Component<TProps>> = new (props: TProps) => TInstance;
+type ConcreteComponentConstructor = new (...args: never[]) => Component;
+export type VNodeType<TProps extends ComponentProps = ComponentProps> = string | typeof Fragment | ComponentConstructor<TProps> | FunctionComponent<TProps>;
+export interface VNode<TProps extends ComponentProps = ComponentProps> {
+    readonly type: string | typeof Fragment | Function;
+    readonly key: Key | null;
+    readonly props: TProps & {
+        children: NormalizedChild[];
+    };
+}
+export type CapillaryUiChild = string | number | boolean | null | undefined | VNode | Component | ReadableEmitter<CapillaryUiChild, unknown> | readonly CapillaryUiChild[];
+type NormalizedChild = string | number | VNode | Component | ReadableEmitter<CapillaryUiChild, unknown>;
+declare const liveBindingBrand: unique symbol;
+/** Explicitly subscribe a DOM or component property to an emitter's current value. */
+export interface LiveBinding<TValue> {
+    readonly emitter: ReadableEmitter<TValue, unknown>;
+    readonly [liveBindingBrand]: true;
+}
+/** Minimal writable Capillary contract used by native `bind:value` and `bind:checked`. */
+export interface WritableEmitter<TValue, TError = unknown> extends ReadableEmitter<TValue, TError> {
+    set(value: TValue, eventOrCause?: unknown): unknown;
+}
+export interface EmitterSnapshot<TValue, TError = unknown> {
+    readonly value: TValue;
+    readonly fetchState: FetchStateValue;
+    readonly error: TError | null;
+}
+declare const livePropContract: unique symbol;
+/** Type-only declaration of the component props that accept `live()` bindings. */
+export interface LivePropContract<TName extends string> {
+    readonly [livePropContract]?: TName;
+}
+/** Components opt in to every supported `live()` prop through LivePropContract. */
+type DefaultLivePropName<_TProps extends ComponentProps> = never;
+type DeclaredLivePropName<TProps extends ComponentProps> = typeof livePropContract extends keyof TProps ? Extract<Exclude<TProps[typeof livePropContract], undefined>, keyof TProps> : DefaultLivePropName<TProps>;
+export type TemplateProps<TProps extends ComponentProps> = {
+    [TName in keyof TProps as TName extends typeof livePropContract ? never : TName]: TName extends 'key' | 'children' ? TProps[TName] : TName extends DeclaredLivePropName<TProps> ? TProps[TName] | LiveBinding<Exclude<TProps[TName], undefined>> : TProps[TName];
+};
+export interface ComponentDependency {
+    registerStyles(runtime?: CapillaryUiRuntime, seen?: Set<ComponentDependency>): void;
+}
+interface Watchable {
+    subscribe(listener: (notification: {
+        event: EventBubble<unknown> | null;
+    }) => void, options?: {
+        emitCurrent?: boolean;
+    }): () => void;
+}
+/** Mark an emitter as a one-way live value for a DOM or component property. */
+export declare function live<TValue>(emitter: ReadableEmitter<TValue, unknown>): LiveBinding<TValue>;
+/** Build a Capillary UI virtual node. */
+export declare function h<TProps extends ComponentProps = ComponentProps>(type: VNodeType<TProps>, props?: TemplateProps<TProps> | null, ...children: CapillaryUiChild[]): VNode<TProps>;
+type LiveValue<TValue> = TValue | LiveBinding<Exclude<TValue, undefined>>;
+type AriaAttributes = {
+    [TName in `aria-${string}`]?: LiveValue<string | number | boolean | null | undefined>;
+};
+type DataAttributes = {
+    [TName in `data-${string}`]?: LiveValue<string | number | boolean | null | undefined>;
+};
+interface DOMEvents<TElement extends HTMLElement> {
+    onClick?: ((event: MouseEvent & {
+        currentTarget: TElement;
+    }) => void) | undefined;
+    onInput?: ((event: InputEvent & {
+        currentTarget: TElement;
+    }) => void) | undefined;
+    onChange?: ((event: Event & {
+        currentTarget: TElement;
+    }) => void) | undefined;
+    onKeyDown?: ((event: KeyboardEvent & {
+        currentTarget: TElement;
+    }) => void) | undefined;
+    onKeyUp?: ((event: KeyboardEvent & {
+        currentTarget: TElement;
+    }) => void) | undefined;
+    onFocus?: ((event: FocusEvent & {
+        currentTarget: TElement;
+    }) => void) | undefined;
+    onBlur?: ((event: FocusEvent & {
+        currentTarget: TElement;
+    }) => void) | undefined;
+    onPointerDown?: ((event: PointerEvent & {
+        currentTarget: TElement;
+    }) => void) | undefined;
+    onPointerMove?: ((event: PointerEvent & {
+        currentTarget: TElement;
+    }) => void) | undefined;
+    onPointerUp?: ((event: PointerEvent & {
+        currentTarget: TElement;
+    }) => void) | undefined;
+    onPointerCancel?: ((event: PointerEvent & {
+        currentTarget: TElement;
+    }) => void) | undefined;
+}
+type CapillaryUiDOMProps<TElement extends HTMLElement> = Omit<ComponentProps, 'class' | 'className'> & DOMEvents<TElement> & AriaAttributes & DataAttributes & {
+    class?: LiveValue<string | undefined>;
+    className?: LiveValue<string | undefined>;
+    for?: string | undefined;
+    htmlFor?: string | undefined;
+    ref?: Ref<TElement> | undefined;
+    style?: LiveValue<string | Record<string, string | number | null | undefined> | undefined>;
+};
+type LiveDOMProperties<TElement extends HTMLElement> = {
+    [TName in keyof Omit<TElement, keyof ComponentProps | 'style' | 'children'>]?: LiveValue<TElement[TName] | undefined>;
+};
+type NativeValueBinding<TElement extends HTMLElement> = TElement extends HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement ? {
+    'bind:value'?: WritableEmitter<string> | undefined;
+} : {};
+type NativeCheckedBinding<TElement extends HTMLElement> = TElement extends HTMLInputElement ? {
+    'bind:checked'?: WritableEmitter<boolean> | undefined;
+} : {};
+export interface CapillaryUiHostElementTagNameMap {
+    'cap-content': HTMLElement;
+    'cap-checkshell': HTMLElement;
+    'cap-selectshell': HTMLElement;
+    'cap-expander': HTMLElement;
+    'cap-label': HTMLElement;
+    'cap-options': HTMLElement;
+    'cap-error': HTMLElement;
+    'cap-erroricon': HTMLElement;
+    'cap-errortext': HTMLElement;
+    'cap-toolbarcontent': HTMLElement;
+    'cap-primary': HTMLElement;
+    'cap-secondary': HTMLElement;
+    'cap-separator': HTMLElement;
+    'cap-progress': HTMLElement;
+    'cap-inverse': HTMLElement;
+    'cap-presets': HTMLElement;
+    'cap-draghandle': HTMLElement;
+    'cap-chart': HTMLElement;
+    'cap-readout': HTMLElement;
+    'cap-swatch': HTMLElement;
+    'cap-summary': HTMLElement;
+    'cap-scroller': HTMLElement;
+    'cap-blocks': HTMLElement;
+    'cap-blocklabel': HTMLElement;
+    'cap-blockname': HTMLElement;
+    'cap-blockgroup': HTMLElement;
+    'cap-categoryhidecontent': HTMLElement;
+    'cap-criteriongroups': HTMLElement;
+    'cap-categorygroupcontent': HTMLElement;
+    'cap-categories': HTMLElement;
+    'cap-categoryoption': HTMLElement;
+    'cap-categoryswatch': HTMLElement;
+    'cap-infopanel': HTMLElement;
+    'cap-datepicker': HTMLElement;
+    'cap-timepicker': HTMLElement;
+    'cap-datetimepicker': HTMLElement;
+}
+export type CapillaryUiElementTagNameMap = HTMLElementTagNameMap & CapillaryUiHostElementTagNameMap;
+export type CapillaryUiIntrinsicElements = {
+    [TTag in keyof CapillaryUiElementTagNameMap]: CapillaryUiDOMProps<CapillaryUiElementTagNameMap[TTag]> & LiveDOMProperties<CapillaryUiElementTagNameMap[TTag]> & NativeValueBinding<CapillaryUiElementTagNameMap[TTag]> & NativeCheckedBinding<CapillaryUiElementTagNameMap[TTag]>;
+};
+/** Classic JSX type namespace for consumers configured with `jsxFactory: "h"`. */
+export declare namespace h {
+    namespace JSX {
+        type Element = VNode | Component;
+        interface ElementClass extends Component {
+        }
+        interface ElementAttributesProperty {
+            props: {};
+        }
+        interface ElementChildrenAttribute {
+            children: {};
+        }
+        interface IntrinsicAttributes {
+            key?: Key;
+        }
+        type LibraryManagedAttributes<_TComponent, TProps extends ComponentProps> = TemplateProps<TProps>;
+        type IntrinsicElements = CapillaryUiIntrinsicElements;
+    }
+}
+export declare function css(strings: TemplateStringsArray, ...values: unknown[]): string;
+export declare class Component<TProps extends ComponentProps = ComponentProps> {
+    static dependencies: ComponentDependency[];
+    static requiredServices: readonly ServiceKey<unknown>[];
+    /** Component `live()` bindings are opt-in; subclasses declare their allowlist. */
+    static liveProps: readonly string[] | null;
+    static css: string;
+    static hostName: string | null;
+    static new<TConstructor extends ConcreteComponentConstructor>(this: TConstructor, ...args: ConstructorParameters<TConstructor>): InstanceType<TConstructor>;
+    static registerStyles(this: ComponentDependency & {
+        css?: string;
+        dependencies?: ComponentDependency[];
+        hostName?: string | null;
+    }, runtime?: CapillaryUiRuntime, seen?: Set<ComponentDependency>): void;
+    props: TProps;
+    dom: ChildNode | null;
+    private initialized;
+    private mounted;
+    private destroyed;
+    private updating;
+    private updateRequested;
+    private readonly cleanupFunctions;
+    private readonly watched;
+    private readonly renderReadSubscriptions;
+    private collectingRenderReads;
+    constructor(props?: TProps);
+    /** One-time setup hook. Constructors must not subscribe or render. */
+    initialize(): void;
+    render(): CapillaryUiChild;
+    /** Render this component's configured custom host element. */
+    protected host(props?: ComponentProps | null, ...children: CapillaryUiChild[]): VNode;
+    /** JSX component for this instance's runtime-configured custom host. */
+    protected readonly Host: (props: ComponentProps) => VNode;
+    mount(parent?: ParentNode | null, before?: Node | null): this;
+    attachTo(parent: ParentNode): this;
+    update(_event?: unknown): this;
+    setProps(nextProps: TProps): this;
+    afterMount(_dom: ChildNode | null): void;
+    afterUpdate(_dom: ChildNode | null): void;
+    watch(...observables: Watchable[]): this;
+    watchFutureValues(...observables: Watchable[]): this;
+    /** Read an emitter during render and rerender when that dependency changes. */
+    read<TValue, TError>(emitter: ReadableEmitter<TValue, TError>): TValue;
+    /** Read a Capillary value, fetch state, and error as one tracked render dependency. */
+    snapshot<TValue, TError>(emitter: ReadableEmitter<TValue, TError>): EmitterSnapshot<TValue, TError>;
+    onCleanup(cleanup: () => void): () => void;
+    /** Resolve one explicitly declared application service from this component's runtime. */
+    protected requireService<TService>(key: ServiceKey<TService>): TService;
+    /** Read the immutable Capillary UI localization selected for this component's runtime. */
+    protected get localization(): CapillaryUiLocalization;
+    /** Resolve one Capillary UI-authored message with the runtime's English fallback. */
+    protected capillaryUiMessage<TKey extends keyof CapillaryUiMessageOverrides>(key: TKey): CapillaryUiMessage<TKey>;
+    listen<TEvent extends Event = Event>(target: EventTarget, type: string, listener: (event: TEvent) => void, options?: boolean | AddEventListenerOptions): this;
+    registerChild<TComponent extends Component>(component: TComponent): TComponent;
+    destroy(): void;
+    private validateRequiredServices;
+    private validateIslandAncestry;
+    private hasIslandDescendant;
+    onDestroy(): void;
+    private trackRenderRead;
+    private reconcileRenderReads;
+}
+export declare function isVNode(value: unknown): value is VNode;
+export {};
+//# sourceMappingURL=component.d.ts.map

package/dist/Components/component.d.ts.map

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

package/dist/Components/controlUtils.d.ts

@@ -0,0 +1,23 @@
+import type { ReadableEmitter } from '@capillaryjs/capillary';
+import type { Component, ComponentProps } from './component.js';
+import type { CapillaryUiLayoutParticipantProps } from './layout/layoutTraits.js';
+export interface ValueEmitter<TValue> extends ReadableEmitter<TValue, unknown> {
+    set(value: TValue, eventOrCause?: unknown): boolean;
+}
+export interface ValueControlProps<TValue> extends ComponentProps {
+    valueEmitter?: ValueEmitter<TValue>;
+    value?: TValue;
+    defaultValue?: TValue;
+    initialValue?: TValue;
+}
+export declare function controlId(prefix: string, provided?: string | number | null): string;
+export declare function createValueEmitter<TValue>(component: Component, props: ValueControlProps<TValue>, fallback: TValue, purpose: string): ValueEmitter<TValue>;
+export declare function assertEmitter<TValue = unknown>(value: unknown, name?: string): asserts value is ValueEmitter<TValue>;
+export declare function classNames(...values: unknown[]): string;
+export declare function componentClass(props: Pick<ComponentProps, 'class' | 'className'>): string;
+/** Build the host class for a component that intentionally exposes allocation. */
+export declare function layoutParticipantClass(props: Pick<ComponentProps, 'class' | 'className'> & CapillaryUiLayoutParticipantProps): string;
+export declare function invoke<TArguments extends unknown[]>(callback: ((...args: TArguments) => void) | null | undefined, ...args: TArguments): void;
+export declare function assertOptions<TOption>(options: unknown, name?: string): asserts options is TOption[];
+export declare function describeState(value: unknown): string;
+//# sourceMappingURL=controlUtils.d.ts.map

package/dist/Components/controlUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controlUtils.d.ts","sourceRoot":"","sources":["../../src/Components/controlUtils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiB,eAAe,EAAC,MAAM,wBAAwB,CAAA;AAE3E,OAAO,KAAK,EAAC,SAAS,EAAE,cAAc,EAAC,MAAM,gBAAgB,CAAA;AAE7D,OAAO,KAAK,EAAC,iCAAiC,EAAC,MAAM,0BAA0B,CAAA;AAG/E,MAAM,WAAW,YAAY,CAAC,MAAM,CAAE,SAAQ,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1E,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAA;CACtD;AAED,MAAM,WAAW,iBAAiB,CAAC,MAAM,CAAE,SAAQ,cAAc;IAC7D,YAAY,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,CAAA;IACnC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;CACxB;AAID,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,MAAM,CAGnF;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EACrC,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAChB,YAAY,CAAC,MAAM,CAAC,CAWtB;AAED,wBAAgB,aAAa,CAAC,MAAM,GAAG,OAAO,EAC1C,KAAK,EAAE,OAAO,EACd,IAAI,SAAY,GACjB,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC,MAAM,CAAC,CAQvC;AAED,wBAAgB,UAAU,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAKvD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,GAAG,WAAW,CAAC,GAAG,MAAM,CAEzF;AAED,kFAAkF;AAClF,wBAAgB,sBAAsB,CAClC,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,GAAG,WAAW,CAAC,GAAG,iCAAiC,GACvF,MAAM,CAER;AAED,wBAAgB,MAAM,CAAC,UAAU,SAAS,OAAO,EAAE,EAC/C,QAAQ,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,UAAU,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,SAAS,EAC5D,GAAG,IAAI,EAAE,UAAU,GACpB,IAAI,CAIN;AAED,wBAAgB,aAAa,CAAC,OAAO,EACjC,OAAO,EAAE,OAAO,EAChB,IAAI,SAAY,GACjB,OAAO,CAAC,OAAO,IAAI,OAAO,EAAE,CAE9B;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGpD"}

package/dist/Components/data/descriptionList.d.ts

@@ -0,0 +1,23 @@
+import { Component } from '../component.js';
+import type { ComponentProps, CapillaryUiChild } from '../component.js';
+export interface DescriptionItemProps extends ComponentProps {
+    term: CapillaryUiChild;
+    value?: CapillaryUiChild;
+}
+/** A term/value group with standards-valid `dl` children. */
+export declare class DescriptionItem extends Component<DescriptionItemProps> {
+    static liveProps: readonly string[];
+    render(): CapillaryUiChild;
+}
+export interface DescriptionListProps extends ComponentProps {
+    label?: string;
+}
+/** Semantic description-list container for compact record summaries. */
+export declare class DescriptionList extends Component<DescriptionListProps> {
+    static liveProps: readonly string[];
+    render(): CapillaryUiChild;
+    static hostName: string;
+    static dependencies: (typeof DescriptionItem)[];
+    static css: string;
+}
+//# sourceMappingURL=descriptionList.d.ts.map

package/dist/Components/data/descriptionList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptionList.d.ts","sourceRoot":"","sources":["../../../src/Components/data/descriptionList.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAC,SAAS,EAAM,MAAM,iBAAiB,CAAA;AAC9C,OAAO,KAAK,EAAC,cAAc,EAAE,gBAAgB,EAAC,MAAM,iBAAiB,CAAA;AAGrE,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IACxD,IAAI,EAAE,gBAAgB,CAAA;IACtB,KAAK,CAAC,EAAE,gBAAgB,CAAA;CAC3B;AAED,6DAA6D;AAC7D,qBAAa,eAAgB,SAAQ,SAAS,CAAC,oBAAoB,CAAC;IAChE,OAAgB,SAAS,EAAE,SAAS,MAAM,EAAE,CAAK;IACjD,MAAM,IAAI,gBAAgB;CAO7B;AAED,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IACxD,KAAK,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,wEAAwE;AACxE,qBAAa,eAAgB,SAAQ,SAAS,CAAC,oBAAoB,CAAC;IAChE,OAAgB,SAAS,EAAE,SAAS,MAAM,EAAE,CAAK;IACjD,MAAM,IAAI,gBAAgB;IAO1B,OAAgB,QAAQ,SAAoB;IAE5C,MAAM,CAAC,YAAY,6BAAoB;IAEvC,MAAM,CAAC,GAAG,SAUT;CACJ"}

package/dist/Components/data/filterState.d.ts

@@ -0,0 +1,38 @@
+import { DerivedEmitter } from '@capillaryjs/capillary';
+import type { ReadableEmitter } from '@capillaryjs/capillary';
+import type { FilterModeValue } from '../../util/filterMode.js';
+export type FilterOptionState = Readonly<Record<string, FilterModeValue>>;
+export type FilterState = Readonly<Record<string, FilterOptionState>>;
+export interface SerializedFilterState {
+    readonly version: 1;
+    readonly dimensions: Record<string, Record<string, FilterModeValue>>;
+}
+export interface FilterOptionDefinition<TItem> {
+    /** Stable persisted identity within its dimension. */
+    key: string;
+    matches: (item: TItem) => boolean;
+}
+export interface FilterDimensionDefinition<TItem> {
+    /** Stable persisted identity for the dimension. */
+    key: string;
+    options: readonly FilterOptionDefinition<TItem>[];
+}
+/**
+ * Test an item against semantic filter state.
+ *
+ * Dimensions combine with AND. Within one dimension, deny wins, every required
+ * option must match, and at least one preferred option must match when any are
+ * active. Unknown persisted dimensions and options are retained by
+ * serialization but do not constrain matching.
+ */
+export declare function matchesFilterState<TItem>(item: TItem, state: FilterState, dimensions: readonly FilterDimensionDefinition<TItem>[]): boolean;
+export declare function filterByState<TItem>(items: readonly TItem[], state: FilterState, dimensions: readonly FilterDimensionDefinition<TItem>[]): TItem[];
+/** Derive a reusable predicate without giving Capillary UI ownership of persistence. */
+export declare function deriveFilterPredicate<TItem>(state: ReadableEmitter<FilterState, unknown>, dimensions: readonly FilterDimensionDefinition<TItem>[], owner?: unknown): DerivedEmitter<(item: TItem) => boolean, readonly [ReadableEmitter<FilterState, unknown>]>;
+/** Derive a filtered collection from application-owned items and filter state. */
+export declare function deriveFilteredItems<TItem>(items: ReadableEmitter<readonly TItem[], unknown>, state: ReadableEmitter<FilterState, unknown>, dimensions: readonly FilterDimensionDefinition<TItem>[], owner?: unknown): DerivedEmitter<TItem[], readonly [ReadableEmitter<readonly TItem[], unknown>, ReadableEmitter<FilterState, unknown>]>;
+/** Convert state to deterministic, versioned, plain JSON-compatible data. */
+export declare function serializeFilterState(state: FilterState): SerializedFilterState;
+/** Validate and restore versioned filter data. Unknown keys are preserved. */
+export declare function parseFilterState(value: unknown): FilterState;
+//# sourceMappingURL=filterState.d.ts.map