@fiodos/web-core 0.1.0

package/dist/cjs/ui/messages.d.ts

@@ -0,0 +1,36 @@
+/**
+ * UI strings for the web orb (buttons, modal titles, consent copy). Spoken
+ * agent messages come from @fiodos/core's AgentMessages; these are only the
+ * DOM-chrome labels the orb renders. English and Spanish ship built-in.
+ */
+export interface WebUiMessages {
+    /** Accessible label for the orb button. */
+    orbLabel: string;
+    /** Confirmation modal title. */
+    confirmTitle: string;
+    /** Confirm button label. */
+    confirmLabel: string;
+    /** Cancel button label. */
+    cancelLabel: string;
+    /** Consent modal title. */
+    consentTitle: string;
+    /** Consent body paragraph. */
+    consentBody: string;
+    /** Consent accept button. */
+    consentAccept: string;
+    /** Consent decline button. */
+    consentDecline: string;
+    /** Placeholder for the text input bubble. */
+    textPlaceholder: string;
+    /** Accessible label for the keyboard chip beside the orb. */
+    keyboardChipLabel: string;
+    /** Send button label for the text bubble. */
+    sendLabel: string;
+    /** Spoken/shown when the browser lacks speech recognition. */
+    voiceUnavailable: string;
+}
+export interface ResolveUiMessagesOptions {
+    catalogs?: Record<string, WebUiMessages>;
+    overrides?: Partial<WebUiMessages>;
+}
+export declare function resolveUiMessages(locale: string, options?: ResolveUiMessagesOptions): WebUiMessages;

package/dist/cjs/ui/messages.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveUiMessages = resolveUiMessages;
+const en = {
+    orbLabel: 'Voice assistant',
+    confirmTitle: 'Confirm',
+    confirmLabel: 'Confirm',
+    cancelLabel: 'Cancel',
+    consentTitle: 'Voice assistant',
+    consentBody: 'This assistant uses your microphone to understand voice commands and may navigate or perform actions in this app on your behalf. Your speech is processed to answer you and is not stored as a transcript.',
+    consentAccept: 'Allow',
+    consentDecline: 'Not now',
+    textPlaceholder: 'Type a message…',
+    keyboardChipLabel: 'Type instead of talking',
+    sendLabel: 'Send',
+    voiceUnavailable: 'Voice input is not available in this browser. You can type instead.',
+};
+const es = {
+    orbLabel: 'Asistente de voz',
+    confirmTitle: 'Confirmar',
+    confirmLabel: 'Confirmar',
+    cancelLabel: 'Cancelar',
+    consentTitle: 'Asistente de voz',
+    consentBody: 'Este asistente usa tu micrófono para entender comandos de voz y puede navegar o realizar acciones en esta app en tu nombre. Tu voz se procesa para responderte y no se guarda como transcripción.',
+    consentAccept: 'Permitir',
+    consentDecline: 'Ahora no',
+    textPlaceholder: 'Escribe un mensaje…',
+    keyboardChipLabel: 'Escribir en lugar de hablar',
+    sendLabel: 'Enviar',
+    voiceUnavailable: 'La entrada por voz no está disponible en este navegador. Puedes escribir.',
+};
+const CATALOGS = { en, es };
+function baseLanguage(locale) {
+    return locale.split(/[-_]/)[0]?.toLowerCase() ?? locale.toLowerCase();
+}
+function resolveUiMessages(locale, options = {}) {
+    const externals = options.catalogs ?? {};
+    const base = baseLanguage(locale);
+    const resolved = externals[locale] ?? CATALOGS[locale] ?? externals[base] ?? CATALOGS[base] ?? en;
+    return options.overrides ? { ...resolved, ...options.overrides } : resolved;
+}

package/dist/esm/adapters/webNavigationAdapter.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Web NavigationAdapter — framework-agnostic. The manifest route strings for a
+ * web app are URL paths (e.g. "/cart"). The host provides a `navigate` delegate
+ * (Vue Router's `router.push`, SvelteKit's `goto`, Angular Router's
+ * `navigateByUrl`, or a plain `location.assign`) and the adapter forwards the
+ * opaque route string. The router owns query-string / param interpretation.
+ *
+ * `setCurrentRoute` lets the host keep `getCurrentRoute()` in sync with the
+ * live pathname (telemetry + LLM context). No framework imports here — each
+ * binding wires its own router-change subscription.
+ */
+import type { NavigationAdapter } from '@fiodos/core';
+export declare const BACK_ROUTE = "BACK";
+export interface WebNavigationAdapterOptions {
+    /**
+     * Forwards a manifest route string to the host router. MUST throw on failure
+     * so the engine can degrade to an ActionResult error.
+     */
+    navigate: (route: string) => void;
+    /** Go back. Defaults to history.back() (or backFallbackRoute when empty). */
+    back?: () => void;
+    /** Current route. Defaults to location.pathname + location.search. */
+    getCurrentRoute?: () => string | null;
+    /** Route navigated to when back() is called with no history. */
+    backFallbackRoute?: string;
+}
+export interface WebNavigationAdapter extends NavigationAdapter {
+    /** Updates the tracked current route (called by the host on route change). */
+    setCurrentRoute(route: string | null): void;
+}
+export declare function createWebNavigationAdapter(options: WebNavigationAdapterOptions): WebNavigationAdapter;

package/dist/esm/adapters/webNavigationAdapter.js

@@ -0,0 +1,41 @@
+export const BACK_ROUTE = 'BACK';
+function defaultCurrentRoute() {
+    if (typeof window === 'undefined' || !window.location)
+        return null;
+    return `${window.location.pathname}${window.location.search}`;
+}
+export function createWebNavigationAdapter(options) {
+    let tracked = null;
+    let hasNavigated = false;
+    return {
+        navigate(route) {
+            if (!route || route === BACK_ROUTE) {
+                this.back();
+                return;
+            }
+            hasNavigated = true;
+            options.navigate(route);
+        },
+        back() {
+            if (options.back) {
+                options.back();
+                return;
+            }
+            if (hasNavigated && typeof window !== 'undefined' && window.history?.length > 1) {
+                window.history.back();
+                return;
+            }
+            if (options.backFallbackRoute) {
+                options.navigate(options.backFallbackRoute);
+            }
+        },
+        getCurrentRoute() {
+            if (tracked != null)
+                return tracked;
+            return options.getCurrentRoute ? options.getCurrentRoute() : defaultCurrentRoute();
+        },
+        setCurrentRoute(route) {
+            tracked = route;
+        },
+    };
+}

package/dist/esm/adapters/webStorageAdapter.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Web StorageAdapter — backs the consent manager (and any future per-app
+ * preferences) with window.localStorage by default. The @fiodos/core contract
+ * is async; localStorage is sync, so we wrap calls in resolved promises. If
+ * localStorage is unavailable (private mode, SSR, disabled) we degrade to an
+ * in-memory map (consent just won't persist across reloads).
+ */
+import type { StorageAdapter } from '@fiodos/core';
+export interface WebStorageAdapterOptions {
+    /** Storage backend. Defaults to window.localStorage. */
+    backend?: Pick<Storage, 'getItem' | 'setItem' | 'removeItem'>;
+}
+export declare function createWebStorageAdapter(options?: WebStorageAdapterOptions): StorageAdapter;

package/dist/esm/adapters/webStorageAdapter.js

@@ -0,0 +1,54 @@
+function resolveBackend(preferred) {
+    if (preferred)
+        return preferred;
+    try {
+        if (typeof window !== 'undefined' && window.localStorage) {
+            const probe = '__fyodos_probe__';
+            window.localStorage.setItem(probe, '1');
+            window.localStorage.removeItem(probe);
+            return window.localStorage;
+        }
+    }
+    catch {
+        /* localStorage blocked — fall through to memory */
+    }
+    const mem = new Map();
+    return {
+        getItem: (k) => (mem.has(k) ? mem.get(k) : null),
+        setItem: (k, v) => {
+            mem.set(k, v);
+        },
+        removeItem: (k) => {
+            mem.delete(k);
+        },
+    };
+}
+export function createWebStorageAdapter(options = {}) {
+    const backend = resolveBackend(options.backend);
+    return {
+        async getItem(key) {
+            try {
+                return backend.getItem(key);
+            }
+            catch {
+                return null;
+            }
+        },
+        async setItem(key, value) {
+            try {
+                backend.setItem(key, value);
+            }
+            catch {
+                /* quota/availability errors are non-fatal for consent */
+            }
+        },
+        async removeItem(key) {
+            try {
+                backend.removeItem(key);
+            }
+            catch {
+                /* non-fatal */
+            }
+        },
+    };
+}

package/dist/esm/adapters/webVoiceAdapter.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Web VoiceAdapter — browser STT via the Web Speech API
+ * (`SpeechRecognition` / `webkitSpeechRecognition`) and TTS playback of
+ * server-generated MP3 (base64) through an <audio> element, with a device
+ * SpeechSynthesis fallback. Availability is browser-dependent (Chrome/Edge/
+ * Safari yes; Firefox no), so `isRecognitionAvailable()` is honest and the UI
+ * must fall back to text input when it returns false.
+ *
+ * Framework-agnostic: shared by every Fiodos web binding.
+ */
+import type { VoiceAdapter } from '@fiodos/core';
+export interface WebVoiceAdapterOptions {
+    /** Disable the SpeechSynthesis fallback when server MP3 is missing. */
+    disableDeviceTtsFallback?: boolean;
+}
+export declare function createWebVoiceAdapter(options?: WebVoiceAdapterOptions): VoiceAdapter;