@happyvertical/smrt-ui 0.57.21 → 0.57.23

package/AGENTS.md

@@ -58,6 +58,7 @@ components are exempt — they *are* the primitives.
 | `.` permissions | `PermissionCheck` and the domain-agnostic `PermissionPicker` for grouped, searchable native role-grant forms over host-supplied catalog records |
 | `./form-retry` | **Svelte-free** form retry (#3291): submission key, in-flight refusal, conditional reset, opt-in restore-after-reload, browser `runOnce()` digest. Also re-exported from `./forms`. Framework-free TS typed structurally against SvelteKit's `SubmitFunction` — never import `@sveltejs/kit` here. Guide: `docs/content/form-retry.md` |
 | `./i18n` | i18n **client**: `useI18n`, `<Trans>`, `defineMessages`, `renderTemplate` (no `smrt-languages` import — the server resolver stays in `smrt-svelte/i18n/server`) |
+| `./analytics` | Optional provider-neutral Svelte context for static shared component outcomes; noop without a host sink. No Matomo dependency. Browser provider lives in smrt-analytics. |
 | `./registry` | `ModuleUIRegistry` for cross-package component discovery |
 | `./theme` | deprecated compatibility path forwarding to the canonical theme system |
 | `./themes` | canonical `ThemeProvider`, context, preset token system (material/glass/studio/smrt/happyvertical), and CSS generation |

package/dist/analytics/index.d.ts

@@ -0,0 +1,17 @@
+/** Static standard outcomes and engagement; never includes component data. */
+export type StandardAnalyticsEvent = 'planner_opened' | 'planner_cookbook_applied' | 'project_question_answered' | 'project_decision_resolved' | 'project_preview_opened' | 'project_preview_approved' | 'project_preview_rejected';
+/** Optional private receipt identity, used only for in-memory duplicate suppression. */
+export interface AnalyticsEmissionOptions {
+    dedupeKey?: string;
+}
+export type AnalyticsSink = (name: string, options?: AnalyticsEmissionOptions) => unknown;
+/** Install once during the host root component's initialization. No SSR globals. */
+export declare function setAnalyticsContext(sink: AnalyticsSink): void;
+/** Capture during component initialization; absent configuration is a noop. */
+export declare function getAnalyticsContext(): AnalyticsSink;
+/** Observe only persisted status changes; initial/historical rows are not events. */
+export declare function createAnalyticsTransitions(emit: (name: StandardAnalyticsEvent) => unknown): (rows: readonly {
+    id: string;
+    status: string;
+}[], from: string, outcomes: Readonly<Record<string, StandardAnalyticsEvent>>) => void;
+//# sourceMappingURL=index.d.ts.map

package/dist/analytics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,MAAM,MAAM,sBAAsB,GAC9B,gBAAgB,GAChB,0BAA0B,GAC1B,2BAA2B,GAC3B,2BAA2B,GAC3B,wBAAwB,GACxB,0BAA0B,GAC1B,0BAA0B,CAAC;AAC/B,wFAAwF;AACxF,MAAM,WAAW,wBAAwB;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AACD,MAAM,MAAM,aAAa,GAAG,CAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,wBAAwB,KAC/B,OAAO,CAAC;AAIb,oFAAoF;AACpF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAE7D;AACD,+EAA+E;AAC/E,wBAAgB,mBAAmB,IAAI,aAAa,CASnD;AAED,qFAAqF;AACrF,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,CAAC,IAAI,EAAE,sBAAsB,KAAK,OAAO,IAI7C,MAAM,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAAE,EAC/C,MAAM,MAAM,EACZ,UAAU,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,UAmB7D"}

package/dist/analytics/index.js

@@ -0,0 +1,43 @@
+import { getContext, setContext } from 'svelte';
+const KEY = Symbol.for('@happyvertical/smrt-ui/analytics');
+const noop = () => { };
+/** Install once during the host root component's initialization. No SSR globals. */
+export function setAnalyticsContext(sink) {
+    setContext(KEY, sink);
+}
+/** Capture during component initialization; absent configuration is a noop. */
+export function getAnalyticsContext() {
+    const sink = getContext(KEY) ?? noop;
+    return (name, options) => {
+        try {
+            Promise.resolve(sink(name, options)).catch(() => { });
+        }
+        catch {
+            /* analytics never breaks UI */
+        }
+    };
+}
+/** Observe only persisted status changes; initial/historical rows are not events. */
+export function createAnalyticsTransitions(emit) {
+    const seen = new Map();
+    return (rows, from, outcomes) => {
+        const present = new Set(rows.map((row) => row.id));
+        for (const id of seen.keys()) {
+            if (!present.has(id))
+                seen.delete(id);
+        }
+        for (const row of rows) {
+            const previous = seen.get(row.id);
+            seen.set(row.id, row.status);
+            const outcome = outcomes[row.status];
+            if (previous === from && outcome) {
+                try {
+                    Promise.resolve(emit(outcome)).catch(() => { });
+                }
+                catch {
+                    /* no UI failures */
+                }
+            }
+        }
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-ui",
-  "version": "0.57.21",
+  "version": "0.57.23",
   "smrtJsdoc": "strict",
   "description": "Domain-agnostic Svelte 5 UI runtime for SMRT: primitives, i18n client, theme system, and module UI registry",
   "type": "module",
@@ -142,6 +142,11 @@
     "./charts/format": {
       "types": "./dist/charts/format.d.ts",
       "import": "./dist/charts/format.js"
+    },
+    "./analytics": {
+      "types": "./dist/analytics/index.d.ts",
+      "import": "./dist/analytics/index.js",
+      "default": "./dist/analytics/index.js"
     }
   },
   "files": [
@@ -170,7 +175,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@happyvertical/smrt-types": "0.57.21",
+    "@happyvertical/smrt-types": "0.57.23",
     "esm-env": "^1.2.2"
   },
   "peerDependencies": {