@elaraai/e3-ui 1.0.102 → 1.0.104

package/dist/src/diff/index.d.ts

@@ -1,407 +0,0 @@
-/**
- * Copyright (c) 2025 Elara AI Pty Ltd
- * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
- */
-/**
- * Diff component — transactional review of pending changes for any
- * combination of {@link Data.bind} bindings.
- *
- * @remarks
- * The Diff card surfaces the in-flight change for each binding the caller
- * lists in `bindings`. Per-leaf Discard, per-group Discard-all, and a
- * footer Apply button drive the binding's commit flow. Conflicts surface
- * inline as orange chooser rows (staged-mode 3-way drift) and as orange
- * "stale" warning badges (drift between a patch dataset's expectations
- * and the current source).
- *
- * Declared via the `EastUI.component` extension API — the React renderer
- * lives in `@elaraai/e3-ui-components` and is wired via
- * `implementUIComponent(DiffComponent, EastChakraDiff)` at module load
- * time.
- *
- * @packageDocumentation
- */
-import { StringType, BooleanType, NullType, IntegerType, StructType, OptionType, ArrayType, FunctionType, type ExprType, type SubtypeExprOrValue } from "@elaraai/east";
-import { DensityType, type DensityLiteral, type UIComponentType } from "@elaraai/east-ui";
-import { DiffBindingType } from "../bind/data.js";
-/**
- * Visual style escape hatches for the Diff component. Every visible surface
- * is tokenable; defaults come from the host's Chakra theme (Elara AI brand).
- *
- * @property addedBackground - Soft-tint background for added / inserted leaves.
- * @property addedColor - Foreground for added leaves.
- * @property addedBorderColor - Border for added chips.
- * @property removedBackground - Soft-tint background for removed / deleted leaves.
- * @property removedColor - Foreground for removed leaves.
- * @property removedBorderColor - Border for removed chips.
- * @property changedBackground - Soft-tint background for updated leaves.
- * @property changedColor - Foreground for updated leaves.
- * @property changedBorderColor - Border for updated chips.
- * @property unchangedColor - Foreground for unchanged rows when shown.
- * @property acceptedBackground - Lane background for accepted-row indicator.
- * @property acceptedBorderColor - Left-edge accent stripe for accepted rows.
- * @property rejectedBackground - Lane background for rejected rows.
- * @property rejectedBorderColor - Border for rejected rows.
- * @property headerBackground - Card header background.
- * @property summaryBackground - Stats bar background.
- * @property background - Card body background.
- * @property borderColor - Card outer border.
- * @property indentGuideColor - Vertical guide line for nested rows.
- * @property lineNumberColor - Gutter line numbers in unified mode.
- */
-export declare const DiffStyleType: StructType<{
-    readonly addedBackground: OptionType<StringType>;
-    readonly addedColor: OptionType<StringType>;
-    readonly addedBorderColor: OptionType<StringType>;
-    readonly removedBackground: OptionType<StringType>;
-    readonly removedColor: OptionType<StringType>;
-    readonly removedBorderColor: OptionType<StringType>;
-    readonly changedBackground: OptionType<StringType>;
-    readonly changedColor: OptionType<StringType>;
-    readonly changedBorderColor: OptionType<StringType>;
-    readonly unchangedColor: OptionType<StringType>;
-    readonly acceptedBackground: OptionType<StringType>;
-    readonly acceptedBorderColor: OptionType<StringType>;
-    readonly rejectedBackground: OptionType<StringType>;
-    readonly rejectedBorderColor: OptionType<StringType>;
-    readonly headerBackground: OptionType<StringType>;
-    readonly summaryBackground: OptionType<StringType>;
-    readonly background: OptionType<StringType>;
-    readonly borderColor: OptionType<StringType>;
-    readonly indentGuideColor: OptionType<StringType>;
-    readonly lineNumberColor: OptionType<StringType>;
-}>;
-/** Type alias for {@link DiffStyleType}. */
-export type DiffStyleType = typeof DiffStyleType;
-export { DiffBindingType } from "../bind/data.js";
-/**
- * Schema for the `Diff` extension component. Internal IR shape — the
- * developer-facing factory `Diff.Root` accepts {@link DataBindHandleType}
- * descriptors and forwards them as `bindings`.
- *
- * @property bindings - The set of bindings to surface in the card. Each
- *   entry is a {@link DiffBindingType} value (typically obtained via the
- *   `binding` field of a {@link Data.bind} handle).
- * @property readonly - Render the Diff without per-leaf or per-group Discard
- *   buttons. The footer Apply / Discard-all still render. Default `false`
- *   (interactive review).
- * @property hideUnchanged - Elide unchanged rows. None ⇒ false.
- * @property maxDepth - Cap nesting depth before "Show more" collapses. None ⇒ no cap.
- * @property density - Information-density preset (`comfortable` | `compact`
- *   | `condensed`). Defaults to `comfortable`.
- * @property onCommitted - Fired after a successful commit (post-merge).
- * @property onDiscarded - Fired after a successful discard.
- * @property style - Visual style escape hatches.
- */
-export declare const DiffPayloadType: StructType<{
-    readonly bindings: ArrayType<StructType<{
-        readonly source: ArrayType<import("@elaraai/east").VariantType<{
-            readonly field: StringType;
-        }>>;
-        readonly patch: OptionType<ArrayType<import("@elaraai/east").VariantType<{
-            readonly field: StringType;
-        }>>>;
-        readonly mode: import("@elaraai/east").VariantType<{
-            readonly staged: NullType;
-            readonly direct: NullType;
-        }>;
-    }>>;
-    readonly readonly: OptionType<BooleanType>;
-    readonly hideUnchanged: OptionType<BooleanType>;
-    readonly maxDepth: OptionType<IntegerType>;
-    readonly density: OptionType<import("@elaraai/east").VariantType<{
-        readonly comfortable: NullType;
-        readonly compact: NullType;
-        readonly condensed: NullType;
-    }>>;
-    readonly onCommitted: OptionType<FunctionType<[], NullType>>;
-    readonly onDiscarded: OptionType<FunctionType<[], NullType>>;
-    readonly style: OptionType<StructType<{
-        readonly addedBackground: OptionType<StringType>;
-        readonly addedColor: OptionType<StringType>;
-        readonly addedBorderColor: OptionType<StringType>;
-        readonly removedBackground: OptionType<StringType>;
-        readonly removedColor: OptionType<StringType>;
-        readonly removedBorderColor: OptionType<StringType>;
-        readonly changedBackground: OptionType<StringType>;
-        readonly changedColor: OptionType<StringType>;
-        readonly changedBorderColor: OptionType<StringType>;
-        readonly unchangedColor: OptionType<StringType>;
-        readonly acceptedBackground: OptionType<StringType>;
-        readonly acceptedBorderColor: OptionType<StringType>;
-        readonly rejectedBackground: OptionType<StringType>;
-        readonly rejectedBorderColor: OptionType<StringType>;
-        readonly headerBackground: OptionType<StringType>;
-        readonly summaryBackground: OptionType<StringType>;
-        readonly background: OptionType<StringType>;
-        readonly borderColor: OptionType<StringType>;
-        readonly indentGuideColor: OptionType<StringType>;
-        readonly lineNumberColor: OptionType<StringType>;
-    }>>;
-}>;
-/** Type alias for {@link DiffPayloadType}. */
-export type DiffPayloadType = typeof DiffPayloadType;
-/**
- * Internal `EastUI.component` carrier. Renderers register against this in
- * `@elaraai/e3-ui-components`. Most callers should use {@link Diff.Root}
- * (which wraps this with the handle-friendly API) rather than touching
- * `DiffComponent` directly.
- */
-export declare const DiffComponent: import("@elaraai/east-ui").UIComponentDef<StructType<{
-    readonly bindings: ArrayType<StructType<{
-        readonly source: ArrayType<import("@elaraai/east").VariantType<{
-            readonly field: StringType;
-        }>>;
-        readonly patch: OptionType<ArrayType<import("@elaraai/east").VariantType<{
-            readonly field: StringType;
-        }>>>;
-        readonly mode: import("@elaraai/east").VariantType<{
-            readonly staged: NullType;
-            readonly direct: NullType;
-        }>;
-    }>>;
-    readonly readonly: OptionType<BooleanType>;
-    readonly hideUnchanged: OptionType<BooleanType>;
-    readonly maxDepth: OptionType<IntegerType>;
-    readonly density: OptionType<import("@elaraai/east").VariantType<{
-        readonly comfortable: NullType;
-        readonly compact: NullType;
-        readonly condensed: NullType;
-    }>>;
-    readonly onCommitted: OptionType<FunctionType<[], NullType>>;
-    readonly onDiscarded: OptionType<FunctionType<[], NullType>>;
-    readonly style: OptionType<StructType<{
-        readonly addedBackground: OptionType<StringType>;
-        readonly addedColor: OptionType<StringType>;
-        readonly addedBorderColor: OptionType<StringType>;
-        readonly removedBackground: OptionType<StringType>;
-        readonly removedColor: OptionType<StringType>;
-        readonly removedBorderColor: OptionType<StringType>;
-        readonly changedBackground: OptionType<StringType>;
-        readonly changedColor: OptionType<StringType>;
-        readonly changedBorderColor: OptionType<StringType>;
-        readonly unchangedColor: OptionType<StringType>;
-        readonly acceptedBackground: OptionType<StringType>;
-        readonly acceptedBorderColor: OptionType<StringType>;
-        readonly rejectedBackground: OptionType<StringType>;
-        readonly rejectedBorderColor: OptionType<StringType>;
-        readonly headerBackground: OptionType<StringType>;
-        readonly summaryBackground: OptionType<StringType>;
-        readonly background: OptionType<StringType>;
-        readonly borderColor: OptionType<StringType>;
-        readonly indentGuideColor: OptionType<StringType>;
-        readonly lineNumberColor: OptionType<StringType>;
-    }>>;
-}>>;
-/**
- * Options for {@link Diff.Root}.
- *
- * @property bindings - The set of bindings to surface. Pass `view.binding`
- *   from each {@link Data.bind} handle, or hand-build descriptors of shape
- *   {@link DiffBindingType}.
- * @property readonly - Render without per-leaf / per-group Discard buttons.
- *   The footer Apply / Discard-all still render. Defaults to false.
- * @property hideUnchanged - Elide unchanged rows. Defaults to false.
- * @property maxDepth - Cap nesting depth. Defaults to no cap.
- * @property density - Information-density preset (`comfortable` | `compact`
- *   | `condensed`). Defaults to `comfortable`.
- * @property onCommitted - Fired after the user commits.
- * @property onDiscarded - Fired after the user discards.
- * @property style - Visual style escape hatches.
- */
-export interface DiffOptions {
-    /** Bindings to surface. Typically `[view.binding, ...]`. */
-    bindings: SubtypeExprOrValue<ArrayType<DiffBindingType>>;
-    /** Render without per-leaf / per-group Discard buttons. Defaults to false (interactive). */
-    readonly?: SubtypeExprOrValue<OptionType<BooleanType>>;
-    /** Elide unchanged rows. Defaults to false. */
-    hideUnchanged?: SubtypeExprOrValue<OptionType<BooleanType>>;
-    /** Cap nesting depth before "Show more" collapses. Defaults to no cap. */
-    maxDepth?: SubtypeExprOrValue<OptionType<IntegerType>>;
-    /** Information-density preset. */
-    density?: SubtypeExprOrValue<OptionType<DensityType>> | DensityLiteral;
-    /** Fired after a successful commit (post-merge). */
-    onCommitted?: SubtypeExprOrValue<OptionType<FunctionType<[], NullType>>>;
-    /** Fired after a successful discard. */
-    onDiscarded?: SubtypeExprOrValue<OptionType<FunctionType<[], NullType>>>;
-    /** Visual style escape hatches — see {@link DiffStyleType}. */
-    style?: SubtypeExprOrValue<OptionType<DiffStyleType>>;
-}
-/**
- * The Diff component namespace. Surfaces transactional pending edits for
- * review and commit, with merge-aware conflict resolution and stale-patch
- * drift detection.
- *
- * @remarks
- * Use `Diff.Root({ bindings: [view.binding, ...] })` to render the panel.
- * The `Component` property is the internal {@link EastUI.component}
- * carrier that renderers register against — most callers shouldn't need
- * it.
- */
-export declare const Diff: {
-    /**
-     * Build a Diff component. Surfaces every binding's in-flight change in
-     * a single review card, with per-leaf accept / reject and a footer
-     * Apply that runs the right commit per binding.
-     *
-     * @param options - {@link DiffOptions}. Only `bindings` is required;
-     *   the rest default to absent / interactive.
-     * @returns An East expression of {@link UIComponentType} representing
-     *   the Diff panel.
-     *
-     * @remarks
-     * The renderer reads each binding's IR descriptor (`source`, optional
-     * `patch`, `mode`), looks up the runtime types in the binding
-     * registry, and derives the in-flight change to display. Apply's
-     * commit code path depends on the binding's mode and patch presence —
-     * staged + no patch applies the buffer to source; staged + patch
-     * publishes the buffer as a fresh patch to the patch dataset; direct
-     * + patch applies the existing patch dataset to the source. Discard
-     * always drops the in-flight change in place.
-     *
-     * @example
-     * ```ts
-     * import { East, FloatType, variant } from "@elaraai/east";
-     * import { Reactive, UIComponentType } from "@elaraai/east-ui";
-     * import { Data, Diff } from "@elaraai/e3-ui";
-     * import * as e3 from "@elaraai/e3";
-     *
-     * const maxWeeklyHoursInput = e3.input("max_weekly_hours", FloatType, variant("value", 38.0));
-     *
-     * // Mirrors `diffDefaults` in test/diff.examples.ts (wired via Assert.examples).
-     * const diffDefaults = East.function([], UIComponentType, _$ => {
-     *     return Reactive.Root(East.function([], UIComponentType, $ => {
-     *         const view = $.let(Data.bind(maxWeeklyHoursInput, { mode: "staged" }));
-     *         return Diff.Root({ bindings: [view.binding] });
-     *     }));
-     * });
-     * ```
-     */
-    readonly Root: (options: DiffOptions) => ExprType<UIComponentType>;
-    /**
-     * The internal {@link EastUI.component} carrier. Renderers register
-     * against this in `@elaraai/e3-ui-components` via
-     * `implementUIComponent(Diff.Component, EastChakraDiff)`. Most callers
-     * should use {@link Diff.Root} (the handle-friendly factory) and never
-     * touch this directly.
-     */
-    readonly Component: import("@elaraai/east-ui").UIComponentDef<StructType<{
-        readonly bindings: ArrayType<StructType<{
-            readonly source: ArrayType<import("@elaraai/east").VariantType<{
-                readonly field: StringType;
-            }>>;
-            readonly patch: OptionType<ArrayType<import("@elaraai/east").VariantType<{
-                readonly field: StringType;
-            }>>>;
-            readonly mode: import("@elaraai/east").VariantType<{
-                readonly staged: NullType;
-                readonly direct: NullType;
-            }>;
-        }>>;
-        readonly readonly: OptionType<BooleanType>;
-        readonly hideUnchanged: OptionType<BooleanType>;
-        readonly maxDepth: OptionType<IntegerType>;
-        readonly density: OptionType<import("@elaraai/east").VariantType<{
-            readonly comfortable: NullType;
-            readonly compact: NullType;
-            readonly condensed: NullType;
-        }>>;
-        readonly onCommitted: OptionType<FunctionType<[], NullType>>;
-        readonly onDiscarded: OptionType<FunctionType<[], NullType>>;
-        readonly style: OptionType<StructType<{
-            readonly addedBackground: OptionType<StringType>;
-            readonly addedColor: OptionType<StringType>;
-            readonly addedBorderColor: OptionType<StringType>;
-            readonly removedBackground: OptionType<StringType>;
-            readonly removedColor: OptionType<StringType>;
-            readonly removedBorderColor: OptionType<StringType>;
-            readonly changedBackground: OptionType<StringType>;
-            readonly changedColor: OptionType<StringType>;
-            readonly changedBorderColor: OptionType<StringType>;
-            readonly unchangedColor: OptionType<StringType>;
-            readonly acceptedBackground: OptionType<StringType>;
-            readonly acceptedBorderColor: OptionType<StringType>;
-            readonly rejectedBackground: OptionType<StringType>;
-            readonly rejectedBorderColor: OptionType<StringType>;
-            readonly headerBackground: OptionType<StringType>;
-            readonly summaryBackground: OptionType<StringType>;
-            readonly background: OptionType<StringType>;
-            readonly borderColor: OptionType<StringType>;
-            readonly indentGuideColor: OptionType<StringType>;
-            readonly lineNumberColor: OptionType<StringType>;
-        }>>;
-    }>>;
-    readonly Types: {
-        /** Rendered Diff payload struct (bindings + style). */
-        readonly Payload: StructType<{
-            readonly bindings: ArrayType<StructType<{
-                readonly source: ArrayType<import("@elaraai/east").VariantType<{
-                    readonly field: StringType;
-                }>>;
-                readonly patch: OptionType<ArrayType<import("@elaraai/east").VariantType<{
-                    readonly field: StringType;
-                }>>>;
-                readonly mode: import("@elaraai/east").VariantType<{
-                    readonly staged: NullType;
-                    readonly direct: NullType;
-                }>;
-            }>>;
-            readonly readonly: OptionType<BooleanType>;
-            readonly hideUnchanged: OptionType<BooleanType>;
-            readonly maxDepth: OptionType<IntegerType>;
-            readonly density: OptionType<import("@elaraai/east").VariantType<{
-                readonly comfortable: NullType;
-                readonly compact: NullType;
-                readonly condensed: NullType;
-            }>>;
-            readonly onCommitted: OptionType<FunctionType<[], NullType>>;
-            readonly onDiscarded: OptionType<FunctionType<[], NullType>>;
-            readonly style: OptionType<StructType<{
-                readonly addedBackground: OptionType<StringType>;
-                readonly addedColor: OptionType<StringType>;
-                readonly addedBorderColor: OptionType<StringType>;
-                readonly removedBackground: OptionType<StringType>;
-                readonly removedColor: OptionType<StringType>;
-                readonly removedBorderColor: OptionType<StringType>;
-                readonly changedBackground: OptionType<StringType>;
-                readonly changedColor: OptionType<StringType>;
-                readonly changedBorderColor: OptionType<StringType>;
-                readonly unchangedColor: OptionType<StringType>;
-                readonly acceptedBackground: OptionType<StringType>;
-                readonly acceptedBorderColor: OptionType<StringType>;
-                readonly rejectedBackground: OptionType<StringType>;
-                readonly rejectedBorderColor: OptionType<StringType>;
-                readonly headerBackground: OptionType<StringType>;
-                readonly summaryBackground: OptionType<StringType>;
-                readonly background: OptionType<StringType>;
-                readonly borderColor: OptionType<StringType>;
-                readonly indentGuideColor: OptionType<StringType>;
-                readonly lineNumberColor: OptionType<StringType>;
-            }>>;
-        }>;
-        /** Visual-presentation sub-struct (density, layout). */
-        readonly Style: StructType<{
-            readonly addedBackground: OptionType<StringType>;
-            readonly addedColor: OptionType<StringType>;
-            readonly addedBorderColor: OptionType<StringType>;
-            readonly removedBackground: OptionType<StringType>;
-            readonly removedColor: OptionType<StringType>;
-            readonly removedBorderColor: OptionType<StringType>;
-            readonly changedBackground: OptionType<StringType>;
-            readonly changedColor: OptionType<StringType>;
-            readonly changedBorderColor: OptionType<StringType>;
-            readonly unchangedColor: OptionType<StringType>;
-            readonly acceptedBackground: OptionType<StringType>;
-            readonly acceptedBorderColor: OptionType<StringType>;
-            readonly rejectedBackground: OptionType<StringType>;
-            readonly rejectedBorderColor: OptionType<StringType>;
-            readonly headerBackground: OptionType<StringType>;
-            readonly summaryBackground: OptionType<StringType>;
-            readonly background: OptionType<StringType>;
-            readonly borderColor: OptionType<StringType>;
-            readonly indentGuideColor: OptionType<StringType>;
-            readonly lineNumberColor: OptionType<StringType>;
-        }>;
-    };
-};
-//# sourceMappingURL=index.d.ts.map

package/dist/src/diff/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/diff/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAEH,UAAU,EACV,WAAW,EACX,QAAQ,EACR,WAAW,EACX,UAAU,EACV,UAAU,EACV,SAAS,EACT,YAAY,EAIZ,KAAK,QAAQ,EACb,KAAK,kBAAkB,EAC1B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAU,WAAW,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAElG,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAMlD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;EAqBxB,CAAC;AACH,4CAA4C;AAC5C,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC;AAOjD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAMlD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS1B,CAAC;AACH,8CAA8C;AAC9C,MAAM,MAAM,eAAe,GAAG,OAAO,eAAe,CAAC;AAErD;;;;;GAKG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAAgE,CAAC;AAM3F;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,WAAW;IACxB,4DAA4D;IAC5D,QAAQ,EAAE,kBAAkB,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC,CAAC;IACzD,4FAA4F;IAC5F,QAAQ,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;IACvD,+CAA+C;IAC/C,aAAa,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;IAC5D,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;IACvD,kCAAkC;IAClC,OAAO,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,GAAG,cAAc,CAAC;IACvE,oDAAoD;IACpD,WAAW,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACzE,wCAAwC;IACxC,WAAW,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACzE,+DAA+D;IAC/D,KAAK,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC;CACzD;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,IAAI;IACb;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;6BACW,WAAW,KAAG,QAAQ,CAAC,eAAe,CAAC;IAiBrD;;;;;;OAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAGC,uDAAuD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAEvD,wDAAwD;;;;;;;;;;;;;;;;;;;;;;;;CAGtD,CAAC"}

package/dist/src/diff/index.js

@@ -1,203 +0,0 @@
-/**
- * Copyright (c) 2025 Elara AI Pty Ltd
- * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
- */
-/**
- * Diff component — transactional review of pending changes for any
- * combination of {@link Data.bind} bindings.
- *
- * @remarks
- * The Diff card surfaces the in-flight change for each binding the caller
- * lists in `bindings`. Per-leaf Discard, per-group Discard-all, and a
- * footer Apply button drive the binding's commit flow. Conflicts surface
- * inline as orange chooser rows (staged-mode 3-way drift) and as orange
- * "stale" warning badges (drift between a patch dataset's expectations
- * and the current source).
- *
- * Declared via the `EastUI.component` extension API — the React renderer
- * lives in `@elaraai/e3-ui-components` and is wired via
- * `implementUIComponent(DiffComponent, EastChakraDiff)` at module load
- * time.
- *
- * @packageDocumentation
- */
-import { East, StringType, BooleanType, NullType, IntegerType, StructType, OptionType, ArrayType, FunctionType, none, some, variant, } from "@elaraai/east";
-import { EastUI, DensityType } from "@elaraai/east-ui";
-import { DiffBindingType } from "../bind/data.js";
-// ============================================================================
-// Sub-types — visual style escape hatches.
-// ============================================================================
-/**
- * Visual style escape hatches for the Diff component. Every visible surface
- * is tokenable; defaults come from the host's Chakra theme (Elara AI brand).
- *
- * @property addedBackground - Soft-tint background for added / inserted leaves.
- * @property addedColor - Foreground for added leaves.
- * @property addedBorderColor - Border for added chips.
- * @property removedBackground - Soft-tint background for removed / deleted leaves.
- * @property removedColor - Foreground for removed leaves.
- * @property removedBorderColor - Border for removed chips.
- * @property changedBackground - Soft-tint background for updated leaves.
- * @property changedColor - Foreground for updated leaves.
- * @property changedBorderColor - Border for updated chips.
- * @property unchangedColor - Foreground for unchanged rows when shown.
- * @property acceptedBackground - Lane background for accepted-row indicator.
- * @property acceptedBorderColor - Left-edge accent stripe for accepted rows.
- * @property rejectedBackground - Lane background for rejected rows.
- * @property rejectedBorderColor - Border for rejected rows.
- * @property headerBackground - Card header background.
- * @property summaryBackground - Stats bar background.
- * @property background - Card body background.
- * @property borderColor - Card outer border.
- * @property indentGuideColor - Vertical guide line for nested rows.
- * @property lineNumberColor - Gutter line numbers in unified mode.
- */
-export const DiffStyleType = StructType({
-    addedBackground: OptionType(StringType),
-    addedColor: OptionType(StringType),
-    addedBorderColor: OptionType(StringType),
-    removedBackground: OptionType(StringType),
-    removedColor: OptionType(StringType),
-    removedBorderColor: OptionType(StringType),
-    changedBackground: OptionType(StringType),
-    changedColor: OptionType(StringType),
-    changedBorderColor: OptionType(StringType),
-    unchangedColor: OptionType(StringType),
-    acceptedBackground: OptionType(StringType),
-    acceptedBorderColor: OptionType(StringType),
-    rejectedBackground: OptionType(StringType),
-    rejectedBorderColor: OptionType(StringType),
-    headerBackground: OptionType(StringType),
-    summaryBackground: OptionType(StringType),
-    background: OptionType(StringType),
-    borderColor: OptionType(StringType),
-    indentGuideColor: OptionType(StringType),
-    lineNumberColor: OptionType(StringType),
-});
-// ============================================================================
-// Re-export the binding descriptor — it lives in `data.ts` to keep the
-// dependency direction one-way (Diff consumes; Data produces).
-// ============================================================================
-export { DiffBindingType } from "../bind/data.js";
-// ============================================================================
-// Diff payload — IR shape consumed by the renderer.
-// ============================================================================
-/**
- * Schema for the `Diff` extension component. Internal IR shape — the
- * developer-facing factory `Diff.Root` accepts {@link DataBindHandleType}
- * descriptors and forwards them as `bindings`.
- *
- * @property bindings - The set of bindings to surface in the card. Each
- *   entry is a {@link DiffBindingType} value (typically obtained via the
- *   `binding` field of a {@link Data.bind} handle).
- * @property readonly - Render the Diff without per-leaf or per-group Discard
- *   buttons. The footer Apply / Discard-all still render. Default `false`
- *   (interactive review).
- * @property hideUnchanged - Elide unchanged rows. None ⇒ false.
- * @property maxDepth - Cap nesting depth before "Show more" collapses. None ⇒ no cap.
- * @property density - Information-density preset (`comfortable` | `compact`
- *   | `condensed`). Defaults to `comfortable`.
- * @property onCommitted - Fired after a successful commit (post-merge).
- * @property onDiscarded - Fired after a successful discard.
- * @property style - Visual style escape hatches.
- */
-export const DiffPayloadType = StructType({
-    bindings: ArrayType(DiffBindingType),
-    readonly: OptionType(BooleanType),
-    hideUnchanged: OptionType(BooleanType),
-    maxDepth: OptionType(IntegerType),
-    density: OptionType(DensityType),
-    onCommitted: OptionType(FunctionType([], NullType)),
-    onDiscarded: OptionType(FunctionType([], NullType)),
-    style: OptionType(DiffStyleType),
-});
-/**
- * Internal `EastUI.component` carrier. Renderers register against this in
- * `@elaraai/e3-ui-components`. Most callers should use {@link Diff.Root}
- * (which wraps this with the handle-friendly API) rather than touching
- * `DiffComponent` directly.
- */
-export const DiffComponent = EastUI.component("Diff", DiffPayloadType, { optional: true });
-/**
- * The Diff component namespace. Surfaces transactional pending edits for
- * review and commit, with merge-aware conflict resolution and stale-patch
- * drift detection.
- *
- * @remarks
- * Use `Diff.Root({ bindings: [view.binding, ...] })` to render the panel.
- * The `Component` property is the internal {@link EastUI.component}
- * carrier that renderers register against — most callers shouldn't need
- * it.
- */
-export const Diff = {
-    /**
-     * Build a Diff component. Surfaces every binding's in-flight change in
-     * a single review card, with per-leaf accept / reject and a footer
-     * Apply that runs the right commit per binding.
-     *
-     * @param options - {@link DiffOptions}. Only `bindings` is required;
-     *   the rest default to absent / interactive.
-     * @returns An East expression of {@link UIComponentType} representing
-     *   the Diff panel.
-     *
-     * @remarks
-     * The renderer reads each binding's IR descriptor (`source`, optional
-     * `patch`, `mode`), looks up the runtime types in the binding
-     * registry, and derives the in-flight change to display. Apply's
-     * commit code path depends on the binding's mode and patch presence —
-     * staged + no patch applies the buffer to source; staged + patch
-     * publishes the buffer as a fresh patch to the patch dataset; direct
-     * + patch applies the existing patch dataset to the source. Discard
-     * always drops the in-flight change in place.
-     *
-     * @example
-     * ```ts
-     * import { East, FloatType, variant } from "@elaraai/east";
-     * import { Reactive, UIComponentType } from "@elaraai/east-ui";
-     * import { Data, Diff } from "@elaraai/e3-ui";
-     * import * as e3 from "@elaraai/e3";
-     *
-     * const maxWeeklyHoursInput = e3.input("max_weekly_hours", FloatType, variant("value", 38.0));
-     *
-     * // Mirrors `diffDefaults` in test/diff.examples.ts (wired via Assert.examples).
-     * const diffDefaults = East.function([], UIComponentType, _$ => {
-     *     return Reactive.Root(East.function([], UIComponentType, $ => {
-     *         const view = $.let(Data.bind(maxWeeklyHoursInput, { mode: "staged" }));
-     *         return Diff.Root({ bindings: [view.binding] });
-     *     }));
-     * });
-     * ```
-     */
-    Root(options) {
-        const density = options.density === undefined
-            ? none
-            : typeof options.density === "string"
-                ? some(East.value(variant(options.density, null), DensityType))
-                : options.density;
-        return DiffComponent.Root({
-            bindings: options.bindings,
-            readonly: options.readonly ?? none,
-            hideUnchanged: options.hideUnchanged ?? none,
-            maxDepth: options.maxDepth ?? none,
-            density,
-            onCommitted: options.onCommitted ?? none,
-            onDiscarded: options.onDiscarded ?? none,
-            style: options.style ?? none,
-        });
-    },
-    /**
-     * The internal {@link EastUI.component} carrier. Renderers register
-     * against this in `@elaraai/e3-ui-components` via
-     * `implementUIComponent(Diff.Component, EastChakraDiff)`. Most callers
-     * should use {@link Diff.Root} (the handle-friendly factory) and never
-     * touch this directly.
-     */
-    Component: DiffComponent,
-    Types: {
-        /** Rendered Diff payload struct (bindings + style). */
-        Payload: DiffPayloadType,
-        /** Visual-presentation sub-struct (density, layout). */
-        Style: DiffStyleType,
-    },
-};
-//# sourceMappingURL=index.js.map

package/dist/src/diff/index.js.map

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