makethisbetter 1.11.2 → 1.12.1

package/README.md

@@ -251,6 +251,7 @@ MakeThisBetter.init({
   // Optional
   locale: 'en',              // UI language
   position: 'right',         // Tab position: 'left' | 'right'
+  entryMode: 'button',       // 'button' docks a tab | 'api' renders none
   theme: 'auto',             // 'light' | 'dark' | 'auto'
   frustrationDetection: true, // Proactive frustration prompts
   apiUrl: 'https://...',     // Self-hosted API endpoint
@@ -357,8 +358,36 @@ MakeThisBetter.init(config: MakeThisBetterConfig): void
 
 // Remove the widget and clean up all listeners
 MakeThisBetter.destroy(): void
+
+// Open annotation mode from your own UI. Idempotent while already open.
+MakeThisBetter.open(): void
+
+// Close annotation mode and restore the page
+MakeThisBetter.close(): void
+
+// Show or remove the docked tab without tearing the widget down
+MakeThisBetter.showLauncher(): void
+MakeThisBetter.hideLauncher(): void
+```
+
+### Your own entry point
+
+A tab docked to the edge of the screen is the right default, but it is not
+always right — a full-screen editor, a map, or a phone where every pixel is
+spoken for. Set `entryMode: 'api'` to render no tab at all and open the widget
+from wherever the entry point belongs in your product:
+
+```js
+MakeThisBetter.init({ projectKey: 'mtb_proj_xxx', entryMode: 'api' })
+
+document.querySelector('#menu-feedback')
+  .addEventListener('click', () => MakeThisBetter.open())
 ```
 
+In `api` mode nothing is reachable until you wire up that call, so the widget
+logs a warning on init as a reminder. `showLauncher()` brings the tab back at
+runtime if you want both.
+
 ## Architecture
 
 The widget runs inside a Shadow DOM container, isolating its styles from your page. No CSS conflicts, no z-index wars.

package/dist/annotate/draw-note-bar.d.ts

@@ -9,6 +9,7 @@ interface DrawNoteBarOptions {
 }
 export declare class DrawNoteBar {
     private el;
+    private sheet;
     private input;
     private undoBtn;
     private redoBtn;

package/dist/annotate/draw-note-bar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"draw-note-bar.d.ts","sourceRoot":"","sources":["../../src/annotate/draw-note-bar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAG3C,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,YAAY,CAAA;IACtB,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CACjC;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAgB;IAC1B,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,OAAO,CAAQ;gBAEX,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,kBAAkB;IA6B7D,OAAO,CAAC,SAAS;IAgBjB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAKrD,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAiBlC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK/B,OAAO,CAAC,MAAM;IAKd,OAAO,IAAI,IAAI;CAGhB"}
+{"version":3,"file":"draw-note-bar.d.ts","sourceRoot":"","sources":["../../src/annotate/draw-note-bar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAI3C,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,YAAY,CAAA;IACtB,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,QAAQ,EAAE,MAAM,IAAI,CAAA;IACpB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CACjC;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,EAAE,CAAgB;IAC1B,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,OAAO,CAAQ;gBAEX,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,kBAAkB;IAiC7D,OAAO,CAAC,SAAS;IAgBjB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAKrD,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAiBlC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAK/B,OAAO,CAAC,MAAM;IAKd,OAAO,IAAI,IAAI;CAIhB"}

package/dist/annotate/overlay.d.ts

@@ -1,17 +1,28 @@
 import type { ShadowContainer } from '../widget/shadow';
+export interface OverlayHandlers {
+    onPointerDown: (e: PointerEvent) => void;
+    onPointerMove: (e: PointerEvent) => void;
+    onPointerUp: (e: PointerEvent) => void;
+    onPointerCancel: (e: PointerEvent) => void;
+}
+/**
+ * The annotation surface. Runs on pointer events only — never mouse events.
+ *
+ * Mouse listeners are deliberately absent. Touch browsers replay a tap as
+ * pointerdown/up followed by compatibility mousedown/up/click, so listening to
+ * both would run the annotation logic twice for one tap and drop two pins.
+ * Pointer events already cover mouse and stylus, so the desktop loses nothing.
+ */
 export declare class AnnotationOverlay {
     private overlayEl;
     private dimEl;
-    private onMouseDown;
-    private onMouseMove;
-    private onMouseUp;
-    private onMouseLeave;
-    constructor(shadow: ShadowContainer, handlers: {
-        onMouseDown: (e: MouseEvent) => void;
-        onMouseMove: (e: MouseEvent) => void;
-        onMouseUp: (e: MouseEvent) => void;
-        onMouseLeave: (e: MouseEvent) => void;
-    });
+    private handlers;
+    private onPointerDown;
+    private onPointerMove;
+    private onPointerUp;
+    private onPointerCancel;
+    constructor(shadow: ShadowContainer, handlers: OverlayHandlers);
+    private releaseCapture;
     destroy(): void;
 }
 //# sourceMappingURL=overlay.d.ts.map

package/dist/annotate/overlay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../../src/annotate/overlay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAEvD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,SAAS,CAAyB;IAC1C,OAAO,CAAC,YAAY,CAAyB;gBAG3C,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE;QACR,WAAW,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAA;QACpC,WAAW,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAA;QACpC,SAAS,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAA;QAClC,YAAY,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAA;KACtC;IAkBH,OAAO,IAAI,IAAI;CAQhB"}
+{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../../src/annotate/overlay.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAEvD,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,CAAA;IACxC,aAAa,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,CAAA;IACxC,WAAW,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,CAAA;IACtC,eAAe,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,IAAI,CAAA;CAC3C;AAED;;;;;;;GAOG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,aAAa,CAAoB;IACzC,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,eAAe,CAAoB;gBAE/B,MAAM,EAAE,eAAe,EAAE,QAAQ,EAAE,eAAe;IAuD9D,OAAO,CAAC,cAAc;IAQtB,OAAO,IAAI,IAAI;CAQhB"}

package/dist/annotate/session.d.ts

@@ -17,11 +17,11 @@ export declare class AnnotationSession {
     private lastMoveX;
     private lastMoveY;
     constructor(shadow: ShadowContainer, messages: I18nMessages, handlers: SessionHandlers);
-    private handleMouseDown;
-    private handleMouseMove;
+    private handlePointerDown;
+    private handlePointerMove;
     private updateHighlight;
     private cancelPendingHighlight;
-    private handleMouseUp;
+    private handlePointerUp;
     private finishStroke;
     undoDraw(): void;
     redoDraw(): void;

package/dist/annotate/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/annotate/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAQ1C,UAAU,eAAe;IACvB,KAAK,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3D,YAAY,EAAE,MAAM,IAAI,CAAA;CACzB;AAED,qBAAa,iBAAiB;IAY1B,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,QAAQ;IAZlB,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,iBAAiB,CAAO;IAChC,OAAO,CAAC,qBAAqB,CAAsB;IACnD,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,SAAS,CAAI;gBAGnB,MAAM,EAAE,eAAe,EACf,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,eAAe;IAiBnC,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,sBAAsB;IAM9B,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,YAAY;IA4BpB,QAAQ,IAAI,IAAI;IAIhB,QAAQ,IAAI,IAAI;IAIhB,WAAW,IAAI,OAAO;IAItB,WAAW,IAAI,OAAO;IAItB,cAAc,IAAI,OAAO;IAIzB,OAAO,CAAC,iBAAiB;IAIzB,iBAAiB,IAAI,UAAU,GAAG,IAAI;IAItC,SAAS,IAAI,IAAI;IAIjB,kBAAkB,IAAI,IAAI;IAO1B,aAAa,IAAI,IAAI;IAIrB,OAAO,IAAI,IAAI;CAMhB"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/annotate/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAQ1C,UAAU,eAAe;IACvB,KAAK,EAAE,CAAC,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAA;IAC3D,YAAY,EAAE,MAAM,IAAI,CAAA;CACzB;AAED,qBAAa,iBAAiB;IAY1B,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,QAAQ;IAZlB,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,iBAAiB,CAAO;IAChC,OAAO,CAAC,qBAAqB,CAAsB;IACnD,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,SAAS,CAAI;gBAGnB,MAAM,EAAE,eAAe,EACf,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,eAAe;IAoBnC,OAAO,CAAC,iBAAiB;IAKzB,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,sBAAsB;IAM9B,OAAO,CAAC,eAAe;IAQvB,OAAO,CAAC,YAAY;IA4BpB,QAAQ,IAAI,IAAI;IAIhB,QAAQ,IAAI,IAAI;IAIhB,WAAW,IAAI,OAAO;IAItB,WAAW,IAAI,OAAO;IAItB,cAAc,IAAI,OAAO;IAIzB,OAAO,CAAC,iBAAiB;IAIzB,iBAAiB,IAAI,UAAU,GAAG,IAAI;IAItC,SAAS,IAAI,IAAI;IAIjB,kBAAkB,IAAI,IAAI;IAO1B,aAAa,IAAI,IAAI;IAIrB,OAAO,IAAI,IAAI;CAMhB"}

package/dist/annotate/toolbar.d.ts

@@ -8,12 +8,13 @@ export declare class AnnotationToolbar {
     private recordBtn;
     private messages;
     private currentMode;
-    private fadeTimer;
+    private idleTimer;
     private faded;
-    private handleDocMouseMove;
+    private handlePointerMove;
     constructor(shadow: ShadowContainer, messages: I18nMessages, onExit: () => void, onModeChange?: (mode: ToolbarMode) => void);
-    private startFadeTimer;
-    private clearFadeTimer;
+    private restartIdleTimer;
+    private clearIdleTimer;
+    private fadeToolbar;
     private restoreToolbar;
     private buildHTML;
     setMode(mode: ToolbarMode): void;

package/dist/annotate/toolbar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toolbar.d.ts","sourceRoot":"","sources":["../../src/annotate/toolbar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAI7C,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,EAAE,CAAgB;IAC1B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,WAAW,CAAwB;IAE3C,OAAO,CAAC,SAAS,CAA6C;IAC9D,OAAO,CAAC,KAAK,CAAQ;IAKrB,OAAO,CAAC,kBAAkB,CAWzB;gBAGC,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,MAAM,IAAI,EAClB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI;IA0B5C,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,cAAc;IAKtB,OAAO,CAAC,SAAS;IAoBjB,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAahC,OAAO,IAAI,WAAW;IAItB,OAAO,IAAI,IAAI;CAKhB"}
+{"version":3,"file":"toolbar.d.ts","sourceRoot":"","sources":["../../src/annotate/toolbar.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAK7C,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,EAAE,CAAgB;IAC1B,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,WAAW,CAAwB;IAE3C,OAAO,CAAC,SAAS,CAA6C;IAC9D,OAAO,CAAC,KAAK,CAAQ;IAWrB,OAAO,CAAC,iBAAiB,CAexB;gBAGC,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,MAAM,IAAI,EAClB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI;IA6B5C,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,SAAS;IAoBjB,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAahC,OAAO,IAAI,WAAW;IAItB,OAAO,IAAI,IAAI;CAKhB"}

package/dist/index.d.cts

@@ -3,6 +3,15 @@ declare const MakeThisBetter: {
     init(config: MakeThisBetterConfig): void;
     destroy(): void;
     setLocale(locale: string): void;
+    /**
+     * Opens annotation mode from the host's own UI. Pair with
+     * `entryMode: 'api'` to replace the docked tab entirely, which is the only
+     * good answer on a phone where a permanent floating control is in the way.
+     */
+    open(): void;
+    close(): void;
+    showLauncher(): void;
+    hideLauncher(): void;
 };
 export { MakeThisBetter };
 export type { MakeThisBetterConfig };

package/dist/index.d.mts

@@ -3,6 +3,15 @@ declare const MakeThisBetter: {
     init(config: MakeThisBetterConfig): void;
     destroy(): void;
     setLocale(locale: string): void;
+    /**
+     * Opens annotation mode from the host's own UI. Pair with
+     * `entryMode: 'api'` to replace the docked tab entirely, which is the only
+     * good answer on a phone where a permanent floating control is in the way.
+     */
+    open(): void;
+    close(): void;
+    showLauncher(): void;
+    hideLauncher(): void;
 };
 export { MakeThisBetter };
 export type { MakeThisBetterConfig };

package/dist/index.d.ts

@@ -3,6 +3,15 @@ declare const MakeThisBetter: {
     init(config: MakeThisBetterConfig): void;
     destroy(): void;
     setLocale(locale: string): void;
+    /**
+     * Opens annotation mode from the host's own UI. Pair with
+     * `entryMode: 'api'` to replace the docked tab entirely, which is the only
+     * good answer on a phone where a permanent floating control is in the way.
+     */
+    open(): void;
+    close(): void;
+    showLauncher(): void;
+    hideLauncher(): void;
 };
 export { MakeThisBetter };
 export type { MakeThisBetterConfig };

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAKnD,QAAA,MAAM,cAAc;iBACL,oBAAoB,GAAG,IAAI;eAe7B,IAAI;sBAMG,MAAM,GAAG,IAAI;CAIhC,CAAA;AAED,OAAO,EAAE,cAAc,EAAE,CAAA;AACzB,YAAY,EAAE,oBAAoB,EAAE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAA;AAKnD,QAAA,MAAM,cAAc;iBACL,oBAAoB,GAAG,IAAI;eAe7B,IAAI;sBAMG,MAAM,GAAG,IAAI;IAK/B;;;;OAIG;YACK,IAAI;aAIH,IAAI;oBAIG,IAAI;oBAIJ,IAAI;CAGrB,CAAA;AAED,OAAO,EAAE,cAAc,EAAE,CAAA;AACzB,YAAY,EAAE,oBAAoB,EAAE,CAAA"}