@elaraai/east-ui 1.0.4 → 1.0.5

package/dist/src/collections/library/index.js

@@ -0,0 +1,284 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * `Library` — a draggable palette of things that get assigned onto grid
+ * surfaces (Roster, Blend): people, assets, vehicles, rooms. Each card
+ * carries a primary identity plus configurable secondary dimensions that are
+ * filterable, groupable, and visible on the card. The Library declares the
+ * drag & drop **source** role under its `id`; targets connect by listing
+ * that id in their `sources`.
+ *
+ * @packageDocumentation
+ */
+import { East, Expr, variant, some, none, ArrayType, BooleanType, DictType, FloatType, StringType, StructType, } from "@elaraai/east";
+import { UIComponentType } from "../../component.js";
+import {} from "../../display/icon/types.js";
+import { StatusTokenType } from "../../style/interaction.js";
+import { LibraryRootType, LibraryItemType, LibraryCardFaceType, LibraryStatusType, LibraryDimValueType, LibraryGroupPlacementType, LibraryGroupMetaType, LibraryDimMetaType, } from "./types.js";
+// Re-export types
+export { LibraryRootType, LibraryItemType, LibraryCardFaceType, LibraryStatusType, LibraryDimValueType, LibraryGroupPlacementType, LibraryGroupMetaType, LibraryDimMetaType, } from "./types.js";
+/**
+ * Creates a card face — the per-item identity the `item` accessor returns.
+ *
+ * @param input - Card face fields
+ * @returns An East expression of the card face
+ *
+ * @example
+ * ```ts
+ * import { East, some, none } from "@elaraai/east";
+ * import { Library } from "@elaraai/east-ui";
+ *
+ * // Inside an `item` accessor:
+ * //   p => ({
+ * //       key: p.id,
+ * //       label: p.name,
+ * //       sublabel: p.role,
+ * //       icon: "user",
+ * //       status: p.atCap.ifElse(() => some(Library.status("At cap", "neutral")), () => none),
+ * //       draggable: p.atCap.not(),
+ * //   })
+ * ```
+ */
+function createCard(input) {
+    return East.value({
+        key: input.key,
+        label: input.label,
+        sublabel: input.sublabel !== undefined ? some(input.sublabel) : none,
+        icon: input.icon !== undefined ? some(input.icon) : none,
+        status: input.status !== undefined ? input.status : none,
+        draggable: input.draggable !== undefined ? input.draggable : true,
+    }, LibraryCardFaceType);
+}
+/**
+ * Creates a status pill value for a card face.
+ *
+ * @param label - Pill text (rendered uppercase)
+ * @param tone - Standard status tone
+ * @returns An East expression of the status pill
+ *
+ * @example
+ * ```ts
+ * import { Library } from "@elaraai/east-ui";
+ *
+ * // status: some(Library.status("On roster", "info"))
+ * ```
+ */
+function createStatus(label, tone) {
+    return East.value({
+        label,
+        tone: typeof tone === "string" ? variant(tone, null) : tone,
+    }, LibraryStatusType);
+}
+function dimValue(dim, row) {
+    switch (dim.kind) {
+        case "meter": {
+            const value = East.value(dim.value(row), FloatType);
+            return East.value(variant("meter", {
+                value,
+                max: typeof dim.max === "function" ? dim.max(row) : dim.max,
+                text: dim.format !== undefined ? some(dim.format(value)) : none,
+            }), LibraryDimValueType);
+        }
+        case "chips":
+            return East.value(variant("chips", dim.values(row)), LibraryDimValueType);
+        case "text":
+            return East.value(variant("text", dim.value(row)), LibraryDimValueType);
+    }
+}
+function buildRoot(data, config) {
+    const data_expr = East.value(data);
+    const dimensions = config.dimensions ?? [];
+    const groupDefs = config.groupBy ?? [];
+    const items = data_expr.map(($, row) => {
+        const dims = $.let(new Map(), DictType(StringType, LibraryDimValueType));
+        for (const dim of dimensions) {
+            $(dims.insert(dim.key, dimValue(dim, row)));
+        }
+        const groups = $.let(new Map(), DictType(StringType, LibraryGroupPlacementType));
+        for (const group of groupDefs) {
+            $(groups.insert(group.key, East.value({
+                value: group.value(row),
+                summary: group.summary !== undefined
+                    ? some(group.summary(data_expr.filter((_$, peer) => East.equal(East.value(group.value(peer), StringType), East.value(group.value(row), StringType)))))
+                    : none,
+            }, LibraryGroupPlacementType)));
+        }
+        const raw = config.item(row);
+        const face = $.let(raw instanceof Expr ? raw : createCard(raw), LibraryCardFaceType);
+        return East.value({
+            key: face.key,
+            label: face.label,
+            sublabel: face.sublabel,
+            icon: face.icon,
+            status: face.status,
+            draggable: face.draggable,
+            search: config.search !== undefined ? some(config.search(row)) : none,
+            groups,
+            dims,
+        }, LibraryItemType);
+    });
+    return East.value(variant("Library", {
+        id: config.id,
+        hint: config.hint !== undefined ? some(config.hint) : none,
+        items,
+        groupOptions: East.value(groupDefs.map(g => ({ key: g.key, label: g.label })), ArrayType(LibraryGroupMetaType)),
+        dimOptions: East.value(dimensions.map(d => ({ key: d.key, label: d.label })), ArrayType(LibraryDimMetaType)),
+        defaultDimensions: East.value(config.defaultDimensions ?? dimensions.slice(0, 2).map(d => d.key), ArrayType(StringType)),
+        searchable: config.search !== undefined,
+        addLabel: config.addLabel !== undefined ? some(config.addLabel) : none,
+        onAdd: config.onAdd !== undefined ? some(config.onAdd) : none,
+    }), UIComponentType);
+}
+/**
+ * Creates a Library — a draggable palette of assignable items.
+ *
+ * @typeParam R - The struct type of each data row
+ * @param data - The rows (one card per element)
+ * @param config - The Library configuration ({@link LibraryConfig})
+ * @returns An East expression of `UIComponentType`
+ *
+ * @example
+ * ```ts
+ * import { East } from "@elaraai/east";
+ * import { Library, UIComponentType } from "@elaraai/east-ui";
+ *
+ * const example = East.function([], UIComponentType, _$ =>
+ *     Library.Root(
+ *         [{ id: "patel", name: "Patel, R.", role: "Senior SE", hours: 38.0 }],
+ *         {
+ *             id: "people",
+ *             item: p => ({ key: p.id, label: p.name, sublabel: p.role, icon: "user" }),
+ *             dimensions: [
+ *                 { kind: "meter", key: "hours", label: "Hours", value: p => p.hours, max: 40.0,
+ *                   format: h => East.str`${h}h` },
+ *             ],
+ *         },
+ *     ),
+ * );
+ * ```
+ */
+function createLibrary(data, config) {
+    return buildRoot(data, config);
+}
+// ============================================================================
+// Namespace export
+// ============================================================================
+/**
+ * Library component namespace.
+ *
+ * @remarks
+ * `Library.Root(data, config)` builds the palette; the `item` mapper returns
+ * plain card-face fields per row; `Library.status` builds status-pill values.
+ * Secondary dimensions and group-by options are plain discriminated config
+ * literals (`{ kind: "meter", ... }`), like Planner column definitions.
+ */
+export const Library = {
+    /**
+     * Creates a Library — a draggable palette of assignable items.
+     *
+     * @typeParam R - The struct type of each data row
+     * @param data - The rows (one card per element)
+     * @param config - The Library configuration ({@link LibraryConfig})
+     * @returns An East expression of `UIComponentType`
+     *
+     * @remarks
+     * Declares the DnD **source** role under `config.id`. Cards with
+     * `draggable: false` show no grip and never start a drag. Search text
+     * dims unmatched cards instead of removing them.
+     *
+     * @example
+     * ```ts
+     * import { East } from "@elaraai/east";
+     * import { Library, UIComponentType } from "@elaraai/east-ui";
+     *
+     * const example = East.function([], UIComponentType, _$ =>
+     *     Library.Root(
+     *         [{ id: "patel", name: "Patel, R.", role: "Senior SE" }],
+     *         {
+     *             id: "people",
+     *             item: p => ({ key: p.id, label: p.name, sublabel: p.role }),
+     *         },
+     *     ),
+     * );
+     * ```
+     */
+    Root: createLibrary,
+    /**
+     * Creates a status pill value for a card face.
+     *
+     * @param label - Pill text (rendered uppercase)
+     * @param tone - Standard status tone (`success` / `warning` / `danger` / `info` / `neutral`)
+     * @returns An East expression of the status pill
+     *
+     * @example
+     * ```ts
+     * import { Library } from "@elaraai/east-ui";
+     *
+     * // Library.status("At cap", "neutral")
+     * ```
+     */
+    status: createStatus,
+    Types: {
+        /**
+         * East StructType for the Library component.
+         *
+         * @remarks
+         * The resolved palette: cards plus toolbar metadata. See
+         * {@link LibraryRootType} for per-field docs.
+         *
+         * @property id - DnD source identity
+         * @property hint - Optional header-right caption
+         * @property items - The resolved cards
+         * @property groupOptions - GROUP BY toolbar options
+         * @property dimOptions - SECONDARY dimension toggles
+         * @property defaultDimensions - Initially-visible dimension keys
+         * @property searchable - Whether the search input renders
+         * @property addLabel - Optional footer action label
+         * @property onAdd - Optional footer action callback
+         */
+        Library: LibraryRootType,
+        /**
+         * A resolved Library card.
+         *
+         * @property key - Item identity
+         * @property label - Primary identity line
+         * @property sublabel - Optional muted second line
+         * @property icon - Optional Font Awesome solid icon name
+         * @property status - Optional status pill
+         * @property draggable - Whether the card can start a drag
+         * @property search - Optional filter text
+         * @property groups - Group placement per group-by option key
+         * @property dims - Secondary dimension value per dimension key
+         */
+        Item: LibraryItemType,
+        /**
+         * The card face produced by the `item` accessor.
+         *
+         * @property key - Item identity
+         * @property label - Primary identity line
+         * @property sublabel - Optional muted second line
+         * @property icon - Optional Font Awesome solid icon name
+         * @property status - Optional status pill
+         * @property draggable - Whether the card can start a drag
+         */
+        CardFace: LibraryCardFaceType,
+        /**
+         * Status pill on a Library card.
+         *
+         * @property label - Pill text (rendered uppercase)
+         * @property tone - Standard status tone
+         */
+        Status: LibraryStatusType,
+        /**
+         * A secondary dimension's value on one card.
+         *
+         * @property meter - Utilisation bar with optional right-aligned text
+         * @property chips - A row of small chips
+         * @property text - A muted caption line
+         */
+        DimValue: LibraryDimValueType,
+    },
+};
+//# sourceMappingURL=index.js.map

package/dist/src/collections/library/index.js.map

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

package/dist/src/collections/library/types.d.ts

@@ -0,0 +1,329 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import { ArrayType, BooleanType, DictType, FloatType, NullType, OptionType, StringType, StructType, VariantType, FunctionType } from "@elaraai/east";
+/**
+ * Status pill on a Library card.
+ *
+ * @remarks
+ * The card's availability/assignment state (`ON ROSTER`, `AT CAP`,
+ * `PTO MAR 4–8`, `IN SERVICE`), rendered as a small pill in the card's top
+ * right using the standard status tone set.
+ *
+ * @property label - Pill text (rendered uppercase)
+ * @property tone - Standard status tone
+ */
+export declare const LibraryStatusType: StructType<{
+    /** Pill text (rendered uppercase) */
+    readonly label: StringType;
+    /** Standard status tone */
+    readonly tone: VariantType<{
+        readonly success: NullType;
+        readonly warning: NullType;
+        readonly danger: NullType;
+        readonly info: NullType;
+        readonly neutral: NullType;
+    }>;
+}>;
+/**
+ * Type representing Library card status values.
+ */
+export type LibraryStatusType = typeof LibraryStatusType;
+/**
+ * A secondary dimension's value on one card.
+ *
+ * @remarks
+ * Secondary dimensions are the configurable card facts (hours, skills,
+ * certifications, capacity, range, location) that the toolbar toggles on and
+ * off. Each renders by kind: `meter` (utilisation bar + right-aligned text),
+ * `chips` (a row of small chips), or `text` (a muted caption).
+ *
+ * @property meter - Utilisation bar with optional right-aligned text
+ * @property chips - A row of small chips
+ * @property text - A muted caption line
+ */
+export declare const LibraryDimValueType: VariantType<{
+    /** Utilisation bar with optional right-aligned text */
+    readonly meter: StructType<{
+        /** Current value */
+        readonly value: FloatType;
+        /** Full-scale value */
+        readonly max: FloatType;
+        /** Optional right-aligned text (e.g. `38h`) */
+        readonly text: OptionType<StringType>;
+    }>;
+    /** A row of small chips */
+    readonly chips: ArrayType<StringType>;
+    /** A muted caption line */
+    readonly text: StringType;
+}>;
+/**
+ * Type representing secondary dimension values.
+ */
+export type LibraryDimValueType = typeof LibraryDimValueType;
+/**
+ * One card's group placement under a group-by option: the group value it
+ * belongs to plus the (shared) group summary text.
+ *
+ * @property value - The group this card belongs to under the option
+ * @property summary - Right-aligned group-head summary text
+ */
+export declare const LibraryGroupPlacementType: StructType<{
+    /** The group this card belongs to under the option */
+    readonly value: StringType;
+    /** Right-aligned group-head summary text */
+    readonly summary: OptionType<StringType>;
+}>;
+/**
+ * Type representing a card's group placement.
+ */
+export type LibraryGroupPlacementType = typeof LibraryGroupPlacementType;
+/**
+ * A resolved Library card.
+ *
+ * @remarks
+ * Produced by the `item` accessor plus the dimension / group / search
+ * accessors at authoring time — the renderer never sees the host's row type.
+ *
+ * @property key - Item identity; carried by `LibraryRef` when dragged
+ * @property label - Primary identity line
+ * @property sublabel - Optional muted second line (role / class)
+ * @property icon - Optional Font Awesome solid icon name
+ * @property status - Optional status pill
+ * @property draggable - Whether the card can start a drag
+ * @property search - Optional filter text (card dims when unmatched)
+ * @property groups - Group placement per group-by option key
+ * @property dims - Secondary dimension value per dimension key
+ */
+export declare const LibraryItemType: StructType<{
+    /** Item identity; carried by `LibraryRef` when dragged */
+    readonly key: StringType;
+    /** Primary identity line */
+    readonly label: StringType;
+    /** Optional muted second line (role / class) */
+    readonly sublabel: OptionType<StringType>;
+    /** Optional Font Awesome solid icon name */
+    readonly icon: OptionType<StringType>;
+    /** Optional status pill */
+    readonly status: OptionType<StructType<{
+        /** Pill text (rendered uppercase) */
+        readonly label: StringType;
+        /** Standard status tone */
+        readonly tone: VariantType<{
+            readonly success: NullType;
+            readonly warning: NullType;
+            readonly danger: NullType;
+            readonly info: NullType;
+            readonly neutral: NullType;
+        }>;
+    }>>;
+    /** Whether the card can start a drag */
+    readonly draggable: BooleanType;
+    /** Optional filter text (card dims when unmatched) */
+    readonly search: OptionType<StringType>;
+    /** Group placement per group-by option key */
+    readonly groups: DictType<StringType, StructType<{
+        /** The group this card belongs to under the option */
+        readonly value: StringType;
+        /** Right-aligned group-head summary text */
+        readonly summary: OptionType<StringType>;
+    }>>;
+    /** Secondary dimension value per dimension key */
+    readonly dims: DictType<StringType, VariantType<{
+        /** Utilisation bar with optional right-aligned text */
+        readonly meter: StructType<{
+            /** Current value */
+            readonly value: FloatType;
+            /** Full-scale value */
+            readonly max: FloatType;
+            /** Optional right-aligned text (e.g. `38h`) */
+            readonly text: OptionType<StringType>;
+        }>;
+        /** A row of small chips */
+        readonly chips: ArrayType<StringType>;
+        /** A muted caption line */
+        readonly text: StringType;
+    }>>;
+}>;
+/**
+ * Type representing resolved Library cards.
+ */
+export type LibraryItemType = typeof LibraryItemType;
+/**
+ * The card face — the per-item fields produced by the `item` accessor
+ * (via `Library.card`), before the factory merges in dimensions, group
+ * placements, and search text.
+ *
+ * @property key - Item identity; carried by `LibraryRef` when dragged
+ * @property label - Primary identity line
+ * @property sublabel - Optional muted second line
+ * @property icon - Optional Font Awesome solid icon name
+ * @property status - Optional status pill
+ * @property draggable - Whether the card can start a drag
+ */
+export declare const LibraryCardFaceType: StructType<{
+    /** Item identity; carried by `LibraryRef` when dragged */
+    readonly key: StringType;
+    /** Primary identity line */
+    readonly label: StringType;
+    /** Optional muted second line */
+    readonly sublabel: OptionType<StringType>;
+    /** Optional Font Awesome solid icon name */
+    readonly icon: OptionType<StringType>;
+    /** Optional status pill */
+    readonly status: OptionType<StructType<{
+        /** Pill text (rendered uppercase) */
+        readonly label: StringType;
+        /** Standard status tone */
+        readonly tone: VariantType<{
+            readonly success: NullType;
+            readonly warning: NullType;
+            readonly danger: NullType;
+            readonly info: NullType;
+            readonly neutral: NullType;
+        }>;
+    }>>;
+    /** Whether the card can start a drag */
+    readonly draggable: BooleanType;
+}>;
+/**
+ * Type representing card face values.
+ */
+export type LibraryCardFaceType = typeof LibraryCardFaceType;
+/**
+ * Toolbar metadata for one group-by option.
+ *
+ * @property key - Option identity (matches each card's `groups` key)
+ * @property label - Segment label in the GROUP BY toolbar
+ */
+export declare const LibraryGroupMetaType: StructType<{
+    /** Option identity (matches each card's `groups` key) */
+    readonly key: StringType;
+    /** Segment label in the GROUP BY toolbar */
+    readonly label: StringType;
+}>;
+/**
+ * Type representing group-by option metadata.
+ */
+export type LibraryGroupMetaType = typeof LibraryGroupMetaType;
+/**
+ * Toolbar metadata for one secondary dimension.
+ *
+ * @property key - Dimension identity (matches each card's `dims` key)
+ * @property label - Toggle label in the SECONDARY toolbar
+ */
+export declare const LibraryDimMetaType: StructType<{
+    /** Dimension identity (matches each card's `dims` key) */
+    readonly key: StringType;
+    /** Toggle label in the SECONDARY toolbar */
+    readonly label: StringType;
+}>;
+/**
+ * Type representing secondary dimension metadata.
+ */
+export type LibraryDimMetaType = typeof LibraryDimMetaType;
+/**
+ * East StructType for the Library component.
+ *
+ * @remarks
+ * A draggable palette of things that get assigned onto grid surfaces
+ * (Roster, Blend): people, assets, vehicles, rooms. Declares the DnD
+ * **source** role under `id`; targets connect by listing that id in their
+ * `sources`. Pure source — it never receives drops, except as the
+ * return-to-palette sink for its connected targets.
+ *
+ * @property id - DnD source identity
+ * @property hint - Optional header-right caption (defaults to the drag hint)
+ * @property items - The resolved cards
+ * @property groupOptions - GROUP BY toolbar options (empty = no grouping toolbar)
+ * @property dimOptions - SECONDARY dimension toggles (empty = no toggle toolbar)
+ * @property defaultDimensions - Initially-visible dimension keys
+ * @property searchable - Whether the search input renders
+ * @property addLabel - Optional footer action label
+ * @property onAdd - Optional footer action callback
+ */
+export declare const LibraryRootType: StructType<{
+    /** DnD source identity */
+    readonly id: StringType;
+    /** Optional header-right caption (defaults to the drag hint) */
+    readonly hint: OptionType<StringType>;
+    /** The resolved cards */
+    readonly items: ArrayType<StructType<{
+        /** Item identity; carried by `LibraryRef` when dragged */
+        readonly key: StringType;
+        /** Primary identity line */
+        readonly label: StringType;
+        /** Optional muted second line (role / class) */
+        readonly sublabel: OptionType<StringType>;
+        /** Optional Font Awesome solid icon name */
+        readonly icon: OptionType<StringType>;
+        /** Optional status pill */
+        readonly status: OptionType<StructType<{
+            /** Pill text (rendered uppercase) */
+            readonly label: StringType;
+            /** Standard status tone */
+            readonly tone: VariantType<{
+                readonly success: NullType;
+                readonly warning: NullType;
+                readonly danger: NullType;
+                readonly info: NullType;
+                readonly neutral: NullType;
+            }>;
+        }>>;
+        /** Whether the card can start a drag */
+        readonly draggable: BooleanType;
+        /** Optional filter text (card dims when unmatched) */
+        readonly search: OptionType<StringType>;
+        /** Group placement per group-by option key */
+        readonly groups: DictType<StringType, StructType<{
+            /** The group this card belongs to under the option */
+            readonly value: StringType;
+            /** Right-aligned group-head summary text */
+            readonly summary: OptionType<StringType>;
+        }>>;
+        /** Secondary dimension value per dimension key */
+        readonly dims: DictType<StringType, VariantType<{
+            /** Utilisation bar with optional right-aligned text */
+            readonly meter: StructType<{
+                /** Current value */
+                readonly value: FloatType;
+                /** Full-scale value */
+                readonly max: FloatType;
+                /** Optional right-aligned text (e.g. `38h`) */
+                readonly text: OptionType<StringType>;
+            }>;
+            /** A row of small chips */
+            readonly chips: ArrayType<StringType>;
+            /** A muted caption line */
+            readonly text: StringType;
+        }>>;
+    }>>;
+    /** GROUP BY toolbar options (empty = no grouping toolbar) */
+    readonly groupOptions: ArrayType<StructType<{
+        /** Option identity (matches each card's `groups` key) */
+        readonly key: StringType;
+        /** Segment label in the GROUP BY toolbar */
+        readonly label: StringType;
+    }>>;
+    /** SECONDARY dimension toggles (empty = no toggle toolbar) */
+    readonly dimOptions: ArrayType<StructType<{
+        /** Dimension identity (matches each card's `dims` key) */
+        readonly key: StringType;
+        /** Toggle label in the SECONDARY toolbar */
+        readonly label: StringType;
+    }>>;
+    /** Initially-visible dimension keys */
+    readonly defaultDimensions: ArrayType<StringType>;
+    /** Whether the search input renders */
+    readonly searchable: BooleanType;
+    /** Optional footer action label */
+    readonly addLabel: OptionType<StringType>;
+    /** Optional footer action callback */
+    readonly onAdd: OptionType<FunctionType<[], NullType>>;
+}>;
+/**
+ * Type representing the Library component.
+ */
+export type LibraryRootType = typeof LibraryRootType;
+//# sourceMappingURL=types.d.ts.map

package/dist/src/collections/library/types.d.ts.map

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