@tailorkit/client-core 0.1.0-beta.23 → 0.1.0-beta.24

package/dist/store/local/slot-runtime.d.ts

@@ -0,0 +1,36 @@
+import type { Session, ViewInstance } from "@tailorkit/app/client";
+import type { ViewStatus } from "@tailorkit/core/views";
+import type { RuntimeSlotProps } from "../../client/slot-types";
+import type { TailorKitStore } from "../store";
+export type SlotRuntimeOptions = RuntimeSlotProps & ({
+    mode: "managed";
+} | {
+    mode: "controlled";
+    view: string;
+    context?: unknown;
+    status: ViewStatus;
+    instance?: ViewInstance;
+});
+export type SlotRuntimeSnapshot = {
+    status: "hidden";
+} | {
+    status: "loading";
+    message: string;
+} | {
+    status: "error";
+    error: Error;
+} | {
+    status: "render";
+    appUrl: string;
+    sourceText?: string;
+    hostKey: string | number;
+    props: Record<string, unknown>;
+    getBackendSession: (options: {
+        refresh: boolean;
+    }) => Promise<Session>;
+};
+/** Resolve a managed or controlled slot; adapters only render its snapshot. */
+export declare function createSlotRuntime(store: TailorKitStore, initial: SlotRuntimeOptions): {
+    state: import("nanostores").ReadableAtom<SlotRuntimeSnapshot>;
+    setInput(options: SlotRuntimeOptions): void;
+};

package/dist/store/local/view-context-diagnostics.d.ts

@@ -0,0 +1,10 @@
+import type { TailorKitSchemaSpecType } from "@tailorkit/core/spec";
+import type { ViewEntry } from "./view-context";
+type Definition = TailorKitSchemaSpecType["views"][string];
+interface Diagnostic {
+    message: string;
+    details?: unknown;
+}
+/** Cache validators by schema identity; metadata refreshes can replace schemas. */
+export declare function createViewContextDiagnostics(): (entry: ViewEntry, definition: Definition | undefined) => Diagnostic | null;
+export {};

package/dist/store/local/view-context-types.d.ts

@@ -0,0 +1,21 @@
+import type { ViewDefinition } from "@tailorkit/core/schema";
+type DefaultViews = Record<`/${string}`, ViewDefinition>;
+export type ViewName<TViews extends Record<string, ViewDefinition>> = keyof TViews & string;
+export type ViewContext<TView> = TView extends ViewDefinition ? NonNullable<TView["~standard"]["types"]>["output"] : Record<string, never>;
+export interface ViewContextState<TContext = unknown> {
+    /** The complete context for this view, or undefined while it is unavailable. */
+    context: TContext | undefined;
+    /** Defaults to false. Loading views do not publish context. */
+    loading?: boolean;
+    /** Takes precedence over loading. Error views do not publish context. */
+    error?: Error | null;
+}
+export type ViewState<TViews extends Record<string, ViewDefinition> = DefaultViews, TView extends ViewName<TViews> = ViewName<TViews>> = ViewContextState<ViewContext<TViews[TView]>>;
+export type ViewOptions<TViews extends Record<string, ViewDefinition> = DefaultViews, TView extends ViewName<TViews> = ViewName<TViews>> = TView extends ViewName<TViews> ? ViewState<TViews, TView> & {
+    view: TView;
+} : never;
+export interface ViewContextRegistration<TContext = unknown> extends ViewContextState<TContext> {
+    id: symbol;
+    view: string;
+}
+export {};

package/dist/store/local/{view-registry.d.ts → view-context.d.ts}

@@ -1,4 +1,6 @@
 import type { ActiveView, ViewStatus } from "@tailorkit/core/views";
+import type { TailorKitFetchClient } from "../../client/fetch-client";
+import type { ViewContextRegistration } from "./view-context-types";
 export interface ViewEntry {
     id: symbol;
     view: string;
@@ -6,10 +8,11 @@ export interface ViewEntry {
     status: ViewStatus;
     order: number;
 }
-export declare function createViewRegistry(): {
+/** Own view state and diagnostics independently of any framework adapter. */
+export declare function createViewContextStore(client: TailorKitFetchClient): {
     state: import("nanostores").PreinitializedWritableAtom<ActiveView | null> & object;
     getSnapshot: () => ActiveView | null;
     subscribe: (listener: () => void) => (() => void);
-    register(entry: Omit<ViewEntry, "order">): void;
+    register(input: ViewContextRegistration): void;
     unregister(id: symbol): void;
 };

package/dist/store/query.d.ts

@@ -0,0 +1,39 @@
+import type { ReadableAtom } from "nanostores";
+import type { TailorKitApp } from "../types";
+import type { TailorKitStore } from "./store";
+import type { FetchSnapshot } from "./fetch/cache";
+import type { SlotItem } from "./fetch/slot";
+import type { ViewsQueryOptions } from "../client/views";
+export interface AppsQueryOptions<TScopeNames extends string = string> {
+    scopes?: readonly TScopeNames[];
+    appIds?: readonly string[];
+}
+export interface QueryResult<T> {
+    data: T | undefined;
+    error: Error | null;
+    status: FetchSnapshot<unknown>["status"];
+    isFetching: boolean;
+    isError: boolean;
+    isLoading: boolean;
+    isPending: boolean;
+    isSuccess: boolean;
+    refetch: () => Promise<void>;
+}
+export type ViewsQueryResult<TMultiple extends boolean = boolean> = QueryResult<SlotItem<TMultiple>[]>;
+export declare function appsQueryKey(options: AppsQueryOptions): string;
+/** Discover and filter apps, with the same result shape in every framework. */
+export declare function createAppsQuery(store: TailorKitStore, options?: AppsQueryOptions): {
+    state: ReadableAtom<QueryResult<TailorKitApp[]>>;
+    refetch: () => Promise<void>;
+    fetch: (options?: import("./fetch").FetchOptions) => Promise<void>;
+};
+/** Resolve a slot reactively as discovery, metadata, and registered context change. */
+export declare function createViewsQuery(store: TailorKitStore, options: ViewsQueryOptions): {
+    state: ReadableAtom<ViewsQueryResult<boolean>>;
+    refetch: () => Promise<void>;
+};
+/** Resolve an explicitly supplied app without initiating discovery. */
+export declare function createAppViewsQuery(store: TailorKitStore, app: TailorKitApp, slot: string): {
+    state: ReadableAtom<ViewsQueryResult<boolean>>;
+    refetch: () => Promise<void>;
+};

package/dist/store/snapshot-store.d.ts

@@ -0,0 +1,5 @@
+import type { ReadableAtom } from "nanostores";
+/** Expose cache snapshots as a Nano Store with immediate observer cleanup. */
+export declare function createSnapshotStore<T>(getSnapshot: () => T, subscribe: (listener: () => void) => () => void): ReadableAtom<T>;
+/** Follow a selected store and detach the previous reader immediately. */
+export declare function switchStore<T>(selection: ReadableAtom<ReadableAtom<T>>): ReadableAtom<T>;

package/dist/store/store.d.ts

@@ -37,19 +37,21 @@ export declare function createTailorKitStore(baseUrl: string | URL, initialApps?
             setProvidedApps(apps: TailorKitApp[] | undefined): void;
             updateViews(appId: string, appViews: NonNullable<TailorKitApp["views"]>): void;
             invalidate: () => Promise<void>;
+            state: import("nanostores").ReadableAtom<import("./fetch").TailorKitAppsSnapshot>;
         };
         meta: {
             getSnapshot(): import("./fetch").TailorKitMetaSnapshot;
             subscribe: (listener: () => void) => () => void;
             fetch: (options?: import("./fetch").FetchOptions) => Promise<void>;
             invalidate: () => Promise<void>;
+            state: import("nanostores").ReadableAtom<import("./fetch").TailorKitMetaSnapshot>;
         };
     };
     views: {
         state: import("nanostores").PreinitializedWritableAtom<import("@tailorkit/core/views").ActiveView | null> & object;
         getSnapshot: () => import("@tailorkit/core/views").ActiveView | null;
         subscribe: (listener: () => void) => (() => void);
-        register(entry: Omit<import("./local").ViewEntry, "order">): void;
+        register(input: import("./local").ViewContextRegistration): void;
         unregister(id: symbol): void;
     };
     setProvidedApps: (apps: TailorKitApp[] | undefined) => void;
@@ -64,5 +66,6 @@ export declare function createTailorKitStore(baseUrl: string | URL, initialApps?
         updateApp: (app: TailorKitApp) => void;
         subscribe: (app: TailorKitApp, listener: () => void) => (() => void);
         dispose: () => void;
+        getStore(getApp: () => TailorKitApp): import("nanostores").ReadableAtom<import("./fetch").PreviewSnapshot>;
     };
 };

package/dist/store-fetch.js

@@ -1,13 +1,14 @@
 import {
   createAppsStore,
   createMetadataStore,
-  createPreviewManager,
-  createSlotStore
-} from "./chunk-K3QITWU4.js";
+  createPreviewManager
+} from "./chunk-CWDPTXSZ.js";
+import "./chunk-FUBKKH3Q.js";
 import {
   createFetchCache,
+  createSlotStore,
   serializeCacheKey
-} from "./chunk-RNTQ3LLF.js";
+} from "./chunk-BLDTSDUG.js";
 export {
   createAppsStore,
   createFetchCache,

package/dist/store-local.js

@@ -1,8 +1,16 @@
 import {
   NodeStore,
-  createViewRegistry
-} from "./chunk-ED3BWTXG.js";
+  createRemoteElementProps,
+  createRemoteViewStore,
+  createSlotRuntime,
+  createViewContextStore
+} from "./chunk-N4X53WS2.js";
+import "./chunk-LNGQREZV.js";
+import "./chunk-BLDTSDUG.js";
 export {
   NodeStore,
-  createViewRegistry
+  createRemoteElementProps,
+  createRemoteViewStore,
+  createSlotRuntime,
+  createViewContextStore
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tailorkit/client-core",
-  "version": "0.1.0-beta.23",
+  "version": "0.1.0-beta.24",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
@@ -34,10 +34,11 @@
     "access": "public"
   },
   "dependencies": {
-    "@tailorkit/app": "0.1.0-beta.23",
-    "@tailorkit/client-platform": "0.1.0-beta.23",
-    "@tailorkit/core": "0.1.0-beta.23",
-    "@tailorkit/sandbox": "0.1.0-beta.23",
+    "@nanostores/async": "0.1.0",
+    "@tailorkit/app": "0.1.0-beta.24",
+    "@tailorkit/client-platform": "0.1.0-beta.24",
+    "@tailorkit/core": "0.1.0-beta.24",
+    "@tailorkit/sandbox": "0.1.0-beta.24",
     "nanostores": "1.5.4"
   },
   "devDependencies": {

package/dist/chunk-DPR3U4U2.js

@@ -1,57 +0,0 @@
-import {
-  createEndpointClient,
-  createFetchCache
-} from "./chunk-RNTQ3LLF.js";
-
-// src/client/fetch-client.ts
-function createTailorKitFetchClient(options) {
-  const endpoints = createEndpointClient(options);
-  const cache = createFetchCache(options.cache);
-  const baseUrl = endpoints.baseUrl;
-  const prefix = ["tailorkit", baseUrl.toString()];
-  return {
-    baseUrl,
-    endpoints,
-    cache,
-    cacheOptions: options.cache,
-    apps: (settings = {}) => cache.getStore([...prefix, "apps"], endpoints.apps, { ...options.cache?.apps, ...settings }),
-    meta: (settings = {}) => cache.getStore([...prefix, "meta"], endpoints.meta, { ...options.cache?.meta, ...settings }),
-    clear() {
-      cache.clear();
-      endpoints.clearSessions();
-    }
-  };
-}
-
-// src/client/apps.ts
-function matchesApp(app, scopes, appIds) {
-  return (scopes === void 0 || app.scope !== void 0 && scopes.includes(app.scope.name)) && (appIds === void 0 || appIds.includes(app.id));
-}
-
-// src/client/scope-query.ts
-function appendScopeSelection(url, scopes) {
-  if (scopes === void 0) {
-    return;
-  }
-  if (scopes.length === 0) {
-    url.searchParams.append("scopes", "");
-    return;
-  }
-  for (const scope of scopes) {
-    url.searchParams.append("scopes", scope);
-  }
-}
-function normalizeScopeSelection(scopes) {
-  if (scopes === void 0) {
-    return { key: "*" };
-  }
-  const names = [...new Set(scopes)].sort();
-  return { key: JSON.stringify(names), scopes: names };
-}
-
-export {
-  createTailorKitFetchClient,
-  matchesApp,
-  appendScopeSelection,
-  normalizeScopeSelection
-};

package/dist/chunk-ED3BWTXG.js

@@ -1,128 +0,0 @@
-// src/store/local/node-store.ts
-import { atom, computed } from "nanostores";
-var childIds = (children) => children.map((c) => c.id).join(",");
-var nodeSignature = (node) => {
-  if (node.kind === "text") {
-    return `text:${node.text}`;
-  }
-  if (node.kind === "fragment") {
-    return `frag:${childIds(node.children)}`;
-  }
-  const propsStr = JSON.stringify(node.props);
-  const callbacksStr = (node.callbacks ?? []).map((binding) => `${binding.callback}:${binding.event}:${binding.inputCount}`).join(",");
-  return `elem:${node.type}|${childIds(node.children)}|${propsStr}|${callbacksStr}`;
-};
-var flattenTree = (node, out) => {
-  out.set(node.id, node);
-  if (node.kind === "text") {
-    return;
-  }
-  for (const child of node.children) {
-    flattenTree(child, out);
-  }
-};
-var NodeStore = class {
-  state = atom({ nodes: /* @__PURE__ */ new Map(), rootId: null });
-  signatures = /* @__PURE__ */ new Map();
-  clear() {
-    this.signatures.clear();
-    this.state.set({ nodes: /* @__PURE__ */ new Map(), rootId: null });
-  }
-  setSnapshot(tree) {
-    const previous = this.state.get();
-    const next = /* @__PURE__ */ new Map();
-    flattenTree(tree, next);
-    let changed = previous.rootId !== tree.id || previous.nodes.size !== next.size;
-    for (const [id, node] of next) {
-      const signature = nodeSignature(node);
-      const previousNode = previous.nodes.get(id);
-      if (previousNode && this.signatures.get(id) === signature) {
-        next.set(id, previousNode);
-      } else {
-        changed = true;
-        this.signatures.set(id, signature);
-      }
-    }
-    for (const id of this.signatures.keys()) {
-      if (!next.has(id)) {
-        this.signatures.delete(id);
-      }
-    }
-    if (changed) {
-      this.state.set({ nodes: next, rootId: tree.id });
-    }
-  }
-  getRootId() {
-    return this.state.get().rootId;
-  }
-  getNode(id) {
-    return this.state.get().nodes.get(id) ?? null;
-  }
-  subscribe(id, listener) {
-    const node = computed(this.state, (snapshot) => snapshot.nodes.get(id) ?? null);
-    return node.listen(listener);
-  }
-  subscribeRoot(listener) {
-    const root = computed(this.state, (snapshot) => snapshot.rootId);
-    return root.listen(listener);
-  }
-};
-
-// src/store/local/view-registry.ts
-import { atom as atom2 } from "nanostores";
-import { getViewDepth, isViewAncestor } from "@tailorkit/core/views";
-function createViewRegistry() {
-  const entries = /* @__PURE__ */ new Map();
-  const state = atom2(null);
-  let nextOrder = 0;
-  let scheduled = false;
-  const publish = () => {
-    if (scheduled) {
-      return;
-    }
-    scheduled = true;
-    queueMicrotask(() => {
-      scheduled = false;
-      const ordered = [...entries.values()].toSorted(
-        (a, b) => getViewDepth(b.view) - getViewDepth(a.view) || b.order - a.order
-      );
-      const selected = ordered[0];
-      if (selected) {
-        const peers = ordered.filter(
-          (entry) => getViewDepth(entry.view) === getViewDepth(selected.view)
-        );
-        if (peers.length > 1) {
-          console.warn(
-            `TailorKit found multiple active views at the same hierarchy depth: ${peers.toReversed().map((entry) => `"${entry.view}"`).join(
-              ", "
-            )}. TailorKit selected "${selected.view}" by mount order. Only one route at a hierarchy depth should register a view.`
-          );
-        }
-        state.set({
-          view: selected.view,
-          layers: ordered.filter((entry) => isViewAncestor(entry.view, selected.view)).toReversed().map((entry) => ({ path: entry.view, context: entry.context, status: entry.status }))
-        });
-      } else {
-        state.set(null);
-      }
-    });
-  };
-  return {
-    state,
-    getSnapshot: () => state.get(),
-    subscribe: (listener) => state.listen(listener),
-    register(entry) {
-      entries.set(entry.id, { ...entry, order: entries.get(entry.id)?.order ?? nextOrder++ });
-      publish();
-    },
-    unregister(id) {
-      entries.delete(id);
-      publish();
-    }
-  };
-}
-
-export {
-  createViewRegistry,
-  NodeStore
-};