foundation-sdk 0.1.0 → 0.1.1

package/README.md

@@ -1,4 +1,4 @@
-# foundation-iframe-sdk
+# foundation-sdk
 
 SDK for building applications that embed within the Foundation container.
 
@@ -7,13 +7,21 @@ SDK for building applications that embed within the Foundation container.
 ## Installation
 
 ```bash
-npm install foundation-iframe-sdk
+npm install foundation-sdk
+```
+
+Vue is an optional peer dependency - only required if using the `/vue` entry point:
+
+```bash
+npm install foundation-sdk vue
 ```
 
 ## Quick Start
 
+### Vanilla TypeScript/JavaScript
+
 ```typescript
-import { createFoundationClient } from 'foundation-iframe-sdk'
+import { createFoundationClient } from 'foundation-sdk'
 
 const sdk = createFoundationClient()
 
@@ -30,6 +38,26 @@ const { items } = await sdk.db.list('projects', { limit: 10 })
 await sdk.ui.toast('Hello from embedded app!', 'success')
 ```
 
+### Vue 3
+
+```typescript
+import { useFoundation } from 'foundation-sdk/vue'
+
+// In your component setup
+const { isReady, user, isDark, db, ui } = useFoundation()
+
+// Reactive state is automatically updated
+watch(isReady, (ready) => {
+  if (ready) {
+    console.log('SDK ready, user:', user.value)
+  }
+})
+
+// Use services directly
+const { items } = await db.list('projects', { limit: 10 })
+await ui.toast('Hello!', 'success')
+```
+
 ## API Reference
 
 ### Initialization
@@ -48,6 +76,19 @@ if (sdk.isReady) {
 
 // Wait for ready
 await sdk.ready
+
+// Access available entity definitions
+console.log(sdk.entities) // EntityDefinition[]
+```
+
+#### `resetFoundationClient(): void`
+
+Resets the singleton instance. Useful for testing or re-initialization.
+
+```typescript
+import { resetFoundationClient } from 'foundation-sdk'
+
+resetFoundationClient()
 ```
 
 ---
@@ -224,6 +265,8 @@ const unsubscribe = sdk.router.onChange((route) => {
 interface ThemeService {
   readonly isDark: boolean
   readonly mode: 'light' | 'dark' | 'system'
+  setTheme(mode: 'light' | 'dark' | 'system'): Promise<void>
+  toggle(): Promise<void>
   onChange(callback: (theme: Theme) => void): () => void
 }
 ```
@@ -236,6 +279,13 @@ if (sdk.theme.isDark) {
   // Apply dark styles
 }
 
+// Set specific theme mode
+await sdk.theme.setTheme('dark')
+await sdk.theme.setTheme('system')
+
+// Toggle between light/dark
+await sdk.theme.toggle()
+
 // Subscribe to theme changes
 const unsubscribe = sdk.theme.onChange((theme) => {
   document.body.classList.toggle('dark', theme.isDark)
@@ -387,6 +437,96 @@ const unsubscribe = sdk.onEntityChange((event) => {
 
 ---
 
+## Vue Integration
+
+The SDK provides a Vue 3 composable for reactive state management:
+
+```typescript
+import { useFoundation } from 'foundation-sdk/vue'
+```
+
+### `useFoundation()`
+
+Returns reactive state and direct service access:
+
+```typescript
+interface UseFoundationReturn {
+  // Reactive state (readonly refs)
+  isReady: Ref<boolean>
+  user: ShallowRef<User | null>
+  isDark: Ref<boolean>
+  themeMode: Ref<'light' | 'dark' | 'system'>
+  routerPath: Ref<string>
+  routerQuery: ShallowRef<Record<string, string>>
+  routerHash: Ref<string>
+  entities: ShallowRef<EntityDefinition[]>
+
+  // Computed helpers
+  isAuthenticated: boolean
+  currentUser: User | null
+
+  // Direct service access
+  client: FoundationClient
+  auth: AuthService
+  ui: UIService
+  db: DbService
+  router: RouterService
+  config: ConfigService
+  files: FilesService
+  storage: StorageService
+  log: LogService
+  theme: ThemeService
+
+  // Theme control shortcuts
+  setTheme(mode: 'light' | 'dark' | 'system'): Promise<void>
+  toggleTheme(): Promise<void>
+
+  // Entity change subscription
+  onEntityChange(callback: (event: EntityChangeEvent) => void): () => void
+}
+```
+
+**Example:**
+
+```vue
+<script setup lang="ts">
+import { useFoundation } from 'foundation-sdk/vue'
+import { watch } from 'vue'
+
+const { isReady, user, isDark, db, ui, toggleTheme } = useFoundation()
+
+// Reactive state updates automatically
+watch(user, (newUser) => {
+  console.log('User changed:', newUser?.email)
+})
+
+// Theme reactivity
+watch(isDark, (dark) => {
+  document.body.classList.toggle('dark-mode', dark)
+})
+
+async function loadProjects() {
+  const { items } = await db.list('projects', { limit: 10 })
+  return items
+}
+
+async function handleClick() {
+  await toggleTheme()
+  await ui.toast('Theme toggled!', 'success')
+}
+</script>
+
+<template>
+  <div v-if="isReady">
+    <p>Welcome, {{ user?.name }}</p>
+    <button @click="handleClick">Toggle Theme</button>
+  </div>
+  <div v-else>Loading...</div>
+</template>
+```
+
+---
+
 ## TypeScript
 
 Full TypeScript support with exported types:
@@ -397,12 +537,19 @@ import type {
   User,
   Theme,
   RouterState,
+  EntityDefinition,
   EntityChangeEvent,
   AuthService,
+  ThemeService,
+  RouterService,
   DbService,
   UIService,
-  // ... more types
-} from 'foundation-iframe-sdk'
+  StorageService,
+  FilesService,
+  FileMetadata,
+  LogService,
+  ConfigService
+} from 'foundation-sdk'
 ```
 
 ---

package/dist/client.d.ts

@@ -0,0 +1,4 @@
+import { FoundationClient } from './types';
+export declare function createFoundationClient(): FoundationClient;
+export declare function resetFoundationClient(): void;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAiBjB,MAAM,SAAS,CAAA;AAIhB,wBAAgB,sBAAsB,IAAI,gBAAgB,CA4OzD;AAED,wBAAgB,qBAAqB,IAAI,IAAI,CAE5C"}

package/dist/index.d.ts

@@ -1,202 +1,3 @@
-export declare interface AuthService {
-    readonly user: User | null;
-    readonly isAuthenticated: boolean;
-    getToken(): Promise<string>;
-    login(): Promise<void>;
-    logout(): Promise<void>;
-    onChange(callback: (user: User | null) => void): () => void;
-}
-
-export declare interface ConfigService {
-    readonly features: Record<string, unknown>;
-    readonly app: {
-        id?: string;
-        name?: string;
-        environment?: string;
-    };
-    get(key: string): Promise<unknown>;
-}
-
-export declare function createFoundationClient(): FoundationClient;
-
-export declare interface DbService {
-    list<T = unknown>(entity: string, options?: {
-        filters?: Record<string, unknown>;
-        limit?: number;
-        cursor?: string;
-        orderBy?: string;
-        orderDir?: 'asc' | 'desc';
-    }): Promise<{
-        items: T[];
-        nextCursor?: string;
-    }>;
-    get<T = unknown>(entity: string, id: string): Promise<T>;
-    create<T = unknown>(entity: string, data: Partial<T>): Promise<T>;
-    update<T = unknown>(entity: string, id: string, updates: Partial<T>): Promise<T>;
-    delete(entity: string, id: string): Promise<void>;
-}
-
-export declare interface EntityChangeEvent {
-    changeType: string;
-    entityId?: string;
-    id?: string;
-    namespace?: string;
-    timestamp?: number;
-}
-
-export declare interface EntityDefinition {
-    name: string;
-    schema?: Record<string, unknown>;
-    methods?: string[];
-}
-
-export declare interface FileMetadata {
-    id: string;
-    name: string;
-    type: string;
-    size: number;
-    url: string;
-    folder?: string;
-    metadata?: Record<string, unknown>;
-    createdAt: string;
-}
-
-export declare interface FilesService {
-    initiate(options: {
-        name: string;
-        contentType: string;
-        contentLength: number;
-        metadata?: Record<string, unknown>;
-    }): Promise<{
-        id: string;
-        name: string;
-        signedUrl: string;
-        signedData: Record<string, string>;
-    }>;
-    get(fileId: string): Promise<FileMetadata>;
-    delete(fileId: string): Promise<void>;
-    list(options?: {
-        limit?: number;
-        cursor?: string;
-    }): Promise<{
-        items: FileMetadata[];
-        nextCursor?: string;
-    }>;
-}
-
-export declare interface FoundationClient {
-    readonly ready: Promise<void>;
-    readonly isReady: boolean;
-    auth: AuthService;
-    theme: ThemeService;
-    router: RouterService;
-    db: DbService;
-    ui: UIService;
-    storage: StorageService;
-    files: FilesService;
-    log: LogService;
-    config: ConfigService;
-    onEntityChange(callback: (event: EntityChangeEvent) => void): () => void;
-    readonly entities: EntityDefinition[];
-}
-
-export declare interface LogService {
-    info(message: string, data?: Record<string, unknown>): void;
-    warn(message: string, data?: Record<string, unknown>): void;
-    error(message: string, data?: Record<string, unknown>): void;
-    event(name: string, properties?: Record<string, unknown>): void;
-}
-
-export declare function resetFoundationClient(): void;
-
-export declare interface RouterService {
-    readonly path: string;
-    readonly query: Record<string, string>;
-    readonly hash: string;
-    push(path: string, options?: {
-        query?: Record<string, string>;
-        hash?: string;
-    }): Promise<void>;
-    replace(path: string, options?: {
-        query?: Record<string, string>;
-        hash?: string;
-    }): Promise<void>;
-    setQuery(params: Record<string, string>, options?: {
-        replace?: boolean;
-    }): Promise<void>;
-    onChange(callback: (route: RouterState) => void): () => void;
-}
-
-export declare interface RouterState {
-    path: string;
-    query: Record<string, string>;
-    hash: string;
-}
-
-export declare interface StorageService {
-    upload(options: {
-        name: string;
-        type: string;
-        size: number;
-        data: string;
-        folder?: string;
-        metadata?: Record<string, unknown>;
-    }): Promise<{
-        id: string;
-        url: string;
-        name: string;
-    }>;
-    get(fileId: string): Promise<FileMetadata>;
-    delete(fileId: string): Promise<void>;
-    list(options?: {
-        folder?: string;
-        limit?: number;
-        cursor?: string;
-    }): Promise<{
-        items: FileMetadata[];
-        nextCursor?: string;
-    }>;
-}
-
-export declare interface Theme {
-    isDark: boolean;
-    mode: 'light' | 'dark' | 'system';
-}
-
-export declare interface ThemeService {
-    readonly isDark: boolean;
-    readonly mode: 'light' | 'dark' | 'system';
-    setTheme(mode: 'light' | 'dark' | 'system'): Promise<void>;
-    toggle(): Promise<void>;
-    onChange(callback: (theme: Theme) => void): () => void;
-}
-
-export declare interface UIService {
-    toast(message: string, type?: 'success' | 'error' | 'warn' | 'info'): Promise<void>;
-    confirm(message: string): Promise<{
-        confirmed: boolean;
-    }>;
-    loading: {
-        show(message?: string): Promise<void>;
-        hide(): Promise<void>;
-    };
-    banner: {
-        show(message: string, options?: {
-            type?: 'info' | 'warning' | 'error' | 'success';
-            dismissible?: boolean;
-        }): Promise<{
-            bannerId: string;
-        }>;
-        hide(bannerId: string): Promise<void>;
-    };
-}
-
-export declare interface User {
-    id: string;
-    email: string;
-    name?: string;
-    picture?: string;
-    [key: string]: unknown;
-}
-
-export { }
+export { createFoundationClient, resetFoundationClient } from './client';
+export type { FoundationClient, User, Theme, RouterState, EntityDefinition, EntityChangeEvent, AuthService, ThemeService, RouterService, DbService, UIService, StorageService, FilesService, FileMetadata, LogService, ConfigService } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AAExE,YAAY,EACV,gBAAgB,EAChB,IAAI,EACJ,KAAK,EACL,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,aAAa,EACb,SAAS,EACT,SAAS,EACT,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,aAAa,EACd,MAAM,SAAS,CAAA"}

package/dist/types.d.ts

@@ -0,0 +1,208 @@
+export interface User {
+    id: string;
+    email: string;
+    name?: string;
+    picture?: string;
+    [key: string]: unknown;
+}
+export interface Theme {
+    isDark: boolean;
+    mode: 'light' | 'dark' | 'system';
+}
+export interface RouterState {
+    path: string;
+    query: Record<string, string>;
+    hash: string;
+}
+export interface EntityDefinition {
+    name: string;
+    schema?: Record<string, unknown>;
+    methods?: string[];
+}
+export interface AuthService {
+    readonly user: User | null;
+    readonly isAuthenticated: boolean;
+    getToken(): Promise<string>;
+    login(): Promise<void>;
+    logout(): Promise<void>;
+    onChange(callback: (user: User | null) => void): () => void;
+}
+export interface ThemeService {
+    readonly isDark: boolean;
+    readonly mode: 'light' | 'dark' | 'system';
+    setTheme(mode: 'light' | 'dark' | 'system'): Promise<void>;
+    toggle(): Promise<void>;
+    onChange(callback: (theme: Theme) => void): () => void;
+}
+export interface RouterService {
+    readonly path: string;
+    readonly query: Record<string, string>;
+    readonly hash: string;
+    push(path: string, options?: {
+        query?: Record<string, string>;
+        hash?: string;
+    }): Promise<void>;
+    replace(path: string, options?: {
+        query?: Record<string, string>;
+        hash?: string;
+    }): Promise<void>;
+    setQuery(params: Record<string, string>, options?: {
+        replace?: boolean;
+    }): Promise<void>;
+    onChange(callback: (route: RouterState) => void): () => void;
+}
+export interface DbService {
+    list<T = unknown>(entity: string, options?: {
+        filters?: Record<string, unknown>;
+        limit?: number;
+        cursor?: string;
+        orderBy?: string;
+        orderDir?: 'asc' | 'desc';
+    }): Promise<{
+        items: T[];
+        nextCursor?: string;
+    }>;
+    get<T = unknown>(entity: string, id: string): Promise<T>;
+    create<T = unknown>(entity: string, data: Partial<T>): Promise<T>;
+    update<T = unknown>(entity: string, id: string, updates: Partial<T>): Promise<T>;
+    delete(entity: string, id: string): Promise<void>;
+}
+export interface UIService {
+    toast(message: string, type?: 'success' | 'error' | 'warn' | 'info'): Promise<void>;
+    confirm(message: string): Promise<{
+        confirmed: boolean;
+    }>;
+    loading: {
+        show(message?: string): Promise<void>;
+        hide(): Promise<void>;
+    };
+    banner: {
+        show(message: string, options?: {
+            type?: 'info' | 'warning' | 'error' | 'success';
+            dismissible?: boolean;
+        }): Promise<{
+            bannerId: string;
+        }>;
+        hide(bannerId: string): Promise<void>;
+    };
+}
+export interface StorageService {
+    upload(options: {
+        name: string;
+        type: string;
+        size: number;
+        data: string;
+        folder?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<{
+        id: string;
+        url: string;
+        name: string;
+    }>;
+    get(fileId: string): Promise<FileMetadata>;
+    delete(fileId: string): Promise<void>;
+    list(options?: {
+        folder?: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<{
+        items: FileMetadata[];
+        nextCursor?: string;
+    }>;
+}
+export interface FilesService {
+    initiate(options: {
+        name: string;
+        contentType: string;
+        contentLength: number;
+        metadata?: Record<string, unknown>;
+    }): Promise<{
+        id: string;
+        name: string;
+        signedUrl: string;
+        signedData: Record<string, string>;
+    }>;
+    get(fileId: string): Promise<FileMetadata>;
+    delete(fileId: string): Promise<void>;
+    list(options?: {
+        limit?: number;
+        cursor?: string;
+    }): Promise<{
+        items: FileMetadata[];
+        nextCursor?: string;
+    }>;
+}
+export interface FileMetadata {
+    id: string;
+    name: string;
+    type: string;
+    size: number;
+    url: string;
+    folder?: string;
+    metadata?: Record<string, unknown>;
+    createdAt: string;
+}
+export interface LogService {
+    info(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, data?: Record<string, unknown>): void;
+    error(message: string, data?: Record<string, unknown>): void;
+    event(name: string, properties?: Record<string, unknown>): void;
+}
+export interface ConfigService {
+    readonly features: Record<string, unknown>;
+    readonly app: {
+        id?: string;
+        name?: string;
+        environment?: string;
+    };
+    get(key: string): Promise<unknown>;
+}
+export interface EntityChangeEvent {
+    changeType: string;
+    entityId?: string;
+    id?: string;
+    namespace?: string;
+    timestamp?: number;
+}
+export interface FoundationClient {
+    readonly ready: Promise<void>;
+    readonly isReady: boolean;
+    auth: AuthService;
+    theme: ThemeService;
+    router: RouterService;
+    db: DbService;
+    ui: UIService;
+    storage: StorageService;
+    files: FilesService;
+    log: LogService;
+    config: ConfigService;
+    onEntityChange(callback: (event: EntityChangeEvent) => void): () => void;
+    readonly entities: EntityDefinition[];
+}
+export interface SDKReadyPayload {
+    user?: User | null;
+    config?: {
+        features?: Record<string, unknown>;
+        app?: {
+            id?: string;
+            name?: string;
+            environment?: string;
+        };
+    };
+    theme?: Theme;
+    router?: RouterState;
+    entities?: EntityDefinition[];
+}
+export interface SDKMessage {
+    id: number;
+    namespace: string;
+    type: string;
+    data: Record<string, unknown>;
+}
+export interface SDKResponse {
+    id: number;
+    success: boolean;
+    data?: unknown;
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/vue.cjs

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const vue = require("vue");
+const index = require("./index.cjs");
+let client = null;
+let isReady = null;
+let user = null;
+let isDark = null;
+let themeMode = null;
+let routerPath = null;
+let routerQuery = null;
+let routerHash = null;
+let entities = null;
+let initialized = false;
+function initializeState() {
+  if (initialized) return;
+  client = index.createFoundationClient();
+  isReady = vue.ref(false);
+  user = vue.shallowRef(null);
+  isDark = vue.ref(false);
+  themeMode = vue.ref("system");
+  routerPath = vue.ref("/");
+  routerQuery = vue.shallowRef({});
+  routerHash = vue.ref("");
+  entities = vue.shallowRef([]);
+  client.ready.then(() => {
+    isReady.value = true;
+    user.value = client.auth.user;
+    isDark.value = client.theme.isDark;
+    themeMode.value = client.theme.mode;
+    routerPath.value = client.router.path;
+    routerQuery.value = client.router.query;
+    routerHash.value = client.router.hash;
+    entities.value = client.entities;
+  });
+  client.auth.onChange((newUser) => {
+    user.value = newUser;
+  });
+  client.theme.onChange((theme) => {
+    isDark.value = theme.isDark;
+    themeMode.value = theme.mode;
+  });
+  client.router.onChange((route) => {
+    routerPath.value = route.path;
+    routerQuery.value = route.query;
+    routerHash.value = route.hash;
+  });
+  initialized = true;
+}
+function useFoundation() {
+  initializeState();
+  return {
+    // Reactive state (readonly to prevent external mutation)
+    isReady: vue.readonly(isReady),
+    user: vue.readonly(user),
+    isDark: vue.readonly(isDark),
+    themeMode: vue.readonly(themeMode),
+    routerPath: vue.readonly(routerPath),
+    routerQuery: vue.readonly(routerQuery),
+    routerHash: vue.readonly(routerHash),
+    entities: vue.readonly(entities),
+    // Computed helpers
+    get isAuthenticated() {
+      return !!user.value;
+    },
+    get currentUser() {
+      return user.value;
+    },
+    // Direct access to SDK client for non-reactive operations
+    client,
+    // Shorthand service access
+    auth: client.auth,
+    ui: client.ui,
+    db: client.db,
+    router: client.router,
+    config: client.config,
+    files: client.files,
+    storage: client.storage,
+    log: client.log,
+    theme: client.theme,
+    // Theme control methods
+    setTheme: (mode) => client.theme.setTheme(mode),
+    toggleTheme: () => client.theme.toggle(),
+    // Entity change subscription
+    onEntityChange: client.onEntityChange.bind(client)
+  };
+}
+exports.useFoundation = useFoundation;
+//# sourceMappingURL=vue.cjs.map

package/dist/vue.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue.cjs","sources":["../src/vue.ts"],"sourcesContent":["/**\n * Vue composable wrapper for Foundation SDK\n *\n * Provides Vue reactivity around the framework-agnostic SDK client.\n */\nimport { ref, readonly, shallowRef, type Ref, type ShallowRef, type DeepReadonly } from 'vue'\nimport { createFoundationClient } from './client'\nimport type {\n  FoundationClient,\n  User,\n  Theme,\n  RouterState,\n  EntityDefinition,\n  EntityChangeEvent\n} from './types'\n\n// Singleton client\nlet client: FoundationClient | null = null\n\n// Reactive state (module-level singletons)\nlet isReady: Ref<boolean> | null = null\nlet user: ShallowRef<User | null> | null = null\nlet isDark: Ref<boolean> | null = null\nlet themeMode: Ref<Theme['mode']> | null = null\nlet routerPath: Ref<string> | null = null\nlet routerQuery: ShallowRef<Record<string, string>> | null = null\nlet routerHash: Ref<string> | null = null\nlet entities: ShallowRef<EntityDefinition[]> | null = null\n\nlet initialized = false\n\nfunction initializeState() {\n  if (initialized) return\n\n  client = createFoundationClient()\n\n  isReady = ref(false)\n  user = shallowRef<User | null>(null)\n  isDark = ref(false)\n  themeMode = ref<Theme['mode']>('system')\n  routerPath = ref('/')\n  routerQuery = shallowRef<Record<string, string>>({})\n  routerHash = ref('')\n  entities = shallowRef<EntityDefinition[]>([])\n\n  // Initialize reactive state when SDK is ready\n  client.ready.then(() => {\n    isReady!.value = true\n    user!.value = client!.auth.user\n    isDark!.value = client!.theme.isDark\n    themeMode!.value = client!.theme.mode\n    routerPath!.value = client!.router.path\n    routerQuery!.value = client!.router.query\n    routerHash!.value = client!.router.hash\n    entities!.value = client!.entities\n  })\n\n  // Subscribe to changes\n  client.auth.onChange((newUser) => {\n    user!.value = newUser\n  })\n\n  client.theme.onChange((theme) => {\n    isDark!.value = theme.isDark\n    themeMode!.value = theme.mode\n  })\n\n  client.router.onChange((route) => {\n    routerPath!.value = route.path\n    routerQuery!.value = route.query\n    routerHash!.value = route.hash\n  })\n\n  initialized = true\n}\n\nexport interface UseFoundationReturn {\n  // Reactive state (readonly to prevent external mutation)\n  isReady: DeepReadonly<Ref<boolean>>\n  user: DeepReadonly<ShallowRef<User | null>>\n  isDark: DeepReadonly<Ref<boolean>>\n  themeMode: DeepReadonly<Ref<Theme['mode']>>\n  routerPath: DeepReadonly<Ref<string>>\n  routerQuery: DeepReadonly<ShallowRef<Record<string, string>>>\n  routerHash: DeepReadonly<Ref<string>>\n  entities: DeepReadonly<ShallowRef<EntityDefinition[]>>\n\n  // Computed helpers\n  readonly isAuthenticated: boolean\n  readonly currentUser: User | null\n\n  // Direct access to SDK client for non-reactive operations\n  client: FoundationClient\n\n  // Shorthand service access\n  auth: FoundationClient['auth']\n  ui: FoundationClient['ui']\n  db: FoundationClient['db']\n  router: FoundationClient['router']\n  config: FoundationClient['config']\n  files: FoundationClient['files']\n  storage: FoundationClient['storage']\n  log: FoundationClient['log']\n  theme: FoundationClient['theme']\n\n  // Theme control methods\n  setTheme: (mode: Theme['mode']) => Promise<void>\n  toggleTheme: () => Promise<void>\n\n  // Entity change subscription\n  onEntityChange: (callback: (event: EntityChangeEvent) => void) => () => void\n}\n\n/**\n * Main composable for accessing Foundation SDK with Vue reactivity\n */\nexport function useFoundation(): UseFoundationReturn {\n  initializeState()\n\n  return {\n    // Reactive state (readonly to prevent external mutation)\n    isReady: readonly(isReady!),\n    user: readonly(user!),\n    isDark: readonly(isDark!),\n    themeMode: readonly(themeMode!),\n    routerPath: readonly(routerPath!),\n    routerQuery: readonly(routerQuery!),\n    routerHash: readonly(routerHash!),\n    entities: readonly(entities!),\n\n    // Computed helpers\n    get isAuthenticated() {\n      return !!user!.value\n    },\n\n    get currentUser() {\n      return user!.value\n    },\n\n    // Direct access to SDK client for non-reactive operations\n    client: client!,\n\n    // Shorthand service access\n    auth: client!.auth,\n    ui: client!.ui,\n    db: client!.db,\n    router: client!.router,\n    config: client!.config,\n    files: client!.files,\n    storage: client!.storage,\n    log: client!.log,\n    theme: client!.theme,\n\n    // Theme control methods\n    setTheme: (mode: Theme['mode']) => client!.theme.setTheme(mode),\n    toggleTheme: () => client!.theme.toggle(),\n\n    // Entity change subscription\n    onEntityChange: client!.onEntityChange.bind(client)\n  }\n}\n\n// Re-export types for convenience\nexport type { User, Theme, RouterState, EntityDefinition, EntityChangeEvent }\n"],"names":["createFoundationClient","ref","shallowRef","readonly"],"mappings":";;;;AAiBA,IAAI,SAAkC;AAGtC,IAAI,UAA+B;AACnC,IAAI,OAAuC;AAC3C,IAAI,SAA8B;AAClC,IAAI,YAAuC;AAC3C,IAAI,aAAiC;AACrC,IAAI,cAAyD;AAC7D,IAAI,aAAiC;AACrC,IAAI,WAAkD;AAEtD,IAAI,cAAc;AAElB,SAAS,kBAAkB;AACzB,MAAI,YAAa;AAEjB,WAASA,MAAAA,uBAAA;AAET,YAAUC,IAAAA,IAAI,KAAK;AACnB,SAAOC,IAAAA,WAAwB,IAAI;AACnC,WAASD,IAAAA,IAAI,KAAK;AAClB,cAAYA,IAAAA,IAAmB,QAAQ;AACvC,eAAaA,IAAAA,IAAI,GAAG;AACpB,gBAAcC,IAAAA,WAAmC,EAAE;AACnD,eAAaD,IAAAA,IAAI,EAAE;AACnB,aAAWC,IAAAA,WAA+B,EAAE;AAG5C,SAAO,MAAM,KAAK,MAAM;AACtB,YAAS,QAAQ;AACjB,SAAM,QAAQ,OAAQ,KAAK;AAC3B,WAAQ,QAAQ,OAAQ,MAAM;AAC9B,cAAW,QAAQ,OAAQ,MAAM;AACjC,eAAY,QAAQ,OAAQ,OAAO;AACnC,gBAAa,QAAQ,OAAQ,OAAO;AACpC,eAAY,QAAQ,OAAQ,OAAO;AACnC,aAAU,QAAQ,OAAQ;AAAA,EAC5B,CAAC;AAGD,SAAO,KAAK,SAAS,CAAC,YAAY;AAChC,SAAM,QAAQ;AAAA,EAChB,CAAC;AAED,SAAO,MAAM,SAAS,CAAC,UAAU;AAC/B,WAAQ,QAAQ,MAAM;AACtB,cAAW,QAAQ,MAAM;AAAA,EAC3B,CAAC;AAED,SAAO,OAAO,SAAS,CAAC,UAAU;AAChC,eAAY,QAAQ,MAAM;AAC1B,gBAAa,QAAQ,MAAM;AAC3B,eAAY,QAAQ,MAAM;AAAA,EAC5B,CAAC;AAED,gBAAc;AAChB;AA0CO,SAAS,gBAAqC;AACnD,kBAAA;AAEA,SAAO;AAAA;AAAA,IAEL,SAASC,IAAAA,SAAS,OAAQ;AAAA,IAC1B,MAAMA,IAAAA,SAAS,IAAK;AAAA,IACpB,QAAQA,IAAAA,SAAS,MAAO;AAAA,IACxB,WAAWA,IAAAA,SAAS,SAAU;AAAA,IAC9B,YAAYA,IAAAA,SAAS,UAAW;AAAA,IAChC,aAAaA,IAAAA,SAAS,WAAY;AAAA,IAClC,YAAYA,IAAAA,SAAS,UAAW;AAAA,IAChC,UAAUA,IAAAA,SAAS,QAAS;AAAA;AAAA,IAG5B,IAAI,kBAAkB;AACpB,aAAO,CAAC,CAAC,KAAM;AAAA,IACjB;AAAA,IAEA,IAAI,cAAc;AAChB,aAAO,KAAM;AAAA,IACf;AAAA;AAAA,IAGA;AAAA;AAAA,IAGA,MAAM,OAAQ;AAAA,IACd,IAAI,OAAQ;AAAA,IACZ,IAAI,OAAQ;AAAA,IACZ,QAAQ,OAAQ;AAAA,IAChB,QAAQ,OAAQ;AAAA,IAChB,OAAO,OAAQ;AAAA,IACf,SAAS,OAAQ;AAAA,IACjB,KAAK,OAAQ;AAAA,IACb,OAAO,OAAQ;AAAA;AAAA,IAGf,UAAU,CAAC,SAAwB,OAAQ,MAAM,SAAS,IAAI;AAAA,IAC9D,aAAa,MAAM,OAAQ,MAAM,OAAA;AAAA;AAAA,IAGjC,gBAAgB,OAAQ,eAAe,KAAK,MAAM;AAAA,EAAA;AAEtD;;"}

package/dist/vue.d.ts

@@ -0,0 +1,33 @@
+import { Ref, ShallowRef, DeepReadonly } from 'vue';
+import { FoundationClient, User, Theme, RouterState, EntityDefinition, EntityChangeEvent } from './types';
+export interface UseFoundationReturn {
+    isReady: DeepReadonly<Ref<boolean>>;
+    user: DeepReadonly<ShallowRef<User | null>>;
+    isDark: DeepReadonly<Ref<boolean>>;
+    themeMode: DeepReadonly<Ref<Theme['mode']>>;
+    routerPath: DeepReadonly<Ref<string>>;
+    routerQuery: DeepReadonly<ShallowRef<Record<string, string>>>;
+    routerHash: DeepReadonly<Ref<string>>;
+    entities: DeepReadonly<ShallowRef<EntityDefinition[]>>;
+    readonly isAuthenticated: boolean;
+    readonly currentUser: User | null;
+    client: FoundationClient;
+    auth: FoundationClient['auth'];
+    ui: FoundationClient['ui'];
+    db: FoundationClient['db'];
+    router: FoundationClient['router'];
+    config: FoundationClient['config'];
+    files: FoundationClient['files'];
+    storage: FoundationClient['storage'];
+    log: FoundationClient['log'];
+    theme: FoundationClient['theme'];
+    setTheme: (mode: Theme['mode']) => Promise<void>;
+    toggleTheme: () => Promise<void>;
+    onEntityChange: (callback: (event: EntityChangeEvent) => void) => () => void;
+}
+/**
+ * Main composable for accessing Foundation SDK with Vue reactivity
+ */
+export declare function useFoundation(): UseFoundationReturn;
+export type { User, Theme, RouterState, EntityDefinition, EntityChangeEvent };
+//# sourceMappingURL=vue.d.ts.map

package/dist/vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue.d.ts","sourceRoot":"","sources":["../src/vue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAA6B,KAAK,GAAG,EAAE,KAAK,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,KAAK,CAAA;AAE7F,OAAO,KAAK,EACV,gBAAgB,EAChB,IAAI,EACJ,KAAK,EACL,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,SAAS,CAAA;AA8DhB,MAAM,WAAW,mBAAmB;IAElC,OAAO,EAAE,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAA;IACnC,IAAI,EAAE,YAAY,CAAC,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAA;IAC3C,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAA;IAClC,SAAS,EAAE,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;IAC3C,UAAU,EAAE,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IACrC,WAAW,EAAE,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;IAC7D,UAAU,EAAE,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IACrC,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAA;IAGtD,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;IACjC,QAAQ,CAAC,WAAW,EAAE,IAAI,GAAG,IAAI,CAAA;IAGjC,MAAM,EAAE,gBAAgB,CAAA;IAGxB,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAA;IAC9B,EAAE,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAA;IAC1B,EAAE,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAA;IAC1B,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAA;IAClC,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAA;IAClC,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAChC,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAA;IACpC,GAAG,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAA;IAC5B,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;IAGhC,QAAQ,EAAE,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAChD,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAGhC,cAAc,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,KAAK,MAAM,IAAI,CAAA;CAC7E;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,mBAAmB,CA4CnD;AAGD,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,CAAA"}

package/dist/vue.js

@@ -0,0 +1,89 @@
+import { readonly, ref, shallowRef } from "vue";
+import { createFoundationClient } from "./index.js";
+let client = null;
+let isReady = null;
+let user = null;
+let isDark = null;
+let themeMode = null;
+let routerPath = null;
+let routerQuery = null;
+let routerHash = null;
+let entities = null;
+let initialized = false;
+function initializeState() {
+  if (initialized) return;
+  client = createFoundationClient();
+  isReady = ref(false);
+  user = shallowRef(null);
+  isDark = ref(false);
+  themeMode = ref("system");
+  routerPath = ref("/");
+  routerQuery = shallowRef({});
+  routerHash = ref("");
+  entities = shallowRef([]);
+  client.ready.then(() => {
+    isReady.value = true;
+    user.value = client.auth.user;
+    isDark.value = client.theme.isDark;
+    themeMode.value = client.theme.mode;
+    routerPath.value = client.router.path;
+    routerQuery.value = client.router.query;
+    routerHash.value = client.router.hash;
+    entities.value = client.entities;
+  });
+  client.auth.onChange((newUser) => {
+    user.value = newUser;
+  });
+  client.theme.onChange((theme) => {
+    isDark.value = theme.isDark;
+    themeMode.value = theme.mode;
+  });
+  client.router.onChange((route) => {
+    routerPath.value = route.path;
+    routerQuery.value = route.query;
+    routerHash.value = route.hash;
+  });
+  initialized = true;
+}
+function useFoundation() {
+  initializeState();
+  return {
+    // Reactive state (readonly to prevent external mutation)
+    isReady: readonly(isReady),
+    user: readonly(user),
+    isDark: readonly(isDark),
+    themeMode: readonly(themeMode),
+    routerPath: readonly(routerPath),
+    routerQuery: readonly(routerQuery),
+    routerHash: readonly(routerHash),
+    entities: readonly(entities),
+    // Computed helpers
+    get isAuthenticated() {
+      return !!user.value;
+    },
+    get currentUser() {
+      return user.value;
+    },
+    // Direct access to SDK client for non-reactive operations
+    client,
+    // Shorthand service access
+    auth: client.auth,
+    ui: client.ui,
+    db: client.db,
+    router: client.router,
+    config: client.config,
+    files: client.files,
+    storage: client.storage,
+    log: client.log,
+    theme: client.theme,
+    // Theme control methods
+    setTheme: (mode) => client.theme.setTheme(mode),
+    toggleTheme: () => client.theme.toggle(),
+    // Entity change subscription
+    onEntityChange: client.onEntityChange.bind(client)
+  };
+}
+export {
+  useFoundation
+};
+//# sourceMappingURL=vue.js.map

package/dist/vue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue.js","sources":["../src/vue.ts"],"sourcesContent":["/**\n * Vue composable wrapper for Foundation SDK\n *\n * Provides Vue reactivity around the framework-agnostic SDK client.\n */\nimport { ref, readonly, shallowRef, type Ref, type ShallowRef, type DeepReadonly } from 'vue'\nimport { createFoundationClient } from './client'\nimport type {\n  FoundationClient,\n  User,\n  Theme,\n  RouterState,\n  EntityDefinition,\n  EntityChangeEvent\n} from './types'\n\n// Singleton client\nlet client: FoundationClient | null = null\n\n// Reactive state (module-level singletons)\nlet isReady: Ref<boolean> | null = null\nlet user: ShallowRef<User | null> | null = null\nlet isDark: Ref<boolean> | null = null\nlet themeMode: Ref<Theme['mode']> | null = null\nlet routerPath: Ref<string> | null = null\nlet routerQuery: ShallowRef<Record<string, string>> | null = null\nlet routerHash: Ref<string> | null = null\nlet entities: ShallowRef<EntityDefinition[]> | null = null\n\nlet initialized = false\n\nfunction initializeState() {\n  if (initialized) return\n\n  client = createFoundationClient()\n\n  isReady = ref(false)\n  user = shallowRef<User | null>(null)\n  isDark = ref(false)\n  themeMode = ref<Theme['mode']>('system')\n  routerPath = ref('/')\n  routerQuery = shallowRef<Record<string, string>>({})\n  routerHash = ref('')\n  entities = shallowRef<EntityDefinition[]>([])\n\n  // Initialize reactive state when SDK is ready\n  client.ready.then(() => {\n    isReady!.value = true\n    user!.value = client!.auth.user\n    isDark!.value = client!.theme.isDark\n    themeMode!.value = client!.theme.mode\n    routerPath!.value = client!.router.path\n    routerQuery!.value = client!.router.query\n    routerHash!.value = client!.router.hash\n    entities!.value = client!.entities\n  })\n\n  // Subscribe to changes\n  client.auth.onChange((newUser) => {\n    user!.value = newUser\n  })\n\n  client.theme.onChange((theme) => {\n    isDark!.value = theme.isDark\n    themeMode!.value = theme.mode\n  })\n\n  client.router.onChange((route) => {\n    routerPath!.value = route.path\n    routerQuery!.value = route.query\n    routerHash!.value = route.hash\n  })\n\n  initialized = true\n}\n\nexport interface UseFoundationReturn {\n  // Reactive state (readonly to prevent external mutation)\n  isReady: DeepReadonly<Ref<boolean>>\n  user: DeepReadonly<ShallowRef<User | null>>\n  isDark: DeepReadonly<Ref<boolean>>\n  themeMode: DeepReadonly<Ref<Theme['mode']>>\n  routerPath: DeepReadonly<Ref<string>>\n  routerQuery: DeepReadonly<ShallowRef<Record<string, string>>>\n  routerHash: DeepReadonly<Ref<string>>\n  entities: DeepReadonly<ShallowRef<EntityDefinition[]>>\n\n  // Computed helpers\n  readonly isAuthenticated: boolean\n  readonly currentUser: User | null\n\n  // Direct access to SDK client for non-reactive operations\n  client: FoundationClient\n\n  // Shorthand service access\n  auth: FoundationClient['auth']\n  ui: FoundationClient['ui']\n  db: FoundationClient['db']\n  router: FoundationClient['router']\n  config: FoundationClient['config']\n  files: FoundationClient['files']\n  storage: FoundationClient['storage']\n  log: FoundationClient['log']\n  theme: FoundationClient['theme']\n\n  // Theme control methods\n  setTheme: (mode: Theme['mode']) => Promise<void>\n  toggleTheme: () => Promise<void>\n\n  // Entity change subscription\n  onEntityChange: (callback: (event: EntityChangeEvent) => void) => () => void\n}\n\n/**\n * Main composable for accessing Foundation SDK with Vue reactivity\n */\nexport function useFoundation(): UseFoundationReturn {\n  initializeState()\n\n  return {\n    // Reactive state (readonly to prevent external mutation)\n    isReady: readonly(isReady!),\n    user: readonly(user!),\n    isDark: readonly(isDark!),\n    themeMode: readonly(themeMode!),\n    routerPath: readonly(routerPath!),\n    routerQuery: readonly(routerQuery!),\n    routerHash: readonly(routerHash!),\n    entities: readonly(entities!),\n\n    // Computed helpers\n    get isAuthenticated() {\n      return !!user!.value\n    },\n\n    get currentUser() {\n      return user!.value\n    },\n\n    // Direct access to SDK client for non-reactive operations\n    client: client!,\n\n    // Shorthand service access\n    auth: client!.auth,\n    ui: client!.ui,\n    db: client!.db,\n    router: client!.router,\n    config: client!.config,\n    files: client!.files,\n    storage: client!.storage,\n    log: client!.log,\n    theme: client!.theme,\n\n    // Theme control methods\n    setTheme: (mode: Theme['mode']) => client!.theme.setTheme(mode),\n    toggleTheme: () => client!.theme.toggle(),\n\n    // Entity change subscription\n    onEntityChange: client!.onEntityChange.bind(client)\n  }\n}\n\n// Re-export types for convenience\nexport type { User, Theme, RouterState, EntityDefinition, EntityChangeEvent }\n"],"names":[],"mappings":";;AAiBA,IAAI,SAAkC;AAGtC,IAAI,UAA+B;AACnC,IAAI,OAAuC;AAC3C,IAAI,SAA8B;AAClC,IAAI,YAAuC;AAC3C,IAAI,aAAiC;AACrC,IAAI,cAAyD;AAC7D,IAAI,aAAiC;AACrC,IAAI,WAAkD;AAEtD,IAAI,cAAc;AAElB,SAAS,kBAAkB;AACzB,MAAI,YAAa;AAEjB,WAAS,uBAAA;AAET,YAAU,IAAI,KAAK;AACnB,SAAO,WAAwB,IAAI;AACnC,WAAS,IAAI,KAAK;AAClB,cAAY,IAAmB,QAAQ;AACvC,eAAa,IAAI,GAAG;AACpB,gBAAc,WAAmC,EAAE;AACnD,eAAa,IAAI,EAAE;AACnB,aAAW,WAA+B,EAAE;AAG5C,SAAO,MAAM,KAAK,MAAM;AACtB,YAAS,QAAQ;AACjB,SAAM,QAAQ,OAAQ,KAAK;AAC3B,WAAQ,QAAQ,OAAQ,MAAM;AAC9B,cAAW,QAAQ,OAAQ,MAAM;AACjC,eAAY,QAAQ,OAAQ,OAAO;AACnC,gBAAa,QAAQ,OAAQ,OAAO;AACpC,eAAY,QAAQ,OAAQ,OAAO;AACnC,aAAU,QAAQ,OAAQ;AAAA,EAC5B,CAAC;AAGD,SAAO,KAAK,SAAS,CAAC,YAAY;AAChC,SAAM,QAAQ;AAAA,EAChB,CAAC;AAED,SAAO,MAAM,SAAS,CAAC,UAAU;AAC/B,WAAQ,QAAQ,MAAM;AACtB,cAAW,QAAQ,MAAM;AAAA,EAC3B,CAAC;AAED,SAAO,OAAO,SAAS,CAAC,UAAU;AAChC,eAAY,QAAQ,MAAM;AAC1B,gBAAa,QAAQ,MAAM;AAC3B,eAAY,QAAQ,MAAM;AAAA,EAC5B,CAAC;AAED,gBAAc;AAChB;AA0CO,SAAS,gBAAqC;AACnD,kBAAA;AAEA,SAAO;AAAA;AAAA,IAEL,SAAS,SAAS,OAAQ;AAAA,IAC1B,MAAM,SAAS,IAAK;AAAA,IACpB,QAAQ,SAAS,MAAO;AAAA,IACxB,WAAW,SAAS,SAAU;AAAA,IAC9B,YAAY,SAAS,UAAW;AAAA,IAChC,aAAa,SAAS,WAAY;AAAA,IAClC,YAAY,SAAS,UAAW;AAAA,IAChC,UAAU,SAAS,QAAS;AAAA;AAAA,IAG5B,IAAI,kBAAkB;AACpB,aAAO,CAAC,CAAC,KAAM;AAAA,IACjB;AAAA,IAEA,IAAI,cAAc;AAChB,aAAO,KAAM;AAAA,IACf;AAAA;AAAA,IAGA;AAAA;AAAA,IAGA,MAAM,OAAQ;AAAA,IACd,IAAI,OAAQ;AAAA,IACZ,IAAI,OAAQ;AAAA,IACZ,QAAQ,OAAQ;AAAA,IAChB,QAAQ,OAAQ;AAAA,IAChB,OAAO,OAAQ;AAAA,IACf,SAAS,OAAQ;AAAA,IACjB,KAAK,OAAQ;AAAA,IACb,OAAO,OAAQ;AAAA;AAAA,IAGf,UAAU,CAAC,SAAwB,OAAQ,MAAM,SAAS,IAAI;AAAA,IAC9D,aAAa,MAAM,OAAQ,MAAM,OAAA;AAAA;AAAA,IAGjC,gBAAgB,OAAQ,eAAe,KAAK,MAAM;AAAA,EAAA;AAEtD;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foundation-sdk",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "SDK for apps embedded in the Foundation container iframe",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -16,6 +16,16 @@
         "types": "./dist/index.d.ts",
         "default": "./dist/index.cjs"
       }
+    },
+    "./vue": {
+      "import": {
+        "types": "./dist/vue.d.ts",
+        "default": "./dist/vue.js"
+      },
+      "require": {
+        "types": "./dist/vue.d.ts",
+        "default": "./dist/vue.cjs"
+      }
     }
   },
   "files": [
@@ -36,10 +46,19 @@
   ],
   "author": "",
   "license": "MIT",
+  "peerDependencies": {
+    "vue": "^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vue": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "typescript": "^5.0.0",
     "vite": "^6.0.0",
-    "vite-plugin-dts": "^4.0.0"
+    "vite-plugin-dts": "^4.0.0",
+    "vue": "^3.5.0"
   },
   "sideEffects": false
 }