fibrae 0.2.2 → 0.3.0

package/dist/jsx-runtime/index.d.ts

@@ -13,12 +13,262 @@ export declare function jsx(type: JSXType, props: PropsWithChildren<{
 export declare const jsxs: typeof jsx;
 export declare const jsxDEV: typeof jsx;
 export declare const h: typeof jsx;
+/**
+ * Map DOM event names (lowercase) to camelCase prop names.
+ * Handles compound words: "keydown" → "KeyDown", "pointerenter" → "PointerEnter", etc.
+ */
+type CamelCaseEventName = {
+    keydown: "KeyDown";
+    keyup: "KeyUp";
+    keypress: "KeyPress";
+    mousedown: "MouseDown";
+    mouseup: "MouseUp";
+    mouseover: "MouseOver";
+    mouseout: "MouseOut";
+    mouseenter: "MouseEnter";
+    mouseleave: "MouseLeave";
+    mousemove: "MouseMove";
+    dblclick: "DblClick";
+    pointerdown: "PointerDown";
+    pointerup: "PointerUp";
+    pointermove: "PointerMove";
+    pointerover: "PointerOver";
+    pointerout: "PointerOut";
+    pointerenter: "PointerEnter";
+    pointerleave: "PointerLeave";
+    pointercancel: "PointerCancel";
+    gotpointercapture: "GotPointerCapture";
+    lostpointercapture: "LostPointerCapture";
+    touchstart: "TouchStart";
+    touchend: "TouchEnd";
+    touchmove: "TouchMove";
+    touchcancel: "TouchCancel";
+    focusin: "FocusIn";
+    focusout: "FocusOut";
+    dragenter: "DragEnter";
+    dragleave: "DragLeave";
+    dragover: "DragOver";
+    dragstart: "DragStart";
+    dragend: "DragEnd";
+    animationstart: "AnimationStart";
+    animationend: "AnimationEnd";
+    animationiteration: "AnimationIteration";
+    animationcancel: "AnimationCancel";
+    transitionstart: "TransitionStart";
+    transitionend: "TransitionEnd";
+    transitionrun: "TransitionRun";
+    transitioncancel: "TransitionCancel";
+    compositionstart: "CompositionStart";
+    compositionend: "CompositionEnd";
+    compositionupdate: "CompositionUpdate";
+    selectstart: "SelectStart";
+    selectionchange: "SelectionChange";
+    canplay: "CanPlay";
+    canplaythrough: "CanPlayThrough";
+    durationchange: "DurationChange";
+    loadeddata: "LoadedData";
+    loadedmetadata: "LoadedMetadata";
+    loadstart: "LoadStart";
+    ratechange: "RateChange";
+    timeupdate: "TimeUpdate";
+    volumechange: "VolumeChange";
+    contextmenu: "ContextMenu";
+    beforeinput: "BeforeInput";
+    fullscreenchange: "FullscreenChange";
+    fullscreenerror: "FullscreenError";
+};
+/**
+ * Convert a DOM event name to its `on`-prefixed camelCase form.
+ * Uses CamelCaseEventName for compound words, Capitalize for simple ones.
+ */
+type OnEventName<K extends string> = K extends keyof CamelCaseEventName ? `on${CamelCaseEventName[K]}` : `on${Capitalize<K>}`;
+/**
+ * Event handler return type — handlers can return void, an Effect (forked
+ * with app context via runForkWithRuntime), or a Promise.
+ */
+type EventHandlerReturn = void | import("effect/Effect").Effect<any, any, any>;
+/**
+ * Event handler props derived from the DOM's own HTMLElementEventMap.
+ * Accepts both camelCase (onClick) and lowercase (onclick) since the runtime
+ * lowercases all event prop names before calling addEventListener.
+ */
+type EventHandlerProps = {
+    [K in keyof HTMLElementEventMap as OnEventName<K & string>]?: (event: HTMLElementEventMap[K]) => EventHandlerReturn;
+} & {
+    [K in keyof HTMLElementEventMap as `on${K & string}`]?: (event: HTMLElementEventMap[K]) => EventHandlerReturn;
+};
+/**
+ * For form elements (input, select, textarea), narrow event.target and
+ * event.currentTarget to the specific element type so users don't need casts.
+ */
+type NarrowedEventHandlers<E extends HTMLElement> = {
+    onInput?: (event: Event & {
+        target: E;
+        currentTarget: E;
+    }) => EventHandlerReturn;
+    oninput?: (event: Event & {
+        target: E;
+        currentTarget: E;
+    }) => EventHandlerReturn;
+    onChange?: (event: Event & {
+        target: E;
+        currentTarget: E;
+    }) => EventHandlerReturn;
+    onchange?: (event: Event & {
+        target: E;
+        currentTarget: E;
+    }) => EventHandlerReturn;
+    onFocus?: (event: FocusEvent & {
+        target: E;
+        currentTarget: E;
+    }) => EventHandlerReturn;
+    onfocus?: (event: FocusEvent & {
+        target: E;
+        currentTarget: E;
+    }) => EventHandlerReturn;
+    onBlur?: (event: FocusEvent & {
+        target: E;
+        currentTarget: E;
+    }) => EventHandlerReturn;
+    onblur?: (event: FocusEvent & {
+        target: E;
+        currentTarget: E;
+    }) => EventHandlerReturn;
+};
+/**
+ * Global HTML attributes derived from the DOM HTMLElement interface.
+ * Using native types prevents false negatives (e.g. missing `role`).
+ */
+type NativeGlobalAttrs = Partial<Pick<HTMLElement, "accessKey" | "autocapitalize" | "autofocus" | "contentEditable" | "dir" | "draggable" | "enterKeyHint" | "hidden" | "id" | "inert" | "inputMode" | "lang" | "nonce" | "popover" | "role" | "slot" | "spellcheck" | "tabIndex" | "title" | "translate">>;
+/**
+ * Common HTML attributes shared across all elements.
+ * Combines fibrae-specific props with native global HTML attributes.
+ */
+type BaseHTMLProps = NativeGlobalAttrs & {
+    key?: string | number;
+    ref?: ((el: HTMLElement) => void) | {
+        current: HTMLElement | null;
+    };
+    /** Accepts CSS string or object (native DOM uses CSSStyleDeclaration) */
+    style?: string | Record<string, string | number>;
+    class?: string;
+    className?: string;
+    children?: VChild;
+    /** Set raw HTML content. Replaces children — use with care. */
+    dangerouslySetInnerHTML?: string;
+    [key: `data-${string}`]: unknown;
+    [key: `aria-${string}`]: unknown;
+};
+/**
+ * Event names that get narrowed per-element (excluded from base EventHandlerProps).
+ */
+type NarrowedEventNames = keyof NarrowedEventHandlers<HTMLElement>;
+/**
+ * Props for a specific HTML element, combining base attributes,
+ * typed event handlers, and narrowed form-element events.
+ * Narrowed events override the generic ones to avoid union parameter types.
+ */
+type HTMLElementProps<E extends HTMLElement> = BaseHTMLProps & Omit<EventHandlerProps, NarrowedEventNames> & NarrowedEventHandlers<E>;
+/**
+ * Element-specific attribute types for elements with unique properties.
+ */
+type InputAttrs = {
+    type?: string;
+    value?: string | number;
+    checked?: boolean;
+    placeholder?: string;
+    disabled?: boolean;
+    name?: string;
+    min?: string | number;
+    max?: string | number;
+    step?: string | number;
+    pattern?: string;
+    required?: boolean;
+    readOnly?: boolean;
+    autoFocus?: boolean;
+    autoComplete?: string;
+    multiple?: boolean;
+    accept?: string;
+};
+type SelectAttrs = {
+    value?: string | number;
+    multiple?: boolean;
+    disabled?: boolean;
+    name?: string;
+    required?: boolean;
+};
+type TextareaAttrs = {
+    value?: string;
+    placeholder?: string;
+    disabled?: boolean;
+    name?: string;
+    rows?: number;
+    cols?: number;
+    required?: boolean;
+    readOnly?: boolean;
+};
+type OptionAttrs = {
+    value?: string | number;
+    selected?: boolean;
+    disabled?: boolean;
+    label?: string;
+};
+type AnchorAttrs = {
+    href?: string;
+    target?: string;
+    rel?: string;
+    download?: string | boolean;
+};
+type ImgAttrs = {
+    src?: string;
+    alt?: string;
+    width?: string | number;
+    height?: string | number;
+    loading?: "lazy" | "eager";
+    crossOrigin?: string;
+};
+type FormAttrs = {
+    action?: string;
+    method?: string;
+    encType?: string;
+    noValidate?: boolean;
+};
+type ButtonAttrs = {
+    type?: "button" | "submit" | "reset";
+    disabled?: boolean;
+    name?: string;
+    value?: string;
+};
+type LabelAttrs = {
+    htmlFor?: string;
+    for?: string;
+};
+/**
+ * Map of elements that need extra attribute types beyond the base.
+ */
+type SpecificElements = {
+    input: HTMLElementProps<HTMLInputElement> & InputAttrs;
+    select: HTMLElementProps<HTMLSelectElement> & SelectAttrs;
+    textarea: HTMLElementProps<HTMLTextAreaElement> & TextareaAttrs;
+    option: HTMLElementProps<HTMLOptionElement> & OptionAttrs;
+    a: HTMLElementProps<HTMLAnchorElement> & AnchorAttrs;
+    img: HTMLElementProps<HTMLImageElement> & ImgAttrs;
+    form: HTMLElementProps<HTMLFormElement> & FormAttrs;
+    button: HTMLElementProps<HTMLButtonElement> & ButtonAttrs;
+    label: HTMLElementProps<HTMLLabelElement> & LabelAttrs;
+};
+/**
+ * All remaining HTML elements get base props + typed events.
+ * Derived from TypeScript's own HTMLElementTagNameMap (~140 elements).
+ */
+type GenericElements = {
+    [K in Exclude<keyof HTMLElementTagNameMap, keyof SpecificElements>]: HTMLElementProps<HTMLElementTagNameMap[K]>;
+};
 declare global {
     namespace JSX {
         type Element = VElement;
         type ElementType = keyof IntrinsicElements | ((props: any) => VNode);
-        interface IntrinsicElements {
-            [elemName: string]: Record<string, unknown>;
+        interface IntrinsicElements extends SpecificElements, GenericElements {
         }
         interface IntrinsicAttributes {
             key?: string | number;
@@ -28,3 +278,4 @@ declare global {
         }
     }
 }
+export {};

package/dist/live/atom.d.ts

@@ -0,0 +1,31 @@
+import { Atom, Result } from "@effect-atom/atom";
+import type * as Schema from "effect/Schema";
+/** Metadata attached to live atoms for runtime discovery. */
+export interface LiveMeta<A, I> {
+    readonly event: string;
+    readonly schema: Schema.Schema<A, I>;
+}
+/** A live atom — an atom backed by a remote SSE source. */
+export type LiveAtom<A, I = A> = Atom.Writable<Result.Result<A>> & {
+    readonly _live: LiveMeta<A, I>;
+};
+/** Check if an atom is a live atom. */
+export declare const isLiveAtom: (atom: Atom.Atom<any>) => atom is LiveAtom<any, any>;
+/**
+ * Create a live atom — an atom whose value is synced from a server SSE source.
+ *
+ * The atom's type is `Result<A>`:
+ * - `Result.initial()` before SSE connects
+ * - `Result.success(value)` on each event
+ *
+ * The atom is automatically serializable for SSR hydration.
+ *
+ * @example
+ * ```ts
+ * const ClockAtom = live("clock", { schema: Schema.String })
+ * ```
+ */
+export declare const live: <A, I>(event: string, options: {
+    readonly schema: Schema.Schema<A, I, never>;
+    readonly key?: string | undefined;
+}) => LiveAtom<A, I>;

package/dist/live/atom.js

@@ -0,0 +1,33 @@
+import { Atom, Result } from "@effect-atom/atom";
+/** Check if an atom is a live atom. */
+export const isLiveAtom = (atom) => "_live" in atom && atom._live != null;
+/**
+ * Create a live atom — an atom whose value is synced from a server SSE source.
+ *
+ * The atom's type is `Result<A>`:
+ * - `Result.initial()` before SSE connects
+ * - `Result.success(value)` on each event
+ *
+ * The atom is automatically serializable for SSR hydration.
+ *
+ * @example
+ * ```ts
+ * const ClockAtom = live("clock", { schema: Schema.String })
+ * ```
+ */
+export const live = (event, options) => {
+    // Create a plain writable atom with Result.initial() as default.
+    // The actual SSE stream subscription is wired up by the render
+    // system when it detects a live atom via LiveConfig.
+    const atom = Atom.make(Result.initial());
+    // Mark as serializable for SSR hydration
+    const serialized = Atom.serializable(atom, {
+        key: options.key ?? event,
+        schema: Result.Schema({ success: options.schema }),
+    });
+    // Attach live metadata
+    return Object.assign(serialized, {
+        _live: { event, schema: options.schema },
+    });
+};
+//# sourceMappingURL=atom.js.map

package/dist/live/atom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atom.js","sourceRoot":"","sources":["../../src/live/atom.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAcjD,uCAAuC;AACvC,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAoB,EAAyB,EAAE,CACxE,OAAO,IAAI,IAAI,IAAK,IAAY,CAAC,KAAK,IAAI,IAAI,CAAC;AAEjD;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAClB,KAAa,EACb,OAGC,EACe,EAAE;IAClB,iEAAiE;IACjE,+DAA+D;IAC/D,qDAAqD;IACrD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAmB,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAE3D,yCAAyC;IACzC,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE;QACzC,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,KAAK;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,CAAQ;KAC1D,CAAC,CAAC;IAEH,uBAAuB;IACvB,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE;QAC/B,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAoB;KAC3D,CAAQ,CAAC;AACZ,CAAC,CAAC"}

package/dist/live/client.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @since 1.0.0
+ * Client-side LiveSync — connects to SSE endpoint and syncs atoms.
+ */
+import * as Effect from "effect/Effect";
+import { Registry as AtomRegistry } from "@effect-atom/atom";
+import { ComponentScope } from "../shared.js";
+import type { LiveChannel } from "./types.js";
+/**
+ * Options for `connect()`.
+ *
+ * @since 1.0.0
+ */
+export interface ConnectOptions {
+    /** SSE endpoint URL (e.g. "/api/live"). */
+    readonly url: string;
+    /** Whether to send cookies cross-origin. Required for cookie-based auth. */
+    readonly withCredentials?: boolean;
+}
+/**
+ * Connect to a LiveSync SSE endpoint and sync a single channel's atom.
+ *
+ * @deprecated Live atoms auto-connect via LiveConfig — just read the atom.
+ * Must be called inside a fibrae component — uses `ComponentScope` for
+ * automatic EventSource cleanup on unmount, and `AtomRegistry` to set
+ * the atom value on each event.
+ *
+ * Decode errors are logged via Effect and skipped (no crash).
+ *
+ * @example
+ * ```ts
+ * const LiveLights = () =>
+ *   Effect.gen(function* () {
+ *     yield* LiveSync.connect(LightsChannel, { url: "/api/live" })
+ *     return <span class="live-dot" />
+ *   })
+ * ```
+ *
+ * @since 1.0.0
+ */
+export declare const connect: <A, I>(channel: LiveChannel<A, I>, options: ConnectOptions) => Effect.Effect<void, never, AtomRegistry.AtomRegistry | ComponentScope>;
+/**
+ * Connect to a multiplexed SSE endpoint and sync multiple channels' atoms.
+ *
+ * @deprecated Live atoms auto-connect via LiveConfig — just read the atoms.
+ * Single EventSource, dispatches to correct atom by event name.
+ *
+ * @since 1.0.0
+ */
+export declare const connectGroup: (channels: readonly LiveChannel<any, any>[], options: ConnectOptions) => Effect.Effect<void, never, AtomRegistry.AtomRegistry | ComponentScope>;

package/dist/live/client.js

@@ -0,0 +1,90 @@
+/**
+ * @since 1.0.0
+ * Client-side LiveSync — connects to SSE endpoint and syncs atoms.
+ */
+import * as Effect from "effect/Effect";
+import * as Either from "effect/Either";
+import * as Runtime from "effect/Runtime";
+import * as Scope from "effect/Scope";
+import * as Schema from "effect/Schema";
+import { Registry as AtomRegistry } from "@effect-atom/atom";
+import { ComponentScope } from "../shared.js";
+/**
+ * Connect to a LiveSync SSE endpoint and sync a single channel's atom.
+ *
+ * @deprecated Live atoms auto-connect via LiveConfig — just read the atom.
+ * Must be called inside a fibrae component — uses `ComponentScope` for
+ * automatic EventSource cleanup on unmount, and `AtomRegistry` to set
+ * the atom value on each event.
+ *
+ * Decode errors are logged via Effect and skipped (no crash).
+ *
+ * @example
+ * ```ts
+ * const LiveLights = () =>
+ *   Effect.gen(function* () {
+ *     yield* LiveSync.connect(LightsChannel, { url: "/api/live" })
+ *     return <span class="live-dot" />
+ *   })
+ * ```
+ *
+ * @since 1.0.0
+ */
+export const connect = (channel, options) => Effect.gen(function* () {
+    // Skip during SSR
+    if (typeof window === "undefined")
+        return;
+    const registry = yield* AtomRegistry.AtomRegistry;
+    const { scope } = yield* ComponentScope;
+    const rt = yield* Effect.runtime();
+    const run = Runtime.runSync(rt);
+    const decode = Schema.decodeUnknownEither(Schema.parseJson(channel.schema));
+    const es = new EventSource(options.url, { withCredentials: options.withCredentials ?? false });
+    es.addEventListener(channel.name, (e) => {
+        const result = decode(e.data);
+        if (Either.isRight(result)) {
+            registry.set(channel.atom, result.right);
+        }
+        else {
+            run(Effect.logWarning("LiveSync decode error").pipe(Effect.annotateLogs({ channel: channel.name, error: String(result.left) })));
+        }
+    });
+    es.onerror = () => {
+        run(Effect.logWarning("LiveSync connection error").pipe(Effect.annotateLogs("channel", channel.name)));
+    };
+    yield* Scope.addFinalizer(scope, Effect.sync(() => es.close()));
+});
+/**
+ * Connect to a multiplexed SSE endpoint and sync multiple channels' atoms.
+ *
+ * @deprecated Live atoms auto-connect via LiveConfig — just read the atoms.
+ * Single EventSource, dispatches to correct atom by event name.
+ *
+ * @since 1.0.0
+ */
+export const connectGroup = (channels, options) => Effect.gen(function* () {
+    if (typeof window === "undefined")
+        return;
+    const registry = yield* AtomRegistry.AtomRegistry;
+    const { scope } = yield* ComponentScope;
+    const rt = yield* Effect.runtime();
+    const run = Runtime.runSync(rt);
+    const es = new EventSource(options.url, { withCredentials: options.withCredentials ?? false });
+    for (const ch of channels) {
+        const decode = Schema.decodeUnknownEither(Schema.parseJson(ch.schema));
+        es.addEventListener(ch.name, (e) => {
+            const result = decode(e.data);
+            if (Either.isRight(result)) {
+                registry.set(ch.atom, result.right);
+            }
+            else {
+                run(Effect.logWarning("LiveSync decode error").pipe(Effect.annotateLogs({ channel: ch.name, error: String(result.left) })));
+            }
+        });
+    }
+    es.onerror = () => {
+        run(Effect.logWarning("LiveSync connection error").pipe(Effect.annotateLogs("channels", channels.map((c) => c.name).join(","))));
+    };
+    yield* Scope.addFinalizer(scope, Effect.sync(() => es.close()));
+});
+//# sourceMappingURL=client.js.map

package/dist/live/client.js.map

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

package/dist/live/codec.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @since 1.0.0
+ * SSE encode/decode helpers for LiveSync.
+ */
+/**
+ * Encode an SSE event as a Uint8Array.
+ *
+ * Format: `[id: <id>\n]event: <name>\ndata: <json>\n\n`
+ *
+ * @since 1.0.0
+ */
+export declare const encodeSSE: (name: string, data: unknown, id?: string | undefined) => Uint8Array<ArrayBufferLike>;
+/**
+ * Encode an SSE comment (keepalive).
+ *
+ * Format: `: <text>\n\n`
+ *
+ * @since 1.0.0
+ */
+export declare const encodeComment: (text: string) => Uint8Array<ArrayBufferLike>;
+/**
+ * Encode an SSE retry directive.
+ *
+ * Tells the client how many milliseconds to wait before reconnecting.
+ *
+ * Format: `retry: <millis>\n\n`
+ *
+ * @since 1.0.0
+ */
+export declare const encodeRetry: (millis: number) => Uint8Array<ArrayBufferLike>;
+/**
+ * Standard SSE response headers.
+ *
+ * @since 1.0.0
+ */
+export declare const SSE_HEADERS: {
+    readonly "Cache-Control": "no-cache";
+    readonly Connection: "keep-alive";
+};

package/dist/live/codec.js

@@ -0,0 +1,41 @@
+/**
+ * @since 1.0.0
+ * SSE encode/decode helpers for LiveSync.
+ */
+const encoder = new TextEncoder();
+/**
+ * Encode an SSE event as a Uint8Array.
+ *
+ * Format: `[id: <id>\n]event: <name>\ndata: <json>\n\n`
+ *
+ * @since 1.0.0
+ */
+export const encodeSSE = (name, data, id) => encoder.encode((id !== undefined ? `id: ${id}\n` : "") + `event: ${name}\ndata: ${JSON.stringify(data)}\n\n`);
+/**
+ * Encode an SSE comment (keepalive).
+ *
+ * Format: `: <text>\n\n`
+ *
+ * @since 1.0.0
+ */
+export const encodeComment = (text) => encoder.encode(`: ${text}\n\n`);
+/**
+ * Encode an SSE retry directive.
+ *
+ * Tells the client how many milliseconds to wait before reconnecting.
+ *
+ * Format: `retry: <millis>\n\n`
+ *
+ * @since 1.0.0
+ */
+export const encodeRetry = (millis) => encoder.encode(`retry: ${millis}\n\n`);
+/**
+ * Standard SSE response headers.
+ *
+ * @since 1.0.0
+ */
+export const SSE_HEADERS = {
+    "Cache-Control": "no-cache",
+    Connection: "keep-alive",
+};
+//# sourceMappingURL=codec.js.map

package/dist/live/codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec.js","sourceRoot":"","sources":["../../src/live/codec.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;AAElC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAY,EAAE,IAAa,EAAE,EAAW,EAAc,EAAE,CAChF,OAAO,CAAC,MAAM,CACZ,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,UAAU,IAAI,WAAW,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAC9F,CAAC;AAEJ;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,IAAY,EAAc,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,CAAC;AAE3F;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAc,EAAc,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,MAAM,MAAM,CAAC,CAAC;AAElG;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,eAAe,EAAE,UAAU;IAC3B,UAAU,EAAE,YAAY;CAChB,CAAC"}

package/dist/live/config.d.ts

@@ -0,0 +1,13 @@
+import * as Context from "effect/Context";
+export interface LiveConfigShape {
+    readonly baseUrl: string;
+    readonly channels?: Record<string, string>;
+    readonly withCredentials?: boolean;
+}
+declare const LiveConfig_base: Context.TagClass<LiveConfig, "fibrae/LiveConfig", LiveConfigShape>;
+export declare class LiveConfig extends LiveConfig_base {
+    static make(options: LiveConfigShape): LiveConfigShape;
+    /** Resolve the SSE URL for a given event name. */
+    static resolve(config: LiveConfigShape, event: string): string;
+}
+export {};

package/dist/live/config.js

@@ -0,0 +1,11 @@
+import * as Context from "effect/Context";
+export class LiveConfig extends Context.Tag("fibrae/LiveConfig")() {
+    static make(options) {
+        return options;
+    }
+    /** Resolve the SSE URL for a given event name. */
+    static resolve(config, event) {
+        return config.channels?.[event] ?? config.baseUrl;
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/live/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/live/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAQ1C,MAAM,OAAO,UAAW,SAAQ,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,EAA+B;IAC7F,MAAM,CAAC,IAAI,CAAC,OAAwB;QAClC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,kDAAkD;IAClD,MAAM,CAAC,OAAO,CAAC,MAAuB,EAAE,KAAa;QACnD,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC;IACpD,CAAC;CACF"}

package/dist/live/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @since 1.0.0
+ * fibrae/live — first-class server↔client atom sync over SSE.
+ *
+ * @example
+ * ```ts
+ * import { LiveSync } from "fibrae/live"
+ * ```
+ */
+export { LiveConfig } from "./config.js";
+export type { LiveConfigShape } from "./config.js";
+/** @deprecated Use `live()` to create live atoms instead. */
+export { channel } from "./types.js";
+/** @deprecated Use `LiveAtom` type instead. */
+export type { LiveChannel } from "./types.js";
+export { encodeSSE, encodeComment, encodeRetry, SSE_HEADERS } from "./codec.js";
+export { serve, serveGroup } from "./server.js";
+export type { ServeOptions, ServeGroupChannelOptions } from "./server.js";
+/** @deprecated Live atoms auto-connect via LiveConfig. */
+export { connect, connectGroup } from "./client.js";
+/** @deprecated Live atoms auto-connect via LiveConfig. */
+export type { ConnectOptions } from "./client.js";
+export { sseStream } from "./sse-stream.js";
+export { live, isLiveAtom } from "./atom.js";
+export type { LiveAtom, LiveMeta } from "./atom.js";

package/dist/live/index.js

@@ -0,0 +1,19 @@
+/**
+ * @since 1.0.0
+ * fibrae/live — first-class server↔client atom sync over SSE.
+ *
+ * @example
+ * ```ts
+ * import { LiveSync } from "fibrae/live"
+ * ```
+ */
+export { LiveConfig } from "./config.js";
+/** @deprecated Use `live()` to create live atoms instead. */
+export { channel } from "./types.js";
+export { encodeSSE, encodeComment, encodeRetry, SSE_HEADERS } from "./codec.js";
+export { serve, serveGroup } from "./server.js";
+/** @deprecated Live atoms auto-connect via LiveConfig. */
+export { connect, connectGroup } from "./client.js";
+export { sseStream } from "./sse-stream.js";
+export { live, isLiveAtom } from "./atom.js";
+//# sourceMappingURL=index.js.map

package/dist/live/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/live/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,6DAA6D;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAGrC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEhD,0DAA0D;AAC1D,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGpD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}