@synnaxlabs/pluto 0.43.0 → 0.44.0

package/dist/src/flex/Box.d.ts

@@ -0,0 +1,128 @@
+import { color } from '@synnaxlabs/x';
+import { direction } from '@synnaxlabs/x/spatial';
+import { ReactElement } from 'react';
+import { default as z } from 'zod';
+import { Component } from '../component';
+import { Generic } from '../generic';
+import { Theming } from '../theming';
+/** All possible alignments for the cross axis of a space */
+export declare const ALIGNMENTS: readonly ["start", "center", "end", "stretch"];
+export declare const alignmentZ: z.ZodEnum<{
+    center: "center";
+    end: "end";
+    start: "start";
+    stretch: "stretch";
+}>;
+/** The alignments for the cross axis of a space */
+export type Alignment = z.infer<typeof alignmentZ>;
+/** All possible justifications for the main axis of a space */
+export declare const JUSTIFICATIONS: readonly ["start", "center", "end", "between", "around", "evenly"];
+export declare const justificationZ: z.ZodEnum<{
+    center: "center";
+    end: "end";
+    start: "start";
+    between: "between";
+    around: "around";
+    evenly: "evenly";
+}>;
+/** The justification for the main axis of a space */
+export type Justification = z.infer<typeof justificationZ>;
+/**
+ * Props for the Box component. Extends generic element props with flex layout
+ * capabilities.
+ *
+ * @template E - The HTML element type to render as
+ *
+ * @example
+ * ```tsx
+ * // Basic vertical layout with spacing
+ * <Box gap="medium">
+ *   <div>Item 1</div>
+ *   <div>Item 2</div>
+ * </Box>
+ *
+ * // Horizontal centered layout with border
+ * <Box x center bordered rounded>
+ *   <Button>Action</Button>
+ *   <Button>Cancel</Button>
+ * </Box>
+ *
+ * // Full-width container with custom styling
+ * <Box full background={11} gap={1.5}>
+ *   <Text.H3>Title</Text.H3>
+ *   <Text.P>Content goes here</Text.P>
+ * </Box>
+ * ```
+ */
+export type BoxProps<E extends Generic.ElementType = "div"> = Omit<Generic.OptionalElementProps<E>, "color"> & BoxExtensionProps;
+/**
+ * Extension props that provide flex layout capabilities to the Box component.
+ * These props control layout direction, alignment, spacing, styling, and sizing.
+ */
+export interface BoxExtensionProps {
+    /** Whether to show a border around the container */
+    bordered?: boolean;
+    /** Border color using Theming.Shade, color.Crude, or false to hide */
+    borderColor?: Theming.Shade | color.Crude | false;
+    /** Border width in pixels */
+    borderWidth?: number;
+    /** Border radius. true for default rounding, number for specific rem value */
+    rounded?: boolean | number;
+    /** Whether to remove border radius (sharp corners) */
+    sharp?: boolean;
+    /** Background color using Theming.Shade values */
+    background?: Theming.Shade | color.Crude | false;
+    /** Whether the container has no visible spacing/padding */
+    empty?: boolean;
+    /** Spacing between children. Can be a Component.Size ('small', 'medium', 'large') or
+     * a number (in rem units) */
+    gap?: Component.Size | number;
+    /** The flex direction of the container. Defaults to 'y' (column). Can be 'x', 'y',
+     * 'left', 'right', 'top', 'bottom' */
+    direction?: direction.Crude;
+    /** Shorthand for setting direction to 'x' (row). Overrides direction */
+    x?: boolean;
+    /** Shorthand for setting direction to 'y' (column). Overrides direction if x is
+     * not set */
+    y?: boolean;
+    /** Whether to reverse the direction of children */
+    reverse?: boolean;
+    /** Main-axis justification of children. See {@link Justification} for options:
+     * 'start', 'center', 'end', 'between', 'around', 'evenly' */
+    justify?: Justification;
+    /** Cross-axis alignment of children. See {@link Alignment} for options: 'start',
+     * 'center', 'end', 'stretch' */
+    align?: Alignment;
+    /** Flex grow behavior. true sets flex-grow: 1, false leaves unset, number sets
+     * specific flex-grow value */
+    grow?: boolean | number;
+    /** Flex shrink behavior. true sets flex-shrink: 1, false leaves unset, number
+     * sets specific flex-shrink value */
+    shrink?: boolean | number;
+    /** Shorthand for centering both axes (align: 'center', justify: 'center') */
+    center?: boolean;
+    /** Whether the container should take full width/height. true for both, or specify
+     * a direction ('x', 'y') for single axis */
+    full?: boolean | direction.Direction;
+    /** Whether children should wrap to new lines when they overflow */
+    wrap?: boolean;
+    /** Height of the container using Component.Size values */
+    size?: Component.Size;
+    /**
+     * Whether to use horizontal layout optimized for packing items into
+     * visually consistent groups.
+     */
+    pack?: boolean;
+    /** Text color using Theming.Shade, color.Crude, or false to inherit */
+    color?: Theming.Shade | color.Crude | false;
+    /** Whether the container should maintain square aspect ratio */
+    square?: boolean;
+}
+export declare const shouldReverse: (direction?: direction.Crude, reverse?: boolean) => boolean;
+export declare const parseDirection: (dir?: direction.Crude, x?: boolean, y?: boolean, pack?: boolean) => direction.Direction | undefined;
+/**
+ * A flexible container component that arranges its children using CSS flexbox.
+ * See {@link BoxProps} for all available props and examples.
+ */
+export declare const Box: <E extends Generic.ElementType = "div">({ style, align, className, grow, shrink, gap, color, justify, reverse, empty, pack, wrap, center, direction: crudeDirection, rounded, sharp, borderWidth, borderColor, full, background, bordered, x, y, size, square, ...rest }: BoxProps<E>) => ReactElement;
+//# sourceMappingURL=Box.d.ts.map

package/dist/src/flex/Box.d.ts.map

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

package/dist/src/flex/Box.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Box.spec.d.ts.map

package/dist/src/flex/Box.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Box.spec.d.ts","sourceRoot":"","sources":["../../../src/flex/Box.spec.tsx"],"names":[],"mappings":""}

package/dist/src/flex/Select.d.ts

@@ -0,0 +1,7 @@
+import { ReactElement } from 'react';
+import { Alignment } from './Box';
+import { Select as Core } from '../select';
+export interface SelectAlignmentProps extends Omit<Core.ButtonsProps<Alignment>, "keys"> {
+}
+export declare const SelectAlignment: ({ value, ...rest }: SelectAlignmentProps) => ReactElement;
+//# sourceMappingURL=Select.d.ts.map

package/dist/src/flex/Select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Select.d.ts","sourceRoot":"","sources":["../../../src/flex/Select.tsx"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,OAAO,CAAC;AAE1C,OAAO,EAAE,KAAK,SAAS,EAAc,MAAM,YAAY,CAAC;AAExD,OAAO,EAAE,MAAM,IAAI,IAAI,EAAE,MAAM,UAAU,CAAC;AAE1C,MAAM,WAAW,oBACf,SAAQ,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAAG;AAEvD,eAAO,MAAM,eAAe,GAAI,oBAG7B,oBAAoB,KAAG,YAYzB,CAAC"}

package/dist/src/flex/external.d.ts

@@ -0,0 +1,3 @@
+export * from './Box';
+export * from './Select';
+//# sourceMappingURL=external.d.ts.map

package/dist/src/flex/external.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external.d.ts","sourceRoot":"","sources":["../../../src/flex/external.ts"],"names":[],"mappings":"AASA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}

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

@@ -0,0 +1,2 @@
+export * as Flex from './external';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/flex/index.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC"}

package/dist/src/flux/Context.d.ts

@@ -0,0 +1,4 @@
+import { ListenerAdder } from './aether/types';
+export declare const Context: import('react').Context<ListenerAdder | null>;
+export declare const useAddListener: () => ListenerAdder;
+//# sourceMappingURL=Context.d.ts.map

package/dist/src/flux/Context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Context.d.ts","sourceRoot":"","sources":["../../../src/flux/Context.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGzD,eAAO,MAAM,OAAO,+CAA4C,CAAC;AAEjE,eAAO,MAAM,cAAc,QAAO,aAA4C,CAAC"}

package/dist/src/flux/Provider.d.ts

@@ -0,0 +1,9 @@
+import { framer } from '@synnaxlabs/client';
+import { CrudeTimeSpan } from '@synnaxlabs/x';
+import { PropsWithChildren, ReactElement } from 'react';
+export interface ProviderProps extends PropsWithChildren {
+    openStreamer?: framer.StreamOpener;
+    streamerRemovalDelay?: CrudeTimeSpan;
+}
+export declare const Provider: ({ children, openStreamer: propsOpenStreamer, streamerRemovalDelay, }: ProviderProps) => ReactElement;
+//# sourceMappingURL=Provider.d.ts.map

package/dist/src/flux/Provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Provider.d.ts","sourceRoot":"","sources":["../../../src/flux/Provider.tsx"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,KAAK,aAAa,EAAY,MAAM,eAAe,CAAC;AAC7D,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAIlB,MAAM,OAAO,CAAC;AAUf,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC,YAAY,CAAC;IACnC,oBAAoB,CAAC,EAAE,aAAa,CAAC;CACtC;AAID,eAAO,MAAM,QAAQ,GAAI,sEAItB,aAAa,KAAG,YAqClB,CAAC"}

package/dist/src/flux/aether/external.d.ts

@@ -0,0 +1,5 @@
+export * from './listeners';
+export * from './provider';
+export * from './streamer';
+export * from './types';
+//# sourceMappingURL=external.d.ts.map

package/dist/src/flux/aether/external.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external.d.ts","sourceRoot":"","sources":["../../../../src/flux/aether/external.ts"],"names":[],"mappings":"AASA,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC"}

package/dist/src/flux/aether/index.d.ts

@@ -0,0 +1,2 @@
+export * as flux from './external';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/flux/aether/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/flux/aether/index.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,IAAI,MAAM,wBAAwB,CAAC"}

package/dist/src/flux/aether/listeners.d.ts

@@ -0,0 +1,16 @@
+import { channel } from '@synnaxlabs/client';
+import { MultiSeries } from '@synnaxlabs/x';
+import { default as z } from 'zod';
+export interface ListenerSpec<Value, Extra> {
+    channel: channel.Name;
+    onChange: ListenerHandler<Value, Extra>;
+}
+export type ListenerArgs<Value, Extra> = {
+    changed: Value;
+} & Extra;
+export interface ListenerHandler<Value, Extra> {
+    (args: ListenerArgs<Value, Extra>): Promise<unknown> | unknown;
+}
+export declare const parsedHandler: <Z extends z.ZodType, Extra>(schema: Z, onChange: ListenerHandler<z.output<Z>, Extra>) => ListenerHandler<MultiSeries, Extra>;
+export declare const stringHandler: <Extra>(onChange: ListenerHandler<string, Extra>) => ListenerHandler<MultiSeries, Extra>;
+//# sourceMappingURL=listeners.d.ts.map

package/dist/src/flux/aether/listeners.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listeners.d.ts","sourceRoot":"","sources":["../../../../src/flux/aether/listeners.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAY,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,MAAM,WAAW,YAAY,CAAC,KAAK,EAAE,KAAK;IACxC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC;IACtB,QAAQ,EAAE,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;CACzC;AAED,MAAM,MAAM,YAAY,CAAC,KAAK,EAAE,KAAK,IAAI;IACvC,OAAO,EAAE,KAAK,CAAC;CAChB,GAAG,KAAK,CAAC;AAEV,MAAM,WAAW,eAAe,CAAC,KAAK,EAAE,KAAK;IAC3C,CAAC,IAAI,EAAE,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;CAChE;AAED,eAAO,MAAM,aAAa,GACvB,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,KAAK,EACzB,QAAQ,CAAC,EACT,UAAU,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,KAC5C,eAAe,CAAC,WAAW,EAAE,KAAK,CAOpC,CAAC;AAEJ,eAAO,MAAM,aAAa,GACvB,KAAK,EACJ,UAAU,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,KACvC,eAAe,CAAC,WAAW,EAAE,KAAK,CAIpC,CAAC"}

package/dist/src/flux/aether/params.d.ts

@@ -0,0 +1,31 @@
+import { state } from '../../state';
+/** Options to control async operations. */
+export interface FetchOptions {
+    /** Optional AbortSignal to cancel the operation */
+    signal?: AbortSignal;
+}
+/**
+ * Parameters used to retrieve and/or update a resource from within a query.
+ * The query re-executes whenever the parameters change, making it reactive
+ * to parameter updates.
+ *
+ * Parameters must be primitive values (string, number, boolean, null, undefined)
+ * to ensure proper comparison and memoization.
+ *
+ * @example
+ * ```typescript
+ * interface UserParams extends Params {
+ *   userId: number;
+ *   includeProfile?: boolean;
+ *   searchTerm?: string;
+ * }
+ *
+ * const params: UserParams = {
+ *   userId: 123,
+ *   includeProfile: true,
+ *   searchTerm: "john"
+ * };
+ * ```
+ */
+export type Params = state.State;
+//# sourceMappingURL=params.d.ts.map

package/dist/src/flux/aether/params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.d.ts","sourceRoot":"","sources":["../../../../src/flux/aether/params.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,2CAA2C;AAC3C,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC"}

package/dist/src/flux/aether/provider.d.ts

@@ -0,0 +1,29 @@
+import { Destructor, MultiSeries } from '@synnaxlabs/x';
+import { default as z } from 'zod';
+import { aether } from '../../ether';
+import { flux } from '.';
+import { ListenerSpec } from './listeners';
+import { Streamer } from './streamer';
+import { ListenerAdder } from './types';
+import { status } from '../../status/aether';
+export type ProviderState = z.input<typeof providerStateZ>;
+export declare const providerStateZ: z.ZodObject<{}, z.core.$strip>;
+interface InternalState {
+    streamer: Streamer;
+}
+export interface ContextValue {
+    addListener: ListenerAdder | null;
+}
+export declare const ZERO_CONTEXT_VALUE: ContextValue;
+export declare class Provider extends aether.Composite<typeof providerStateZ, InternalState> {
+    static readonly TYPE = "flux.Provider";
+    static readonly stateZ: z.ZodObject<{}, z.core.$strip>;
+    schema: z.ZodObject<{}, z.core.$strip>;
+    afterUpdate(ctx: aether.Context): void;
+}
+export declare const REGISTRY: aether.ComponentRegistry;
+export declare const useAddListener: (ctx: aether.Context) => ListenerAdder;
+export declare const mountListeners: (add: ListenerAdder, handleError: status.ErrorHandler, listeners: ListenerSpec<MultiSeries, {}> | flux.ListenerSpec<MultiSeries, {}>[]) => Destructor;
+export declare const useListener: (ctx: aether.Context, listeners: ListenerSpec<MultiSeries, {}> | flux.ListenerSpec<MultiSeries, {}>[], destructor: Destructor | null) => Destructor;
+export {};
+//# sourceMappingURL=provider.d.ts.map

package/dist/src/flux/aether/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../../../src/flux/aether/provider.ts"],"names":[],"mappings":"AASA,OAAO,EAAS,KAAK,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,OAAO,EAAE,MAAM,EAAU,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAC3D,eAAO,MAAM,cAAc,gCAAe,CAAC;AAE3C,UAAU,aAAa;IACrB,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,aAAa,GAAG,IAAI,CAAC;CACnC;AAED,eAAO,MAAM,kBAAkB,EAAE,YAEhC,CAAC;AAOF,qBAAa,QAAS,SAAQ,MAAM,CAAC,SAAS,CAAC,OAAO,cAAc,EAAE,aAAa,CAAC;IAClF,MAAM,CAAC,QAAQ,CAAC,IAAI,mBAAmB;IACvC,MAAM,CAAC,QAAQ,CAAC,MAAM,iCAAkB;IACxC,MAAM,iCAAmB;IAEzB,WAAW,CAAC,GAAG,EAAE,MAAM,CAAC,OAAO,GAAG,IAAI;CAiBvC;AAED,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,iBAE7B,CAAC;AAIF,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,CAAC,OAAO,KAAG,aAGpD,CAAC;AAEF,eAAO,MAAM,cAAc,GACzB,KAAK,aAAa,EAClB,aAAa,MAAM,CAAC,YAAY,EAChC,WAAW,YAAY,CAAC,WAAW,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,KAC9E,UAaF,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,KAAK,MAAM,CAAC,OAAO,EACnB,WAAW,YAAY,CAAC,WAAW,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,EAAE,CAAC,EAAE,EAC/E,YAAY,UAAU,GAAG,IAAI,KAC5B,UAKF,CAAC"}

package/dist/src/flux/aether/streamer.d.ts

@@ -0,0 +1,22 @@
+import { channel, framer } from '@synnaxlabs/client';
+import { CrudeTimeSpan } from '@synnaxlabs/x';
+import { FrameHandler } from './types';
+import { Status } from '../../status';
+export interface StreamerArgs {
+    handleError: Status.ErrorHandler;
+    removalDelay?: CrudeTimeSpan;
+}
+export declare class Streamer {
+    private readonly handlers;
+    private readonly streamerMutex;
+    private readonly handleError;
+    private readonly debouncedRemoveHandler;
+    private openStreamer;
+    constructor({ handleError, removalDelay }: StreamerArgs);
+    private handleChange;
+    close(): Promise<void>;
+    private unprotectedClose;
+    updateStreamer(streamOpener?: framer.StreamOpener): Promise<void>;
+    addListener(handler: FrameHandler, channel: channel.Name, onOpen?: () => void): () => void;
+}
+//# sourceMappingURL=streamer.d.ts.map

package/dist/src/flux/aether/streamer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamer.d.ts","sourceRoot":"","sources":["../../../../src/flux/aether/streamer.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,KAAK,aAAa,EAA4B,MAAM,eAAe,CAAC;AAE7E,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AAiBvC,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC,YAAY,CAAC;IACjC,YAAY,CAAC,EAAE,aAAa,CAAC;CAC9B;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8C;IACvE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAE3B;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsB;IAClD,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAkC;IACzE,OAAO,CAAC,YAAY,CAAoC;gBAE5C,EAAE,WAAW,EAAE,YAAgB,EAAE,EAAE,YAAY;IAU3D,OAAO,CAAC,YAAY;IAkBd,KAAK;YAIG,gBAAgB;IAQxB,cAAc,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBvE,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,IAAI;CAa9E"}

package/dist/src/flux/aether/streamer.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=streamer.spec.d.ts.map

package/dist/src/flux/aether/streamer.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamer.spec.d.ts","sourceRoot":"","sources":["../../../../src/flux/aether/streamer.spec.ts"],"names":[],"mappings":""}

package/dist/src/flux/aether/types.d.ts

@@ -0,0 +1,13 @@
+import { channel, framer } from '@synnaxlabs/client';
+import { Destructor, observe } from '@synnaxlabs/x';
+export interface FrameHandler extends observe.Handler<framer.Frame> {
+}
+export interface Subscriber {
+    channel: channel.Name;
+    handler: FrameHandler;
+    onOpen?: () => void;
+}
+export interface ListenerAdder {
+    (subscriber: Subscriber): Destructor;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/flux/aether/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/flux/aether/types.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,OAAO,EAAE,MAAM,eAAe,CAAC;AAE9D,MAAM,WAAW,YAAa,SAAQ,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;CAAG;AAEtE,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC;IACtB,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,CAAC;CACtC"}

package/dist/src/flux/external.d.ts

@@ -0,0 +1,12 @@
+export * from './aether/listeners';
+export * from './aether/params';
+export * from './aether/types';
+export * from './Context';
+export * from './form';
+export * from './list';
+export * from './listeners';
+export * from './Provider';
+export * from './result';
+export * from './retrieve';
+export * from './update';
+//# sourceMappingURL=external.d.ts.map

package/dist/src/flux/external.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external.d.ts","sourceRoot":"","sources":["../../../src/flux/external.ts"],"names":[],"mappings":"AASA,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC"}

package/dist/src/flux/form.d.ts

@@ -0,0 +1,112 @@
+import { z } from 'zod';
+import { FetchOptions, Params } from './aether/params';
+import { Result } from './result';
+import { CreateRetrieveArgs } from './retrieve';
+import { CreateUpdateArgs } from './update';
+import { Form } from '../form';
+/**
+ * Configuration arguments for creating a form query.
+ *
+ * @template FormParams The type of parameters for the form query
+ * @template DataSchema The Zod schema type for form validation
+ */
+export interface CreateFormArgs<FormParams extends Params, DataSchema extends z.ZodObject> extends CreateRetrieveArgs<FormParams, z.infer<DataSchema> | null>, CreateUpdateArgs<FormParams, z.infer<DataSchema>> {
+    /** Zod schema for form validation */
+    schema: DataSchema;
+    /** Default values to use when creating new forms */
+    initialValues: z.infer<DataSchema>;
+}
+/**
+ * Return type for the form hook, providing form management utilities.
+ *
+ * @template DataSchema The Zod schema type for form validation
+ */
+export type UseFormReturn<DataSchema extends z.ZodObject> = Omit<Result<z.infer<DataSchema>>, "data"> & {
+    /** Form management utilities for binding inputs and validation */
+    form: Form.UseReturn<DataSchema>;
+    /** Function to save the current form values */
+    save: (opts?: FetchOptions) => void;
+};
+/**
+ * Arguments passed to the afterSave callback.
+ *
+ * @template FormParams The type of parameters for the form query
+ * @template Z The Zod schema type for form validation
+ */
+export interface AfterSaveArgs<FormParams extends Params, Z extends z.ZodObject> {
+    /** The form management utilities */
+    form: Form.UseReturn<Z>;
+    /** The current form parameters */
+    params: FormParams;
+}
+/**
+ * Arguments for using a form hook.
+ *
+ * @template FormParams The type of parameters for the form query
+ * @template Z The Zod schema type for form validation
+ */
+export interface UseFormArgs<FormParams extends Params, Z extends z.ZodObject> extends Pick<Form.UseArgs<Z>, "sync" | "onHasTouched" | "mode"> {
+    /** Initial values for the form fields */
+    initialValues?: z.infer<Z>;
+    /** Whether to automatically save form changes */
+    autoSave?: boolean;
+    /** Parameters for the form query */
+    params: FormParams;
+    /** Callback function called after successful save */
+    afterSave?: (args: AfterSaveArgs<FormParams, Z>) => void;
+}
+/**
+ * Form hook function signature.
+ *
+ * @template FormParams The type of parameters for the form query
+ * @template Z The Zod schema type for form validation
+ */
+export interface UseForm<FormParams extends Params, Z extends z.ZodObject> {
+    (args: UseFormArgs<FormParams, Z>): UseFormReturn<Z>;
+}
+/**
+ * Creates a form query hook that combines data fetching, form management, and real-time updates.
+ *
+ * This function creates a React hook that automatically handles:
+ * - Data fetching with loading states
+ * - Form validation using Zod schemas
+ * - Automatic form saving and persistence
+ * - Real-time synchronization with server state
+ * - Error handling and user feedback
+ *
+ * @template FormParams The type of parameters for the form query
+ * @template Schema The Zod schema type for form validation
+ * @param config Configuration object with form schema, update function, and query settings
+ * @returns A React hook for managing the form
+ *
+ * @example
+ * ```typescript
+ * const userSchema = z.object({
+ *   name: z.string().min(1),
+ *   email: z.string().email(),
+ *   age: z.number().optional()
+ * });
+ *
+ * const useUserForm = createForm({
+ *   name: "user",
+ *   schema: userSchema,
+ *   initialValues: { name: "", email: "", age: undefined },
+ *   retrieve: async ({ params, client }) => {
+ *     return await client.users.retrieve(params.userId);
+ *   },
+ *   update: async ({ value, params, client }) => {
+ *     await client.users.update(params.userId, value);
+ *   }
+ * });
+ *
+ * // Usage in component
+ * const { form, save, variant } = useUserForm({
+ *   params: { userId: 123 },
+ *   afterSave: ({ form }) => {
+ *     console.log("User saved:", form.value());
+ *   }
+ * });
+ * ```
+ */
+export declare const createForm: <FormParams extends Params, Schema extends z.ZodObject>({ name, schema, retrieve, listeners, update, initialValues: baseInitialValues, }: CreateFormArgs<FormParams, Schema>) => UseForm<FormParams, Schema>;
+//# sourceMappingURL=form.d.ts.map

package/dist/src/flux/form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../../../src/flux/form.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAA8B,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACpE,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAI9B;;;;;GAKG;AACH,MAAM,WAAW,cAAc,CAC7B,UAAU,SAAS,MAAM,EACzB,UAAU,SAAS,CAAC,CAAC,SAAS,CAC9B,SAAQ,kBAAkB,CAAC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,EAChE,gBAAgB,CAAC,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACnD,qCAAqC;IACrC,MAAM,EAAE,UAAU,CAAC;IACnB,oDAAoD;IACpD,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,CAAC,UAAU,SAAS,CAAC,CAAC,SAAS,IAAI,IAAI,CAC9D,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,EAC3B,MAAM,CACP,GAAG;IACF,kEAAkE;IAClE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IACjC,+CAA+C;IAC/C,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,YAAY,KAAK,IAAI,CAAC;CACrC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,aAAa,CAAC,UAAU,SAAS,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,SAAS;IAC7E,oCAAoC;IACpC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACxB,kCAAkC;IAClC,MAAM,EAAE,UAAU,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW,CAAC,UAAU,SAAS,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,SAAS,CAC3E,SAAQ,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,cAAc,GAAG,MAAM,CAAC;IAC/D,yCAAyC;IACzC,aAAa,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3B,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oCAAoC;IACpC,MAAM,EAAE,UAAU,CAAC;IACnB,qDAAqD;IACrD,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,CAAC,UAAU,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;CAC1D;AAED;;;;;GAKG;AACH,MAAM,WAAW,OAAO,CAAC,UAAU,SAAS,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,SAAS;IACvE,CAAC,IAAI,EAAE,WAAW,CAAC,UAAU,EAAE,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;CACtD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,eAAO,MAAM,UAAU,GAAI,UAAU,SAAS,MAAM,EAAE,MAAM,SAAS,CAAC,CAAC,SAAS,EAAE,kFAO/E,cAAc,CAAC,UAAU,EAAE,MAAM,CAAC,KAAG,OAAO,CAAC,UAAU,EAAE,MAAM,CA8EjE,CAAC"}

package/dist/src/flux/form.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=form.spec.d.ts.map

package/dist/src/flux/form.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form.spec.d.ts","sourceRoot":"","sources":["../../../src/flux/form.spec.tsx"],"names":[],"mappings":""}

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

@@ -0,0 +1,2 @@
+export * as Flux from './external';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/flux/index.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC"}