@bluepic/embed 0.4.0-next.193 → 0.4.0-next.195

package/dist/util/fieldHints/index.d.ts

@@ -7,6 +7,7 @@ export type { OrderableHitbox } from './geometry';
 export { useFieldHitboxes } from './useFieldHitboxes';
 export type { FieldHitbox } from './useFieldHitboxes';
 export { useHintReveal } from './useHintReveal';
+export { useChipHighlight } from './useChipHighlight';
 export { createFieldElementRegistry, provideFieldFocus, revealFieldElement, useFieldFocus, FIELD_FOCUS_KEY, FIELD_FOCUS_FLASH_CLASS, FIELD_HOVER_CLASS, } from './fieldFocus';
 export type { FieldFocusController } from './fieldFocus';
 export { chipActionFor, fieldHasChip, readFieldProp } from './chipAction';

package/dist/util/fieldHints/useChipHighlight.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Which hint is highlighted, and which chip is on screen — two answers, because
+ * they are not the same question.
+ *
+ * The OUTLINE follows the pointer exactly: whatever it is over is the element
+ * being asked about, and nothing else may be lit.
+ *
+ * The CHIP cannot, because of where it sits. It is centred on its picture, so
+ * reaching it means travelling ACROSS that picture — and pictures nest (a logo,
+ * a portrait, a badge over a background), so the trip regularly crosses another
+ * hitbox. Handing the chip straight over to whatever the pointer touched on the
+ * way pulled it out from under a pointer already aimed at it, and the click
+ * landed on the element underneath instead: the upload dialog simply never
+ * opened. A chip that has just lost the highlight therefore stays painted (and
+ * clickable) for a moment longer.
+ *
+ * That grace period is not a lifetime: arriving on the chip re-activates it
+ * (`activate` from the chip's own `pointerenter`), so it only ever has to
+ * outlast the trip.
+ */
+export declare function useChipHighlight({ lingerMs }?: {
+    lingerMs?: number;
+}): {
+    activeKey: import("vue").Ref<string | undefined, string | undefined>;
+    chipShown: (key: string) => boolean;
+    activate: (key: string) => void;
+    release: (key: string) => boolean;
+    reset: () => void;
+};

package/dist/util/fieldHints/useHintReveal.d.ts

@@ -3,6 +3,7 @@ export declare function useHintReveal(enabled: Ref<boolean>): {
     revealed: import("vue").ComputedRef<boolean>;
     reveal: () => void;
     onPointerEnter: (event: PointerEvent) => void;
+    onPointerMove: (event: PointerEvent) => void;
     onPointerLeave: (event: PointerEvent) => void;
     onPointerDown: (event: PointerEvent) => void;
     onPointerUp: (event: PointerEvent) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bluepic/embed",
-  "version": "0.4.0-next.193",
+  "version": "0.4.0-next.195",
   "description": "Bluepic embed sdk",
   "type": "module",
   "sideEffects": false,