@stubwise/widget 0.1.0

package/dist/ui/chat.d.ts

@@ -0,0 +1,30 @@
+import { type WidgetApiBase, type WidgetUser } from "../core/api.js";
+import { type WidgetCitation, type WidgetTicketProposal } from "../core/sse.js";
+import type { WidgetStrings } from "../i18n.js";
+/** Un elemento della timeline della chat. */
+export type ChatItem = {
+    kind: "user";
+    id: string;
+    text: string;
+} | {
+    kind: "assistant";
+    id: string;
+    text: string;
+    citations: WidgetCitation[];
+} | {
+    kind: "ticket";
+    id: string;
+    proposal: WidgetTicketProposal;
+};
+export interface ChatProps {
+    base: WidgetApiBase;
+    user: WidgetUser;
+    strings: WidgetStrings;
+    /** Messaggio di benvenuto (fittizio) se non c'è storico da caricare. */
+    welcomeMessage: string;
+    /** Composer attivo solo se la chat è abilitata lato config. */
+    chatEnabled: boolean;
+    /** conversationId iniziale da storage (o null: nuova conversazione lazy). */
+    initialConversationId: string | null;
+}
+export declare function Chat({ base, user, strings, welcomeMessage, chatEnabled, initialConversationId, }: ChatProps): import("preact").JSX.Element;

package/dist/ui/styles.d.ts

@@ -0,0 +1,12 @@
+/**
+ * CSS del widget come stringa, iniettato in un `<style>` dentro lo Shadow DOM.
+ * L'isolamento dello shadow root ci protegge dallo stile del sito ospite (e
+ * viceversa): non servono reset globali né `!important`. Tutte le classi sono
+ * prefissate `sw-` per chiarezza (anche se lo shadow root le confinerebbe già).
+ *
+ * Estetica: sobria, sans di sistema, un solo colore d'accento (dal config,
+ * iniettato come variabile `--sw-accent`). Nessuna dipendenza esterna.
+ *
+ * @param accentColor colore d'accento del progetto (bolla, header, bottoni).
+ */
+export declare function widgetStyles(accentColor: string): string;

package/dist/ui/ticket-card.d.ts

@@ -0,0 +1,16 @@
+import type { WidgetTicketProposal } from "../core/sse.js";
+import type { WidgetStrings } from "../i18n.js";
+export interface TicketCardProps {
+    proposal: WidgetTicketProposal;
+    strings: WidgetStrings;
+    /** Invia la segnalazione (title/body editati). Rigetta su errore → retry. */
+    onConfirm: (input: {
+        title: string;
+        body: string;
+    }) => Promise<{
+        number: number;
+    }>;
+    /** Annulla la card (rimossa dal parent). */
+    onCancel: () => void;
+}
+export declare function TicketCard({ proposal, strings, onConfirm, onCancel }: TicketCardProps): import("preact").JSX.Element;

package/dist/ui/widget.d.ts

@@ -0,0 +1,19 @@
+import type { WidgetApiBase, WidgetConfig, WidgetUser } from "../core/api.js";
+/** Config nella variante ATTIVA (l'unica per cui si monta la UI). */
+type ActiveConfig = Extract<WidgetConfig, {
+    enabled: true;
+}>;
+export interface WidgetRootProps {
+    base: WidgetApiBase;
+    config: ActiveConfig;
+    user: WidgetUser;
+}
+export declare function WidgetRoot({ base, config, user }: WidgetRootProps): import("preact").JSX.Element;
+/**
+ * Crea l'host `<div>` su `document.body`, ci attacca uno shadow root aperto con
+ * lo `<style>` del widget e renderizza {@link WidgetRoot} dentro. Ritorna l'host
+ * (per test/teardown). Isolato in questa funzione così l'entry può gestire la
+ * guardia di doppia init.
+ */
+export declare function mountWidget(base: WidgetApiBase, config: ActiveConfig, user: WidgetUser): HTMLElement;
+export {};

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@stubwise/widget",
+  "version": "0.1.0",
+  "type": "module",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/stubwise-widget.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "vite build && tsc -p tsconfig.build.json --emitDeclarationOnly",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "preact": "^10.29.4"
+  },
+  "devDependencies": {
+    "@preact/preset-vite": "^2.10.5",
+    "happy-dom": "^17.6.3",
+    "typescript": "^5.6.0",
+    "vite": "^7.0.0",
+    "vitest": "^3.2.0"
+  }
+}