kosmio 0.1.2 → 0.1.3

package/README.md

@@ -35,3 +35,33 @@ Kosmio ships default CSS variables and expects each app to override them as need
 ```
 
 Every component style uses the public `--kosmio-*` contract.
+
+## App Runtime
+
+`createKosmioApp` accepts the application's platform adapters, router policies, native appearance and offline queue scope resolver. Auth and tenant identity stay owned by the application:
+
+```js
+const app = createKosmioApp({
+  app: { id: "my-app", androidScheme: "site.example.app" },
+  offlineQueue: {
+    resolveScope: () => ({ userId: auth.user.id, tenantId: auth.tenant?.id }),
+  },
+});
+
+const queryClient = app.configure();
+await app.startOfflineSync();
+```
+
+The resolver must return a non-empty `userId`; `tenantId` may be empty for user-level work. Returning `null` or throwing makes queue writes fail closed and stops that sync attempt without selecting a queue. Applications should pass the same active scope to `OfflineSyncProvider` and pause queue sync around session or tenant changes with `pauseOfflineWriteQueueSync()`.
+
+The offline queue and query client are module singletons. Configure one Kosmio app runtime per JavaScript application.
+
+## Agent Skill
+
+Kosmio's agent skill helps coding agents integrate the library using its public components, styles, tokens, and runtime APIs. Install it from the public GitHub repository with the [Vercel Skills CLI](https://www.skills.sh/docs/cli):
+
+```bash
+npx skills add steven-mendoza-z/kosmio --skill pkg
+```
+
+The CLI can install it for a detected agent or agents selected during setup. The skill is maintained at `.agents/skills/pkg` in this repository.

package/dist/OfflineSyncContext-DWQu0vg_.js

@@ -0,0 +1,40 @@
+import { jsx as f } from "react/jsx-runtime";
+import { useSyncExternalStore as a, useMemo as S, useContext as y, createContext as O } from "react";
+import { g, k as m, a as p } from "./offlineWriteQueue-BIJHFYuO.js";
+const d = {
+  isOnline: !0,
+  isSyncing: !1,
+  pendingSyncCount: 0,
+  hasPendingSync: !1,
+  scopeKey: null
+}, i = {
+  isOnline: !0,
+  isSyncing: !1,
+  pendingSyncCount: 0,
+  hasPendingSync: !1
+}, o = O(d), T = () => y(o);
+function P({
+  children: r,
+  scope: n,
+  scopeKey: c,
+  getQueueState: s = p,
+  subscribeQueue: l = m
+}) {
+  const e = n ? String(n.userId ?? "").trim() ? g(n) : null : c ?? null, t = a(
+    l,
+    () => e ? s(e) : i,
+    () => e ? s(e) : i
+  ), u = S(
+    () => ({
+      ...t,
+      scopeKey: e
+    }),
+    [e, t]
+  );
+  return /* @__PURE__ */ f(o.Provider, { value: u, children: r });
+}
+export {
+  d as D,
+  P as O,
+  T as u
+};

package/dist/app.js

@@ -1,84 +1,95 @@
 import { jsx as c } from "react/jsx-runtime";
-import { c as b, b as K, A as k, m as f } from "./systemBars-C3QiEL7z.js";
-import { M as N } from "./MobileRouteTransition-C16D4K5c.js";
-import { N as C } from "./NativeBackButtonHandler-CcLHewdm.js";
-import { q as m } from "./queryClient-ZtNrT-lA.js";
-import { j as P, c as U, g } from "./offlineWriteQueue-C31IjyB_.js";
-const H = "/auth/callback";
-function L(e = {}) {
-  const a = e.colors ?? {}, r = e.statusBarColors ?? (a.light?.statusBar || a.dark?.statusBar ? {
+import { c as N, b as w, A as C, m as P } from "./systemBars-C3QiEL7z.js";
+import { M as g } from "./MobileRouteTransition-C16D4K5c.js";
+import { N as O } from "./NativeBackButtonHandler-CcLHewdm.js";
+import { q as p } from "./queryClient-ZtNrT-lA.js";
+import { j as U, c as H, O as S, g as h } from "./offlineWriteQueue-BIJHFYuO.js";
+const L = "/auth/callback";
+let m = null;
+function I(e = {}) {
+  const a = e.colors ?? {}, o = e.statusBarColors ?? (a.light?.statusBar || a.dark?.statusBar ? {
     light: a.light?.statusBar,
     dark: a.dark?.statusBar
-  } : void 0), o = e.navigationBarColors ?? (a.light?.navigationBar || a.dark?.navigationBar ? {
+  } : void 0), r = e.navigationBarColors ?? (a.light?.navigationBar || a.dark?.navigationBar ? {
     light: a.light?.navigationBar,
     dark: a.dark?.navigationBar
   } : void 0);
   return {
-    statusBarColors: r,
-    navigationBarColors: o
+    statusBarColors: o,
+    navigationBarColors: r
   };
 }
-function O(e = {}) {
-  const a = e.disabledRouteKeys ?? [], r = e.rules ?? [];
-  return [...a.map((s) => ({
-    id: `${s}-no-transition`,
-    routeKey: s,
+function M(e = {}) {
+  const a = e.disabledRouteKeys ?? [], o = e.rules ?? [];
+  return [...a.map((n) => ({
+    id: `${n}-no-transition`,
+    routeKey: n,
     enabled: !1
-  })), ...r];
+  })), ...o];
 }
-function M(e = {}) {
+function $(e = {}) {
   return typeof e.resolveScopeKey == "function" ? e.resolveScopeKey : async () => {
-    const a = typeof e.resolveUser == "function" ? await e.resolveUser() : e.userId, r = typeof e.resolveTenant == "function" ? await e.resolveTenant() : e.tenantId;
-    return g({
+    if (typeof e.resolveScope == "function") {
+      const r = await e.resolveScope();
+      if (!r || !String(r.userId ?? "").trim())
+        throw new S();
+      return h(r);
+    }
+    const a = typeof e.resolveUser == "function" ? await e.resolveUser() : e.userId, o = typeof e.resolveTenant == "function" ? await e.resolveTenant() : e.tenantId;
+    if (!String(a ?? "").trim())
+      throw new S();
+    return h({
       userId: a,
-      tenantId: r
+      tenantId: o
     });
   };
 }
-function D(e = {}) {
-  const a = e.capacitor?.runtime ?? e.capacitor, r = e.capacitor?.app, o = e.capacitor?.registerPlugin, s = e.app?.id ?? "kosmio", p = b({
-    capacitor: a,
+function W(e = {}) {
+  const a = /* @__PURE__ */ Symbol("kosmio-app-runtime"), o = e.capacitor?.runtime ?? e.capacitor, r = e.capacitor?.app, n = e.capacitor?.registerPlugin, d = e.app?.id ?? "kosmio", y = N({
+    capacitor: o,
     androidAppScheme: e.app?.androidScheme ?? e.app?.androidAppScheme ?? "app",
-    authCallbackPath: e.auth?.callbackPath ?? H,
+    authCallbackPath: e.auth?.callbackPath ?? L,
     nativeAuthHost: e.auth?.nativeHost,
     nativeAuthPath: e.auth?.nativePath
-  }), i = p.isNativeApp(), n = e.mobileTransitions ?? {}, u = n.stateKey ?? `${s}MobileTransitionDirection`, d = O(n), y = e.router?.matchLocalizedRoute ?? e.matchRoute, { statusBarColors: v, navigationBarColors: S } = L(e.systemBars), l = K({
-    registerPlugin: o,
+  }), i = y.isNativeApp(), s = e.mobileTransitions ?? {}, u = s.stateKey ?? `${d}MobileTransitionDirection`, v = M(s), B = e.router?.matchLocalizedRoute ?? e.matchRoute, { statusBarColors: R, navigationBarColors: f } = I(e.systemBars), l = w({
+    registerPlugin: n,
     isNative: i,
     pluginName: e.systemBars?.pluginName,
-    pluginKey: e.systemBars?.pluginKey ?? `__${s}SystemBarsPlugin`,
-    statusBarColors: v,
-    navigationBarColors: S
+    pluginKey: e.systemBars?.pluginKey ?? `__${d}SystemBarsPlugin`,
+    statusBarColors: R,
+    navigationBarColors: f
   });
-  function B() {
-    return e.offlineQueue && U({
+  function b() {
+    if (m && m !== a)
+      throw new Error("Only one Kosmio app runtime may configure the offline queue per application.");
+    return e.offlineQueue && H({
       storagePrefix: e.offlineQueue.storagePrefix,
-      resolveScopeKey: M(e.offlineQueue),
-      invalidateQueries: e.offlineQueue.invalidateQueries ?? (() => m.invalidateQueries()),
+      resolveScopeKey: $(e.offlineQueue),
+      invalidateQueries: e.offlineQueue.invalidateQueries ?? (() => p.invalidateQueries()),
       appStateAdapter: e.offlineQueue.appStateAdapter ?? (i ? r : null)
-    }), m;
+    }), m = a, p;
   }
-  function h() {
-    return P();
+  function A() {
+    return U();
   }
-  function R(t) {
+  function T(t) {
     return /* @__PURE__ */ c(
-      k,
+      C,
       {
         app: t?.app ?? r,
         isNative: t?.isNative ?? i,
-        mapUrlToRoute: t?.mapUrlToRoute ?? e.mapAppUrlToRoute ?? f
+        mapUrlToRoute: t?.mapUrlToRoute ?? e.mapAppUrlToRoute ?? P
       }
     );
   }
-  function A(t) {
+  function K(t) {
     return /* @__PURE__ */ c(
-      C,
+      O,
       {
         app: t?.app ?? r,
         isNative: t?.isNative ?? i,
         router: t?.router ?? e.router,
-        mainRouteKeys: t?.mainRouteKeys ?? n.mainRouteKeys,
+        mainRouteKeys: t?.mainRouteKeys ?? s.mainRouteKeys,
         transitionStateKey: t?.transitionStateKey ?? u,
         closeableSelectSelectors: t?.closeableSelectSelectors,
         selectSheetBackdropSelector: t?.selectSheetBackdropSelector,
@@ -87,37 +98,37 @@ function D(e = {}) {
       }
     );
   }
-  function T(t) {
+  function k(t) {
     return /* @__PURE__ */ c(
-      N,
+      g,
       {
         ...t,
         router: t?.router ?? e.router,
-        matchRoute: t?.matchRoute ?? y,
-        rules: t?.rules ?? d,
+        matchRoute: t?.matchRoute ?? B,
+        rules: t?.rules ?? v,
         stateKey: t?.stateKey ?? u,
-        defaultTransition: t?.defaultTransition ?? n.defaultTransition
+        defaultTransition: t?.defaultTransition ?? s.defaultTransition
       }
     );
   }
   return {
-    ...p,
-    AppUrlListener: R,
-    MobileRouteTransition: T,
-    NativeBackButtonHandler: A,
-    configure: B,
-    queryClient: m,
-    startOfflineSync: h,
+    ...y,
+    AppUrlListener: T,
+    MobileRouteTransition: k,
+    NativeBackButtonHandler: K,
+    configure: b,
+    queryClient: p,
+    startOfflineSync: A,
     systemBars: l,
     getSystemBarsPlugin: l.getSystemBarsPlugin,
     markNativeAppReady: l.markNativeAppReady,
     syncSystemBarsTheme: l.syncSystemBarsTheme,
     mobileTransitions: {
-      rules: d,
+      rules: v,
       stateKey: u
     }
   };
 }
 export {
-  D as createKosmioApp
+  W as createKosmioApp
 };

package/dist/context.js

@@ -1,5 +1,5 @@
 import { F as o, a, P as s, V as i, c as t, u, b as n, d as F, e as p } from "./ViewportContext-z-ZwlTIZ.js";
-import { D as c, O as d, u as f } from "./OfflineSyncContext-CRwPM5kh.js";
+import { D as c, O as d, u as f } from "./OfflineSyncContext-DWQu0vg_.js";
 export {
   c as DEFAULT_OFFLINE_SYNC_STATE,
   o as FloatingActionsProvider,

package/dist/core.js

@@ -1,55 +1,57 @@
 import { c as s } from "./classNames-CcykAxZN.js";
-import { A as r, E as i, a as u, F as o, b as l, c as n, d as f, e as c, f as y, g as m, i as p, k as d, h as Q, m as g, j as k, l as O, r as S, t as h, n as W, o as C } from "./localizedRouter-BjT5yIzl.js";
-import { c as b, a as E, b as R, g as x, i as q, d as M, m as v, n as F, p as H, r as K, s as A, v as j } from "./shortcuts-n31uRPcv.js";
-import { c as D, e as P, g as w, a as L, i as B, b as G, d as I, f as J, r as N, h as U, s as V, j as X, k as Y } from "./offlineWriteQueue-C31IjyB_.js";
-import { c as _, q as $ } from "./queryClient-ZtNrT-lA.js";
+import { A as r, E as i, a as u, F as o, b as l, c as n, d as f, e as c, f as y, g as p, i as m, k as d, h as Q, m as O, j as S, l as g, r as k, t as W, n as h, o as b } from "./localizedRouter-CNO61cBH.js";
+import { c as E, a as T, b as R, g as x, i as q, d as v, m as M, n as F, p as H, r as K, s as A, v as j } from "./shortcuts-n31uRPcv.js";
+import { O as D, c as P, e as w, g as L, a as U, i as B, b as G, d as I, f as J, p as N, r as V, h as X, s as Y, j as Z, k as _ } from "./offlineWriteQueue-BIJHFYuO.js";
+import { c as ee, q as ae } from "./queryClient-ZtNrT-lA.js";
 export {
   r as ApiClient,
   i as Entity,
   u as EntityModelFactory,
   o as Field,
   l as FieldTypes,
+  D as OfflineQueueScopeUnavailableError,
   n as buildRoutePath,
-  b as clamp,
-  D as configureOfflineWriteQueue,
+  E as clamp,
+  P as configureOfflineWriteQueue,
   f as createEntityModels,
   c as createEntityResource,
   y as createEnumType,
-  _ as createKosmioQueryClient,
-  m as createLocalizedRouter,
-  E as createShortcutMatcher,
+  ee as createKosmioQueryClient,
+  p as createLocalizedRouter,
+  T as createShortcutMatcher,
   R as createStaggerDelay,
   s as cx,
-  P as enqueueOfflineWrite,
-  w as getOfflineWriteQueueScopeKey,
-  L as getOfflineWriteQueueState,
+  w as enqueueOfflineWrite,
+  L as getOfflineWriteQueueScopeKey,
+  U as getOfflineWriteQueueState,
   x as getRevealStyle,
   q as isEditableTarget,
-  p as isEnumType,
+  m as isEnumType,
   B as isOfflineQueueCanceledResult,
   G as isOfflineQueueHandledResult,
   I as isOfflineQueueQueuedResult,
   J as isQueueableWriteRequest,
-  M as isTypingTarget,
+  v as isTypingTarget,
   d as keysToCamel,
   Q as keysToSnake,
-  g as makeCrudHooks,
-  k as makeMutationHook,
-  O as makeQueryHook,
-  v as motion,
+  O as makeCrudHooks,
+  S as makeMutationHook,
+  g as makeQueryHook,
+  M as motion,
   F as normalizeShortcutKey,
   H as parseShortcutKeys,
-  $ as queryClient,
-  N as registerOfflineWriteClient,
-  U as requestOfflineWriteQueueSync,
-  S as resolveTypeDescriptor,
+  N as pauseOfflineWriteQueueSync,
+  ae as queryClient,
+  V as registerOfflineWriteClient,
+  X as requestOfflineWriteQueueSync,
+  k as resolveTypeDescriptor,
   K as rowAppearStyle,
   A as shortcutMatches,
-  V as shouldQueueOfflineWrite,
-  X as startOfflineWriteQueueSync,
-  Y as subscribeOfflineWriteQueue,
-  h as toCamel,
-  W as toPascalCase,
-  C as toSnake,
+  Y as shouldQueueOfflineWrite,
+  Z as startOfflineWriteQueueSync,
+  _ as subscribeOfflineWriteQueue,
+  W as toCamel,
+  h as toPascalCase,
+  b as toSnake,
   j as variants
 };