qapture2 0.2.3 → 0.3.0

package/dist/index.cjs

@@ -1,20 +1,24 @@
 'use strict';
 
-var chunkPC6LNG5Y_cjs = require('./chunk-PC6LNG5Y.cjs');
+var chunk6KAXMN77_cjs = require('./chunk-6KAXMN77.cjs');
 
 
 
 Object.defineProperty(exports, "QaStudio", {
   enumerable: true,
-  get: function () { return chunkPC6LNG5Y_cjs.Qapture; }
+  get: function () { return chunk6KAXMN77_cjs.Qapture; }
 });
 Object.defineProperty(exports, "Qapture", {
   enumerable: true,
-  get: function () { return chunkPC6LNG5Y_cjs.Qapture; }
+  get: function () { return chunk6KAXMN77_cjs.Qapture; }
+});
+Object.defineProperty(exports, "deleteQaDatabase", {
+  enumerable: true,
+  get: function () { return chunk6KAXMN77_cjs.deleteQaDatabase; }
 });
 Object.defineProperty(exports, "initQaStudio", {
   enumerable: true,
-  get: function () { return chunkPC6LNG5Y_cjs.initQaStudio; }
+  get: function () { return chunk6KAXMN77_cjs.initQaStudio; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.d.cts

@@ -5,15 +5,23 @@
  * or skips invalid entries, and NEVER throws. Returns a fully-resolved config
  * plus human-readable warnings.
  *
- * Also exports DEFAULT_THEME so that defaults.ts can import it without
- * creating a circular dependency (defaults.ts → schema.ts, not the reverse).
+ * Custom themes were removed in Qapture 0.3.0 — QaConfig.theme is kept only
+ * so older config objects still type-check; it is IGNORED by validateConfig
+ * (a warning is pushed) and ResolvedConfig no longer carries a theme field.
  */
 /** A bilingual string: either a plain string (language-neutral) or { en, ar? }. */
 type QaBilingual = string | {
     en: string;
     ar?: string;
 };
-/** Brand colour palette for the QA panel. All fields optional on input. */
+/**
+ * Brand colour palette for the QA panel.
+ *
+ * @deprecated Custom themes were removed in Qapture 0.3.0 — the widget now
+ * ships one fixed, self-contained design. This type is kept only so that
+ * existing `theme?: Partial<QaTheme>` config objects still type-check; it has
+ * no effect on the rendered UI.
+ */
 type QaTheme = {
     primary: string;
     primaryDark: string;
@@ -43,6 +51,8 @@ type QaRisk = 'red' | 'amber' | 'green';
 type QaJourneyStep = {
     path: string;
     what: QaBilingual;
+    /** Optional "what pass looks like" — shown alongside `what` when present. */
+    expect?: QaBilingual;
     risk?: QaRisk;
     riskWhy?: string;
 };
@@ -78,7 +88,13 @@ type QaPreamble = {
 type QaConfig = {
     /** Storage + DB namespace. Defaults to 'qapture'. */
     namespace?: string;
-    /** Override any subset of the colour palette. */
+    /**
+     * Override any subset of the colour palette.
+     *
+     * @deprecated Custom themes were removed in Qapture 0.3.0 — the widget now
+     * ships one fixed, self-contained design. This key is IGNORED (a warning is
+     * pushed by validateConfig); remove it from your qa.config to silence it.
+     */
     theme?: Partial<QaTheme>;
     /** Panel brand label. */
     brand?: {
@@ -108,10 +124,15 @@ type QaConfig = {
     alwaysVisible?: boolean;
     /** Keyboard shortcut to toggle the panel. Default: 'shift+alt+q'. */
     hotkey?: string;
+    /**
+     * Whether to capture ambient runtime context (console errors/warnings,
+     * uncaught errors, network failures, env snapshot) alongside new notes.
+     * Default: true.
+     */
+    captureContext?: boolean;
 };
 type ResolvedConfig = {
     namespace: string;
-    theme: QaTheme;
     brand: {
         label: string;
     };
@@ -134,8 +155,15 @@ type ResolvedConfig = {
     visible: boolean | undefined;
     alwaysVisible: boolean;
     hotkey: string;
+    captureContext: boolean;
 };
 
+/**
+ * Full uninstall helper — wipes the entire DB for the given namespace.
+ * Call from the browser console: `import('qapture2').then(m => m.deleteQaDatabase('qapture'))`.
+ */
+declare function deleteQaDatabase(namespace: string): Promise<void>;
+
 /**
  * qapture — public API.
  *
@@ -176,4 +204,4 @@ declare function Qapture({ config }: {
     config?: QaConfig;
 }): null;
 
-export { type QaBilingual, type QaConfig, type QaCredential, type QaJourneyLane, type QaJourneyStep, type QaPreamble, type QaRisk, Qapture as QaStudio, type QaTheme, Qapture, type ResolvedConfig, initQaStudio };
+export { type QaBilingual, type QaConfig, type QaCredential, type QaJourneyLane, type QaJourneyStep, type QaPreamble, type QaRisk, Qapture as QaStudio, type QaTheme, Qapture, type ResolvedConfig, deleteQaDatabase, initQaStudio };

package/dist/index.d.ts

@@ -5,15 +5,23 @@
  * or skips invalid entries, and NEVER throws. Returns a fully-resolved config
  * plus human-readable warnings.
  *
- * Also exports DEFAULT_THEME so that defaults.ts can import it without
- * creating a circular dependency (defaults.ts → schema.ts, not the reverse).
+ * Custom themes were removed in Qapture 0.3.0 — QaConfig.theme is kept only
+ * so older config objects still type-check; it is IGNORED by validateConfig
+ * (a warning is pushed) and ResolvedConfig no longer carries a theme field.
  */
 /** A bilingual string: either a plain string (language-neutral) or { en, ar? }. */
 type QaBilingual = string | {
     en: string;
     ar?: string;
 };
-/** Brand colour palette for the QA panel. All fields optional on input. */
+/**
+ * Brand colour palette for the QA panel.
+ *
+ * @deprecated Custom themes were removed in Qapture 0.3.0 — the widget now
+ * ships one fixed, self-contained design. This type is kept only so that
+ * existing `theme?: Partial<QaTheme>` config objects still type-check; it has
+ * no effect on the rendered UI.
+ */
 type QaTheme = {
     primary: string;
     primaryDark: string;
@@ -43,6 +51,8 @@ type QaRisk = 'red' | 'amber' | 'green';
 type QaJourneyStep = {
     path: string;
     what: QaBilingual;
+    /** Optional "what pass looks like" — shown alongside `what` when present. */
+    expect?: QaBilingual;
     risk?: QaRisk;
     riskWhy?: string;
 };
@@ -78,7 +88,13 @@ type QaPreamble = {
 type QaConfig = {
     /** Storage + DB namespace. Defaults to 'qapture'. */
     namespace?: string;
-    /** Override any subset of the colour palette. */
+    /**
+     * Override any subset of the colour palette.
+     *
+     * @deprecated Custom themes were removed in Qapture 0.3.0 — the widget now
+     * ships one fixed, self-contained design. This key is IGNORED (a warning is
+     * pushed by validateConfig); remove it from your qa.config to silence it.
+     */
     theme?: Partial<QaTheme>;
     /** Panel brand label. */
     brand?: {
@@ -108,10 +124,15 @@ type QaConfig = {
     alwaysVisible?: boolean;
     /** Keyboard shortcut to toggle the panel. Default: 'shift+alt+q'. */
     hotkey?: string;
+    /**
+     * Whether to capture ambient runtime context (console errors/warnings,
+     * uncaught errors, network failures, env snapshot) alongside new notes.
+     * Default: true.
+     */
+    captureContext?: boolean;
 };
 type ResolvedConfig = {
     namespace: string;
-    theme: QaTheme;
     brand: {
         label: string;
     };
@@ -134,8 +155,15 @@ type ResolvedConfig = {
     visible: boolean | undefined;
     alwaysVisible: boolean;
     hotkey: string;
+    captureContext: boolean;
 };
 
+/**
+ * Full uninstall helper — wipes the entire DB for the given namespace.
+ * Call from the browser console: `import('qapture2').then(m => m.deleteQaDatabase('qapture'))`.
+ */
+declare function deleteQaDatabase(namespace: string): Promise<void>;
+
 /**
  * qapture — public API.
  *
@@ -176,4 +204,4 @@ declare function Qapture({ config }: {
     config?: QaConfig;
 }): null;
 
-export { type QaBilingual, type QaConfig, type QaCredential, type QaJourneyLane, type QaJourneyStep, type QaPreamble, type QaRisk, Qapture as QaStudio, type QaTheme, Qapture, type ResolvedConfig, initQaStudio };
+export { type QaBilingual, type QaConfig, type QaCredential, type QaJourneyLane, type QaJourneyStep, type QaPreamble, type QaRisk, Qapture as QaStudio, type QaTheme, Qapture, type ResolvedConfig, deleteQaDatabase, initQaStudio };

package/dist/index.js

@@ -1,3 +1,3 @@
-export { Qapture as QaStudio, Qapture, initQaStudio } from './chunk-BE3H3FKR.js';
+export { Qapture as QaStudio, Qapture, deleteQaDatabase, initQaStudio } from './chunk-ESRQOU32.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/next.cjs

@@ -1,21 +1,21 @@
 "use client";
 'use strict';
 
-var chunkPC6LNG5Y_cjs = require('./chunk-PC6LNG5Y.cjs');
+var chunk6KAXMN77_cjs = require('./chunk-6KAXMN77.cjs');
 
 
 
 Object.defineProperty(exports, "QaStudio", {
   enumerable: true,
-  get: function () { return chunkPC6LNG5Y_cjs.Qapture; }
+  get: function () { return chunk6KAXMN77_cjs.Qapture; }
 });
 Object.defineProperty(exports, "Qapture", {
   enumerable: true,
-  get: function () { return chunkPC6LNG5Y_cjs.Qapture; }
+  get: function () { return chunk6KAXMN77_cjs.Qapture; }
 });
 Object.defineProperty(exports, "initQaStudio", {
   enumerable: true,
-  get: function () { return chunkPC6LNG5Y_cjs.initQaStudio; }
+  get: function () { return chunk6KAXMN77_cjs.initQaStudio; }
 });
 //# sourceMappingURL=next.cjs.map
 //# sourceMappingURL=next.cjs.map

package/dist/next.js

@@ -1,4 +1,4 @@
 "use client";
-export { Qapture as QaStudio, Qapture, initQaStudio } from './chunk-BE3H3FKR.js';
+export { Qapture as QaStudio, Qapture, initQaStudio } from './chunk-ESRQOU32.js';
 //# sourceMappingURL=next.js.map
 //# sourceMappingURL=next.js.map

package/dist/standalone.cjs

@@ -1,39 +1,44 @@
 'use strict';
 
-var chunkPC6LNG5Y_cjs = require('./chunk-PC6LNG5Y.cjs');
+var chunk6KAXMN77_cjs = require('./chunk-6KAXMN77.cjs');
 
 // src/standalone.ts
 if (typeof window !== "undefined" && typeof customElements !== "undefined" && !customElements.get("qapture-widget")) {
   import('./index.cjs').then(({ initQaStudio: init }) => {
-    customElements.define(
-      "qapture-widget",
-      class QaStudioWidget extends HTMLElement {
-        connectedCallback() {
-          let cfg = {};
-          try {
-            const attr = this.getAttribute("config");
-            if (attr) cfg = JSON.parse(attr);
-          } catch {
-          }
-          const propCfg = this["config"];
-          if (propCfg && typeof propCfg === "object" && !Array.isArray(propCfg)) {
-            cfg = propCfg;
-          }
-          const instance = init(cfg);
-          this._destroy = instance.destroy;
+    class QaStudioWidget extends HTMLElement {
+      connectedCallback() {
+        if (this._destroy) return;
+        let cfg = {};
+        try {
+          const attr = this.getAttribute("config");
+          if (attr) cfg = JSON.parse(attr);
+        } catch {
         }
-        disconnectedCallback() {
-          this._destroy?.();
+        const propCfg = this["config"];
+        if (propCfg && typeof propCfg === "object" && !Array.isArray(propCfg)) {
+          cfg = propCfg;
         }
+        const instance = init(cfg);
+        this._destroy = instance.destroy;
       }
-    );
+      disconnectedCallback() {
+        this._destroy?.();
+        this._destroy = void 0;
+      }
+    }
+    customElements.define("qapture-widget", QaStudioWidget);
+    document.querySelectorAll("qapture-widget").forEach((el) => {
+      if (el instanceof QaStudioWidget && el.isConnected) {
+        el.connectedCallback();
+      }
+    });
   }).catch(() => {
   });
 }
 
 Object.defineProperty(exports, "initQaStudio", {
   enumerable: true,
-  get: function () { return chunkPC6LNG5Y_cjs.initQaStudio; }
+  get: function () { return chunk6KAXMN77_cjs.initQaStudio; }
 });
 //# sourceMappingURL=standalone.cjs.map
 //# sourceMappingURL=standalone.cjs.map

package/dist/standalone.js

@@ -1,30 +1,35 @@
-export { initQaStudio } from './chunk-BE3H3FKR.js';
+export { initQaStudio } from './chunk-ESRQOU32.js';
 
 // src/standalone.ts
 if (typeof window !== "undefined" && typeof customElements !== "undefined" && !customElements.get("qapture-widget")) {
   import('./index.js').then(({ initQaStudio: init }) => {
-    customElements.define(
-      "qapture-widget",
-      class QaStudioWidget extends HTMLElement {
-        connectedCallback() {
-          let cfg = {};
-          try {
-            const attr = this.getAttribute("config");
-            if (attr) cfg = JSON.parse(attr);
-          } catch {
-          }
-          const propCfg = this["config"];
-          if (propCfg && typeof propCfg === "object" && !Array.isArray(propCfg)) {
-            cfg = propCfg;
-          }
-          const instance = init(cfg);
-          this._destroy = instance.destroy;
+    class QaStudioWidget extends HTMLElement {
+      connectedCallback() {
+        if (this._destroy) return;
+        let cfg = {};
+        try {
+          const attr = this.getAttribute("config");
+          if (attr) cfg = JSON.parse(attr);
+        } catch {
         }
-        disconnectedCallback() {
-          this._destroy?.();
+        const propCfg = this["config"];
+        if (propCfg && typeof propCfg === "object" && !Array.isArray(propCfg)) {
+          cfg = propCfg;
         }
+        const instance = init(cfg);
+        this._destroy = instance.destroy;
       }
-    );
+      disconnectedCallback() {
+        this._destroy?.();
+        this._destroy = void 0;
+      }
+    }
+    customElements.define("qapture-widget", QaStudioWidget);
+    document.querySelectorAll("qapture-widget").forEach((el) => {
+      if (el instanceof QaStudioWidget && el.isConnected) {
+        el.connectedCallback();
+      }
+    });
   }).catch(() => {
   });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qapture2",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "description": "Drop-in, AI-aware in-browser QA capture widget. A tester annotates the live app (element/region + auto-screenshot + note), tracks a graded testing journey, and exports a ZIP your own coding agent reads. Ships zero AI.",
   "type": "module",
   "license": "MIT",
@@ -78,10 +78,16 @@
     "prepublishOnly": "npm run build",
     "dev": "tsup --watch",
     "typecheck": "tsc --noEmit",
+    "typecheck:bin": "tsc --noEmit -p tsconfig.bin.json",
     "smoke": "node scripts/smoke.mjs",
     "export-smoke": "esbuild src/lib/exportZip.ts --bundle --format=esm --platform=node --outfile=dist/_export-test.mjs --log-level=error && node scripts/export-smoke.mjs dist/_export-test.mjs",
+    "cli-smoke": "node scripts/cli-smoke.mjs",
+    "cli-detectors-smoke": "node scripts/cli-detectors-smoke.mjs",
+    "selector-smoke": "node scripts/selector-smoke.mjs",
+    "capture-timeout-smoke": "node scripts/capture-timeout-smoke.mjs",
+    "standalone-smoke": "node scripts/standalone-smoke.mjs",
     "browser-test": "node scripts/browser-test.mjs",
-    "verify": "npm run typecheck && npm run build && npm run smoke && npm run export-smoke",
+    "verify": "npm run typecheck && npm run typecheck:bin && npm run build && npm run smoke && npm run export-smoke && npm run cli-smoke && npm run cli-detectors-smoke && npm run selector-smoke && npm run capture-timeout-smoke && npm run standalone-smoke",
     "play": "npm --prefix playground run dev"
   },
   "engines": {
@@ -104,6 +110,7 @@
     "jszip": "^3.10.1"
   },
   "devDependencies": {
+    "@types/node": "^20.19.43",
     "@types/react": "^18.3.12",
     "@types/react-dom": "^18.3.1",
     "jsdom": "^29.1.1",