@marktiderman/genesis-core 1.5.1 → 1.7.0

package/dist/hooks/use-infinite-resource.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"use-infinite-resource.js"}

package/dist/hooks/use-live.d.ts

@@ -0,0 +1,27 @@
+import { QueryKey } from '@tanstack/react-query';
+import { o as SubscribeParams, l as ResourceChangeEvent } from '../types-CS9UpxQS.js';
+import '../types-C7FJtFXV.js';
+import '../form-types.js';
+
+/** How long a burst of change events is gathered into one refetch. */
+declare const DEFAULT_LIVE_DEBOUNCE_MS = 250;
+/** `live` as an object, to tune it. `live: true` takes the defaults. */
+interface LiveOptions {
+    /**
+     * Events arriving within this many milliseconds of each other cause one
+     * refetch, not one each. Default {@link DEFAULT_LIVE_DEBOUNCE_MS}. A
+     * steady stream still refetches at least every `4 × debounceMs`.
+     */
+    debounceMs?: number;
+}
+/**
+ * Subscribes while mounted and `enabled`, and invalidates `queryKey` (a
+ * prefix) once per burst of events that `accept` lets through. While the
+ * page is hidden the queries are only marked stale; they refetch when it is
+ * shown again (TanStack Query's `refetchOnWindowFocus`) or next used.
+ *
+ * @internal Used by `useResource` and `useOne`'s `live` option.
+ */
+declare function useLiveInvalidation(resource: string, live: boolean | LiveOptions | undefined, enabled: boolean, params: SubscribeParams, queryKey: QueryKey, accept?: (event: ResourceChangeEvent) => boolean): void;
+
+export { DEFAULT_LIVE_DEBOUNCE_MS, type LiveOptions, useLiveInvalidation };

package/dist/hooks/use-live.js

@@ -0,0 +1,5 @@
+export { DEFAULT_LIVE_DEBOUNCE_MS, useLiveInvalidation } from '../chunk-KXVHDK3Q.js';
+import '../chunk-GGSXSI6Z.js';
+import '../chunk-ZYJUEJ4Z.js';
+//# sourceMappingURL=use-live.js.map
+//# sourceMappingURL=use-live.js.map

package/dist/hooks/use-live.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"use-live.js"}

package/dist/hooks/use-one.d.ts

@@ -1,6 +1,7 @@
 import { UseQueryResult } from '@tanstack/react-query';
-import { B as BaseRecord, I as Identifier } from '../types-DDOmG9hj.js';
-import '../types-5cuflvha.js';
+import { B as BaseRecord, I as Identifier } from '../types-CS9UpxQS.js';
+import { LiveOptions } from './use-live.js';
+import '../types-C7FJtFXV.js';
 import '../form-types.js';
 
 interface UseOneOptions {
@@ -8,6 +9,12 @@ interface UseOneOptions {
     select?: string;
     /** Defaults to `!!id` — won't fetch when id is falsy. */
     enabled?: boolean;
+    /**
+     * Keep the record current while mounted: refetch it when the provider
+     * reports a change to it (`DataProvider.subscribe`). See
+     * `UseResourceOptions.live`. Off by default.
+     */
+    live?: boolean | LiveOptions;
 }
 /**
  * Fetch a single record by id, powered by TanStack Query.

package/dist/hooks/use-one.js

@@ -1,4 +1,5 @@
-export { useOne } from '../chunk-ZK5C3OOT.js';
+export { useOne } from '../chunk-ZKMAU6NN.js';
+import '../chunk-KXVHDK3Q.js';
 import '../chunk-GGSXSI6Z.js';
 import '../chunk-ZYJUEJ4Z.js';
 //# sourceMappingURL=use-one.js.map

package/dist/hooks/use-resource-form.d.ts

@@ -1,8 +1,8 @@
 import { UseFormReturn } from 'react-hook-form';
 import { ResourceFormFieldDef } from '../form-types.js';
-import { j as InvalidationKey } from '../types-DDOmG9hj.js';
+import { j as InvalidationKey } from '../types-CS9UpxQS.js';
 import { MutationModeOptions } from './mutation-mode.js';
-import '../types-5cuflvha.js';
+import '../types-C7FJtFXV.js';
 import '@tanstack/react-query';
 
 interface UseResourceFormOptions extends MutationModeOptions {

package/dist/hooks/use-resource-form.js

@@ -1,12 +1,13 @@
-export { buildArrayItemDefaults, useResourceForm } from '../chunk-3JSFTLDV.js';
-import '../chunk-XQO4OH2N.js';
+export { buildArrayItemDefaults, useResourceForm } from '../chunk-Y3SCYMNN.js';
 import '../chunk-5NHR6ZXS.js';
+import '../chunk-ZKMAU6NN.js';
+import '../chunk-KXVHDK3Q.js';
+import '../chunk-XQO4OH2N.js';
 import '../chunk-RYEXWQFD.js';
-import '../chunk-F3BE7NGM.js';
-import '../chunk-7NUL32W7.js';
+import '../chunk-OBUBP4BY.js';
 import '../chunk-BQOJX67X.js';
-import '../chunk-ZK5C3OOT.js';
 import '../chunk-GGSXSI6Z.js';
 import '../chunk-ZYJUEJ4Z.js';
+import '../chunk-7NUL32W7.js';
 //# sourceMappingURL=use-resource-form.js.map
 //# sourceMappingURL=use-resource-form.js.map

package/dist/hooks/use-resource.d.ts

@@ -1,7 +1,8 @@
 import { UseQueryResult, UseMutationResult } from '@tanstack/react-query';
-import { m as SortParam, F as FilterParam, j as InvalidationKey, k as ListResult, L as ListParams, I as Identifier, B as BaseRecord } from '../types-DDOmG9hj.js';
+import { n as SortParam, F as FilterParam, j as InvalidationKey, k as ListResult, L as ListParams, I as Identifier, B as BaseRecord } from '../types-CS9UpxQS.js';
 import { MutationModeOptions } from './mutation-mode.js';
-import '../types-5cuflvha.js';
+import { LiveOptions } from './use-live.js';
+import '../types-C7FJtFXV.js';
 import '../form-types.js';
 
 interface UseResourceOptions<T> extends MutationModeOptions {
@@ -40,6 +41,17 @@ interface UseResourceOptions<T> extends MutationModeOptions {
      * rather than flashing a skeleton. Default false.
      */
     keepPreviousData?: boolean;
+    /**
+     * Keep the list current while mounted: subscribe to the provider's change
+     * events (`DataProvider.subscribe`) and refetch this resource's cached
+     * reads (lists and records) when it reports one, once per burst of
+     * events. Events are hints: rows always come from the provider's normal
+     * read. Pending optimistic and undoable writes stay applied over the
+     * refetch. Needs a provider that serves `subscribe` for the resource
+     * (`capabilities(resource).realtime`); otherwise it does nothing. Off by
+     * default.
+     */
+    live?: boolean | LiveOptions;
     /**
      * After the write commits, with the provider's row. In `optimistic` and
      * `undoable` modes that is after `create` / `update` / `remove` have

package/dist/hooks/use-resource.js

@@ -1,8 +1,9 @@
-export { useResource } from '../chunk-6Q477CHB.js';
-import '../chunk-F3BE7NGM.js';
-import '../chunk-7NUL32W7.js';
+export { useResource } from '../chunk-QFR6YJ3R.js';
+import '../chunk-KXVHDK3Q.js';
+import '../chunk-OBUBP4BY.js';
 import '../chunk-BQOJX67X.js';
 import '../chunk-GGSXSI6Z.js';
 import '../chunk-ZYJUEJ4Z.js';
+import '../chunk-7NUL32W7.js';
 //# sourceMappingURL=use-resource.js.map
 //# sourceMappingURL=use-resource.js.map

package/dist/index.d.ts

@@ -1,17 +1,19 @@
-export { A as ArrayFilter, B as BaseRecord, a as BulkChange, b as BulkResult, C as CreateParams, c as CreateResult, D as DataProvider, d as DeleteParams, e as DeleteResult, F as FilterParam, G as GetManyParams, f as GetManyResult, g as GetOneParams, h as GetOneResult, H as HistoryParams, I as Identifier, i as ImportParams, j as InvalidationKey, L as ListParams, k as ListResult, N as NullFilter, P as PaginationParam, R as RangeFilter, l as RowFailure, S as ScalarFilter, m as SortParam, U as UpdateParams, n as UpdateResult, W as WriteEvent } from './types-DDOmG9hj.js';
-export { D as DataReadError, a as DataReadErrorOptions, b as DataWriteError, c as DataWriteErrorOptions, R as ReadOutcome, W as WriteOutcome, i as isDataReadError, d as isDataWriteError, r as readFailureMessage } from './read-outcome-kgNhfuST.js';
-export { DataProviderRoot, DataProviderRootProps, GenesisProvider, GenesisProviderProps, MockProviderOptions, PostgrestFieldErrors, SupabaseClient, SupabaseClientInput, SupabaseProviderOptions, SupabaseResourceConfig, SupabaseWriteContext, createMockProvider, createSupabaseProvider, fieldErrorsFromPostgrest, readOutcomeFromCode, toDataWriteError, useDataProvider, useStorage, writeOutcomeFromCode } from './provider/index.js';
+export { A as ArrayFilter, B as BaseRecord, a as BulkChange, b as BulkResult, C as CreateParams, c as CreateResult, D as DataProvider, d as DeleteParams, e as DeleteResult, F as FilterParam, G as GetManyParams, f as GetManyResult, g as GetOneParams, h as GetOneResult, H as HistoryParams, I as Identifier, i as ImportParams, j as InvalidationKey, L as ListParams, k as ListResult, N as NullFilter, P as PaginationParam, R as RangeFilter, l as ResourceChangeEvent, m as RowFailure, S as ScalarFilter, n as SortParam, o as SubscribeParams, U as UpdateParams, p as UpdateResult, W as WriteEvent } from './types-CS9UpxQS.js';
+export { D as DataReadError, a as DataReadErrorOptions, b as DataWriteError, c as DataWriteErrorOptions, R as ReadOutcome, W as WriteOutcome, i as isDataReadError, d as isDataWriteError, r as readFailureMessage } from './read-outcome-C_9HbXvb.js';
+export { DataProviderRoot, DataProviderRootProps, GenesisProvider, GenesisProviderProps, MockProviderOptions, PostgrestFieldErrors, SupabaseClient, SupabaseClientInput, SupabaseProviderOptions, SupabaseRealtimeChannel, SupabaseRealtimePayload, SupabaseResourceConfig, SupabaseWriteContext, createMockProvider, createSupabaseProvider, fieldErrorsFromPostgrest, readOutcomeFromCode, toDataWriteError, useDataProvider, useStorage, writeOutcomeFromCode } from './provider/index.js';
 export { S as StorageAdapter } from './types-DKcxHXxq.js';
 export { createLocalStorageAdapter, createMemoryStorageAdapter, createNoopStorageAdapter } from './storage/index.js';
 export { UseResourceOptions, UseResourceReturn, useResource } from './hooks/use-resource.js';
 export { UseOneOptions, useOne } from './hooks/use-one.js';
+export { InfinitePageParam, UseInfiniteResourceOptions, UseInfiniteResourceReturn, useInfiniteResource } from './hooks/use-infinite-resource.js';
 export { useCapabilities } from './hooks/use-capabilities.js';
+export { DEFAULT_LIVE_DEBOUNCE_MS, LiveOptions } from './hooks/use-live.js';
 export { UseResourceFormOptions, UseResourceFormReturn, buildArrayItemDefaults, useResourceForm } from './hooks/use-resource-form.js';
 export { UseWizardReturn, WizardStep, useWizard } from './hooks/use-wizard.js';
 export { DEFAULT_UNDO_DELAY_MS, MutationMode, MutationModeOptions, UndoableWrite, pendingWriteCount } from './hooks/mutation-mode.js';
 export { DEFAULT_UNSAVED_CHANGES_MESSAGE, UseUnsavedChangesGuardOptions, UseUnsavedChangesGuardReturn, useUnsavedChangesGuard } from './hooks/use-unsaved-changes-guard.js';
 export { FieldType, ResourceFormFieldDef, SelectOption, FieldType as WidgetHint } from './form-types.js';
-export { A as AuditEntry, D as DataRow, F as FieldPermissions, a as FieldReference, b as FieldSchema, c as FilterOperator, P as ProviderCapabilities, R as RecordComment, d as ResourceAccess, e as ResourceContract, f as ResourceRelation, g as ResourceSchema, h as ResourceSummary, i as RowAction, S as StorageType, V as VersionField } from './types-5cuflvha.js';
+export { A as AuditEntry, D as DataRow, F as FieldPermissions, a as FieldReference, b as FieldSchema, c as FilterOperator, P as ProviderCapabilities, R as RecordComment, d as ResourceAccess, e as ResourceContract, f as ResourceRelation, g as ResourceSchema, h as ResourceSummary, i as RowAction, S as StorageType, V as VersionField } from './types-C7FJtFXV.js';
 export { decodeRecordKey, encodeRecordKey, keyFields } from './schema/index.js';
 export { titleCase } from './utils.js';
 import 'react';

package/dist/index.js

@@ -1,20 +1,22 @@
-export { createSupabaseProvider, fieldErrorsFromPostgrest, readOutcomeFromCode, toDataWriteError, writeOutcomeFromCode } from './chunk-E5VYFAQO.js';
+export { createSupabaseProvider, fieldErrorsFromPostgrest, readOutcomeFromCode, toDataWriteError, writeOutcomeFromCode } from './chunk-Y475Z7BM.js';
 export { decodeRecordKey, encodeRecordKey, keyFields } from './chunk-KV2HW4G4.js';
 export { DataReadError, isDataReadError, readFailureMessage } from './chunk-HUNGCTRA.js';
 import './chunk-XCX2TRBL.js';
 import './chunk-65SXNHWE.js';
-import './chunk-HT43MPKW.js';
-export { buildArrayItemDefaults, useResourceForm } from './chunk-3JSFTLDV.js';
-export { useResource } from './chunk-6Q477CHB.js';
+import './chunk-V3GDAELU.js';
+export { useInfiniteResource } from './chunk-ADD2RIGA.js';
+export { buildArrayItemDefaults, useResourceForm } from './chunk-Y3SCYMNN.js';
+export { DataWriteError, isDataWriteError } from './chunk-5NHR6ZXS.js';
+export { useOne } from './chunk-ZKMAU6NN.js';
+export { useResource } from './chunk-QFR6YJ3R.js';
+export { DEFAULT_LIVE_DEBOUNCE_MS } from './chunk-KXVHDK3Q.js';
 export { DEFAULT_UNSAVED_CHANGES_MESSAGE, useUnsavedChangesGuard } from './chunk-XQO4OH2N.js';
 export { useWizard } from './chunk-7KOLYF27.js';
-export { DataWriteError, isDataWriteError } from './chunk-5NHR6ZXS.js';
 export { titleCase } from './chunk-RYEXWQFD.js';
-export { DEFAULT_UNDO_DELAY_MS, pendingWriteCount } from './chunk-F3BE7NGM.js';
-import './chunk-7NUL32W7.js';
+export { DEFAULT_UNDO_DELAY_MS, pendingWriteCount } from './chunk-OBUBP4BY.js';
 export { useCapabilities } from './chunk-BQOJX67X.js';
-export { useOne } from './chunk-ZK5C3OOT.js';
 export { DataProviderRoot, GenesisProvider, createMockProvider, useDataProvider, useStorage } from './chunk-GGSXSI6Z.js';
 export { createLocalStorageAdapter, createMemoryStorageAdapter, createNoopStorageAdapter } from './chunk-ZYJUEJ4Z.js';
+import './chunk-7NUL32W7.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/navigation.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Router-free, DOM-free navigation: the logical navigation tree and the
+ * active-path matcher, shared by the web app shell and native shells.
+ * `resolveNavigation` never reads browser history or `window`.
+ */
+/**
+ * Options for {@link isPathActive}.
+ *
+ * @stability Beta
+ */
+interface IsPathActiveOptions {
+    /** Require an exact path match instead of a prefix match (like `NavLink end`). */
+    end?: boolean;
+}
+/**
+ * Default active-path matcher, mirroring React Router's `NavLink` (prefix
+ * match, with `/` treated as exact). Consumers can override via an `isActive`
+ * prop where components accept one.
+ *
+ * `activePath` may carry a query and hash (`pathname + search + hash`). An
+ * item whose `to` has neither compares against the path part only, exactly as
+ * before. An item that opts in by putting a query or hash in its `to`
+ * (`/admin?tab=users`, `/settings#profile`) is active only when the path
+ * matches exactly AND every query param it names has the same value in
+ * `activePath` (extra params such as `&page=2` are ignored) AND, if it names a
+ * hash, the hash is equal.
+ *
+ * @stability Beta
+ */
+declare function isPathActive(to: string, activePath?: string, options?: IsPathActiveOptions): boolean;
+/**
+ * One node of a logical navigation hierarchy. `path` is a route pattern whose
+ * segments are either static (`clients`) or named params (`$clientId`). A
+ * node's place in the tree is its LOGICAL parent, which need not share its URL
+ * prefix — `/clients/$clientId` can sit under `/dashboard`.
+ *
+ * @stability Beta
+ */
+interface NavigationNode<T> {
+    id: string;
+    path: string;
+    label: string;
+    /** Contextual nav items to show while this node is current. */
+    items: T[];
+    children?: NavigationNode<T>[];
+    /**
+     * Ask the app shell to open its desktop sidebar collapsed (icon rail) while
+     * this node, or a descendant that doesn't set its own value, is current.
+     * The nearest node in the resolved trail that sets it wins, so
+     * `defaultCollapsed: false` on a child re-opens it under a collapsed
+     * parent. Only a default: once the user has toggled the sidebar, their
+     * choice wins everywhere. `AppShell` reads it; `resolveNavigation` copies
+     * it through untouched.
+     *
+     * @stability Beta
+     */
+    defaultCollapsed?: boolean;
+    /**
+     * How the app shell shows this node's `items` (its child pages, e.g. a
+     * form's Questions / Logic / Responses / Settings). `"tabs"` (across the
+     * top of the content) or `"sidebar"` (nested under the active item) turn
+     * shell sub-navigation on, which also gives phones a back item plus the
+     * children in the bottom bar. `"section"` is the legacy rendering (the
+     * shell's default) and `"off"` hides them. The nearest node in the trail
+     * that sets it wins over the shell's `options.subNav`.
+     *
+     * @stability Beta
+     */
+    subNav?: "section" | "tabs" | "sidebar" | "off";
+}
+/**
+ * Result of {@link resolveNavigation}. `current`, `parent` and every `trail`
+ * entry are shallow copies of their tree nodes with `path` interpolated from
+ * `params` (a param the URL did not supply stays as `$name`).
+ *
+ * @stability Beta
+ */
+interface ResolvedNavigation<T> {
+    /** The best-matching node — the root when nothing else matches. */
+    current: NavigationNode<T>;
+    /** `current`'s logical parent, for an "up" / back-to-parent link. */
+    parent?: NavigationNode<T>;
+    /** `current.items`. */
+    items: T[];
+    /** Root → `current`, inclusive. */
+    trail: NavigationNode<T>[];
+    /** Params captured by `current.path`, URL-decoded. */
+    params: Record<string, string>;
+}
+/**
+ * Resolve where `pathname` sits in a logical navigation tree. Pure: it never
+ * reads browser history or `window`.
+ *
+ * A node matches when its pattern matches a leading run of WHOLE path
+ * segments (`/my` matches `/my/tasks`, never `/my-other`). Among matches the
+ * winner is decided by positional specificity: at the first position where
+ * one pattern is static and the other a `$param`, the static one wins (so
+ * `/clients/new` beats `/clients/$clientId` whatever the sibling order, and
+ * `/my` beats `/$space/tasks` for `/my/tasks`). Otherwise the pattern matching
+ * more segments wins, then the deeper tree node.
+ * Non-matching nodes are still searched, so a match keeps its logical
+ * ancestors even when their URLs differ.
+ *
+ * @stability Beta
+ */
+declare function resolveNavigation<T>(tree: NavigationNode<T>, pathname: string): ResolvedNavigation<T>;
+
+export { type IsPathActiveOptions, type NavigationNode, type ResolvedNavigation, isPathActive, resolveNavigation };

package/dist/navigation.js

@@ -0,0 +1,101 @@
+// src/navigation.ts
+function splitHref(href) {
+  const hashAt = href.indexOf("#");
+  const hash = hashAt === -1 ? "" : href.slice(hashAt + 1);
+  const beforeHash = hashAt === -1 ? href : href.slice(0, hashAt);
+  const searchAt = beforeHash.indexOf("?");
+  const rawPath = searchAt === -1 ? beforeHash : beforeHash.slice(0, searchAt);
+  return {
+    path: rawPath.length > 1 ? rawPath.replace(/\/+$/, "") || "/" : rawPath,
+    search: searchAt === -1 ? "" : beforeHash.slice(searchAt + 1),
+    hash
+  };
+}
+function isPathActive(to, activePath, options) {
+  if (activePath == null) return false;
+  if (to === activePath) return true;
+  const target = splitHref(to);
+  const current = splitHref(activePath);
+  if (!target.search && !target.hash) {
+    if (target.path === current.path) return true;
+    if (options?.end) return false;
+    return target.path !== "/" && current.path.startsWith(target.path + "/");
+  }
+  if (target.path !== current.path) return false;
+  if (target.hash && target.hash !== current.hash) return false;
+  if (target.search) {
+    const want = new URLSearchParams(target.search);
+    const have = new URLSearchParams(current.search);
+    for (const key of new Set(want.keys())) {
+      const wanted = want.getAll(key);
+      const had = have.getAll(key);
+      if (!wanted.every((value) => had.includes(value))) return false;
+    }
+  }
+  return true;
+}
+function pathSegments(path) {
+  return splitHref(path).path.split("/").filter(Boolean);
+}
+function decodeSegment(segment) {
+  try {
+    return decodeURIComponent(segment);
+  } catch {
+    return segment;
+  }
+}
+function resolveNavigation(tree, pathname) {
+  const segments = pathSegments(pathname).map(decodeSegment);
+  const matches = (pattern) => pattern.length <= segments.length && pattern.every(
+    (part, i) => part.startsWith("$") || decodeSegment(part) === segments[i]
+  );
+  const compare = (a, b) => {
+    const shared = Math.min(a.pattern.length, b.pattern.length);
+    for (let i = 0; i < shared; i++) {
+      const aParam = a.pattern[i].startsWith("$");
+      const bParam = b.pattern[i].startsWith("$");
+      if (aParam !== bParam) return aParam ? -1 : 1;
+    }
+    if (a.pattern.length !== b.pattern.length) {
+      return a.pattern.length - b.pattern.length;
+    }
+    return a.trail.length - b.trail.length;
+  };
+  let best;
+  const visit = (node, ancestors) => {
+    const trail2 = [...ancestors, node];
+    const pattern = pathSegments(node.path);
+    if (matches(pattern)) {
+      const candidate = { trail: trail2, pattern };
+      if (!best || compare(candidate, best) > 0) best = candidate;
+    }
+    for (const child of node.children ?? []) visit(child, trail2);
+  };
+  visit(tree, []);
+  const winner = best ?? { trail: [tree], pattern: [] };
+  const params = {};
+  winner.pattern.forEach((part, i) => {
+    if (part.startsWith("$")) params[part.slice(1)] = segments[i];
+  });
+  const interpolate = (node) => ({
+    ...node,
+    path: node.path.split("/").map((part) => {
+      if (!part.startsWith("$")) return part;
+      const value = params[part.slice(1)];
+      return value == null ? part : encodeURIComponent(value);
+    }).join("/")
+  });
+  const trail = winner.trail.map(interpolate);
+  const current = trail[trail.length - 1];
+  return {
+    current,
+    parent: trail.length > 1 ? trail[trail.length - 2] : void 0,
+    items: current.items,
+    trail,
+    params
+  };
+}
+
+export { isPathActive, resolveNavigation };
+//# sourceMappingURL=navigation.js.map
+//# sourceMappingURL=navigation.js.map

package/dist/navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/navigation.ts"],"names":["trail"],"mappings":"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","file":"navigation.js","sourcesContent":["/**\n * Router-free, DOM-free navigation: the logical navigation tree and the\n * active-path matcher, shared by the web app shell and native shells.\n * `resolveNavigation` never reads browser history or `window`.\n */\n\n/**\n * Split a href into its path (trailing slash dropped, except for `/`), query\n * (no `?`) and hash (no `#`).\n */\nfunction splitHref(href: string): { path: string; search: string; hash: string } {\n  const hashAt = href.indexOf(\"#\");\n  const hash = hashAt === -1 ? \"\" : href.slice(hashAt + 1);\n  const beforeHash = hashAt === -1 ? href : href.slice(0, hashAt);\n  const searchAt = beforeHash.indexOf(\"?\");\n  const rawPath = searchAt === -1 ? beforeHash : beforeHash.slice(0, searchAt);\n  return {\n    path: rawPath.length > 1 ? rawPath.replace(/\\/+$/, \"\") || \"/\" : rawPath,\n    search: searchAt === -1 ? \"\" : beforeHash.slice(searchAt + 1),\n    hash,\n  };\n}\n\n/**\n * Options for {@link isPathActive}.\n *\n * @stability Beta\n */\nexport interface IsPathActiveOptions {\n  /** Require an exact path match instead of a prefix match (like `NavLink end`). */\n  end?: boolean;\n}\n\n/**\n * Default active-path matcher, mirroring React Router's `NavLink` (prefix\n * match, with `/` treated as exact). Consumers can override via an `isActive`\n * prop where components accept one.\n *\n * `activePath` may carry a query and hash (`pathname + search + hash`). An\n * item whose `to` has neither compares against the path part only, exactly as\n * before. An item that opts in by putting a query or hash in its `to`\n * (`/admin?tab=users`, `/settings#profile`) is active only when the path\n * matches exactly AND every query param it names has the same value in\n * `activePath` (extra params such as `&page=2` are ignored) AND, if it names a\n * hash, the hash is equal.\n *\n * @stability Beta\n */\nexport function isPathActive(\n  to: string,\n  activePath?: string,\n  options?: IsPathActiveOptions,\n): boolean {\n  if (activePath == null) return false;\n  if (to === activePath) return true;\n  const target = splitHref(to);\n  const current = splitHref(activePath);\n\n  if (!target.search && !target.hash) {\n    if (target.path === current.path) return true;\n    if (options?.end) return false;\n    return target.path !== \"/\" && current.path.startsWith(target.path + \"/\");\n  }\n\n  if (target.path !== current.path) return false;\n  if (target.hash && target.hash !== current.hash) return false;\n  if (target.search) {\n    const want = new URLSearchParams(target.search);\n    const have = new URLSearchParams(current.search);\n    for (const key of new Set(want.keys())) {\n      const wanted = want.getAll(key);\n      const had = have.getAll(key);\n      if (!wanted.every((value) => had.includes(value))) return false;\n    }\n  }\n  return true;\n}\n\n// ---------------------------------------------------------------------------\n// Hierarchical navigation resolver\n// ---------------------------------------------------------------------------\n\n/**\n * One node of a logical navigation hierarchy. `path` is a route pattern whose\n * segments are either static (`clients`) or named params (`$clientId`). A\n * node's place in the tree is its LOGICAL parent, which need not share its URL\n * prefix — `/clients/$clientId` can sit under `/dashboard`.\n *\n * @stability Beta\n */\nexport interface NavigationNode<T> {\n  id: string;\n  path: string;\n  label: string;\n  /** Contextual nav items to show while this node is current. */\n  items: T[];\n  children?: NavigationNode<T>[];\n  /**\n   * Ask the app shell to open its desktop sidebar collapsed (icon rail) while\n   * this node, or a descendant that doesn't set its own value, is current.\n   * The nearest node in the resolved trail that sets it wins, so\n   * `defaultCollapsed: false` on a child re-opens it under a collapsed\n   * parent. Only a default: once the user has toggled the sidebar, their\n   * choice wins everywhere. `AppShell` reads it; `resolveNavigation` copies\n   * it through untouched.\n   *\n   * @stability Beta\n   */\n  defaultCollapsed?: boolean;\n  /**\n   * How the app shell shows this node's `items` (its child pages, e.g. a\n   * form's Questions / Logic / Responses / Settings). `\"tabs\"` (across the\n   * top of the content) or `\"sidebar\"` (nested under the active item) turn\n   * shell sub-navigation on, which also gives phones a back item plus the\n   * children in the bottom bar. `\"section\"` is the legacy rendering (the\n   * shell's default) and `\"off\"` hides them. The nearest node in the trail\n   * that sets it wins over the shell's `options.subNav`.\n   *\n   * @stability Beta\n   */\n  subNav?: \"section\" | \"tabs\" | \"sidebar\" | \"off\";\n}\n\n/**\n * Result of {@link resolveNavigation}. `current`, `parent` and every `trail`\n * entry are shallow copies of their tree nodes with `path` interpolated from\n * `params` (a param the URL did not supply stays as `$name`).\n *\n * @stability Beta\n */\nexport interface ResolvedNavigation<T> {\n  /** The best-matching node — the root when nothing else matches. */\n  current: NavigationNode<T>;\n  /** `current`'s logical parent, for an \"up\" / back-to-parent link. */\n  parent?: NavigationNode<T>;\n  /** `current.items`. */\n  items: T[];\n  /** Root → `current`, inclusive. */\n  trail: NavigationNode<T>[];\n  /** Params captured by `current.path`, URL-decoded. */\n  params: Record<string, string>;\n}\n\nfunction pathSegments(path: string): string[] {\n  return splitHref(path).path.split(\"/\").filter(Boolean);\n}\n\nfunction decodeSegment(segment: string): string {\n  try {\n    return decodeURIComponent(segment);\n  } catch {\n    return segment;\n  }\n}\n\n/**\n * Resolve where `pathname` sits in a logical navigation tree. Pure: it never\n * reads browser history or `window`.\n *\n * A node matches when its pattern matches a leading run of WHOLE path\n * segments (`/my` matches `/my/tasks`, never `/my-other`). Among matches the\n * winner is decided by positional specificity: at the first position where\n * one pattern is static and the other a `$param`, the static one wins (so\n * `/clients/new` beats `/clients/$clientId` whatever the sibling order, and\n * `/my` beats `/$space/tasks` for `/my/tasks`). Otherwise the pattern matching\n * more segments wins, then the deeper tree node.\n * Non-matching nodes are still searched, so a match keeps its logical\n * ancestors even when their URLs differ.\n *\n * @stability Beta\n */\nexport function resolveNavigation<T>(\n  tree: NavigationNode<T>,\n  pathname: string,\n): ResolvedNavigation<T> {\n  // Compare decoded forms on both sides, so `/caf%C3%A9` matches a `/café`\n  // node (and an encoded pattern matches a decoded pathname).\n  const segments = pathSegments(pathname).map(decodeSegment);\n\n  type Match = { trail: NavigationNode<T>[]; pattern: string[] };\n  const matches = (pattern: string[]) =>\n    pattern.length <= segments.length &&\n    pattern.every(\n      (part, i) => part.startsWith(\"$\") || decodeSegment(part) === segments[i],\n    );\n\n  // > 0 when `a` should win over `b`.\n  // Positional specificity, as TanStack Router and React Router rank routes:\n  // walking left to right, the first position where one pattern is static and\n  // the other a `$param` decides. Only then does the longer match win.\n  const compare = (a: Match, b: Match): number => {\n    const shared = Math.min(a.pattern.length, b.pattern.length);\n    for (let i = 0; i < shared; i++) {\n      const aParam = a.pattern[i]!.startsWith(\"$\");\n      const bParam = b.pattern[i]!.startsWith(\"$\");\n      if (aParam !== bParam) return aParam ? -1 : 1;\n    }\n    if (a.pattern.length !== b.pattern.length) {\n      return a.pattern.length - b.pattern.length;\n    }\n    return a.trail.length - b.trail.length;\n  };\n\n  let best: Match | undefined;\n  const visit = (node: NavigationNode<T>, ancestors: NavigationNode<T>[]) => {\n    const trail = [...ancestors, node];\n    const pattern = pathSegments(node.path);\n    if (matches(pattern)) {\n      const candidate = { trail, pattern };\n      if (!best || compare(candidate, best) > 0) best = candidate;\n    }\n    for (const child of node.children ?? []) visit(child, trail);\n  };\n  visit(tree, []);\n\n  const winner: Match = best ?? { trail: [tree], pattern: [] };\n  const params: Record<string, string> = {};\n  winner.pattern.forEach((part, i) => {\n    if (part.startsWith(\"$\")) params[part.slice(1)] = segments[i]!;\n  });\n\n  const interpolate = (node: NavigationNode<T>): NavigationNode<T> => ({\n    ...node,\n    path: node.path\n      .split(\"/\")\n      .map((part) => {\n        if (!part.startsWith(\"$\")) return part;\n        const value = params[part.slice(1)];\n        return value == null ? part : encodeURIComponent(value);\n      })\n      .join(\"/\"),\n  });\n\n  const trail = winner.trail.map(interpolate);\n  const current = trail[trail.length - 1]!;\n  return {\n    current,\n    parent: trail.length > 1 ? trail[trail.length - 2] : undefined,\n    items: current.items,\n    trail,\n    params,\n  };\n}\n"]}

package/dist/provider/index.d.ts

@@ -1,12 +1,12 @@
-import { D as DataProvider, I as Identifier, B as BaseRecord, j as InvalidationKey, W as WriteEvent } from '../types-DDOmG9hj.js';
-export { A as ArrayFilter, a as BulkChange, b as BulkResult, C as CreateParams, c as CreateResult, d as DeleteParams, e as DeleteResult, F as FilterParam, G as GetManyParams, f as GetManyResult, g as GetOneParams, h as GetOneResult, H as HistoryParams, i as ImportParams, L as ListParams, k as ListResult, N as NullFilter, P as PaginationParam, R as RangeFilter, l as RowFailure, S as ScalarFilter, m as SortParam, U as UpdateParams, n as UpdateResult } from '../types-DDOmG9hj.js';
-import { D as DataReadError, R as ReadOutcome, b as DataWriteError, W as WriteOutcome } from '../read-outcome-kgNhfuST.js';
-export { a as DataReadErrorOptions, c as DataWriteErrorOptions, i as isDataReadError, d as isDataWriteError, r as readFailureMessage } from '../read-outcome-kgNhfuST.js';
+import { D as DataProvider, I as Identifier, B as BaseRecord, j as InvalidationKey, W as WriteEvent } from '../types-CS9UpxQS.js';
+export { A as ArrayFilter, a as BulkChange, b as BulkResult, C as CreateParams, c as CreateResult, d as DeleteParams, e as DeleteResult, F as FilterParam, G as GetManyParams, f as GetManyResult, g as GetOneParams, h as GetOneResult, H as HistoryParams, i as ImportParams, L as ListParams, k as ListResult, N as NullFilter, P as PaginationParam, R as RangeFilter, l as ResourceChangeEvent, m as RowFailure, S as ScalarFilter, n as SortParam, o as SubscribeParams, U as UpdateParams, p as UpdateResult } from '../types-CS9UpxQS.js';
+import { D as DataReadError, R as ReadOutcome, b as DataWriteError, W as WriteOutcome } from '../read-outcome-C_9HbXvb.js';
+export { a as DataReadErrorOptions, c as DataWriteErrorOptions, i as isDataReadError, d as isDataWriteError, r as readFailureMessage } from '../read-outcome-C_9HbXvb.js';
 import * as react from 'react';
 import { ReactNode } from 'react';
 import { QueryClient } from '@tanstack/react-query';
 import { S as StorageAdapter } from '../types-DKcxHXxq.js';
-import '../types-5cuflvha.js';
+import '../types-C7FJtFXV.js';
 import '../form-types.js';
 
 interface MockProviderOptions {
@@ -37,6 +37,7 @@ interface SupabaseQueryBuilder {
     or(filters: string): SupabaseQueryBuilder;
     order(column: string, options?: {
         ascending?: boolean;
+        nullsFirst?: boolean;
     }): SupabaseQueryBuilder;
     range(from: number, to: number): SupabaseQueryBuilder;
     single(): SupabaseQueryBuilder;
@@ -55,6 +56,35 @@ interface SupabaseQueryBuilder {
  */
 interface SupabaseClient {
     from(table: string): SupabaseQueryBuilder;
+    /** Supabase Realtime; needed only for `subscribe` (see `SupabaseProviderOptions.realtime`). */
+    channel?(name: string): SupabaseRealtimeChannel;
+    /** Releases a channel made by `channel()`. */
+    removeChannel?(channel: SupabaseRealtimeChannel): unknown;
+}
+/**
+ * One `postgres_changes` message, as Supabase Realtime sends it. Only the
+ * fields the provider reads; a real payload has more.
+ */
+interface SupabaseRealtimePayload {
+    eventType: "INSERT" | "UPDATE" | "DELETE";
+    /** The row after an insert or update (empty for a delete). */
+    new?: Record<string, unknown>;
+    /** For a delete or update: the old row's key (all of it with `REPLICA IDENTITY FULL`). */
+    old?: Record<string, unknown>;
+}
+/**
+ * The part of a Supabase `RealtimeChannel` the provider uses. A real
+ * `@supabase/supabase-js` channel satisfies it.
+ */
+interface SupabaseRealtimeChannel {
+    on(type: "postgres_changes", filter: {
+        event: "*" | "INSERT" | "UPDATE" | "DELETE";
+        schema: string;
+        table: string;
+        filter?: string;
+    }, callback: (payload: SupabaseRealtimePayload) => void): SupabaseRealtimeChannel;
+    subscribe(callback?: (status: string, error?: unknown) => void): SupabaseRealtimeChannel;
+    unsubscribe?(): unknown;
 }
 /**
  * What `createSupabaseProvider` actually requires from its `client` argument
@@ -72,6 +102,9 @@ interface SupabaseClient {
  */
 interface SupabaseClientInput {
     from(table: string): unknown;
+    /** Supabase Realtime, for `subscribe`. Any real client's `channel` fits. */
+    channel?(name: string): unknown;
+    removeChannel?(channel: unknown): unknown;
 }
 /** What a write hook is told about the write it is part of. */
 interface SupabaseWriteContext {
@@ -138,6 +171,14 @@ interface SupabaseResourceConfig {
      * `useResource` and `useResourceForm` invalidate after their writes.
      */
     invalidates?: InvalidationKey[] | ((event: WriteEvent) => InvalidationKey[]);
+    /**
+     * Serve `subscribe` for this resource through Supabase Realtime
+     * (`postgres_changes`), so `live` lists and records refresh when the table
+     * changes. The table must be in the `supabase_realtime` publication, with
+     * RLS on. `false` turns it off even when `SupabaseProviderOptions.realtime`
+     * covers the resource.
+     */
+    realtime?: boolean;
 }
 /** Options for `createSupabaseProvider`. All optional; none changes reads. */
 interface SupabaseProviderOptions {
@@ -175,6 +216,13 @@ interface SupabaseProviderOptions {
         resource: string;
         operation: "getList" | "getOne" | "getMany";
     }) => void | Promise<void>;
+    /**
+     * Which resources `subscribe` serves through Supabase Realtime: `true` for
+     * all, a list of names, or a test. Off by default; a resource's own
+     * `resources[name].realtime` wins. Needs a client with `channel()` (any
+     * `@supabase/supabase-js` client).
+     */
+    realtime?: boolean | readonly string[] | ((resource: string) => boolean);
 }
 /**
  * The Supabase data provider. Reads and writes go through the client you
@@ -310,4 +358,4 @@ type GenesisProviderProps = {
  */
 declare function GenesisProvider({ children, provider, mock, storage, queryClient: queryClientProp, }: GenesisProviderProps): react.JSX.Element;
 
-export { BaseRecord, DataProvider, DataProviderRoot, type DataProviderRootProps, DataReadError, DataWriteError, GenesisProvider, type GenesisProviderProps, Identifier, InvalidationKey, type MockProviderOptions, type PostgrestFieldErrors, ReadOutcome, type SupabaseClient, type SupabaseClientInput, type SupabaseProviderOptions, type SupabaseResourceConfig, type SupabaseWriteContext, WriteEvent, WriteOutcome, createMockProvider, createSupabaseProvider, fieldErrorsFromPostgrest, readOutcomeFromCode, toDataWriteError, useDataProvider, useStorage, writeOutcomeFromCode };
+export { BaseRecord, DataProvider, DataProviderRoot, type DataProviderRootProps, DataReadError, DataWriteError, GenesisProvider, type GenesisProviderProps, Identifier, InvalidationKey, type MockProviderOptions, type PostgrestFieldErrors, ReadOutcome, type SupabaseClient, type SupabaseClientInput, type SupabaseProviderOptions, type SupabaseRealtimeChannel, type SupabaseRealtimePayload, type SupabaseResourceConfig, type SupabaseWriteContext, WriteEvent, WriteOutcome, createMockProvider, createSupabaseProvider, fieldErrorsFromPostgrest, readOutcomeFromCode, toDataWriteError, useDataProvider, useStorage, writeOutcomeFromCode };

package/dist/provider/index.js

@@ -1,4 +1,4 @@
-export { createSupabaseProvider, fieldErrorsFromPostgrest, readOutcomeFromCode, toDataWriteError, writeOutcomeFromCode } from '../chunk-E5VYFAQO.js';
+export { createSupabaseProvider, fieldErrorsFromPostgrest, readOutcomeFromCode, toDataWriteError, writeOutcomeFromCode } from '../chunk-Y475Z7BM.js';
 export { DataReadError, isDataReadError, readFailureMessage } from '../chunk-HUNGCTRA.js';
 export { DataWriteError, isDataWriteError } from '../chunk-5NHR6ZXS.js';
 import '../chunk-RYEXWQFD.js';

package/dist/{read-outcome-kgNhfuST.d.ts → read-outcome-C_9HbXvb.d.ts}

@@ -1,4 +1,4 @@
-import { D as DataRow } from './types-5cuflvha.js';
+import { D as DataRow } from './types-C7FJtFXV.js';
 
 /**
  * - `conflict`: someone else changed the row since it was read. `current`

package/dist/schema/index.d.ts

@@ -1,7 +1,7 @@
-import { e as ResourceContract, D as DataRow } from '../types-5cuflvha.js';
-export { A as AuditEntry, F as FieldPermissions, a as FieldReference, b as FieldSchema, c as FilterOperator, P as ProviderCapabilities, R as RecordComment, d as ResourceAccess, f as ResourceRelation, g as ResourceSchema, h as ResourceSummary, i as RowAction, S as StorageType, V as VersionField } from '../types-5cuflvha.js';
-import { I as Identifier } from '../types-DDOmG9hj.js';
-export { D as DataReadError, a as DataReadErrorOptions, b as DataWriteError, c as DataWriteErrorOptions, R as ReadOutcome, W as WriteOutcome, i as isDataReadError, d as isDataWriteError, r as readFailureMessage } from '../read-outcome-kgNhfuST.js';
+import { e as ResourceContract, D as DataRow } from '../types-C7FJtFXV.js';
+export { A as AuditEntry, F as FieldPermissions, a as FieldReference, b as FieldSchema, c as FilterOperator, P as ProviderCapabilities, R as RecordComment, d as ResourceAccess, f as ResourceRelation, g as ResourceSchema, h as ResourceSummary, i as RowAction, S as StorageType, V as VersionField } from '../types-C7FJtFXV.js';
+import { I as Identifier } from '../types-CS9UpxQS.js';
+export { D as DataReadError, a as DataReadErrorOptions, b as DataWriteError, c as DataWriteErrorOptions, R as ReadOutcome, W as WriteOutcome, i as isDataReadError, d as isDataWriteError, r as readFailureMessage } from '../read-outcome-C_9HbXvb.js';
 export { FieldType as WidgetHint } from '../form-types.js';
 
 /** The key of a contract as a list, whichever form `key` was declared in. */