@octaviaflow/core 3.1.0-beta.86 → 3.1.0-beta.88

package/dist/components/Combobox/Combobox.d.ts

@@ -35,6 +35,19 @@ export interface ComboboxProps {
     emptyMessage?: ReactNode;
     /** Override the default substring match. Receives the option and typed query. */
     filter?: (option: ComboboxOption, query: string) => boolean;
+    /**
+     * Render a value that exactly matches a known option as a token showing the
+     * option's LABEL, with a clear button, instead of the raw value text.
+     *
+     * For fields whose values are opaque machine strings — dynamic tokens,
+     * URNs, ids — the raw form overflows the input and the user reads a clipped
+     * fragment with no signal that the value is bound rather than typed.
+     *
+     * Off by default: every existing consumer keeps the plain editable input.
+     * Free-typing is unaffected — anything that is not an exact option match
+     * still renders as ordinary text.
+     */
+    tokenizeKnownValue?: boolean;
     id?: string;
     name?: string;
     required?: boolean;
@@ -51,7 +64,7 @@ export interface ComboboxProps {
  * Free-type-OR-pick is the core behaviour — use it wherever a field accepts
  * both known values and arbitrary input (dynamic tokens, custom identifiers).
  */
-export declare function Combobox({ value, onChange, options, placeholder, ariaLabel, label, helperText, size, disabled, loading, error, errorMessage, creatable, emptyMessage, filter, id, name, required, className, onBlur, }: ComboboxProps): import("react/jsx-runtime").JSX.Element;
+export declare function Combobox({ value, onChange, options, placeholder, ariaLabel, label, helperText, size, disabled, loading, error, errorMessage, creatable, emptyMessage, filter, tokenizeKnownValue, id, name, required, className, onBlur, }: ComboboxProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace Combobox {
     var displayName: string;
 }

package/dist/components/Combobox/Combobox.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Combobox.d.ts","sourceRoot":"","sources":["../../../src/components/Combobox/Combobox.tsx"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,SAAS,EAQf,MAAM,OAAO,CAAC;AAIf,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gFAAgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,iFAAiF;IACjF,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAC5D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AASD;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,QAAQ,EACR,OAAO,EACP,WAA+B,EAC/B,SAAS,EACT,KAAK,EACL,UAAU,EACV,IAAW,EACX,QAAgB,EAChB,OAAe,EACf,KAAa,EACb,YAAY,EACZ,SAAiB,EACjB,YAAoC,EACpC,MAAsB,EACtB,EAAE,EACF,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,MAAM,GACP,EAAE,aAAa,2CAiRf;yBAtSe,QAAQ"}
+{"version":3,"file":"Combobox.d.ts","sourceRoot":"","sources":["../../../src/components/Combobox/Combobox.tsx"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,SAAS,EAQf,MAAM,OAAO,CAAC;AAIf,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uDAAuD;IACvD,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gFAAgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0DAA0D;IAC1D,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,iFAAiF;IACjF,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAC5D;;;;;;;;;;;OAWG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AASD;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,QAAQ,EACR,OAAO,EACP,WAA+B,EAC/B,SAAS,EACT,KAAK,EACL,UAAU,EACV,IAAW,EACX,QAAgB,EAChB,OAAe,EACf,KAAa,EACb,YAAY,EACZ,SAAiB,EACjB,YAAoC,EACpC,MAAsB,EACtB,kBAA0B,EAC1B,EAAE,EACF,IAAI,EACJ,QAAQ,EACR,SAAS,EACT,MAAM,GACP,EAAE,aAAa,2CA0Tf;yBAhVe,QAAQ"}

package/dist/components/ConditionBuilder/ConditionBuilder.d.ts

@@ -41,6 +41,14 @@ export interface ConditionBuilderProps extends Omit<ComponentPropsWithoutRef<"di
      *  clicking one fills the input, and the user can still type any value not in
      *  the list. Omit / return [] to keep a plain text input. */
     getValueOptions?: (condition: Condition, index: number) => ConditionValueOption[];
+    /** Show a value that exactly matches one of `getValueOptions` as a token
+     *  displaying the option's LABEL, instead of its raw value text.
+     *
+     *  For option values that are opaque machine strings — dynamic tokens,
+     *  URNs — the raw form overflows the field and the user reads a clipped
+     *  fragment ("session/lastSuccessRun}}") with no signal that the value is
+     *  bound rather than typed. Off by default; free-typing is unaffected. */
+    tokenizeValueOptions?: boolean;
     /** Auto-enables search above 8 options. Force on/off via boolean. */
     searchable?: boolean;
     allowGroups?: boolean;

package/dist/components/ConditionBuilder/ConditionBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConditionBuilder.d.ts","sourceRoot":"","sources":["../../../src/components/ConditionBuilder/ConditionBuilder.tsx"],"names":[],"mappings":"AAQA,OAAO,EACL,KAAK,wBAAwB,EAG7B,KAAK,SAAS,EAQf,MAAM,OAAO,CAAC;AAKf,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd;;4DAEwD;IACxD,YAAY,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,KAAK,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,CAAC,SAAS,GAAG,cAAc,CAAC,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,qBACf,SAAQ,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IACzD,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,QAAQ,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,KAAK,IAAI,CAAC;IAC5C,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B;;;;iEAI6D;IAC7D,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,KAAK,oBAAoB,EAAE,CAAC;IAClF,qEAAqE;IACrE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAChC;4EACwE;IACxE,YAAY,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IAC5B;yEACqE;IACrE,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,CAAC;IAC5C,mDAAmD;IACnD,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;mEAI+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AA0OD,eAAO,MAAM,gBAAgB,kHA6N3B,CAAC"}
+{"version":3,"file":"ConditionBuilder.d.ts","sourceRoot":"","sources":["../../../src/components/ConditionBuilder/ConditionBuilder.tsx"],"names":[],"mappings":"AAQA,OAAO,EACL,KAAK,wBAAwB,EAG7B,KAAK,SAAS,EAQf,MAAM,OAAO,CAAC;AAKf,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd;;4DAEwD;IACxD,YAAY,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,KAAK,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,CAAC,SAAS,GAAG,cAAc,CAAC,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,qBACf,SAAQ,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IACzD,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,QAAQ,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,KAAK,IAAI,CAAC;IAC5C,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B;;;;iEAI6D;IAC7D,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,KAAK,oBAAoB,EAAE,CAAC;IAClF;;;;;;8EAM0E;IAC1E,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,qEAAqE;IACrE,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAChC;4EACwE;IACxE,YAAY,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IAC5B;yEACqE;IACrE,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,CAAC;IAC5C,mDAAmD;IACnD,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;mEAI+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AA0OD,eAAO,MAAM,gBAAgB,kHA+N3B,CAAC"}

package/dist/components/Popover/Popover.d.ts

@@ -1,9 +1,25 @@
 import { type ReactNode } from "react";
 export type PopoverPlacement = "top" | "bottom" | "left" | "right";
+/**
+ * Where the popover sits along the trigger's cross axis. `center` is the
+ * classic tooltip-style placement; `start` / `end` line the popover's leading
+ * or trailing edge up with the trigger's — what an anchored panel opened from
+ * a top-right control (a bell, an avatar menu) needs so it grows inward
+ * rather than off the viewport.
+ */
+export type PopoverAlign = "start" | "center" | "end";
 export interface PopoverProps {
     content: ReactNode;
     placement?: PopoverPlacement;
+    /** Cross-axis alignment against the trigger. Default `center`. */
+    align?: PopoverAlign;
     offset?: number;
+    /**
+     * Minimum distance kept from the viewport edges. The popover is shifted
+     * (and flipped to the opposite side when it would not fit) so it stays on
+     * screen; the arrow keeps pointing at the trigger. Default 8.
+     */
+    viewportPadding?: number;
     open?: boolean;
     defaultOpen?: boolean;
     onOpenChange?: (open: boolean) => void;
@@ -18,5 +34,36 @@ export interface PopoverProps {
     children: ReactNode;
     className?: string;
 }
-export declare function Popover({ content, placement, offset, open: openProp, defaultOpen, onOpenChange, trigger, closeOnClickOutside, closeOnEsc, arrow, "aria-label": ariaLabel, children, className, }: PopoverProps): import("react/jsx-runtime").JSX.Element;
+export interface PopoverCoords {
+    top: number;
+    left: number;
+    /** The side the popover actually opened on, after any flip. */
+    placement: PopoverPlacement;
+    /** Arrow offset along the popover's cross axis, in px from its top-left. */
+    arrow: number;
+}
+interface RectLike {
+    top: number;
+    left: number;
+    right: number;
+    bottom: number;
+    width: number;
+    height: number;
+}
+/**
+ * Pure placement maths, exported for tests.
+ *
+ * Steps: place on the requested side · align along the cross axis · flip to
+ * the opposite side when the preferred one cannot fit but the other can ·
+ * clamp inside the viewport · point the arrow back at the trigger's centre.
+ */
+export declare function computePopoverPosition(rect: RectLike, popRect: {
+    width: number;
+    height: number;
+}, placement: PopoverPlacement, offset: number, align?: PopoverAlign, viewport?: {
+    width: number;
+    height: number;
+}, pad?: number): PopoverCoords;
+export declare function Popover({ content, placement, align, offset, viewportPadding, open: openProp, defaultOpen, onOpenChange, trigger, closeOnClickOutside, closeOnEsc, arrow, "aria-label": ariaLabel, children, className, }: PopoverProps): import("react/jsx-runtime").JSX.Element;
+export {};
 //# sourceMappingURL=Popover.d.ts.map

package/dist/components/Popover/Popover.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Popover.d.ts","sourceRoot":"","sources":["../../../src/components/Popover/Popover.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAA6D,MAAM,OAAO,CAAC;AAIlG,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAEnE,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,SAAS,CAAC;IACnB,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC7B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;sDAEkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA2BD,wBAAgB,OAAO,CAAC,EACtB,OAAO,EACP,SAAoB,EACpB,MAAU,EACV,IAAI,EAAE,QAAQ,EACd,WAAmB,EACnB,YAAY,EACZ,OAAiB,EACjB,mBAA0B,EAC1B,UAAiB,EACjB,KAAY,EACZ,YAAY,EAAE,SAAqB,EACnC,QAAQ,EACR,SAAS,GACV,EAAE,YAAY,2CA2Gd"}
+{"version":3,"file":"Popover.d.ts","sourceRoot":"","sources":["../../../src/components/Popover/Popover.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAA6D,MAAM,OAAO,CAAC;AAIlG,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,SAAS,CAAC;IACnB,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B,kEAAkE;IAClE,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC7B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;sDAEkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,SAAS,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,SAAS,EAAE,gBAAgB,CAAC;IAC5B,4EAA4E;IAC5E,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,QAAQ;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAQD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,QAAQ,EACd,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC1C,SAAS,EAAE,gBAAgB,EAC3B,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,YAAuB,EAC9B,QAAQ,GAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAGxC,EACD,GAAG,SAAI,GACN,aAAa,CAoDf;AAED,wBAAgB,OAAO,CAAC,EACtB,OAAO,EACP,SAAoB,EACpB,KAAgB,EAChB,MAAU,EACV,eAAmB,EACnB,IAAI,EAAE,QAAQ,EACd,WAAmB,EACnB,YAAY,EACZ,OAAiB,EACjB,mBAA0B,EAC1B,UAAiB,EACjB,KAAY,EACZ,YAAY,EAAE,SAAqB,EACnC,QAAQ,EACR,SAAS,GACV,EAAE,YAAY,2CAqId"}

package/dist/components/Popover/index.d.ts

@@ -1,2 +1,2 @@
-export { Popover, type PopoverPlacement, type PopoverProps } from "./Popover";
+export { computePopoverPosition, Popover, type PopoverAlign, type PopoverCoords, type PopoverPlacement, type PopoverProps, } from "./Popover";
 //# sourceMappingURL=index.d.ts.map

package/dist/components/Popover/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Popover/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Popover/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,OAAO,EACP,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,YAAY,GAClB,MAAM,WAAW,CAAC"}

package/dist/components/ScheduleBuilder/ScheduleBuilder.d.ts

@@ -0,0 +1,90 @@
+import { type ReactNode } from "react";
+import { type TimeValue } from "../TimePicker";
+import "./ScheduleBuilder.module.scss";
+export type ScheduleFrequency = "immediate" | "hourly" | "daily" | "weekly" | "monthly";
+/**
+ * A normalised recurrence.
+ *
+ * `timezone` is an IANA zone name, never an offset. An offset breaks twice a
+ * year for any DST zone, silently, and the symptom — "the digest arrives an
+ * hour late in summer" — is hard to trace back to the stored value.
+ *
+ * `time`, `weekdays` and `dayOfMonth` are only meaningful for the frequencies
+ * that use them, and are preserved rather than cleared when the frequency
+ * changes: someone toggling weekly → monthly → weekly should not have to
+ * re-enter the days they already chose.
+ */
+export interface ScheduleValue {
+    frequency: ScheduleFrequency;
+    /** Time of day. Unused when frequency is `immediate` or `hourly`. */
+    time?: TimeValue;
+    /**
+     * Days to run on, 0 = Sunday … 6 = Saturday. Used when frequency is
+     * `weekly`.
+     *
+     * An ARRAY, not a single day: "every Monday, Wednesday and Friday" is the
+     * common shape for a digest, and a single-day field forces the caller to
+     * create three separate schedules that then drift apart independently.
+     * Stored sorted so two equivalent selections compare equal.
+     */
+    weekdays?: number[];
+    /** 1–31. Used when frequency is `monthly`. See the clamping note below. */
+    dayOfMonth?: number;
+    /** IANA zone, e.g. `Asia/Kolkata`. Unused when frequency is `immediate`. */
+    timezone?: string;
+}
+export interface ScheduleBuilderProps {
+    value: ScheduleValue;
+    onChange: (value: ScheduleValue) => void;
+    /** Frequencies to offer. Defaults to all five. */
+    frequencies?: ScheduleFrequency[];
+    label?: ReactNode;
+    helperText?: ReactNode;
+    size?: "sm" | "md" | "lg";
+    disabled?: boolean;
+    /** Hide the timezone control when the caller pins the zone itself. */
+    showTimezone?: boolean;
+    /**
+     * Echo the schedule back in words — "Every Monday and Friday at 09:00
+     * (Asia/Kolkata)".
+     *
+     * On by default. A recurrence assembled from four controls is easy to build
+     * wrong and hard to re-read, and every caller would otherwise wire
+     * `describeSchedule` itself — or, more likely, not bother, leaving the user
+     * to verify by mentally recombining the fields.
+     */
+    showSummary?: boolean;
+    /** Validation message. Rendered in place of the summary when present. */
+    error?: ReactNode;
+    className?: string;
+    id?: string;
+}
+/**
+ * ScheduleBuilder — composes a recurrence from frequency, time, day and zone.
+ *
+ * `TimePicker` answers "what time" and `TimezonePicker` answers "which zone",
+ * but nothing composed *"every Monday at 09:00 Asia/Kolkata"* — the frequency
+ * switch, the day selector that appears only for weekly, the day-of-month for
+ * monthly. Every consumer would otherwise hand-roll that conditional and get
+ * it subtly different.
+ *
+ * Controlled, like the other builders here: the component holds no copy of the
+ * schedule, so the caller decides where it is persisted and can normalise or
+ * validate before saving.
+ *
+ * Fields appear only when the chosen frequency uses them — `immediate` shows
+ * nothing further, `hourly` shows only a zone (the minute past the hour is not
+ * worth a control). That keeps the default state minimal, matching the
+ * progressive-disclosure convention used across config surfaces.
+ */
+export declare function ScheduleBuilder({ value, onChange, frequencies, label, helperText, size, disabled, showTimezone, showSummary, error, className, id, }: ScheduleBuilderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Human-readable summary of a schedule — "Every Monday at 09:00 (Asia/Kolkata)".
+ *
+ * Exported because a schedule is almost always echoed back somewhere the
+ * builder is not: a row in a table, a confirmation dialog, a digest header.
+ * Keeping the phrasing here stops each surface inventing its own.
+ */
+export declare function describeSchedule(value: ScheduleValue): string;
+export default ScheduleBuilder;
+//# sourceMappingURL=ScheduleBuilder.d.ts.map

package/dist/components/ScheduleBuilder/ScheduleBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScheduleBuilder.d.ts","sourceRoot":"","sources":["../../../src/components/ScheduleBuilder/ScheduleBuilder.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAsB,MAAM,OAAO,CAAC;AAO3D,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAM3D,OAAO,+BAA+B,CAAC;AAEvC,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAExF;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,iBAAiB,CAAC;IAC7B,qEAAqE;IACrE,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IACzC,kDAAkD;IAClD,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAClC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sEAAsE;IACtE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,yEAAyE;IACzE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AA+FD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,QAAQ,EACR,WAAmE,EACnE,KAAK,EACL,UAAU,EACV,IAAW,EACX,QAAgB,EAChB,YAAmB,EACnB,WAAkB,EAClB,KAAK,EACL,SAAS,EACT,EAAE,GACH,EAAE,oBAAoB,2CA0HtB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CA4B7D;AAED,eAAe,eAAe,CAAC"}

package/dist/components/ScheduleBuilder/index.d.ts

@@ -0,0 +1,2 @@
+export { ScheduleBuilder, describeSchedule, type ScheduleBuilderProps, type ScheduleValue, type ScheduleFrequency, } from "./ScheduleBuilder";
+//# sourceMappingURL=index.d.ts.map

package/dist/components/ScheduleBuilder/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/ScheduleBuilder/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAC"}

package/dist/components/Sheet/Sheet.d.ts

@@ -14,5 +14,15 @@ export interface SheetProps {
     dragHandle?: boolean;
     className?: string;
 }
+/**
+ * Turn `size` into a CSS length for the panel's cross axis.
+ *
+ * Named sizes are checked FIRST. The previous order returned any string
+ * verbatim, so `"md"` reached the DOM as `width: md` — invalid CSS that the
+ * browser dropped — and every sheet using a named size silently took its
+ * content's intrinsic width instead, growing and shrinking as sections
+ * opened. Exported for the regression test.
+ */
+export declare function resolveSheetSize(side: SheetSide, size: SheetProps["size"]): string;
 export declare function Sheet({ open, onClose, side, size, title, description, children, footer, closeOnOverlayClick, closeOnEsc, dragHandle, className, }: SheetProps): import("react").ReactPortal;
 //# sourceMappingURL=Sheet.d.ts.map

package/dist/components/Sheet/Sheet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Sheet.d.ts","sourceRoot":"","sources":["../../../src/components/Sheet/Sheet.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,OAAO,CAAC;AAIlD,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE5D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACrD,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAsBD,wBAAgB,KAAK,CAAC,EACpB,IAAI,EACJ,OAAO,EACP,IAAe,EACf,IAAW,EACX,KAAK,EACL,WAAW,EACX,QAAQ,EACR,MAAM,EACN,mBAA0B,EAC1B,UAAiB,EACjB,UAAiB,EACjB,SAAS,GACV,EAAE,UAAU,+BA8DZ"}
+{"version":3,"file":"Sheet.d.ts","sourceRoot":"","sources":["../../../src/components/Sheet/Sheet.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,OAAO,CAAC;AAIlD,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;AAE5D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACrD,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAeD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,MAAM,CAUlF;AAED,wBAAgB,KAAK,CAAC,EACpB,IAAI,EACJ,OAAO,EACP,IAAe,EACf,IAAW,EACX,KAAK,EACL,WAAW,EACX,QAAQ,EACR,MAAM,EACN,mBAA0B,EAC1B,UAAiB,EACjB,UAAiB,EACjB,SAAS,GACV,EAAE,UAAU,+BA4DZ"}

package/dist/components/Sheet/index.d.ts

@@ -1,2 +1,2 @@
-export { Sheet, type SheetProps, type SheetSide } from "./Sheet";
+export { resolveSheetSize, Sheet, type SheetProps, type SheetSide } from "./Sheet";
 //# sourceMappingURL=index.d.ts.map

package/dist/components/Sheet/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Sheet/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Sheet/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC"}

package/dist/components/TimezonePicker/TimezonePicker.d.ts

@@ -23,6 +23,15 @@ export interface TimezonePickerProps extends DivPropsBase {
     helperText?: ReactNode;
     placeholder?: string;
 }
+/**
+ * Curated default zones.
+ *
+ * Exported so a composing component can EXTEND the list rather than replace
+ * it: passing a bare `options` array to cover one extra zone would silently
+ * drop the other fifteen. A value outside this list otherwise renders as the
+ * placeholder, which reads as "nothing selected" while a value is in fact set.
+ */
+export declare const DEFAULT_TIMEZONE_OPTIONS: TimezoneOption[];
 export declare const TimezonePicker: import("react").ForwardRefExoticComponent<TimezonePickerProps & import("react").RefAttributes<HTMLDivElement>>;
 export {};
 //# sourceMappingURL=TimezonePicker.d.ts.map

package/dist/components/TimezonePicker/TimezonePicker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TimezonePicker.d.ts","sourceRoot":"","sources":["../../../src/components/TimezonePicker/TimezonePicker.tsx"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,wBAAwB,EAG7B,KAAK,SAAS,EAOf,MAAM,OAAO,CAAC;AASf,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEpD,KAAK,YAAY,GAAG,IAAI,CACtB,wBAAwB,CAAC,KAAK,CAAC,EAC/B,UAAU,GAAG,UAAU,GAAG,cAAc,CACzC,CAAC;AAEF,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAiBD,eAAO,MAAM,cAAc,gHAwU1B,CAAC"}
+{"version":3,"file":"TimezonePicker.d.ts","sourceRoot":"","sources":["../../../src/components/TimezonePicker/TimezonePicker.tsx"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,wBAAwB,EAG7B,KAAK,SAAS,EAOf,MAAM,OAAO,CAAC;AASf,MAAM,WAAW,cAAc;IAC7B,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEpD,KAAK,YAAY,GAAG,IAAI,CACtB,wBAAwB,CAAC,KAAK,CAAC,EAC/B,UAAU,GAAG,UAAU,GAAG,cAAc,CACzC,CAAC;AAEF,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,EAAE,cAAc,EAapD,CAAC;AAEF,eAAO,MAAM,cAAc,gHAwU1B,CAAC"}

package/dist/components/TimezonePicker/index.d.ts

@@ -1,2 +1,2 @@
-export { type TimezoneOption, TimezonePicker, type TimezonePickerProps, type TimezonePickerSize, } from "./TimezonePicker";
+export { DEFAULT_TIMEZONE_OPTIONS, type TimezoneOption, TimezonePicker, type TimezonePickerProps, type TimezonePickerSize, } from "./TimezonePicker";
 //# sourceMappingURL=index.d.ts.map

package/dist/components/TimezonePicker/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/TimezonePicker/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EACnB,cAAc,EACd,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/TimezonePicker/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,KAAK,cAAc,EACnB,cAAc,EACd,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,GACxB,MAAM,kBAAkB,CAAC"}