@ephia/dova-sdk 1.0.0

package/dist/testing/index.d.ts

@@ -0,0 +1,84 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React__default from 'react';
+import { StoreApi } from 'zustand/vanilla';
+import { a as EphiaStoreState } from '../types-D5SXPSwR.js';
+import { EphiaServerEvent } from 'ephia-protocol';
+import { E as EphiaBinding } from '../EphiaBinding-BvRmlqqC.js';
+import '../connection-state-Bk33YprE.js';
+import '../Transport-zdeA4Pou.js';
+import '../audio-state-kZ3KSvux.js';
+
+type EphiaStore = StoreApi<EphiaStoreState>;
+
+interface EphiaProviderConfig {
+    apiUrl?: string;
+    apiKey?: string;
+    bearerToken?: string;
+    clientType?: string;
+    language?: string;
+    medicalDomain?: string;
+}
+interface RegisterTargetOptions {
+    mode?: string;
+    element?: HTMLElement;
+}
+/**
+ * Public context value exposed by <EphiaProvider>.
+ *
+ * V2 rules:
+ *  - no direct client access (getClient / clientRef removed)
+ *  - no legacy registry (registryRef removed)
+ *  - no voice-formatting config (handled backend-side)
+ *
+ * Consumers receive the reactive store and a target registration helper.
+ */
+interface EphiaContextValue {
+    store: EphiaStore;
+    /**
+     * Registers a V2 EphiaBinding with the TargetManager.
+     * Returns a cleanup function that unregisters and detaches the binding.
+     */
+    registerTarget: (id: string, binding: EphiaBinding, opts?: RegisterTargetOptions) => () => void;
+    /**
+     * Réapplique un événement serveur (replay backend / événements manqués).
+     * Délègue au TranscriptApplier interne du provider.
+     */
+    applyServerEvent: (event: EphiaServerEvent) => void;
+    config: EphiaProviderConfig;
+}
+
+/**
+ * Crée un store Ephia vierge pour les tests ou le catalogue UI.
+ *
+ * Le store a le même shape que celui utilisé par <EphiaProvider>, mais il n'est
+ * connecté à aucun client audio. C'est utile pour monter des composants qui
+ * consomment useEphiaStatus / useEphiaConnection / useEphia en isolation.
+ */
+declare function createEphiaTestStore(): EphiaStore;
+interface EphiaTestProviderProps {
+    children: React__default.ReactNode;
+    /**
+     * Store injecté. Si absent, un store vierge est créé.
+     */
+    store?: EphiaStore;
+}
+/**
+ * Provider minimal pour les tests unitaires et le catalogue UI preview.
+ *
+ * Fournit un contexte Ephia avec un store Zustand réel mais déconnecté
+ * (status idle, connexion idle, etc.) afin que les composants utilisant
+ * useEphiaStatus / useEphiaConnection / useEphia / useEphiaPartial
+ * puissent être montés sans backend.
+ *
+ * @example
+ * ```tsx
+ * import { EphiaTestProvider } from "@ephia/dova-sdk/testing";
+ *
+ * <EphiaTestProvider>
+ *   <MyComponent />
+ * </EphiaTestProvider>
+ * ```
+ */
+declare function EphiaTestProvider({ children, store: injectedStore }: EphiaTestProviderProps): react_jsx_runtime.JSX.Element;
+
+export { type EphiaContextValue, type EphiaProviderConfig, type EphiaStore, EphiaTestProvider, type EphiaTestProviderProps, createEphiaTestStore };

package/dist/testing/index.js

@@ -0,0 +1,36 @@
+"use client";
+import {
+  createEphiaStore
+} from "../chunk-IDC7FHIZ.js";
+import "../chunk-RFQRV7ML.js";
+import "../chunk-EGIAN7FH.js";
+import {
+  EphiaContext
+} from "../chunk-K24GNU27.js";
+
+// src/testing/index.tsx
+import { useMemo } from "react";
+import { jsx } from "react/jsx-runtime";
+function createEphiaTestStore() {
+  return createEphiaStore();
+}
+function EphiaTestProvider({ children, store: injectedStore }) {
+  const store = useMemo(() => injectedStore ?? createEphiaTestStore(), [injectedStore]);
+  const value = useMemo(
+    () => ({
+      store,
+      registerTarget: () => () => {
+      },
+      applyServerEvent: () => {
+      },
+      config: {}
+    }),
+    [store]
+  );
+  return /* @__PURE__ */ jsx(EphiaContext.Provider, { value, children });
+}
+export {
+  EphiaTestProvider,
+  createEphiaTestStore
+};
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/index.tsx"],"sourcesContent":["\"use client\";\n\nimport React, { useMemo } from \"react\";\nimport { EphiaContext, type EphiaContextValue } from \"../react/provider/EphiaContext\";\nimport { createEphiaStore, type EphiaStore } from \"../react/store/create-ephia-store\";\n\nexport type { EphiaStore } from \"../react/store/create-ephia-store\";\nexport type { EphiaContextValue, EphiaProviderConfig } from \"../react/provider/EphiaContext\";\n\n/**\n * Crée un store Ephia vierge pour les tests ou le catalogue UI.\n *\n * Le store a le même shape que celui utilisé par <EphiaProvider>, mais il n'est\n * connecté à aucun client audio. C'est utile pour monter des composants qui\n * consomment useEphiaStatus / useEphiaConnection / useEphia en isolation.\n */\nexport function createEphiaTestStore(): EphiaStore {\n  return createEphiaStore();\n}\n\nexport interface EphiaTestProviderProps {\n  children: React.ReactNode;\n  /**\n   * Store injecté. Si absent, un store vierge est créé.\n   */\n  store?: EphiaStore;\n}\n\n/**\n * Provider minimal pour les tests unitaires et le catalogue UI preview.\n *\n * Fournit un contexte Ephia avec un store Zustand réel mais déconnecté\n * (status idle, connexion idle, etc.) afin que les composants utilisant\n * useEphiaStatus / useEphiaConnection / useEphia / useEphiaPartial\n * puissent être montés sans backend.\n *\n * @example\n * ```tsx\n * import { EphiaTestProvider } from \"@ephia/dova-sdk/testing\";\n *\n * <EphiaTestProvider>\n *   <MyComponent />\n * </EphiaTestProvider>\n * ```\n */\nexport function EphiaTestProvider({ children, store: injectedStore }: EphiaTestProviderProps) {\n  const store = useMemo(() => injectedStore ?? createEphiaTestStore(), [injectedStore]);\n\n  const value = useMemo<EphiaContextValue>(\n    () => ({\n      store,\n      registerTarget: () => () => {},\n      applyServerEvent: () => {},\n      config: {},\n    }),\n    [store],\n  );\n\n  return <EphiaContext.Provider value={value}>{children}</EphiaContext.Provider>;\n}\n"],"mappings":";;;;;;;;;;;AAEA,SAAgB,eAAe;AAwDtB;AA1CF,SAAS,uBAAmC;AACjD,SAAO,iBAAiB;AAC1B;AA2BO,SAAS,kBAAkB,EAAE,UAAU,OAAO,cAAc,GAA2B;AAC5F,QAAM,QAAQ,QAAQ,MAAM,iBAAiB,qBAAqB,GAAG,CAAC,aAAa,CAAC;AAEpF,QAAM,QAAQ;AAAA,IACZ,OAAO;AAAA,MACL;AAAA,MACA,gBAAgB,MAAM,MAAM;AAAA,MAAC;AAAA,MAC7B,kBAAkB,MAAM;AAAA,MAAC;AAAA,MACzB,QAAQ,CAAC;AAAA,IACX;AAAA,IACA,CAAC,KAAK;AAAA,EACR;AAEA,SAAO,oBAAC,aAAa,UAAb,EAAsB,OAAe,UAAS;AACxD;","names":[]}

package/dist/types-D5SXPSwR.d.ts

@@ -0,0 +1,32 @@
+import { E as EphiaConnectionState } from './connection-state-Bk33YprE.js';
+import { a as EphiaAudioState } from './audio-state-kZ3KSvux.js';
+
+type EphiaStatus = "idle" | "recording" | "processing" | "error";
+interface EphiaPartial {
+    targetId: string | null;
+    text: string;
+    segmentId: string;
+}
+interface EphiaError {
+    code: string;
+    message: string;
+}
+interface EphiaStoreState {
+    status: EphiaStatus;
+    sessionId: string | null;
+    error: EphiaError | null;
+    activeTargetId: string | null;
+    partial: EphiaPartial | null;
+    connection: EphiaConnectionState;
+    audio: EphiaAudioState;
+    _setStatus: (status: EphiaStatus) => void;
+    _setSessionId: (sessionId: string | null) => void;
+    _setError: (error: EphiaError | null) => void;
+    _setActiveTarget: (id: string | null) => void;
+    _setPartial: (partial: EphiaPartial | null) => void;
+    _setConnection: (connection: EphiaConnectionState) => void;
+    _setAudio: (audio: EphiaAudioState) => void;
+    _reset: () => void;
+}
+
+export type { EphiaStatus as E, EphiaStoreState as a, EphiaError as b, EphiaPartial as c };

package/dist/ui/index.d.ts

@@ -0,0 +1,30 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { CSSProperties } from 'react';
+export { B as Button, a as ButtonProps, E as EphiaFloatingButton, b as EphiaFloatingButtonBorderRadius, c as EphiaFloatingButtonPosition, d as EphiaFloatingButtonProps, e as EphiaFloatingButtonSize, f as EphiaFloatingButtonTheme, S as Spinner, g as SpinnerProps } from '../EphiaFloatingButton-CxiF86VW.js';
+import '../types-D5SXPSwR.js';
+import '../connection-state-Bk33YprE.js';
+import '../Transport-zdeA4Pou.js';
+import 'ephia-protocol';
+import '../audio-state-kZ3KSvux.js';
+import '../session-APaXR48R.js';
+
+/** Source of truth: `src/ui/assets/ephia-logo.svg` (same as apps/ephia-website/public/ephia_logo.svg). */
+declare const EPHIA_LOGO_VIEWBOX = "0 0 220 207";
+declare const EPHIA_LOGO_ASPECT: number;
+declare const EPHIA_BRAND_PURPLE = "#723ADE";
+declare const EPHIA_BRAND_TEAL = "#00EBD0";
+type EphiaLogoVariant = "color" | "mono";
+interface EphiaLogoProps {
+    height?: number;
+    width?: number;
+    className?: string;
+    style?: CSSProperties;
+    variant?: EphiaLogoVariant;
+    /** Mono fill (custom brand colors). Ignored when variant is "color". */
+    fill?: string;
+    isRecording?: boolean;
+}
+declare function logoWidthFromHeight(heightPx: number): number;
+declare function EphiaLogo({ height, width, className, style, variant, fill, isRecording, }: EphiaLogoProps): react_jsx_runtime.JSX.Element;
+
+export { EPHIA_BRAND_PURPLE, EPHIA_BRAND_TEAL, EPHIA_LOGO_ASPECT, EPHIA_LOGO_VIEWBOX, EphiaLogo, type EphiaLogoProps, type EphiaLogoVariant, logoWidthFromHeight };

package/dist/ui/index.js

@@ -0,0 +1,34 @@
+import {
+  Button,
+  EPHIA_BRAND_PURPLE,
+  EPHIA_BRAND_TEAL,
+  EPHIA_LOGO_ASPECT,
+  EPHIA_LOGO_VIEWBOX,
+  EphiaFloatingButton,
+  EphiaLogo,
+  Spinner,
+  logoWidthFromHeight
+} from "../chunk-YWZUMUYE.js";
+import "../chunk-ITJFN3VM.js";
+import "../chunk-IDC7FHIZ.js";
+import "../chunk-5IK5TLSK.js";
+import "../chunk-RFQRV7ML.js";
+import "../chunk-DIEWY3IT.js";
+import "../chunk-PSYX674B.js";
+import "../chunk-EGIAN7FH.js";
+import "../chunk-LXMCRXXF.js";
+import "../chunk-N7U5M3VZ.js";
+import "../chunk-THNHRV2B.js";
+import "../chunk-K24GNU27.js";
+export {
+  Button,
+  EPHIA_BRAND_PURPLE,
+  EPHIA_BRAND_TEAL,
+  EPHIA_LOGO_ASPECT,
+  EPHIA_LOGO_VIEWBOX,
+  EphiaFloatingButton,
+  EphiaLogo,
+  Spinner,
+  logoWidthFromHeight
+};
+//# sourceMappingURL=index.js.map

package/dist/ui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/useEphiaSpeechMike-CjD7DWnh.d.ts

@@ -0,0 +1,64 @@
+import * as React from 'react';
+import React__default from 'react';
+
+type EphiaSpeechMikeHidStatus = "unsupported" | "driver_missing" | "idle" | "initializing" | "not_present" | "present_unauthorized" | "authorization_required" | "restoring" | "connected" | "disconnected" | "recovering" | "error";
+type EphiaSpeechMikeAudioStatus = "idle" | "permission_required" | "resolving" | "ready" | "not_found" | "error";
+interface EphiaSpeechMikeStatus {
+    hid: EphiaSpeechMikeHidStatus;
+    audio: EphiaSpeechMikeAudioStatus;
+}
+type EphiaSpeechMikeButton = "RECORD" | "PLAY" | "FORWARD" | "REWIND" | "F1" | "F1_A" | "F2" | "F2_B" | "F3" | "F3_C" | "F4" | "F4_D" | "INS" | "OVR" | "INS_OVR" | "EOL" | "EOL_PRIO" | string;
+type EphiaSpeechMikeAction = "record.toggle" | "record.start" | "record.stop" | "play.toggle" | "seek.forward" | "seek.backward" | "audio.submit" | "audio.discard" | "agent.open" | "exam.new" | "resources.toggle" | "none";
+type EphiaSpeechMikeLedIntent = "off" | "idle" | "recording" | "processing" | "audio_available" | "success" | "error" | "cancelled";
+interface EphiaSpeechMikeDeviceInfo {
+    productName?: string;
+    manufacturerName?: string;
+    vendorId?: number;
+    productId?: number;
+}
+interface EphiaSpeechMikeError {
+    code: string;
+    message: string;
+}
+interface EphiaSpeechMikeState {
+    status: EphiaSpeechMikeStatus;
+    device: unknown | null;
+    deviceInfo: EphiaSpeechMikeDeviceInfo | null;
+    physicallyPresent: boolean;
+    audioInputDeviceId: string | null;
+    audioInputDeviceLabel: string | null;
+    pressedButtons: Set<string>;
+    lastButton: string | null;
+    lastAction: EphiaSpeechMikeAction | null;
+    error: EphiaSpeechMikeError | null;
+}
+
+type EphiaSpeechMikeProviderProps = {
+    children: React__default.ReactNode;
+    enabled?: boolean;
+    autoConnect?: boolean;
+    preferAudioInput?: boolean;
+    requestAudioPermissionOnInit?: boolean;
+    ledSync?: boolean;
+    initialLedIntent?: EphiaSpeechMikeLedIntent;
+    buttonMapping?: Partial<Record<string, EphiaSpeechMikeAction>>;
+    onAction?: (action: EphiaSpeechMikeAction) => void;
+    onError?: (error: EphiaSpeechMikeError) => void;
+    onStatusChange?: (state: EphiaSpeechMikeState) => void;
+};
+declare function EphiaSpeechMikeProvider({ children, enabled, autoConnect, preferAudioInput, requestAudioPermissionOnInit, ledSync, initialLedIntent, buttonMapping, onAction, onError, onStatusChange, }: EphiaSpeechMikeProviderProps): React__default.ReactElement;
+
+type EphiaSpeechMikeContextValue = EphiaSpeechMikeState & {
+    isConnected: boolean;
+    isReady: boolean;
+    requestAuthorization: () => Promise<void>;
+    reconnect: () => Promise<void>;
+    setLedIntent: (intent: EphiaSpeechMikeLedIntent) => void;
+    setButtonMapping: (mapping: Partial<Record<string, EphiaSpeechMikeAction>>) => void;
+};
+declare const FALLBACK_EPHIA_SPEECHMIKE_STATE: EphiaSpeechMikeState;
+declare const EphiaSpeechMikeContext: React.Context<EphiaSpeechMikeContextValue | null>;
+
+declare function useEphiaSpeechMike(): EphiaSpeechMikeContextValue;
+
+export { type EphiaSpeechMikeAction as E, FALLBACK_EPHIA_SPEECHMIKE_STATE as F, type EphiaSpeechMikeAudioStatus as a, type EphiaSpeechMikeButton as b, EphiaSpeechMikeContext as c, type EphiaSpeechMikeContextValue as d, type EphiaSpeechMikeDeviceInfo as e, type EphiaSpeechMikeError as f, type EphiaSpeechMikeHidStatus as g, type EphiaSpeechMikeLedIntent as h, EphiaSpeechMikeProvider as i, type EphiaSpeechMikeProviderProps as j, type EphiaSpeechMikeState as k, type EphiaSpeechMikeStatus as l, useEphiaSpeechMike as u };

package/package.json

@@ -0,0 +1,110 @@
+{
+  "name": "@ephia/dova-sdk",
+  "version": "1.0.0",
+  "type": "module",
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "description": "SDK Ephia — dictée audio headless + React + UI",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "development": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./shared": {
+      "development": "./src/shared/index.ts",
+      "types": "./dist/shared/index.d.ts",
+      "import": "./dist/shared/index.js"
+    },
+    "./react": {
+      "development": "./src/react/index.ts",
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js"
+    },
+    "./speechmike": {
+      "development": "./src/devices/speechmike/index.ts",
+      "types": "./dist/devices/speechmike/index.d.ts",
+      "import": "./dist/devices/speechmike/index.js"
+    },
+    "./ui": {
+      "development": "./src/ui/index.ts",
+      "types": "./dist/ui/index.d.ts",
+      "import": "./dist/ui/index.js"
+    },
+    "./bindings": {
+      "development": "./src/core/bindings/index.ts",
+      "types": "./dist/core/bindings/index.d.ts",
+      "import": "./dist/core/bindings/index.js"
+    },
+    "./headless": {
+      "development": "./src/headless/index.ts",
+      "types": "./dist/headless/index.d.ts",
+      "import": "./dist/headless/index.js"
+    },
+    "./rich-editor": {
+      "development": "./src/rich-editor/index.ts",
+      "types": "./dist/rich-editor/index.d.ts",
+      "import": "./dist/rich-editor/index.js"
+    },
+    "./testing": {
+      "development": "./src/testing/index.tsx",
+      "types": "./dist/testing/index.d.ts",
+      "import": "./dist/testing/index.js"
+    },
+    "./style.css": "./src/style.css"
+  },
+  "files": [
+    "dist",
+    "src",
+    "src/ui/assets"
+  ],
+  "scripts": {
+    "build": "tsup && cat src/ui/theme.css src/react/ephia-react.css > dist/style.css",
+    "dev": "cat src/ui/theme.css src/react/ephia-react.css > dist/style.css && tsup --watch",
+    "build:css": "cat src/ui/theme.css src/react/ephia-react.css > dist/style.css",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@livekit/krisp-noise-filter": "^0.4.3",
+    "ephia-protocol": "workspace:*",
+    "livekit-client": "^2.0.0",
+    "zod": "^3.25.76",
+    "zustand": "^5.0.13"
+  },
+  "optionalDependencies": {
+    "dictation_support": "^1.0.5"
+  },
+  "peerDependencies": {
+    "@tiptap/core": ">=2.0.0",
+    "@tiptap/pm": ">=2.0.0",
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@tiptap/core": {
+      "optional": true
+    },
+    "@tiptap/pm": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@codemirror/state": "^6.5.2",
+    "@codemirror/view": "^6.36.5",
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/react": "^16.3.2",
+    "@tiptap/core": "^3.23.6",
+    "@tiptap/pm": "^3.23.6",
+    "@types/react": "^18.0.0",
+    "jsdom": "^24.0.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.4.0",
+    "vitest": "^2.0.0"
+  }
+}

package/src/core/audio/audio-worklet-source.ts

@@ -0,0 +1,30 @@
+/**
+ * Source AudioWorklet partagée pour la capture audio.
+ *
+ * Utilisée par VoiceLevelMeter et StartupAudioBuffer.
+ * Évite la duplication du blob URL et du processor name.
+ */
+
+const AUDIO_WORKLET_SOURCE = `
+class AudioCaptureProcessor extends AudioWorkletProcessor {
+  process(inputs) {
+    const input = inputs[0];
+    if (input.length > 0) {
+      this.port.postMessage(new Float32Array(input[0]));
+    }
+    return true;
+  }
+}
+registerProcessor('ephia-audio-capture', AudioCaptureProcessor);
+`;
+
+let sharedWorkletModuleUrl: string | null = null;
+
+export function getAudioWorkletModuleUrl(): string {
+  if (!sharedWorkletModuleUrl) {
+    sharedWorkletModuleUrl = URL.createObjectURL(
+      new Blob([AUDIO_WORKLET_SOURCE], { type: "application/javascript" })
+    );
+  }
+  return sharedWorkletModuleUrl;
+}

package/src/core/audio/index.ts

@@ -0,0 +1,3 @@
+export { getAudioWorkletModuleUrl } from "./audio-worklet-source";
+export { VoiceLevelMeter } from "./voice-level-meter";
+export type { VoiceLevelSnapshot } from "./voice-level-meter";

package/src/core/audio/voice-level-meter.test.ts

@@ -0,0 +1,27 @@
+import { describe, expect, it } from "vitest";
+import { VoiceLevelMeter } from "./voice-level-meter";
+
+describe("VoiceLevelMeter startup capture", () => {
+  it("resamples captured Float32 audio to PCM16 16 kHz on drain", () => {
+    const meter = new VoiceLevelMeter() as unknown as {
+      _actualSampleRate: number;
+      _captureEnabled: boolean;
+      _captureBuffers: Float32Array[];
+      _captureTotalSamples: number;
+      drainStartupCapture: () => ArrayBuffer | null;
+    };
+    const source = new Float32Array(48_000);
+    source.fill(0.5);
+    meter._actualSampleRate = 48_000;
+    meter._captureEnabled = true;
+    meter._captureBuffers = [source];
+    meter._captureTotalSamples = source.length;
+
+    const pcm = meter.drainStartupCapture();
+
+    expect(pcm).not.toBeNull();
+    const samples = new Int16Array(pcm!);
+    expect(samples.length).toBe(16_000);
+    expect(samples[0]).toBeGreaterThan(16_000);
+  });
+});