@fougere/svelte 0.2.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fougere contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `@fougere/svelte` — the four primitives, in Svelte, for any host that renders it.
+ *
+ * There is no `@fougere/sveltekit` beside it, and that is not an omission: SvelteKit
+ * serves Web-standard `Request`/`Response` from `+server.ts`, and it hands every
+ * `load` function its own `event`, so there is no ambient-request lookup to package.
+ * A SvelteKit app mounts `@fougere/app/web` directly, the way the TanStack and React
+ * Router demos do. Next needed 124 lines because `next/headers` exists; SvelteKit
+ * needs none because it does not.
+ *
+ * So: one package per UI framework, and a host package only when the host has
+ * something that is genuinely its own.
+ */
+export { useQuery, useCommand, type QueryState, type QueryStore, type CommandStore } from './useFougereData.js';
+export { useFormFor, type FormOptions } from './useFormFor.js';
+export { useCurrentUser, hydrateSession, refreshSession } from './useCurrentUser.js';
+export { fetcher, CALL_ENDPOINT } from '@fougere/app/client';
+export type { CallInput, EntityClass, FormEntity, FormField, SessionView, } from '@fougere/app/client';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAChH,OAAO,EAAE,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAE7D,YAAY,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,SAAS,EACT,WAAW,GACZ,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * `@fougere/svelte` — the four primitives, in Svelte, for any host that renders it.
+ *
+ * There is no `@fougere/sveltekit` beside it, and that is not an omission: SvelteKit
+ * serves Web-standard `Request`/`Response` from `+server.ts`, and it hands every
+ * `load` function its own `event`, so there is no ambient-request lookup to package.
+ * A SvelteKit app mounts `@fougere/app/web` directly, the way the TanStack and React
+ * Router demos do. Next needed 124 lines because `next/headers` exists; SvelteKit
+ * needs none because it does not.
+ *
+ * So: one package per UI framework, and a host package only when the host has
+ * something that is genuinely its own.
+ */
+export { useQuery, useCommand } from './useFougereData.js';
+export { useFormFor } from './useFormFor.js';
+export { useCurrentUser, hydrateSession, refreshSession } from './useCurrentUser.js';
+export { fetcher, CALL_ENDPOINT } from '@fougere/app/client';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAuD,MAAM,qBAAqB,CAAC;AAChH,OAAO,EAAE,UAAU,EAAoB,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/useCurrentUser.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The session: resolved server-side, read here as a store. `refresh()` re-reads it
+ * after a client-side auth change — no page reload, no hand-rolled /api/me.
+ *
+ * SvelteKit hands a `load` function's data down through the page, so a layout that
+ * already resolved the session can `hydrate()` this store and the page arrives
+ * knowing its user. Without it, the store fetches once on first read.
+ */
+import { type Readable } from 'svelte/store';
+import type { SessionView } from '@fougere/app/client';
+/** Seed the store from what the server already resolved (a `load` function's data). */
+export declare function hydrateSession(view: SessionView): void;
+export declare function refreshSession(): Promise<void>;
+export declare function useCurrentUser<TUser = Record<string, unknown>>(): {
+    session: Readable<SessionView>;
+    user: Readable<TUser | null>;
+    loggedIn: Readable<boolean>;
+    refresh: typeof refreshSession;
+};
+//# sourceMappingURL=useCurrentUser.d.ts.map

package/dist/useCurrentUser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCurrentUser.d.ts","sourceRoot":"","sources":["../src/useCurrentUser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAqB,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAKvD,uFAAuF;AACvF,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAGtD;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAIpD;AAED,wBAAgB,cAAc,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAK1D,OAAO,EAAa,QAAQ,CAAC,WAAW,CAAC;IACzC,IAAI;IACJ,QAAQ;IACR,OAAO;EAEV"}

package/dist/useCurrentUser.js

@@ -0,0 +1,33 @@
+/**
+ * The session: resolved server-side, read here as a store. `refresh()` re-reads it
+ * after a client-side auth change — no page reload, no hand-rolled /api/me.
+ *
+ * SvelteKit hands a `load` function's data down through the page, so a layout that
+ * already resolved the session can `hydrate()` this store and the page arrives
+ * knowing its user. Without it, the store fetches once on first read.
+ */
+import { writable, derived } from 'svelte/store';
+const session = writable({ user: null });
+let fetched = false;
+/** Seed the store from what the server already resolved (a `load` function's data). */
+export function hydrateSession(view) {
+    fetched = true;
+    session.set(view);
+}
+export async function refreshSession() {
+    const response = await fetch('/_fougere/session');
+    fetched = true;
+    session.set((await response.json()));
+}
+export function useCurrentUser() {
+    // Only reached in the browser, and only when a layout did not hydrate it.
+    if (!fetched && typeof window !== 'undefined')
+        void refreshSession();
+    return {
+        session: session,
+        user: derived(session, ($session) => ($session.user ?? null)),
+        loggedIn: derived(session, ($session) => $session.user != null),
+        refresh: refreshSession,
+    };
+}
+//# sourceMappingURL=useCurrentUser.js.map

package/dist/useCurrentUser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCurrentUser.js","sourceRoot":"","sources":["../src/useCurrentUser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAiB,MAAM,cAAc,CAAC;AAGhE,MAAM,OAAO,GAAG,QAAQ,CAAc,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;AACtD,IAAI,OAAO,GAAG,KAAK,CAAC;AAEpB,uFAAuF;AACvF,MAAM,UAAU,cAAc,CAAC,IAAiB;IAC9C,OAAO,GAAG,IAAI,CAAC;IACf,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAClD,OAAO,GAAG,IAAI,CAAC;IACf,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAgB,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,0EAA0E;IAC1E,IAAI,CAAC,OAAO,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,KAAK,cAAc,EAAE,CAAC;IAErE,OAAO;QACL,OAAO,EAAE,OAAgC;QACzC,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAiB,CAAC;QAC7E,QAAQ,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAC;QAC/D,OAAO,EAAE,cAAc;KACxB,CAAC;AACJ,CAAC"}

package/dist/useFormFor.d.ts

@@ -0,0 +1,32 @@
+/**
+ * The form contract — state, validation, submission, error mapping. Never a widget.
+ *
+ * `values` is a writable store, so a component binds straight into it with
+ * `bind:value={$form.values[field.name]}`. That is the Svelte equivalent of Vue's
+ * reactive object and of React's `setValue`: the same contract, three ways of
+ * holding a value, none of which is a rule.
+ */
+import { type Readable, type Writable } from 'svelte/store';
+import { type FormEntity, type FormField } from '@fougere/app/client';
+export interface FormOptions {
+    /** Command the submit rides. Default: 'create'. */
+    op?: string;
+    /** Initial values (edit mode: the loaded entity). */
+    initial?: Record<string, unknown>;
+    /** Call params designating the target (edit mode: { id }). */
+    params?: Record<string, string>;
+}
+export declare function useFormFor<T = Record<string, unknown>>(entity: FormEntity, options?: FormOptions): {
+    fields: FormField[];
+    /** The same fields, keyed by name — spread `fieldsByName.email.attrs` on an input
+     *  and the page states no rule of its own. */
+    fieldsByName: Record<string, FormField>;
+    values: Writable<Record<string, unknown>>;
+    errors: Writable<Record<string, string>>;
+    submit: () => Promise<T | null>;
+    judge: () => boolean;
+    valid: Readable<boolean>;
+    /** `{ loading, error }` of the underlying command. */
+    command: import("./useFougereData.js").CommandStore<T>;
+};
+//# sourceMappingURL=useFormFor.d.ts.map

package/dist/useFormFor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormFor.d.ts","sourceRoot":"","sources":["../src/useFormFor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAA0B,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEpF,OAAO,EAML,KAAK,UAAU,EACf,KAAK,SAAS,EACf,MAAM,qBAAqB,CAAC;AAG7B,MAAM,WAAW,WAAW;IAC1B,mDAAmD;IACnD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,qDAAqD;IACrD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,wBAAgB,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,GAAE,WAAgB;;IAoCjG;kDAC8C;kBACkC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC;;;kBAnBlF,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;iBANxB,OAAO;;IA+BvB,sDAAsD;;EAGzD"}

package/dist/useFormFor.js

@@ -0,0 +1,56 @@
+/**
+ * The form contract — state, validation, submission, error mapping. Never a widget.
+ *
+ * `values` is a writable store, so a component binds straight into it with
+ * `bind:value={$form.values[field.name]}`. That is the Svelte equivalent of Vue's
+ * reactive object and of React's `setValue`: the same contract, three ways of
+ * holding a value, none of which is a rule.
+ */
+import { writable, derived, get } from 'svelte/store';
+import { FougereError, ErrorCode } from '@fougere/core/contract';
+import { entityKeyOf, errorsByField, formFieldsOf, payloadOf, } from '@fougere/app/client';
+import { useCommand } from './useFougereData.js';
+export function useFormFor(entity, options = {}) {
+    const entityKey = entityKeyOf(entity);
+    const fields = formFieldsOf(entity, entityKey);
+    // `initial` wins over the declared default: editing a row shows the row. On a
+    // create form there is none, so the field opens on what is about to be written.
+    const values = writable(Object.fromEntries(fields.map((field) => [field.name, options.initial?.[field.name] ?? field.default])));
+    const errors = writable({});
+    const command = useCommand(entity, options.op ?? 'create');
+    /** Local pre-judgment — same rules as the handler, saves a lost round-trip. */
+    function judge() {
+        const result = entity.validate(payloadOf(get(values)));
+        errors.set(result.success ? {} : errorsByField(result.errors));
+        return result.success;
+    }
+    async function submit() {
+        if (!judge())
+            return null;
+        try {
+            return await command.execute({ params: options.params, body: payloadOf(get(values)) });
+        }
+        catch (err) {
+            if (err instanceof FougereError && err.code === ErrorCode.VALIDATION_FAILED && Array.isArray(err.details)) {
+                errors.set(errorsByField(err.details));
+                return null;
+            }
+            throw err;
+        }
+    }
+    const valid = derived(errors, ($errors) => Object.keys($errors).length === 0);
+    return {
+        fields,
+        /** The same fields, keyed by name — spread `fieldsByName.email.attrs` on an input
+         *  and the page states no rule of its own. */
+        fieldsByName: Object.fromEntries(fields.map((field) => [field.name, field])),
+        values,
+        errors,
+        submit,
+        judge,
+        valid,
+        /** `{ loading, error }` of the underlying command. */
+        command,
+    };
+}
+//# sourceMappingURL=useFormFor.js.map

package/dist/useFormFor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormFor.js","sourceRoot":"","sources":["../src/useFormFor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAgC,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EACL,WAAW,EACX,aAAa,EACb,YAAY,EACZ,SAAS,GAIV,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAWjD,MAAM,UAAU,UAAU,CAA8B,MAAkB,EAAE,OAAO,GAAgB,EAAE;IACnG,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,MAAM,GAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAE5D,8EAA8E;IAC9E,gFAAgF;IAChF,MAAM,MAAM,GAAsC,QAAQ,CACxD,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CACxG,CAAC;IACF,MAAM,MAAM,GAAG,QAAQ,CAAyB,EAAE,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,UAAU,CAAI,MAAqB,EAAE,OAAO,CAAC,EAAE,IAAI,QAAQ,CAAC,CAAC;IAE7E,+EAA+E;IAC/E,SAAS,KAAK;QACZ,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACvD,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/D,OAAO,MAAM,CAAC,OAAO,CAAC;IACxB,CAAC;IAED,KAAK,UAAU,MAAM;QACnB,IAAI,CAAC,KAAK,EAAE;YAAE,OAAO,IAAI,CAAC;QAC1B,IAAI,CAAC;YACH,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;QACzF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,YAAY,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,iBAAiB,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC1G,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,OAA8C,CAAC,CAAC,CAAC;gBAC9E,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAsB,OAAO,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC;IAEjG,OAAO;QACL,MAAM;QACN;sDAC8C;QAC9C,YAAY,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAA8B;QACzG,MAAM;QACN,MAAM;QACN,MAAM;QACN,KAAK;QACL,KAAK;QACL,sDAAsD;QACtD,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/useFougereData.d.ts

@@ -0,0 +1,43 @@
+/**
+ * The couple — useQuery (reads) and useCommand (writes), in Svelte.
+ *
+ * Stores, not runes, and that is a packaging decision with a reason: a `.svelte.ts`
+ * file needs the Svelte compiler to run over it, so a library shipping runes ships
+ * SOURCE and forces every consumer's bundler to compile it. `svelte/store` is plain
+ * TypeScript, compiles with `tsc` like every other package here, and a store still
+ * auto-subscribes with `$query` inside a component. The consumer's ergonomics are
+ * the same; the packaging is honest.
+ *
+ * The name is `useQuery`, not `createQuery`, on purpose — the four primitives are
+ * one vocabulary across Nuxt, React and Svelte, and renaming them per ecosystem
+ * would make the same gesture read as three different things.
+ */
+import { get, type Readable } from 'svelte/store';
+import type { FougereError } from '@fougere/core/contract';
+import { type CallInput, type EntityClass } from '@fougere/app/client';
+export interface QueryState<T> {
+    data: T | null;
+    items: T[];
+    total?: number;
+    hasMore?: boolean;
+    loading: boolean;
+    error: FougereError | null;
+}
+export interface QueryStore<T> extends Readable<QueryState<T>> {
+    refresh(): Promise<void>;
+    /** Unregister from the link. Call it from `onDestroy` when a component unmounts. */
+    dispose(): void;
+}
+export declare function useQuery<T = Record<string, unknown>>(entity: EntityClass, op: string, input?: CallInput, opts?: {
+    immediate?: boolean;
+}): QueryStore<T>;
+export interface CommandStore<T> extends Readable<{
+    loading: boolean;
+    error: FougereError | null;
+}> {
+    execute(input?: CallInput): Promise<T>;
+}
+export declare function useCommand<T = unknown>(entity: EntityClass, op: string): CommandStore<T>;
+/** Read a store's current value without subscribing — used by `useFormFor`. */
+export { get };
+//# sourceMappingURL=useFougereData.d.ts.map

package/dist/useFougereData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFougereData.d.ts","sourceRoot":"","sources":["../src/useFougereData.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAY,GAAG,EAAE,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAcL,KAAK,SAAS,EACd,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACf,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,CAAE,SAAQ,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAC5D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,oFAAoF;IACpF,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClD,MAAM,EAAE,WAAW,EACnB,EAAE,EAAE,MAAM,EACV,KAAK,CAAC,EAAE,SAAS,EACjB,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAC7B,UAAU,CAAC,CAAC,CAAC,CAmCf;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,CAAE,SAAQ,QAAQ,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAAA;CAAE,CAAC;IACjG,OAAO,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACxC;AAED,wBAAgB,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,CAqBxF;AAED,+EAA+E;AAC/E,OAAO,EAAE,GAAG,EAAE,CAAC"}

package/dist/useFougereData.js

@@ -0,0 +1,75 @@
+/**
+ * The couple — useQuery (reads) and useCommand (writes), in Svelte.
+ *
+ * Stores, not runes, and that is a packaging decision with a reason: a `.svelte.ts`
+ * file needs the Svelte compiler to run over it, so a library shipping runes ships
+ * SOURCE and forces every consumer's bundler to compile it. `svelte/store` is plain
+ * TypeScript, compiles with `tsc` like every other package here, and a store still
+ * auto-subscribes with `$query` inside a component. The consumer's ergonomics are
+ * the same; the packaging is honest.
+ *
+ * The name is `useQuery`, not `createQuery`, on purpose — the four primitives are
+ * one vocabulary across Nuxt, React and Svelte, and renaming them per ecosystem
+ * would make the same gesture read as three different things.
+ */
+import { writable, get } from 'svelte/store';
+import { asFougereError, callOf, entityKeyOf, fetcher, invocationOf, itemsOf, mountedKeys, onRefetch, pageOf, queryKeyOf, revalidate, sendCall, trackQuery, } from '@fougere/app/client';
+export function useQuery(entity, op, input, opts) {
+    const entityKey = entityKeyOf(entity);
+    const key = queryKeyOf(entityKey, op, input);
+    const immediate = opts?.immediate !== false;
+    const store = writable({
+        data: null,
+        items: [],
+        loading: immediate,
+        error: null,
+    });
+    async function refresh() {
+        store.update((state) => ({ ...state, loading: true, error: null }));
+        try {
+            const data = (await sendCall(fetcher, callOf(entity, op), invocationOf(input)));
+            const page = pageOf(data);
+            store.set({ data, items: itemsOf(data), total: page.total, hasMore: page.hasMore, loading: false, error: null });
+        }
+        catch (err) {
+            store.update((state) => ({ ...state, loading: false, error: asFougereError(err, entityKey, op) }));
+        }
+    }
+    const untrack = trackQuery(entityKey, key);
+    const off = onRefetch(key, () => void refresh());
+    if (immediate)
+        void refresh();
+    return {
+        subscribe: store.subscribe,
+        refresh,
+        dispose() {
+            untrack();
+            off();
+        },
+    };
+}
+export function useCommand(entity, op) {
+    const entityKey = entityKeyOf(entity);
+    const store = writable({ loading: false, error: null });
+    return {
+        subscribe: store.subscribe,
+        async execute(input) {
+            store.set({ loading: true, error: null });
+            try {
+                const result = (await sendCall(fetcher, callOf(entity, op), invocationOf(input)));
+                // The link: same entity designated on both sides → revalidate its queries.
+                revalidate(mountedKeys(entityKey));
+                store.set({ loading: false, error: null });
+                return result;
+            }
+            catch (err) {
+                const failure = asFougereError(err, entityKey, op);
+                store.set({ loading: false, error: failure });
+                throw failure;
+            }
+        },
+    };
+}
+/** Read a store's current value without subscribing — used by `useFormFor`. */
+export { get };
+//# sourceMappingURL=useFougereData.js.map

package/dist/useFougereData.js.map

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

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@fougere/svelte",
+  "version": "0.2.0-alpha.0",
+  "description": "Fougere's four primitives as Svelte stores — host-independent.",
+  "keywords": [
+    "fougere",
+    "svelte",
+    "sveltekit",
+    "typescript",
+    "fullstack",
+    "rpc"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/chok/fougere.git",
+    "directory": "packages/app/svelte"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@fougere/app": "0.2.0-alpha.0",
+    "@fougere/core": "0.2.0-alpha.0"
+  },
+  "devDependencies": {
+    "svelte": "^5.53.4",
+    "vitest": "^4.1.0",
+    "@fougere/schema": "0.2.0-alpha.0"
+  },
+  "peerDependencies": {
+    "svelte": "^5.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit -p tsconfig.test.json"
+  }
+}