@multiplatform.one/core 6.0.4 → 6.3.0

package/README.md

@@ -0,0 +1,57 @@
+# @multiplatform.one/core
+
+App shell for multiplatform.one: provider composition (`createApp`), root
+layout factories, and default screen layouts — so an app wires TanStack Query,
+Keycloak, Frappe, Web3, and theming in one declaration.
+
+## Install
+
+```bash
+pnpm add @multiplatform.one/core
+```
+
+Heavy integrations (`@multiplatform.one/keycloak`, `frappe`, `frappe-ui`,
+`web3`, `@tanstack/react-query`, `one`, `tamagui`, …) are **peer dependencies**
+and lazy-loaded — install only the ones your app enables.
+
+## What it owns
+
+- **`createApp(config)`** — returns `{ AppProvider, withApp, useAppConfig }`;
+  composes providers outermost → innermost:
+  config → TanStack → Web3 → Keycloak → Frappe → custom providers → Theme
+- **`createRootLayout(config)`** — platform-split root layout (web/native) with
+  head, Sentry, and loader-data handling
+- **`createDefaultLayout(options)`** / `createTanstackProvider` — screen layout
+  and query-client factories
+
+## What it must not do
+
+- No screens and no UI catalog — this package is wiring, not widgets
+- No direct Frappe/Keycloak/Web3 implementations — it composes the dedicated
+  packages behind lazy provider boundaries
+
+## Usage
+
+```tsx
+import { createApp } from "@multiplatform.one/core";
+import { themeConfig } from "@package/config";
+
+const { AppProvider } = createApp({
+  theme: themeConfig,
+  tanstack: true, // TanStack Query with defaults (devtools in dev)
+  keycloak: true, // read settings from env config
+  frappe: true,
+});
+
+export function App({ children }) {
+  return <AppProvider>{children}</AppProvider>;
+}
+```
+
+Pass `true` to a provider slot to read all settings from env config, or an
+object (`TanstackConfig`, `KeycloakConfig`, `FrappeConfig`, `Web3AppConfig`)
+to configure explicitly. Disabled slots add zero bundle weight.
+
+## License
+
+Apache-2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@multiplatform.one/core",
-  "version": "6.0.4",
+  "version": "6.3.0",
   "description": "Core framework shell, provider composition, and layout factories for multiplatform.one",
   "keywords": [
     "app",
@@ -9,21 +9,31 @@
   ],
   "license": "Apache-2.0",
   "author": "BitSpur",
+  "repository": {
+    "type": "git",
+    "url": "git+https://gitlab.com/bitspur/frappe/multiplatform.one.git",
+    "directory": "public/core"
+  },
   "source": "src/index.ts",
+  "files": [
+    "src",
+    "types",
+    "!types/.tsbuildinfo"
+  ],
   "sideEffects": true,
   "main": "src/index.ts",
   "module": "src/index.ts",
-  "types": "src/index.ts",
+  "types": "types/index.d.ts",
   "exports": {
     "./package.json": "./package.json",
     "./healthz": {
-      "types": "./src/healthz.ts",
+      "types": "./types/healthz.d.ts",
       "source": "./src/healthz.ts",
       "default": "./src/healthz.ts"
     },
     ".": {
       "source": "./src/index.ts",
-      "types": "./src/index.ts",
+      "types": "./types/index.d.ts",
       "default": "./src/index.ts"
     }
   },
@@ -36,12 +46,12 @@
     "@tanstack/react-form-devtools": "0.2.22",
     "@tanstack/react-pacer-devtools": "^0.7.0",
     "react-cookie": "^8.1.2",
-    "@multiplatform.one/i18n": "6.0.4",
-    "@multiplatform.one/logger": "6.0.4",
-    "@multiplatform.one/platform": "6.0.4",
-    "@multiplatform.one/theme": "6.0.4",
-    "@multiplatform.one/store": "6.0.4",
-    "@multiplatform.one/web3": "6.0.4"
+    "@multiplatform.one/i18n": "6.3.0",
+    "@multiplatform.one/logger": "6.3.0",
+    "@multiplatform.one/platform": "6.3.0",
+    "@multiplatform.one/theme": "6.3.0",
+    "@multiplatform.one/store": "6.3.0",
+    "@multiplatform.one/web3": "6.3.0"
   },
   "devDependencies": {
     "@sentry/react": "^10.51.0",
@@ -57,8 +67,8 @@
     "react-native-safe-area-context": "~5.7.0",
     "tamagui": "2.0.0-rc.41",
     "typescript": "~5.9.3",
-    "@multiplatform.one/frappe": "6.0.4",
-    "@multiplatform.one/web3": "6.0.4"
+    "@multiplatform.one/web3": "6.3.0",
+    "@multiplatform.one/frappe": "6.3.0"
   },
   "peerDependencies": {
     "@sentry/react": "^9.0.0",
@@ -74,33 +84,18 @@
     "react-native-gesture-handler": ">=2.0.0",
     "react-native-safe-area-context": ">=4.0.0",
     "tamagui": "^2.0.0-rc",
-    "@multiplatform.one/frappe": "6.0.4",
-    "@multiplatform.one/keycloak": "6.0.4",
-    "@multiplatform.one/frappe-ui": "6.0.4",
-    "@multiplatform.one/web3": "6.0.4"
+    "@multiplatform.one/web3": "^6.3.0",
+    "@multiplatform.one/frappe-ui": "^6.3.0",
+    "@multiplatform.one/frappe": "^6.3.0",
+    "@multiplatform.one/keycloak": "^6.3.0"
   },
   "peerDependenciesMeta": {
-    "@multiplatform.one/frappe": {
-      "optional": true
-    },
-    "@multiplatform.one/frappe-ui": {
-      "optional": true
-    },
-    "@multiplatform.one/keycloak": {
-      "optional": true
-    },
     "@multiplatform.one/web3": {
       "optional": true
     },
     "@sentry/react": {
       "optional": true
     },
-    "@tanstack/react-query": {
-      "optional": true
-    },
-    "@tanstack/react-query-devtools": {
-      "optional": true
-    },
     "@vxrn/color-scheme": {
       "optional": true
     },
@@ -121,6 +116,7 @@
     }
   },
   "scripts": {
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "build": "rm -rf types 2>/dev/null && tsc -p tsconfig.build.json"
   }
 }

package/src/app/CreateApp.tsx

@@ -20,6 +20,31 @@ import LazyWalletProvider from "./loadWalletProvider";
 
 export type ProviderComponent = ComponentType<PropsWithChildren>;
 
+const LOOPBACK_HOSTS = new Set(["localhost", "127.0.0.1", "[::1]"]);
+
+/**
+ * Follow the page origin when a loopback-configured backend is opened from a
+ * non-loopback host. Dev configs point at `http://localhost:8000`, which is
+ * correct on the dev machine but breaks the moment the app is opened via a
+ * LAN IP (`http://10.x.x.x:3456` → the API and the Socket.IO handshake would
+ * target the *visitor's* machine, and Chromium's Local Network Access policy
+ * flags the cross-origin loopback fetch). Rewriting only the hostname keeps
+ * the configured scheme and port, and only ever triggers in a browser whose
+ * page host is itself not loopback — SSR and same-machine dev are untouched.
+ */
+export function followPageOriginForLoopback(configured: string): string {
+  if (typeof window === "undefined" || !window.location?.hostname) return configured;
+  try {
+    const url = new URL(configured);
+    const pageHost = window.location.hostname;
+    if (!LOOPBACK_HOSTS.has(url.hostname) || LOOPBACK_HOSTS.has(pageHost)) return configured;
+    url.hostname = pageHost;
+    return url.toString().replace(/\/$/, "");
+  } catch {
+    return configured;
+  }
+}
+
 // ---------------------------------------------------------------------------
 // Provider config types
 // ---------------------------------------------------------------------------
@@ -58,6 +83,12 @@ export interface KeycloakConfig {
   iframeSso?: boolean;
   loginRedirectUri?: string;
   messageHandlerKeys?: string[];
+  /** Better Auth server base URL (native sign-in). When omitted, reads
+   * BETTER_AUTH_BASE_URL, then falls back to BASE_URL (the app server proxies
+   * /api/auth). */
+  betterAuthBaseUrl?: string;
+  /** App scheme for the Expo auth-session redirect (native). */
+  expoScheme?: string;
 }
 
 export interface FrappeConfig {
@@ -71,7 +102,7 @@ export interface FrappeConfig {
   socketPort?: number;
   auth?: {
     useToken?: boolean;
-    token?: string;
+    token?: string | (() => string | Promise<string>);
     type?: string;
   };
 }
@@ -85,9 +116,17 @@ export interface Web3AppConfig {
   appUrl?: string;
   appIcon?: string;
   enableTestnets?: boolean;
-  /** Native: URL serving the wallet WebView HTML (preferred over the inline string). */
+  /** Add the local dev chain (`make localnet`). When omitted, reads WEB3_LOCALNET_ENABLED. */
+  localnet?: boolean;
+  /** Local EVM JSON-RPC endpoint for localnet. When omitted, reads WEB3_EVM_RPC. */
+  localnetRpcUrl?: string;
+  /** Solana JSON-RPC endpoint. When omitted, reads WEB3_SOLANA_RPC. */
+  solanaRpcUrl?: string;
+  /** Sui JSON-RPC endpoint. When omitted, reads WEB3_SUI_RPC. */
+  suiRpcUrl?: string;
+  /** Native: URL serving the wallet WebView HTML. When omitted, reads WEB3_WEBVIEW_URL. */
   webViewUrl?: string;
-  /** E2E only (native): route connect through the in-WebView mock wallet. */
+  /** E2E only (native): route connect through the in-WebView mock wallet. When omitted, reads WEB3_MOCK_WALLET. */
   mockWallet?: boolean;
 }
 
@@ -186,8 +225,12 @@ export function createApp(appConfig: CreateAppConfig) {
                 (isWeb && typeof window !== "undefined" ? window.location.origin : ""),
               appIcon: cfg.appIcon,
               enableTestnets: testnetsEnabled,
-              webViewUrl: cfg.webViewUrl,
-              mockWallet: cfg.mockWallet,
+              localnet: cfg.localnet ?? config.get("WEB3_LOCALNET_ENABLED") === "1",
+              localnetRpcUrl: cfg.localnetRpcUrl || config.get("WEB3_EVM_RPC") || undefined,
+              solanaRpcUrl: cfg.solanaRpcUrl || config.get("WEB3_SOLANA_RPC") || undefined,
+              suiRpcUrl: cfg.suiRpcUrl || config.get("WEB3_SUI_RPC") || undefined,
+              webViewUrl: cfg.webViewUrl || config.get("WEB3_WEBVIEW_URL") || undefined,
+              mockWallet: cfg.mockWallet ?? config.get("WEB3_MOCK_WALLET") === "1",
             }}
           >
             {children}
@@ -216,6 +259,8 @@ export function createApp(appConfig: CreateAppConfig) {
             iframeSso?: boolean;
             loginRedirectUri?: string;
             messageHandlerKeys?: string[];
+            betterAuthBaseUrl?: string;
+            expoScheme?: string;
           }>
         >,
       };
@@ -237,6 +282,13 @@ export function createApp(appConfig: CreateAppConfig) {
             iframeSso={cfg.iframeSso}
             loginRedirectUri={cfg.loginRedirectUri}
             messageHandlerKeys={cfg.messageHandlerKeys || []}
+            betterAuthBaseUrl={
+              cfg.betterAuthBaseUrl ||
+              config.get("BETTER_AUTH_BASE_URL") ||
+              config.get("BASE_URL") ||
+              undefined
+            }
+            expoScheme={cfg.expoScheme}
           >
             {children}
           </LazyKeycloakProvider>
@@ -260,12 +312,39 @@ export function createApp(appConfig: CreateAppConfig) {
       const enabled = cfg.enabled ?? config.get("FRAPPE_ENABLED") === "1";
       if (!enabled) return children;
 
-      const baseURL = cfg.baseURL || config.get("BASE_URL") || "http://localhost:8000";
+      // LAN dev: a loopback-configured bench follows the page origin's host
+      // (the Socket.IO URL derives from baseURL too, so realtime follows).
+      const baseURL = followPageOriginForLoopback(
+        cfg.baseURL || config.get("BASE_URL") || "http://localhost:8000",
+      );
       const socketPort =
         cfg.socketPort ?? (Number(config.get("FRAPPE_SOCKETIO_PORT")) || undefined);
 
+      // Keycloak auth uses ONE transport on every platform: the HttpClient
+      // and the Socket.IO handshake send `Authorization: Bearer <keycloak
+      // access token>`, fetched lazily from better-auth's /get-access-token
+      // (which refreshes server-side; SecureStore jar on native, session
+      // cookie on web). The bench's frappe_keycloak auth hook validates the
+      // JWT. Cookies alone can't cover realtime: frappe's socketio middleware
+      // only accepts a frappe `sid` cookie or an Authorization header, so the
+      // better-auth account cookie never authenticated the socket on web.
+      // When signed out the getter resolves undefined and requests fall back
+      // to guest.
+      const auth =
+        cfg.auth ??
+        (appConfig.keycloak
+          ? {
+              useToken: true,
+              type: "Bearer",
+              token: async () => {
+                const mod = await import("@multiplatform.one/keycloak");
+                return (await mod.getKeycloakBearerToken()) || "";
+              },
+            }
+          : undefined);
+
       return (
-        <FrappeProvider baseURL={baseURL} socketPort={socketPort} auth={cfg.auth}>
+        <FrappeProvider baseURL={baseURL} socketPort={socketPort} auth={auth}>
           {children}
         </FrappeProvider>
       );

package/src/app/CreateRootLayout.web.tsx

@@ -123,10 +123,46 @@ export function createRootLayout(cfg: CreateRootLayoutConfig): ComponentType {
       i18n.changeLanguage(rootLoaderData.detectedLanguage);
     }
 
+    // LC-33 FONT-STABLE-MOUNT (DF-17 / Axiom 8 STABLE GROUND): Inter must be
+    // usable at first paint. The Tamagui font CSS is injected as a JS side
+    // effect (theme's createFontLoader.web), so without a head declaration
+    // the fallback→Inter swap reflows settled text (H1 width jumped 74px in
+    // the dogfood axiom review). Preloading the same Inter binaries the app
+    // serves from /fonts (extracted from @tamagui/font-inter — identical
+    // metrics to the late-injected face) and declaring the face in the head
+    // means first paint already renders Inter; `font-display: optional`
+    // guarantees the head face itself never swaps after first paint.
+    const interFonts = cfg.head?.interFonts !== false;
+    const interFontCss = [
+      '@font-face{font-family:"Inter";font-style:normal;font-weight:400;font-display:optional;src:url("/fonts/inter-400.woff2") format("woff2")}',
+      '@font-face{font-family:"Inter";font-style:normal;font-weight:700;font-display:optional;src:url("/fonts/inter-700.woff2") format("woff2")}',
+    ].join("");
+
     return (
       <html lang={htmlLang}>
         <head>
           <meta charSet="utf-8" />
+          {interFonts && (
+            <>
+              <link
+                rel="preload"
+                href="/fonts/inter-400.woff2"
+                as="font"
+                type="font/woff2"
+                crossOrigin=""
+              />
+              <link
+                rel="preload"
+                href="/fonts/inter-700.woff2"
+                as="font"
+                type="font/woff2"
+                crossOrigin=""
+              />
+              <style precedence="reset" href="__font_inter">
+                {interFontCss}
+              </style>
+            </>
+          )}
           {/* Critical reset CSS with data-precedence so React 19 hoists it
               to the very top of <head> – BEFORE the Tamagui atomic CSS.
               This eliminates FOUC during streaming SSR. */}

package/src/app/TanstackDevtools.tsx

@@ -61,7 +61,14 @@ function useFrappePlugin() {
         ]);
         const sync = __getActiveSyncModule();
         if (sync && !cancelled) {
-          setPlugin(frappeDevtoolsPlugin(sync));
+          // SyncModule is a class (nominal typing); when this file is
+          // typechecked through nested node_modules symlinks with
+          // preserveSymlinks, the two dynamic imports above can resolve to
+          // distinct copies of the same source file, making the identical
+          // class types mutually unassignable. Same runtime object either way.
+          setPlugin(
+            frappeDevtoolsPlugin(sync as unknown as Parameters<typeof frappeDevtoolsPlugin>[0]),
+          );
           return true;
         }
       } catch {

package/src/app/rootLayoutShared.ts

@@ -5,6 +5,17 @@ import type { AppProviderProps } from "./CreateApp";
 export interface HeadConfig {
   /** Path to favicon (e.g. "/favicon.svg"). */
   favicon?: string;
+  /**
+   * Preload + declare the default Inter faces (400/700) in the document
+   * head with `font-display: optional` so first paint is font-stable
+   * (LC-33 FONT-STABLE-MOUNT / DF-17): without a head declaration the
+   * Tamagui font CSS arrives as a JS side effect and the fallback→Inter
+   * swap reflows settled text. Defaults to true; requires the app to
+   * serve `/fonts/inter-400.woff2` + `/fonts/inter-700.woff2` from its
+   * public directory. Set false for apps that don't use Inter or ship
+   * their own head declaration.
+   */
+  interFonts?: boolean;
 }
 
 export interface SentryConfig {

package/types/app/CreateApp.d.ts

@@ -0,0 +1,132 @@
+import { type ComponentType, type PropsWithChildren } from "react";
+import type { ThemeConfig } from "@multiplatform.one/theme";
+export type ProviderComponent = ComponentType<PropsWithChildren>;
+/**
+ * Follow the page origin when a loopback-configured backend is opened from a
+ * non-loopback host. Dev configs point at `http://localhost:8000`, which is
+ * correct on the dev machine but breaks the moment the app is opened via a
+ * LAN IP (`http://10.x.x.x:3456` → the API and the Socket.IO handshake would
+ * target the *visitor's* machine, and Chromium's Local Network Access policy
+ * flags the cross-origin loopback fetch). Rewriting only the hostname keeps
+ * the configured scheme and port, and only ever triggers in a browser whose
+ * page host is itself not loopback — SSR and same-machine dev are untouched.
+ */
+export declare function followPageOriginForLoopback(configured: string): string;
+export interface TanstackConfig {
+    /** Show React Query devtools (web only, ignored on native and in Storybook). */
+    debug?: boolean;
+    /** Options forwarded to the QueryClient constructor. */
+    queryClientOptions?: Record<string, unknown>;
+    /**
+     * Pass `useUserScheme` from `one` / `@vxrn/color-scheme` so the theme
+     * devtools panel can control the color scheme (light / dark / system).
+     */
+    useUserScheme?: () => {
+        setting: "system" | "light" | "dark";
+        value: "light" | "dark";
+        set: (s: "system" | "light" | "dark") => void;
+    };
+    /**
+     * Tamagui config object (from `createTamagui()`). When provided, the
+     * TanStack Devtools theme panel extracts `$color1`–`$color12` directly
+     * from the config's themes for the color line visualizer.
+     * Passed automatically by `createApp()` from the theme config.
+     */
+    tamaguiConfig?: unknown;
+}
+export interface KeycloakConfig {
+    /** Force-enable or disable. When omitted, reads KEYCLOAK_ENABLED from env config. */
+    enabled?: boolean;
+    baseUrl?: string;
+    clientId?: string;
+    publicClientId?: string;
+    realm?: string;
+    debug?: boolean;
+    iframeSso?: boolean;
+    loginRedirectUri?: string;
+    messageHandlerKeys?: string[];
+    /** Better Auth server base URL (native sign-in). When omitted, reads
+     * BETTER_AUTH_BASE_URL, then falls back to BASE_URL (the app server proxies
+     * /api/auth). */
+    betterAuthBaseUrl?: string;
+    /** App scheme for the Expo auth-session redirect (native). */
+    expoScheme?: string;
+}
+export interface FrappeConfig {
+    /** Force-enable or disable. When omitted, reads FRAPPE_ENABLED from env config. */
+    enabled?: boolean;
+    baseURL?: string;
+    /**
+     * Override port for Socket.IO realtime connection (e.g. 9000 in dev).
+     * Omit in production behind a reverse proxy.
+     */
+    socketPort?: number;
+    auth?: {
+        useToken?: boolean;
+        token?: string | (() => string | Promise<string>);
+        type?: string;
+    };
+}
+export interface Web3AppConfig {
+    /** Force-enable or disable. When omitted, reads WEB3_ENABLED from env config. */
+    enabled?: boolean;
+    walletConnectProjectId?: string;
+    appName?: string;
+    appDescription?: string;
+    appUrl?: string;
+    appIcon?: string;
+    enableTestnets?: boolean;
+    /** Add the local dev chain (`make localnet`). When omitted, reads WEB3_LOCALNET_ENABLED. */
+    localnet?: boolean;
+    /** Local EVM JSON-RPC endpoint for localnet. When omitted, reads WEB3_EVM_RPC. */
+    localnetRpcUrl?: string;
+    /** Solana JSON-RPC endpoint. When omitted, reads WEB3_SOLANA_RPC. */
+    solanaRpcUrl?: string;
+    /** Sui JSON-RPC endpoint. When omitted, reads WEB3_SUI_RPC. */
+    suiRpcUrl?: string;
+    /** Native: URL serving the wallet WebView HTML. When omitted, reads WEB3_WEBVIEW_URL. */
+    webViewUrl?: string;
+    /** E2E only (native): route connect through the in-WebView mock wallet. When omitted, reads WEB3_MOCK_WALLET. */
+    mockWallet?: boolean;
+}
+export interface CreateAppConfig {
+    /** ThemeConfig to pass to the built-in ThemeProvider. */
+    theme?: ThemeConfig;
+    /**
+     * Additional providers composed outermost-to-innermost order.
+     * Each component receives `{ children }` and must render them.
+     * The first provider in the array becomes the outermost wrapper.
+     */
+    providers?: ProviderComponent[];
+    /** TanStack Query provider with optional devtools. Pass `true` for defaults. */
+    tanstack?: TanstackConfig | boolean;
+    /** Keycloak auth provider (lazy-loaded). Pass `true` to read all settings from env config. */
+    keycloak?: KeycloakConfig | boolean;
+    /** Frappe provider (lazy-loaded). Pass `true` to read all settings from env config. */
+    frappe?: FrappeConfig | boolean;
+    /** Web3 wallet provider (lazy-loaded). Pass `true` to read all settings from env config. */
+    web3?: Web3AppConfig | boolean;
+}
+export interface AppProviderProps extends PropsWithChildren {
+    /** System color scheme for theme resolution. */
+    systemTheme?: "light" | "dark";
+    /** Override the theme config set at createApp() time (useful for Storybook). */
+    themeConfig?: ThemeConfig;
+}
+/**
+ * Creates a pre-configured app shell with composable providers.
+ *
+ * Returns `{ AppProvider, withApp, useAppConfig }`.
+ *
+ * Provider composition order (outermost → innermost):
+ *   config context → TanStack → Web3 → Keycloak → Frappe → custom providers → ThemeProvider → children
+ */
+export declare function createApp(appConfig: CreateAppConfig): {
+    AppProvider: {
+        ({ children, systemTheme, themeConfig }: AppProviderProps): import("react/jsx-runtime").JSX.Element;
+        displayName: string;
+    };
+    withApp: <P extends Record<string, unknown>>(Screen: ComponentType<P>) => ComponentType<P>;
+    useAppConfig: () => CreateAppConfig;
+};
+//# sourceMappingURL=CreateApp.d.ts.map

package/types/app/CreateApp.d.ts.map

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

package/types/app/CreateRootLayout.d.ts

@@ -0,0 +1,13 @@
+import { type ComponentType } from "react";
+import type { CreateRootLayoutConfig } from "./rootLayoutShared";
+export type { CreateRootLayoutConfig, HeadConfig, RootLayoutProps, RootLoaderData, SentryConfig, } from "./rootLayoutShared";
+/**
+ * Creates a root layout component (universal fallback for Tauri / desktop).
+ *
+ * Handles i18n initialization, color-scheme detection via `matchMedia`,
+ * and wraps content in `LoadProgressBar` → `AppProvider` → `RootLayout` → `<Slot />`.
+ *
+ * `head` and `sentry` config options are ignored in the universal fallback.
+ */
+export declare function createRootLayout(cfg: CreateRootLayoutConfig): ComponentType;
+//# sourceMappingURL=CreateRootLayout.d.ts.map

package/types/app/CreateRootLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateRootLayout.d.ts","sourceRoot":"","sources":["../../src/app/CreateRootLayout.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAuB,KAAK,aAAa,EAAkB,MAAM,OAAO,CAAC;AAKhF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE,YAAY,EACV,sBAAsB,EACtB,UAAU,EACV,eAAe,EACf,cAAc,EACd,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,sBAAsB,GAAG,aAAa,CAwC3E"}

package/types/app/CreateRootLayout.native.d.ts

@@ -0,0 +1,14 @@
+import type { ComponentType } from "react";
+import type { CreateRootLayoutConfig } from "./rootLayoutShared";
+export type { CreateRootLayoutConfig, HeadConfig, RootLayoutProps, RootLoaderData, SentryConfig, } from "./rootLayoutShared";
+/**
+ * Creates a root layout component for **React Native** (iOS + Android).
+ *
+ * Handles i18n initialization, color-scheme detection via `@vxrn/color-scheme`,
+ * and wraps content in `GestureHandlerRootView` → `SafeAreaProvider` →
+ * `SchemeProvider` → `AppProvider` → `RootLayout` → `<Slot />`.
+ *
+ * `head` and `sentry` config options are ignored on native.
+ */
+export declare function createRootLayout(cfg: CreateRootLayoutConfig): ComponentType;
+//# sourceMappingURL=CreateRootLayout.native.d.ts.map

package/types/app/CreateRootLayout.native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateRootLayout.native.d.ts","sourceRoot":"","sources":["../../src/app/CreateRootLayout.native.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,OAAO,CAAC;AAQtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEjE,YAAY,EACV,sBAAsB,EACtB,UAAU,EACV,eAAe,EACf,cAAc,EACd,YAAY,GACb,MAAM,oBAAoB,CAAC;AAM5B;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,sBAAsB,GAAG,aAAa,CAsC3E"}

package/types/app/CreateRootLayout.web.d.ts

@@ -0,0 +1,21 @@
+import type { ComponentType } from "react";
+import type { CreateRootLayoutConfig } from "./rootLayoutShared";
+export type { CreateRootLayoutConfig, HeadConfig, RootLayoutProps, RootLoaderData, SentryConfig, } from "./rootLayoutShared";
+/**
+ * Creates a root layout component for **web** (browser + SSR).
+ *
+ * Handles i18n initialization, Sentry setup, color-scheme detection via
+ * `SchemeProvider` (blocking script + localStorage – no cookie needed),
+ * `<Head>` meta tags, `<LoadProgressBar>`, and wraps content in
+ * `SchemeProvider` → `CookiesProvider` → `AppProvider` → `RootLayout` → `<Slot />`.
+ *
+ * Light/dark scheme: handled by `@vxrn/color-scheme` `SchemeProvider` which
+ * injects a blocking `<script>` that reads `localStorage` / `matchMedia`
+ * before the first paint. Works even when cookies are disabled.
+ *
+ * Theme properties (color theme, padding, borderRadius, …): synced via
+ * `mp.preset` + `mp.overrides` cookies so SSR can render with the user's full
+ * theme. The cookies are populated by `useTheme` in `@multiplatform.one/theme`.
+ */
+export declare function createRootLayout(cfg: CreateRootLayoutConfig): ComponentType;
+//# sourceMappingURL=CreateRootLayout.web.d.ts.map

package/types/app/CreateRootLayout.web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateRootLayout.web.d.ts","sourceRoot":"","sources":["../../src/app/CreateRootLayout.web.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,OAAO,CAAC;AAOtD,OAAO,KAAK,EAAE,sBAAsB,EAAkB,MAAM,oBAAoB,CAAC;AAEjF,YAAY,EACV,sBAAsB,EACtB,UAAU,EACV,eAAe,EACf,cAAc,EACd,YAAY,GACb,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,sBAAsB,GAAG,aAAa,CAoL3E"}

package/types/app/TanstackDevtools.d.ts

@@ -0,0 +1,7 @@
+import type { TanstackConfig } from "./CreateApp";
+export interface TanstackDevtoolsProps {
+    resolvedScheme: "light" | "dark";
+    tanstackConfig: TanstackConfig;
+}
+export default function TanstackDevtoolsWrapper({ resolvedScheme, tanstackConfig, }: TanstackDevtoolsProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=TanstackDevtools.d.ts.map

package/types/app/TanstackDevtools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TanstackDevtools.d.ts","sourceRoot":"","sources":["../../src/app/TanstackDevtools.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAsBlD,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,OAAO,GAAG,MAAM,CAAC;IACjC,cAAc,EAAE,cAAc,CAAC;CAChC;AAkED,MAAM,CAAC,OAAO,UAAU,uBAAuB,CAAC,EAC9C,cAAc,EACd,cAAc,GACf,EAAE,qBAAqB,2CA0CvB"}

package/types/app/TanstackProvider.d.ts

@@ -0,0 +1,3 @@
+import type { ProviderComponent, TanstackConfig } from "./CreateApp";
+export declare function createTanstackProvider(tanstackConfig: TanstackConfig): ProviderComponent;
+//# sourceMappingURL=TanstackProvider.d.ts.map

package/types/app/TanstackProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TanstackProvider.d.ts","sourceRoot":"","sources":["../../src/app/TanstackProvider.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIrE,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,cAAc,GAAG,iBAAiB,CAiCxF"}

package/types/app/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * ## Platform File Extension Conventions
+ *
+ * The framework uses platform-specific file extensions for automatic
+ * bundler resolution. When multiple variants exist for a module, the
+ * bundler picks the most specific match for the current target:
+ *
+ * | Extension        | Target                                  |
+ * | ---------------- | --------------------------------------- |
+ * | `.web.tsx`       | Web (browser + SSR)                     |
+ * | `.native.tsx`    | React Native (iOS + Android)            |
+ * | `.ios.tsx`       | iOS only                                |
+ * | `.android.tsx`   | Android only                            |
+ * | `.tauri.tsx`     | Tauri desktop (macOS, Windows, Linux)   |
+ * | `.storybook-expo.ts` | Storybook running in Expo           |
+ * | (no suffix)      | Universal fallback / shared code        |
+ *
+ * Resolution priority (most → least specific):
+ *   `.ios.tsx` > `.native.tsx` > `.tsx` (on iOS)
+ *   `.web.tsx` > `.tsx` (on web)
+ *   `.tauri.tsx` > `.tsx` (on Tauri)
+ *
+ * When creating platform-specific variants, always keep a universal
+ * fallback file (e.g. `index.ts`) that exports the default API.
+ */
+export * from "./CreateApp";
+export * from "./CreateRootLayout";
+//# sourceMappingURL=index.d.ts.map

package/types/app/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/app/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC"}

package/types/app/loadWalletProvider.native.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("react").LazyExoticComponent<typeof import("@multiplatform.one/web3/native").WalletProvider>;
+export default _default;
+//# sourceMappingURL=loadWalletProvider.native.d.ts.map

package/types/app/loadWalletProvider.native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadWalletProvider.native.d.ts","sourceRoot":"","sources":["../../src/app/loadWalletProvider.native.ts"],"names":[],"mappings":";AAWA,wBAEE"}

package/types/app/loadWalletProvider.web.d.ts

@@ -0,0 +1,4 @@
+import { type ComponentType, type PropsWithChildren } from "react";
+declare const WalletProvider: ComponentType<PropsWithChildren<Record<string, unknown>>>;
+export default WalletProvider;
+//# sourceMappingURL=loadWalletProvider.web.d.ts.map

package/types/app/loadWalletProvider.web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadWalletProvider.web.d.ts","sourceRoot":"","sources":["../../src/app/loadWalletProvider.web.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,aAAa,EAAE,KAAK,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAO5F,QAAA,MAAM,cAAc,EAAE,aAAa,CAAC,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CACrC,CAAC;AAC1C,eAAe,cAAc,CAAC"}

package/types/app/rootLayoutShared.d.ts

@@ -0,0 +1,67 @@
+import type { ComponentType, PropsWithChildren } from "react";
+import type { I18nConfigOptions } from "@multiplatform.one/i18n";
+import type { AppProviderProps } from "./CreateApp";
+export interface HeadConfig {
+    /** Path to favicon (e.g. "/favicon.svg"). */
+    favicon?: string;
+    /**
+     * Preload + declare the default Inter faces (400/700) in the document
+     * head with `font-display: optional` so first paint is font-stable
+     * (LC-33 FONT-STABLE-MOUNT / DF-17): without a head declaration the
+     * Tamagui font CSS arrives as a JS side effect and the fallback→Inter
+     * swap reflows settled text. Defaults to true; requires the app to
+     * serve `/fonts/inter-400.woff2` + `/fonts/inter-700.woff2` from its
+     * public directory. Set false for apps that don't use Inter or ship
+     * their own head declaration.
+     */
+    interFonts?: boolean;
+}
+export interface SentryConfig {
+    /** Sentry DSN. When provided, Sentry is initialized on the web client. */
+    dsn?: string;
+}
+/** Shape of the root layout loader data used by createRootLayout. */
+export interface RootLoaderData {
+    cookieHeader?: string;
+    /** Language detected from request (cookie or Accept-Language header). */
+    detectedLanguage?: string;
+    /** Server-side session from the auth loader (used for SSR hydration). */
+    session?: unknown;
+    [key: string]: unknown;
+}
+/**
+ * Props accepted by the `RootLayout` component.
+ *
+ * `ssrSession` is provided only on web during SSR so auth-related UI
+ * (e.g. user name, logout button) can render on the first paint without
+ * waiting for a client-side session fetch.
+ */
+export interface RootLayoutProps extends PropsWithChildren {
+    /** Server-side session data for SSR hydration (web only). */
+    ssrSession?: unknown;
+}
+/**
+ * Configuration for `createRootLayout()`.
+ *
+ * The factory initializes i18n, detects color scheme, wraps with the
+ * appropriate platform providers, and renders the RootLayout + Slot.
+ */
+export interface CreateRootLayoutConfig {
+    /** The AppProvider component returned from `createApp()`. */
+    AppProvider: ComponentType<AppProviderProps>;
+    /** Root layout shell that wraps route content (navigation chrome, header, etc.). */
+    RootLayout: ComponentType<RootLayoutProps>;
+    /** i18n configuration. i18next is initialized as a side-effect when the factory is called. */
+    i18n: I18nConfigOptions;
+    /** `<Head>` meta tags for web. Ignored on native. */
+    head?: HeadConfig;
+    /** Sentry error tracking. Initialized on the web client only. Ignored on native. */
+    sentry?: SentryConfig;
+    /**
+     * Native font map returned by `importFonts()` from `@package/fonts`.
+     * Passed to `useFonts()` so custom fonts load before the first render.
+     * Ignored on web (fonts are loaded via CSS side-effect imports).
+     */
+    fonts?: Record<string, number>;
+}
+//# sourceMappingURL=rootLayoutShared.d.ts.map

package/types/app/rootLayoutShared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rootLayoutShared.d.ts","sourceRoot":"","sources":["../../src/app/rootLayoutShared.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,WAAW,UAAU;IACzB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;;;OASG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,0EAA0E;IAC1E,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qEAAqE;AACrE,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAgB,SAAQ,iBAAiB;IACxD,6DAA6D;IAC7D,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,6DAA6D;IAC7D,WAAW,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;IAC7C,oFAAoF;IACpF,UAAU,EAAE,aAAa,CAAC,eAAe,CAAC,CAAC;IAC3C,8FAA8F;IAC9F,IAAI,EAAE,iBAAiB,CAAC;IACxB,qDAAqD;IACrD,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,oFAAoF;IACpF,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC"}

package/types/app/tanstackProvider.native.d.ts

@@ -0,0 +1,3 @@
+import type { ProviderComponent, TanstackConfig } from "./CreateApp";
+export declare function createTanstackProvider(tanstackConfig: TanstackConfig): ProviderComponent;
+//# sourceMappingURL=tanstackProvider.native.d.ts.map

package/types/app/tanstackProvider.native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tanstackProvider.native.d.ts","sourceRoot":"","sources":["../../src/app/tanstackProvider.native.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAErE,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,cAAc,GAAG,iBAAiB,CAQxF"}

package/types/healthz.d.ts

@@ -0,0 +1,3 @@
+/** Health check handler compatible with One framework +api.ts convention. */
+export declare function GET(_request: Request): Promise<Response>;
+//# sourceMappingURL=healthz.d.ts.map

package/types/healthz.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"healthz.d.ts","sourceRoot":"","sources":["../src/healthz.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,wBAAsB,GAAG,CAAC,QAAQ,EAAE,OAAO,qBAE1C"}

package/types/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./app/index";
+export * from "./layouts/index";
+//# sourceMappingURL=index.d.ts.map

package/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC"}

package/types/layouts/CreateDefaultLayout.d.ts

@@ -0,0 +1,57 @@
+import type { ComponentType, ReactNode } from "react";
+import { type WithLayout } from "@multiplatform.one/platform";
+export type SafeAreaEdge = "top" | "bottom" | "left" | "right";
+export interface CreateDefaultLayoutOptions {
+    /**
+     * SafeArea wrapper component.
+     * Pass SafeAreaWrapper from @multiplatform.one/components.
+     */
+    SafeAreaWrapper?: ComponentType<any>;
+    /**
+     * Edges to apply safe area insets to.
+     * @default ["top", "left", "right"]
+     */
+    safeAreaEdges?: SafeAreaEdge[];
+    /**
+     * Background color token for the safe area wrapper.
+     * @default "$background"
+     */
+    safeAreaBackground?: string;
+    /**
+     * KeyboardAvoiding wrapper component.
+     * Pass KeyboardAvoidingWrapper from @multiplatform.one/components.
+     */
+    KeyboardAvoidingWrapper?: ComponentType<any>;
+    /**
+     * Background color token for the content area.
+     * @default "$background"
+     */
+    background?: string;
+    /**
+     * Toast component to render inside the layout.
+     */
+    Toast?: ComponentType;
+    /**
+     * Debug overlay configuration.
+     * - `true`: enable a minimal debug overlay (visible when DEBUG=1)
+     * - `ComponentType`: render this component as the debug view when DEBUG=1
+     */
+    debug?: boolean | ComponentType;
+    /**
+     * Additional layout HOCs to compose with the default layout.
+     */
+    extraLayouts?: WithLayout[];
+}
+export interface DefaultLayoutProps {
+    children: ReactNode;
+}
+/**
+ * Factory that creates a DefaultLayout component and withDefaultLayout HOC
+ * from configuration. Handles SafeArea, KeyboardAvoiding, fullscreen YStack,
+ * Toast, and optional debug overlay composition.
+ */
+export declare function createDefaultLayout(options?: CreateDefaultLayoutOptions): {
+    DefaultLayout: ({ children }: DefaultLayoutProps) => import("react/jsx-runtime").JSX.Element;
+    withDefaultLayout: WithLayout;
+};
+//# sourceMappingURL=CreateDefaultLayout.d.ts.map

package/types/layouts/CreateDefaultLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateDefaultLayout.d.ts","sourceRoot":"","sources":["../../src/layouts/CreateDefaultLayout.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGtD,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEhF,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAE/D,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,eAAe,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAErC;;;OAGG;IACH,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IAE/B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,uBAAuB,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC;IAE7C;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC;IAEtB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,aAAa,CAAC;IAEhC;;OAEG;IACH,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,0BAA+B;kCAYrC,kBAAkB;;EAiDxD"}

package/types/layouts/index.d.ts

@@ -0,0 +1,3 @@
+export { createDefaultLayout } from "./CreateDefaultLayout";
+export type { CreateDefaultLayoutOptions, DefaultLayoutProps, SafeAreaEdge, } from "./CreateDefaultLayout";
+//# sourceMappingURL=index.d.ts.map

package/types/layouts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/layouts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EACV,0BAA0B,EAC1B,kBAAkB,EAClB,YAAY,GACb,MAAM,uBAAuB,CAAC"}

package/CHANGELOG.md

@@ -1,85 +0,0 @@
-# @multiplatform.one/core
-
-## 6.0.4
-
-### Patch Changes
-
-- Updated dependencies
-  - @multiplatform.one/web3@6.0.4
-  - @multiplatform.one/frappe@6.0.4
-  - @multiplatform.one/frappe-ui@6.0.4
-  - @multiplatform.one/i18n@6.0.4
-  - @multiplatform.one/keycloak@6.0.4
-  - @multiplatform.one/logger@6.0.4
-  - @multiplatform.one/platform@6.0.4
-  - @multiplatform.one/store@6.0.4
-  - @multiplatform.one/theme@6.0.4
-
-## 6.0.3
-
-### Patch Changes
-
-- Updated dependencies
-  - @multiplatform.one/web3@6.0.3
-  - @multiplatform.one/frappe@6.0.3
-  - @multiplatform.one/frappe-ui@6.0.3
-  - @multiplatform.one/i18n@6.0.3
-  - @multiplatform.one/keycloak@6.0.3
-  - @multiplatform.one/logger@6.0.3
-  - @multiplatform.one/platform@6.0.3
-  - @multiplatform.one/store@6.0.3
-  - @multiplatform.one/theme@6.0.3
-
-## 6.0.2
-
-### Patch Changes
-
-- Updated dependencies
-  - @multiplatform.one/web3@6.0.2
-  - @multiplatform.one/frappe@6.0.2
-  - @multiplatform.one/frappe-ui@6.0.2
-  - @multiplatform.one/i18n@6.0.2
-  - @multiplatform.one/keycloak@6.0.2
-  - @multiplatform.one/logger@6.0.2
-  - @multiplatform.one/platform@6.0.2
-  - @multiplatform.one/store@6.0.2
-  - @multiplatform.one/theme@6.0.2
-
-## 6.0.1
-
-### Patch Changes
-
-- Updated dependencies
-  - @multiplatform.one/web3@6.0.1
-  - @multiplatform.one/frappe@6.0.1
-  - @multiplatform.one/frappe-ui@6.0.1
-  - @multiplatform.one/i18n@6.0.1
-  - @multiplatform.one/keycloak@6.0.1
-  - @multiplatform.one/logger@6.0.1
-  - @multiplatform.one/platform@6.0.1
-  - @multiplatform.one/store@6.0.1
-  - @multiplatform.one/theme@6.0.1
-
-## 6.0.0
-
-### Major Changes
-
-- Unified 6.0.0 release: realign all public `@multiplatform.one/*` packages onto a single, matching version line (changesets `fixed` group). Highlights:
-  - **web3 split** into standalone `@multiplatform.one/connectkit` and `@multiplatform.one/gpg` packages; `web3` now depends on them instead of bundling ConnectKit.
-  - **Sign-In With GPG** screen added to the ConnectKit modal.
-  - **Native workspace web-resolution fix** + platform-split wrappers (rich-text / `TextEditor`, forms `Barcode`) so web-only libraries stay out of the native Hermes bundle.
-
-  From this release on, these packages are versioned together.
-
-### Patch Changes
-
-- Updated dependencies
-  - @multiplatform.one/frappe@6.0.0
-  - @multiplatform.one/frappe-ui@6.0.0
-  - @multiplatform.one/i18n@6.0.0
-  - @multiplatform.one/keycloak@6.0.0
-  - @multiplatform.one/logger@6.0.0
-  - @multiplatform.one/platform@6.0.0
-  - @multiplatform.one/store@6.0.0
-  - @multiplatform.one/theme@6.0.0
-  - @multiplatform.one/web3@6.0.0

package/tsconfig.json

@@ -1,11 +0,0 @@
-{
-  "$schema": "https://json.schemastore.org/tsconfig",
-  "extends": "../../tsconfig.base.json",
-  "compilerOptions": {
-    "composite": false,
-    "noEmit": true
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules"],
-  "references": []
-}