@octaviaflow/core 3.1.0-beta.85 → 3.1.0-beta.87

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

@@ -0,0 +1,89 @@
+import { type ReactNode } from "react";
+import { type TimeValue } from "../TimePicker";
+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;AAQ3D,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"}