@yarvelle/ui 0.0.0-stage → 0.1.1

package/dist/lib/api/index.d.ts

@@ -0,0 +1,99 @@
+type AudienceBand = 'adult' | 'teen' | 'child' | 'viewer';
+interface UiContext {
+    profile_id: string;
+    scopes: string[];
+    hidden_panels: string[];
+    audience: AudienceBand;
+}
+interface UiPreference {
+    profile_id: string;
+    hidden_panels: string[];
+    theme_preference?: string | null;
+}
+interface UiPreferenceUpdate {
+    hidden_panels: string[];
+    theme_preference?: string | null;
+}
+type RiskLevel = 'low' | 'medium' | 'high' | 'critical';
+interface ApprovalRisk {
+    level: RiskLevel;
+    label: string;
+}
+interface ApprovalItem {
+    id: string;
+    profile_id: string;
+    tool_name: string;
+    action_summary: string;
+    parameters: Record<string, unknown>;
+    risk: ApprovalRisk;
+    status: 'pending' | 'approved' | 'rejected' | 'expired';
+    created_at: string;
+    expires_at?: string;
+}
+interface ApprovalDecisionRequest {
+    decision: 'approve' | 'reject';
+    reason?: string;
+}
+interface NoteItem {
+    id: string;
+    title: string;
+    content: string;
+    tags?: string[];
+    created_at: string;
+    updated_at: string;
+}
+interface ReminderItem {
+    id: string;
+    profile_id: string;
+    title: string;
+    rrule?: string;
+    due_date?: string;
+    completed: boolean;
+    snoozed_until?: string;
+}
+interface TaskItemData {
+    id: string;
+    profile_id: string;
+    title: string;
+    completed: boolean;
+    priority?: 'low' | 'medium' | 'high';
+    due_date?: string;
+}
+interface RoutineItem {
+    id: string;
+    profile_id: string;
+    name: string;
+    schedule: string;
+    steps: string[];
+    enabled: boolean;
+}
+
+declare class ApiClient {
+    private baseUrl;
+    constructor(baseUrl?: string);
+    private request;
+    getUiContext(profileId?: string): Promise<UiContext>;
+    getUiPrefs(profileId: string): Promise<UiPreference>;
+    updateUiPrefs(profileId: string, prefs: UiPreferenceUpdate): Promise<UiPreference>;
+    decideApproval(approvalId: string, decision: 'approve' | 'reject', reason?: string): Promise<ApprovalItem>;
+    resumeChat(threadId: string, payload?: Record<string, unknown>): Promise<{
+        status: string;
+    }>;
+}
+declare const defaultApiClient: ApiClient;
+
+declare function useUiContext(profileId?: string): {
+    data: UiContext | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+declare function useUiPrefs(profileId: string): {
+    data: UiPreference | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+    updatePrefs: (prefs: UiPreferenceUpdate) => Promise<UiPreference>;
+};
+
+export { ApiClient, type ApprovalDecisionRequest, type ApprovalItem, type ApprovalRisk, type AudienceBand, type NoteItem, type ReminderItem, type RiskLevel, type RoutineItem, type TaskItemData, type UiContext, type UiPreference, type UiPreferenceUpdate, defaultApiClient, useUiContext, useUiPrefs };

package/dist/lib/api/index.js

@@ -0,0 +1,113 @@
+// src/lib/api/client.ts
+var ApiClient = class {
+  baseUrl;
+  constructor(baseUrl = "/api/v1") {
+    this.baseUrl = baseUrl.replace(/\/+$/, "");
+  }
+  async request(path, options = {}) {
+    const url = `${this.baseUrl}${path.startsWith("/") ? path : `/${path}`}`;
+    const headers = new Headers(options.headers || {});
+    if (!headers.has("Content-Type") && options.body && typeof options.body === "string") {
+      headers.set("Content-Type", "application/json");
+    }
+    const response = await fetch(url, { ...options, headers });
+    if (!response.ok) {
+      let detail = `HTTP ${response.status} ${response.statusText}`;
+      try {
+        const body = await response.json();
+        if (body.detail) detail = body.detail;
+      } catch {
+      }
+      throw new Error(detail);
+    }
+    return response.json();
+  }
+  async getUiContext(profileId) {
+    const q = profileId ? `?profile_id=${encodeURIComponent(profileId)}` : "";
+    return this.request(`/me/ui-context${q}`);
+  }
+  async getUiPrefs(profileId) {
+    return this.request(`/me/profiles/${encodeURIComponent(profileId)}/ui-prefs`);
+  }
+  async updateUiPrefs(profileId, prefs) {
+    return this.request(`/me/profiles/${encodeURIComponent(profileId)}/ui-prefs`, {
+      method: "PUT",
+      body: JSON.stringify(prefs)
+    });
+  }
+  async decideApproval(approvalId, decision, reason) {
+    const body = { decision, reason };
+    return this.request(`/approvals/${encodeURIComponent(approvalId)}/decide`, {
+      method: "POST",
+      body: JSON.stringify(body)
+    });
+  }
+  async resumeChat(threadId, payload = {}) {
+    return this.request(`/chat/resume`, {
+      method: "POST",
+      body: JSON.stringify({ thread_id: threadId, ...payload })
+    });
+  }
+};
+var defaultApiClient = new ApiClient();
+
+// src/lib/api/hooks.ts
+import { useCallback, useEffect, useState } from "react";
+function useUiContext(profileId) {
+  const [data, setData] = useState(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const refetch = useCallback(async () => {
+    setLoading(true);
+    setError(null);
+    try {
+      const result = await defaultApiClient.getUiContext(profileId);
+      setData(result);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error(String(err)));
+    } finally {
+      setLoading(false);
+    }
+  }, [profileId]);
+  useEffect(() => {
+    refetch();
+  }, [refetch]);
+  return { data, loading, error, refetch };
+}
+function useUiPrefs(profileId) {
+  const [data, setData] = useState(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const refetch = useCallback(async () => {
+    if (!profileId) return;
+    setLoading(true);
+    setError(null);
+    try {
+      const result = await defaultApiClient.getUiPrefs(profileId);
+      setData(result);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error(String(err)));
+    } finally {
+      setLoading(false);
+    }
+  }, [profileId]);
+  useEffect(() => {
+    refetch();
+  }, [refetch]);
+  const updatePrefs = useCallback(
+    async (prefs) => {
+      const updated = await defaultApiClient.updateUiPrefs(profileId, prefs);
+      setData(updated);
+      return updated;
+    },
+    [profileId]
+  );
+  return { data, loading, error, refetch, updatePrefs };
+}
+export {
+  ApiClient,
+  defaultApiClient,
+  useUiContext,
+  useUiPrefs
+};
+//# sourceMappingURL=index.js.map

package/dist/lib/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lib/api/client.ts","../../../src/lib/api/hooks.ts"],"sourcesContent":["// Yarvelle Core — Domain-Neutral AI Agent Runtime & Execution Engine\n// Copyright 2026 Spectrayan (https://spectrayan.com)\n//\n// Licensed under the PolyForm Noncommercial License 1.0.0 and the\n// Yarvelle Core Additional Terms (see LICENSE and ADDITIONAL-TERMS.md).\n// Personal and household local use only. Commercial use, hosted service\n// offering, rebranding, white-labeling, and redistribution of modified\n// forks are prohibited without a written commercial license from Spectrayan.\n//\n// Required Notice: Copyright 2026 Spectrayan (https://spectrayan.com)\n\nimport type {\n  ApprovalDecisionRequest,\n  ApprovalItem,\n  NoteItem,\n  ReminderItem,\n  RoutineItem,\n  TaskItemData,\n  UiContext,\n  UiPreference,\n  UiPreferenceUpdate,\n} from './types.js';\n\nexport class ApiClient {\n  private baseUrl: string;\n\n  constructor(baseUrl: string = '/api/v1') {\n    this.baseUrl = baseUrl.replace(/\\/+$/, '');\n  }\n\n  private async request<T>(path: string, options: RequestInit = {}): Promise<T> {\n    const url = `${this.baseUrl}${path.startsWith('/') ? path : `/${path}`}`;\n    const headers = new Headers(options.headers || {});\n    if (!headers.has('Content-Type') && options.body && typeof options.body === 'string') {\n      headers.set('Content-Type', 'application/json');\n    }\n\n    const response = await fetch(url, { ...options, headers });\n    if (!response.ok) {\n      let detail = `HTTP ${response.status} ${response.statusText}`;\n      try {\n        const body = await response.json();\n        if (body.detail) detail = body.detail;\n      } catch {\n        // Fallback to text status\n      }\n      throw new Error(detail);\n    }\n    return response.json() as Promise<T>;\n  }\n\n  async getUiContext(profileId?: string): Promise<UiContext> {\n    const q = profileId ? `?profile_id=${encodeURIComponent(profileId)}` : '';\n    return this.request<UiContext>(`/me/ui-context${q}`);\n  }\n\n  async getUiPrefs(profileId: string): Promise<UiPreference> {\n    return this.request<UiPreference>(`/me/profiles/${encodeURIComponent(profileId)}/ui-prefs`);\n  }\n\n  async updateUiPrefs(profileId: string, prefs: UiPreferenceUpdate): Promise<UiPreference> {\n    return this.request<UiPreference>(`/me/profiles/${encodeURIComponent(profileId)}/ui-prefs`, {\n      method: 'PUT',\n      body: JSON.stringify(prefs),\n    });\n  }\n\n  async decideApproval(approvalId: string, decision: 'approve' | 'reject', reason?: string): Promise<ApprovalItem> {\n    const body: ApprovalDecisionRequest = { decision, reason };\n    return this.request<ApprovalItem>(`/approvals/${encodeURIComponent(approvalId)}/decide`, {\n      method: 'POST',\n      body: JSON.stringify(body),\n    });\n  }\n\n  async resumeChat(threadId: string, payload: Record<string, unknown> = {}): Promise<{ status: string }> {\n    return this.request<{ status: string }>(`/chat/resume`, {\n      method: 'POST',\n      body: JSON.stringify({ thread_id: threadId, ...payload }),\n    });\n  }\n}\n\nexport const defaultApiClient = new ApiClient();\n","// Yarvelle Core — Domain-Neutral AI Agent Runtime & Execution Engine\n// Copyright 2026 Spectrayan (https://spectrayan.com)\n//\n// Licensed under the PolyForm Noncommercial License 1.0.0 and the\n// Yarvelle Core Additional Terms (see LICENSE and ADDITIONAL-TERMS.md).\n// Personal and household local use only. Commercial use, hosted service\n// offering, rebranding, white-labeling, and redistribution of modified\n// forks are prohibited without a written commercial license from Spectrayan.\n//\n// Required Notice: Copyright 2026 Spectrayan (https://spectrayan.com)\n\nimport { useCallback, useEffect, useState } from 'react';\nimport { defaultApiClient } from './client.js';\nimport type { UiContext, UiPreference, UiPreferenceUpdate } from './types.js';\n\nexport function useUiContext(profileId?: string) {\n  const [data, setData] = useState<UiContext | null>(null);\n  const [loading, setLoading] = useState<boolean>(true);\n  const [error, setError] = useState<Error | null>(null);\n\n  const refetch = useCallback(async () => {\n    setLoading(true);\n    setError(null);\n    try {\n      const result = await defaultApiClient.getUiContext(profileId);\n      setData(result);\n    } catch (err) {\n      setError(err instanceof Error ? err : new Error(String(err)));\n    } finally {\n      setLoading(false);\n    }\n  }, [profileId]);\n\n  useEffect(() => {\n    refetch();\n  }, [refetch]);\n\n  return { data, loading, error, refetch };\n}\n\nexport function useUiPrefs(profileId: string) {\n  const [data, setData] = useState<UiPreference | null>(null);\n  const [loading, setLoading] = useState<boolean>(true);\n  const [error, setError] = useState<Error | null>(null);\n\n  const refetch = useCallback(async () => {\n    if (!profileId) return;\n    setLoading(true);\n    setError(null);\n    try {\n      const result = await defaultApiClient.getUiPrefs(profileId);\n      setData(result);\n    } catch (err) {\n      setError(err instanceof Error ? err : new Error(String(err)));\n    } finally {\n      setLoading(false);\n    }\n  }, [profileId]);\n\n  useEffect(() => {\n    refetch();\n  }, [refetch]);\n\n  const updatePrefs = useCallback(\n    async (prefs: UiPreferenceUpdate) => {\n      const updated = await defaultApiClient.updateUiPrefs(profileId, prefs);\n      setData(updated);\n      return updated;\n    },\n    [profileId]\n  );\n\n  return { data, loading, error, refetch, updatePrefs };\n}\n"],"mappings":"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","names":[]}

package/dist/lib/auth/index.d.ts

@@ -0,0 +1,21 @@
+import React__default from 'react';
+
+interface UserSession {
+    userId: string;
+    username: string;
+    role: string;
+    token?: string;
+}
+interface AuthContextValue {
+    session: UserSession | null;
+    isAuthenticated: boolean;
+    setSession: (session: UserSession | null) => void;
+    logout: () => void;
+}
+declare const AuthProvider: React__default.FC<{
+    children: React__default.ReactNode;
+    initialSession?: UserSession | null;
+}>;
+declare const useAuth: () => AuthContextValue;
+
+export { type AuthContextValue, AuthProvider, type UserSession, useAuth };

package/dist/lib/auth/index.js

@@ -0,0 +1,37 @@
+// src/lib/auth/auth-context.ts
+import React, { createContext, useContext, useState } from "react";
+var AuthContext = createContext({
+  session: null,
+  isAuthenticated: false,
+  setSession: () => {
+  },
+  logout: () => {
+  }
+});
+var AuthProvider = ({
+  children,
+  initialSession = null
+}) => {
+  const [session, setSession] = useState(initialSession);
+  const logout = () => {
+    setSession(null);
+  };
+  return React.createElement(
+    AuthContext.Provider,
+    {
+      value: {
+        session,
+        isAuthenticated: !!session,
+        setSession,
+        logout
+      }
+    },
+    children
+  );
+};
+var useAuth = () => useContext(AuthContext);
+export {
+  AuthProvider,
+  useAuth
+};
+//# sourceMappingURL=index.js.map

package/dist/lib/auth/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lib/auth/auth-context.ts"],"sourcesContent":["// Yarvelle Core — Domain-Neutral AI Agent Runtime & Execution Engine\n// Copyright 2026 Spectrayan (https://spectrayan.com)\n//\n// Licensed under the PolyForm Noncommercial License 1.0.0 and the\n// Yarvelle Core Additional Terms (see LICENSE and ADDITIONAL-TERMS.md).\n// Personal and household local use only. Commercial use, hosted service\n// offering, rebranding, white-labeling, and redistribution of modified\n// forks are prohibited without a written commercial license from Spectrayan.\n//\n// Required Notice: Copyright 2026 Spectrayan (https://spectrayan.com)\n\nimport React, { createContext, useContext, useState } from 'react';\n\nexport interface UserSession {\n  userId: string;\n  username: string;\n  role: string;\n  token?: string;\n}\n\nexport interface AuthContextValue {\n  session: UserSession | null;\n  isAuthenticated: boolean;\n  setSession: (session: UserSession | null) => void;\n  logout: () => void;\n}\n\nconst AuthContext = createContext<AuthContextValue>({\n  session: null,\n  isAuthenticated: false,\n  setSession: () => {},\n  logout: () => {},\n});\n\nexport const AuthProvider: React.FC<{ children: React.ReactNode; initialSession?: UserSession | null }> = ({\n  children,\n  initialSession = null,\n}) => {\n  const [session, setSession] = useState<UserSession | null>(initialSession);\n\n  const logout = () => {\n    setSession(null);\n  };\n\n  return React.createElement(\n    AuthContext.Provider,\n    {\n      value: {\n        session,\n        isAuthenticated: !!session,\n        setSession,\n        logout,\n      },\n    },\n    children\n  );\n};\n\nexport const useAuth = () => useContext(AuthContext);\n"],"mappings":";AAWA,OAAO,SAAS,eAAe,YAAY,gBAAgB;AAgB3D,IAAM,cAAc,cAAgC;AAAA,EAClD,SAAS;AAAA,EACT,iBAAiB;AAAA,EACjB,YAAY,MAAM;AAAA,EAAC;AAAA,EACnB,QAAQ,MAAM;AAAA,EAAC;AACjB,CAAC;AAEM,IAAM,eAA6F,CAAC;AAAA,EACzG;AAAA,EACA,iBAAiB;AACnB,MAAM;AACJ,QAAM,CAAC,SAAS,UAAU,IAAI,SAA6B,cAAc;AAEzE,QAAM,SAAS,MAAM;AACnB,eAAW,IAAI;AAAA,EACjB;AAEA,SAAO,MAAM;AAAA,IACX,YAAY;AAAA,IACZ;AAAA,MACE,OAAO;AAAA,QACL;AAAA,QACA,iBAAiB,CAAC,CAAC;AAAA,QACnB;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAAA,IACA;AAAA,EACF;AACF;AAEO,IAAM,UAAU,MAAM,WAAW,WAAW;","names":[]}

package/dist/lib/cn.d.ts

@@ -0,0 +1,5 @@
+import { ClassValue } from 'clsx';
+
+declare function cn(...inputs: ClassValue[]): string;
+
+export { cn };

package/dist/lib/cn.js

@@ -0,0 +1,10 @@
+// src/lib/cn.ts
+import { clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+function cn(...inputs) {
+  return twMerge(clsx(inputs));
+}
+export {
+  cn
+};
+//# sourceMappingURL=cn.js.map

package/dist/lib/cn.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/cn.ts"],"sourcesContent":["// Yarvelle Core — Domain-Neutral AI Agent Runtime & Execution Engine\n// Copyright 2026 Spectrayan (https://spectrayan.com)\n//\n// Licensed under the PolyForm Noncommercial License 1.0.0 and the\n// Yarvelle Core Additional Terms (see LICENSE and ADDITIONAL-TERMS.md).\n// Personal and household local use only. Commercial use, hosted service\n// offering, rebranding, white-labeling, and redistribution of modified\n// forks are prohibited without a written commercial license from Spectrayan.\n//\n// Required Notice: Copyright 2026 Spectrayan (https://spectrayan.com)\n\nimport { clsx, type ClassValue } from 'clsx';\nimport { twMerge } from 'tailwind-merge';\n\nexport function cn(...inputs: ClassValue[]): string {\n  return twMerge(clsx(inputs));\n}\n"],"mappings":";AAWA,SAAS,YAA6B;AACtC,SAAS,eAAe;AAEjB,SAAS,MAAM,QAA8B;AAClD,SAAO,QAAQ,KAAK,MAAM,CAAC;AAC7B;","names":[]}

package/dist/lib/i18n/index.d.ts

@@ -0,0 +1,7 @@
+declare function getTextDirection(locale: string): 'ltr' | 'rtl';
+declare function formatDate(value: Date | string | number, locale?: string, options?: Intl.DateTimeFormatOptions): string;
+declare function formatTime(value: Date | string | number, locale?: string, options?: Intl.DateTimeFormatOptions): string;
+declare function formatDateTime(value: Date | string | number, locale?: string, options?: Intl.DateTimeFormatOptions): string;
+declare function formatNumber(value: number, locale?: string, options?: Intl.NumberFormatOptions): string;
+
+export { formatDate, formatDateTime, formatNumber, formatTime, getTextDirection };

package/dist/lib/i18n/index.js

@@ -0,0 +1,45 @@
+// src/lib/i18n/formatters.ts
+function getTextDirection(locale) {
+  const rtlLocales = ["ar", "he", "fa", "ur", "ar-SA", "he-IL"];
+  const prefix = locale.split("-")[0].toLowerCase();
+  return rtlLocales.includes(locale) || rtlLocales.includes(prefix) ? "rtl" : "ltr";
+}
+function formatDate(value, locale = "en-US", options = { dateStyle: "medium" }) {
+  const d = typeof value === "object" ? value : new Date(value);
+  try {
+    return new Intl.DateTimeFormat(locale, options).format(d);
+  } catch {
+    return d.toLocaleDateString();
+  }
+}
+function formatTime(value, locale = "en-US", options = { timeStyle: "short" }) {
+  const d = typeof value === "object" ? value : new Date(value);
+  try {
+    return new Intl.DateTimeFormat(locale, options).format(d);
+  } catch {
+    return d.toLocaleTimeString();
+  }
+}
+function formatDateTime(value, locale = "en-US", options = { dateStyle: "medium", timeStyle: "short" }) {
+  const d = typeof value === "object" ? value : new Date(value);
+  try {
+    return new Intl.DateTimeFormat(locale, options).format(d);
+  } catch {
+    return `${d.toLocaleDateString()} ${d.toLocaleTimeString()}`;
+  }
+}
+function formatNumber(value, locale = "en-US", options = {}) {
+  try {
+    return new Intl.NumberFormat(locale, options).format(value);
+  } catch {
+    return String(value);
+  }
+}
+export {
+  formatDate,
+  formatDateTime,
+  formatNumber,
+  formatTime,
+  getTextDirection
+};
+//# sourceMappingURL=index.js.map

package/dist/lib/i18n/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/lib/i18n/formatters.ts"],"sourcesContent":["// Yarvelle Core — Domain-Neutral AI Agent Runtime & Execution Engine\n// Copyright 2026 Spectrayan (https://spectrayan.com)\n//\n// Licensed under the PolyForm Noncommercial License 1.0.0 and the\n// Yarvelle Core Additional Terms (see LICENSE and ADDITIONAL-TERMS.md).\n// Personal and household local use only. Commercial use, hosted service\n// offering, rebranding, white-labeling, and redistribution of modified\n// forks are prohibited without a written commercial license from Spectrayan.\n//\n// Required Notice: Copyright 2026 Spectrayan (https://spectrayan.com)\n\nexport function getTextDirection(locale: string): 'ltr' | 'rtl' {\n  const rtlLocales = ['ar', 'he', 'fa', 'ur', 'ar-SA', 'he-IL'];\n  const prefix = locale.split('-')[0].toLowerCase();\n  return rtlLocales.includes(locale) || rtlLocales.includes(prefix) ? 'rtl' : 'ltr';\n}\n\nexport function formatDate(\n  value: Date | string | number,\n  locale: string = 'en-US',\n  options: Intl.DateTimeFormatOptions = { dateStyle: 'medium' }\n): string {\n  const d = typeof value === 'object' ? value : new Date(value);\n  try {\n    return new Intl.DateTimeFormat(locale, options).format(d);\n  } catch {\n    return d.toLocaleDateString();\n  }\n}\n\nexport function formatTime(\n  value: Date | string | number,\n  locale: string = 'en-US',\n  options: Intl.DateTimeFormatOptions = { timeStyle: 'short' }\n): string {\n  const d = typeof value === 'object' ? value : new Date(value);\n  try {\n    return new Intl.DateTimeFormat(locale, options).format(d);\n  } catch {\n    return d.toLocaleTimeString();\n  }\n}\n\nexport function formatDateTime(\n  value: Date | string | number,\n  locale: string = 'en-US',\n  options: Intl.DateTimeFormatOptions = { dateStyle: 'medium', timeStyle: 'short' }\n): string {\n  const d = typeof value === 'object' ? value : new Date(value);\n  try {\n    return new Intl.DateTimeFormat(locale, options).format(d);\n  } catch {\n    return `${d.toLocaleDateString()} ${d.toLocaleTimeString()}`;\n  }\n}\n\nexport function formatNumber(\n  value: number,\n  locale: string = 'en-US',\n  options: Intl.NumberFormatOptions = {}\n): string {\n  try {\n    return new Intl.NumberFormat(locale, options).format(value);\n  } catch {\n    return String(value);\n  }\n}\n"],"mappings":";AAWO,SAAS,iBAAiB,QAA+B;AAC9D,QAAM,aAAa,CAAC,MAAM,MAAM,MAAM,MAAM,SAAS,OAAO;AAC5D,QAAM,SAAS,OAAO,MAAM,GAAG,EAAE,CAAC,EAAE,YAAY;AAChD,SAAO,WAAW,SAAS,MAAM,KAAK,WAAW,SAAS,MAAM,IAAI,QAAQ;AAC9E;AAEO,SAAS,WACd,OACA,SAAiB,SACjB,UAAsC,EAAE,WAAW,SAAS,GACpD;AACR,QAAM,IAAI,OAAO,UAAU,WAAW,QAAQ,IAAI,KAAK,KAAK;AAC5D,MAAI;AACF,WAAO,IAAI,KAAK,eAAe,QAAQ,OAAO,EAAE,OAAO,CAAC;AAAA,EAC1D,QAAQ;AACN,WAAO,EAAE,mBAAmB;AAAA,EAC9B;AACF;AAEO,SAAS,WACd,OACA,SAAiB,SACjB,UAAsC,EAAE,WAAW,QAAQ,GACnD;AACR,QAAM,IAAI,OAAO,UAAU,WAAW,QAAQ,IAAI,KAAK,KAAK;AAC5D,MAAI;AACF,WAAO,IAAI,KAAK,eAAe,QAAQ,OAAO,EAAE,OAAO,CAAC;AAAA,EAC1D,QAAQ;AACN,WAAO,EAAE,mBAAmB;AAAA,EAC9B;AACF;AAEO,SAAS,eACd,OACA,SAAiB,SACjB,UAAsC,EAAE,WAAW,UAAU,WAAW,QAAQ,GACxE;AACR,QAAM,IAAI,OAAO,UAAU,WAAW,QAAQ,IAAI,KAAK,KAAK;AAC5D,MAAI;AACF,WAAO,IAAI,KAAK,eAAe,QAAQ,OAAO,EAAE,OAAO,CAAC;AAAA,EAC1D,QAAQ;AACN,WAAO,GAAG,EAAE,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,CAAC;AAAA,EAC5D;AACF;AAEO,SAAS,aACd,OACA,SAAiB,SACjB,UAAoC,CAAC,GAC7B;AACR,MAAI;AACF,WAAO,IAAI,KAAK,aAAa,QAAQ,OAAO,EAAE,OAAO,KAAK;AAAA,EAC5D,QAAQ;AACN,WAAO,OAAO,KAAK;AAAA,EACrB;AACF;","names":[]}

package/dist/lib/index.d.ts

@@ -0,0 +1,8 @@
+export { getScopedItem, getStorageKey, removeScopedItem, setScopedItem } from './storage-namespace.js';
+export { ApiClient, ApprovalDecisionRequest, ApprovalItem, ApprovalRisk, AudienceBand, NoteItem, ReminderItem, RiskLevel, RoutineItem, TaskItemData, UiContext, UiPreference, UiPreferenceUpdate, defaultApiClient, useUiContext, useUiPrefs } from './api/index.js';
+export { SseEvent, parseSseChunk } from './sse/index.js';
+export { AuthContextValue, AuthProvider, UserSession, useAuth } from './auth/index.js';
+export { formatDate, formatDateTime, formatNumber, formatTime, getTextDirection } from './i18n/index.js';
+export { cn } from './cn.js';
+import 'react';
+import 'clsx';

package/dist/lib/index.js

@@ -0,0 +1,272 @@
+// src/lib/storage-namespace.ts
+function getStorageKey(namespace, key, suffix) {
+  const base = `${namespace}_${key}`;
+  return suffix ? `${base}_${suffix}` : base;
+}
+function getScopedItem(namespace, key, suffix) {
+  if (typeof window === "undefined") return null;
+  try {
+    return localStorage.getItem(getStorageKey(namespace, key, suffix));
+  } catch {
+    return null;
+  }
+}
+function setScopedItem(namespace, key, value, suffix) {
+  if (typeof window === "undefined") return;
+  try {
+    localStorage.setItem(getStorageKey(namespace, key, suffix), value);
+  } catch {
+  }
+}
+function removeScopedItem(namespace, key, suffix) {
+  if (typeof window === "undefined") return;
+  try {
+    localStorage.removeItem(getStorageKey(namespace, key, suffix));
+  } catch {
+  }
+}
+
+// src/lib/api/client.ts
+var ApiClient = class {
+  baseUrl;
+  constructor(baseUrl = "/api/v1") {
+    this.baseUrl = baseUrl.replace(/\/+$/, "");
+  }
+  async request(path, options = {}) {
+    const url = `${this.baseUrl}${path.startsWith("/") ? path : `/${path}`}`;
+    const headers = new Headers(options.headers || {});
+    if (!headers.has("Content-Type") && options.body && typeof options.body === "string") {
+      headers.set("Content-Type", "application/json");
+    }
+    const response = await fetch(url, { ...options, headers });
+    if (!response.ok) {
+      let detail = `HTTP ${response.status} ${response.statusText}`;
+      try {
+        const body = await response.json();
+        if (body.detail) detail = body.detail;
+      } catch {
+      }
+      throw new Error(detail);
+    }
+    return response.json();
+  }
+  async getUiContext(profileId) {
+    const q = profileId ? `?profile_id=${encodeURIComponent(profileId)}` : "";
+    return this.request(`/me/ui-context${q}`);
+  }
+  async getUiPrefs(profileId) {
+    return this.request(`/me/profiles/${encodeURIComponent(profileId)}/ui-prefs`);
+  }
+  async updateUiPrefs(profileId, prefs) {
+    return this.request(`/me/profiles/${encodeURIComponent(profileId)}/ui-prefs`, {
+      method: "PUT",
+      body: JSON.stringify(prefs)
+    });
+  }
+  async decideApproval(approvalId, decision, reason) {
+    const body = { decision, reason };
+    return this.request(`/approvals/${encodeURIComponent(approvalId)}/decide`, {
+      method: "POST",
+      body: JSON.stringify(body)
+    });
+  }
+  async resumeChat(threadId, payload = {}) {
+    return this.request(`/chat/resume`, {
+      method: "POST",
+      body: JSON.stringify({ thread_id: threadId, ...payload })
+    });
+  }
+};
+var defaultApiClient = new ApiClient();
+
+// src/lib/api/hooks.ts
+import { useCallback, useEffect, useState } from "react";
+function useUiContext(profileId) {
+  const [data, setData] = useState(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const refetch = useCallback(async () => {
+    setLoading(true);
+    setError(null);
+    try {
+      const result = await defaultApiClient.getUiContext(profileId);
+      setData(result);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error(String(err)));
+    } finally {
+      setLoading(false);
+    }
+  }, [profileId]);
+  useEffect(() => {
+    refetch();
+  }, [refetch]);
+  return { data, loading, error, refetch };
+}
+function useUiPrefs(profileId) {
+  const [data, setData] = useState(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const refetch = useCallback(async () => {
+    if (!profileId) return;
+    setLoading(true);
+    setError(null);
+    try {
+      const result = await defaultApiClient.getUiPrefs(profileId);
+      setData(result);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error(String(err)));
+    } finally {
+      setLoading(false);
+    }
+  }, [profileId]);
+  useEffect(() => {
+    refetch();
+  }, [refetch]);
+  const updatePrefs = useCallback(
+    async (prefs) => {
+      const updated = await defaultApiClient.updateUiPrefs(profileId, prefs);
+      setData(updated);
+      return updated;
+    },
+    [profileId]
+  );
+  return { data, loading, error, refetch, updatePrefs };
+}
+
+// src/lib/sse/parser.ts
+function parseSseChunk(chunk, buffer = "") {
+  const combined = buffer + chunk;
+  const lines = combined.split(/\r?\n/);
+  const events = [];
+  let currentEvent = { data: "" };
+  let hasData = false;
+  const completeLines = lines.slice(0, -1);
+  const remaining = lines[lines.length - 1];
+  for (const line of completeLines) {
+    if (line.trim() === "") {
+      if (hasData) {
+        events.push(currentEvent);
+        currentEvent = { data: "" };
+        hasData = false;
+      }
+      continue;
+    }
+    if (line.startsWith(":")) {
+      continue;
+    }
+    const colonIdx = line.indexOf(":");
+    if (colonIdx === -1) {
+      continue;
+    }
+    const field = line.slice(0, colonIdx).trim();
+    const value = line.slice(colonIdx + 1).replace(/^\s/, "");
+    if (field === "event") {
+      currentEvent.event = value;
+    } else if (field === "data") {
+      currentEvent.data = currentEvent.data ? `${currentEvent.data}
+${value}` : value;
+      hasData = true;
+    } else if (field === "id") {
+      currentEvent.id = value;
+    }
+  }
+  return { events, remainingBuffer: remaining };
+}
+
+// src/lib/auth/auth-context.ts
+import React, { createContext, useContext, useState as useState2 } from "react";
+var AuthContext = createContext({
+  session: null,
+  isAuthenticated: false,
+  setSession: () => {
+  },
+  logout: () => {
+  }
+});
+var AuthProvider = ({
+  children,
+  initialSession = null
+}) => {
+  const [session, setSession] = useState2(initialSession);
+  const logout = () => {
+    setSession(null);
+  };
+  return React.createElement(
+    AuthContext.Provider,
+    {
+      value: {
+        session,
+        isAuthenticated: !!session,
+        setSession,
+        logout
+      }
+    },
+    children
+  );
+};
+var useAuth = () => useContext(AuthContext);
+
+// src/lib/i18n/formatters.ts
+function getTextDirection(locale) {
+  const rtlLocales = ["ar", "he", "fa", "ur", "ar-SA", "he-IL"];
+  const prefix = locale.split("-")[0].toLowerCase();
+  return rtlLocales.includes(locale) || rtlLocales.includes(prefix) ? "rtl" : "ltr";
+}
+function formatDate(value, locale = "en-US", options = { dateStyle: "medium" }) {
+  const d = typeof value === "object" ? value : new Date(value);
+  try {
+    return new Intl.DateTimeFormat(locale, options).format(d);
+  } catch {
+    return d.toLocaleDateString();
+  }
+}
+function formatTime(value, locale = "en-US", options = { timeStyle: "short" }) {
+  const d = typeof value === "object" ? value : new Date(value);
+  try {
+    return new Intl.DateTimeFormat(locale, options).format(d);
+  } catch {
+    return d.toLocaleTimeString();
+  }
+}
+function formatDateTime(value, locale = "en-US", options = { dateStyle: "medium", timeStyle: "short" }) {
+  const d = typeof value === "object" ? value : new Date(value);
+  try {
+    return new Intl.DateTimeFormat(locale, options).format(d);
+  } catch {
+    return `${d.toLocaleDateString()} ${d.toLocaleTimeString()}`;
+  }
+}
+function formatNumber(value, locale = "en-US", options = {}) {
+  try {
+    return new Intl.NumberFormat(locale, options).format(value);
+  } catch {
+    return String(value);
+  }
+}
+
+// src/lib/cn.ts
+import { clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+function cn(...inputs) {
+  return twMerge(clsx(inputs));
+}
+export {
+  ApiClient,
+  AuthProvider,
+  cn,
+  defaultApiClient,
+  formatDate,
+  formatDateTime,
+  formatNumber,
+  formatTime,
+  getScopedItem,
+  getStorageKey,
+  getTextDirection,
+  parseSseChunk,
+  removeScopedItem,
+  setScopedItem,
+  useAuth,
+  useUiContext,
+  useUiPrefs
+};
+//# sourceMappingURL=index.js.map