@jini-ai/ui 0.1.2 → 0.3.0

package/dist/renderers/annotation-canvas/react/hooks/useAnnotationCanvas.controller.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Derivation and orchestration helpers extracted from `useAnnotationCanvas`
+ * to keep the hook's own cyclomatic/cognitive complexity low — a
+ * straight-line move of logic that used to live inline in the hook body or
+ * in `send()`, not a behavior change. Kept colocated with the hook (rather
+ * than folded into `../../rules.ts`) because a few of these orchestrate
+ * injected async side effects (`requestSnapshot`, `compositeWithBackground`)
+ * rather than being the DOM-free pure geometry that file is scoped to.
+ */
+import type { AnnotationAction, AnnotationSubmitDetail, CaptureTarget, MarkTool, PreviewSnapshot, Rect } from '../../types.js';
+import { type SubmitOptionRule } from '../../rules.js';
+import type { useT } from '../../../react/i18n.js';
+import type { MarkToolOptionController, SubmitOptionController } from './useAnnotationCanvas.js';
+type Translate = ReturnType<typeof useT>;
+/** `showCanvas`/`textLayerVisible`/`chromeHidden` — whether the canvas, text layer, and toolbar chrome should currently render. */
+export declare function deriveCanvasVisibility(input: {
+    active: boolean;
+    hasInk: boolean;
+    hasBox: boolean;
+    hasText: boolean;
+    capturing: boolean;
+    hideChrome: boolean;
+}): {
+    showCanvas: boolean;
+    textLayerVisible: boolean;
+    chromeHidden: boolean;
+};
+/** `canUndo`/`canRedo` — gated off while a submit is in flight. */
+export declare function deriveUndoRedoAvailability(input: {
+    undoCount: number;
+    hasBox: boolean;
+    redoCount: number;
+    sending: boolean;
+}): {
+    canUndo: boolean;
+    canRedo: boolean;
+};
+export interface SendGateInput {
+    hasInk: boolean;
+    hasBox: boolean;
+    hasText: boolean;
+    hasCaptureTarget: boolean;
+    captureViewport: boolean;
+    noteTrimmed: string;
+    extraFilesCount: number;
+}
+export interface SendGate {
+    /** Whether there's anything to rasterize (a mark, a target, or an explicit whole-viewport request) — drives both the hook's `canSubmit` value and `send()`'s capture attempt. */
+    shouldCapture: boolean;
+    /** Whether there's anything at all to submit — a capture reason, or a note/attachment on their own. */
+    canSubmitNow: boolean;
+}
+/** Shared by the hook's `canSubmit` value and `send()`'s own gate — both computed the identical chain before this extraction. */
+export declare function deriveSendGate(input: SendGateInput): SendGate;
+/** `send()`'s combined early-return gate: already sending, nothing to submit, or `send` specifically disabled. */
+export declare function canAttemptSend(input: {
+    sending: boolean;
+    canSubmitNow: boolean;
+    action: AnnotationAction;
+    sendDisabled: boolean;
+}): boolean;
+/** Picks which of the two "no screenshot" warnings applies — the whole-viewport-request wording, or the mark-specific one. */
+export declare function selectNoScreenshotMessage(input: {
+    captureViewport: boolean;
+    hasInk: boolean;
+    hasBox: boolean;
+    hasCaptureTarget: boolean;
+}, t: Translate): string;
+export type CaptureAttemptOutcome = {
+    kind: 'captured';
+    file: File;
+} | {
+    kind: 'warned';
+    message: string;
+} | {
+    kind: 'skipped';
+};
+/**
+ * Runs `send()`'s capture attempt once the caller has already established
+ * there's something to capture (`shouldCapture`): rasterize + composite,
+ * and — only when the result is genuinely empty-handed with nothing else to
+ * fall back to (no note, no attachments) — report a warning instead of a
+ * file. Deliberately does *not* own the `shouldCapture` gate itself: `send`
+ * only awaits this at all when `shouldCapture` is true, so the
+ * nothing-to-capture path stays fully synchronous (no extra microtask tick
+ * before `port.onSubmit` fires) exactly as it did before this was split out.
+ */
+export declare function attemptCapture(input: {
+    hasInk: boolean;
+    hasBox: boolean;
+    hasCaptureTarget: boolean;
+    captureViewport: boolean;
+    noteTrimmed: string;
+    extraFilesCount: number;
+    requestSnapshot: () => Promise<PreviewSnapshot | null>;
+    compositeWithBackground: (snap: PreviewSnapshot) => Promise<Blob | null>;
+    t: Translate;
+}, { now }?: {
+    now?: () => Date;
+}): Promise<CaptureAttemptOutcome>;
+/** Assembles the `AnnotationSubmitDetail` passed to `port.onSubmit` — the two "omit when empty" ternaries (`bounds`, `extraFiles`) that used to sit inline in the object literal. */
+export declare function buildSubmitPayload(input: {
+    file: File | null;
+    note: string;
+    action: AnnotationAction;
+    filePath: string | undefined;
+    captureTarget: CaptureTarget | null;
+    markKind: 'click' | 'stroke' | 'click+stroke' | undefined;
+    bounds: Rect | undefined;
+    extraFiles: File[];
+}): AnnotationSubmitDetail;
+/** Falls back to a default failure message when the port resolves `ok:false` with none of its own. */
+export declare function describeSubmitFailure(result: {
+    ok: boolean;
+    message?: string | undefined;
+}, t: Translate): string;
+/** After a successful submit: flags it when capture was attempted but no file made it through (submitted on note/attachments alone). */
+export declare function deriveSentWarning(input: {
+    shouldCapture: boolean;
+    file: File | null;
+    action: AnnotationAction;
+}, t: Translate): {
+    action: AnnotationAction;
+    message: string;
+} | null;
+/** Builds every `SubmitOptionController` (send/draft/queue) plus the currently-selected one. */
+export declare function buildSubmitOptionControllers(input: {
+    submitRules: SubmitOptionRule[];
+    sendDisabled: boolean;
+    sendDisabledReason: string | undefined;
+    submitAction: AnnotationAction;
+    t: Translate;
+}): {
+    submitOptions: SubmitOptionController[];
+    currentSubmit: SubmitOptionController;
+};
+/** Builds every `MarkToolOptionController` (box/pen/text) plus the currently-selected one. */
+export declare function buildMarkToolOptionControllers(input: {
+    markTool: MarkTool;
+    t: Translate;
+}): {
+    markToolOptions: MarkToolOptionController[];
+    currentMarkTool: MarkToolOptionController;
+};
+export {};
+//# sourceMappingURL=useAnnotationCanvas.controller.d.ts.map

package/dist/renderers/annotation-canvas/react/hooks/useAnnotationCanvas.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAnnotationCanvas.controller.d.ts","sourceRoot":"","sources":["../../../../../src/renderers/annotation-canvas/react/hooks/useAnnotationCanvas.controller.ts"],"names":[],"mappings":"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"}

package/dist/renderers/annotation-canvas/react/hooks/useAnnotationCanvas.controller.js

@@ -0,0 +1,118 @@
+import { MARK_TOOL_OPTION_RULES } from '../../rules.js';
+/** `showCanvas`/`textLayerVisible`/`chromeHidden` — whether the canvas, text layer, and toolbar chrome should currently render. */
+export function deriveCanvasVisibility(input) {
+    const { active, hasInk, hasBox, hasText, capturing, hideChrome } = input;
+    return {
+        showCanvas: active || hasInk || hasBox || hasText,
+        textLayerVisible: active || hasText,
+        chromeHidden: capturing || hideChrome,
+    };
+}
+/** `canUndo`/`canRedo` — gated off while a submit is in flight. */
+export function deriveUndoRedoAvailability(input) {
+    const { undoCount, hasBox, redoCount, sending } = input;
+    return {
+        canUndo: (undoCount > 0 || hasBox) && !sending,
+        canRedo: redoCount > 0 && !sending,
+    };
+}
+/** Shared by the hook's `canSubmit` value and `send()`'s own gate — both computed the identical chain before this extraction. */
+export function deriveSendGate(input) {
+    const { hasInk, hasBox, hasText, hasCaptureTarget, captureViewport, noteTrimmed, extraFilesCount } = input;
+    const shouldCapture = hasInk || hasBox || hasText || hasCaptureTarget || captureViewport;
+    const canSubmitNow = shouldCapture || Boolean(noteTrimmed) || extraFilesCount > 0;
+    return { shouldCapture, canSubmitNow };
+}
+/** `send()`'s combined early-return gate: already sending, nothing to submit, or `send` specifically disabled. */
+export function canAttemptSend(input) {
+    const { sending, canSubmitNow, action, sendDisabled } = input;
+    if (sending || !canSubmitNow)
+        return false;
+    if (action === 'send' && sendDisabled)
+        return false;
+    return true;
+}
+/** Picks which of the two "no screenshot" warnings applies — the whole-viewport-request wording, or the mark-specific one. */
+export function selectNoScreenshotMessage(input, t) {
+    const { captureViewport, hasInk, hasBox, hasCaptureTarget } = input;
+    return captureViewport && !hasInk && !hasBox && !hasCaptureTarget
+        ? t('No screenshot was captured for this annotation.')
+        : t('No screenshot was captured for this mark.');
+}
+/**
+ * Runs `send()`'s capture attempt once the caller has already established
+ * there's something to capture (`shouldCapture`): rasterize + composite,
+ * and — only when the result is genuinely empty-handed with nothing else to
+ * fall back to (no note, no attachments) — report a warning instead of a
+ * file. Deliberately does *not* own the `shouldCapture` gate itself: `send`
+ * only awaits this at all when `shouldCapture` is true, so the
+ * nothing-to-capture path stays fully synchronous (no extra microtask tick
+ * before `port.onSubmit` fires) exactly as it did before this was split out.
+ */
+export async function attemptCapture(input, { now = () => new Date() } = {}) {
+    const { hasInk, hasBox, hasCaptureTarget, captureViewport, noteTrimmed, extraFilesCount, requestSnapshot, compositeWithBackground, t } = input;
+    const snap = await requestSnapshot();
+    const blob = snap ? await compositeWithBackground(snap) : null;
+    if (blob) {
+        const ts = now().toISOString().replace(/[:.]/g, '-');
+        return { kind: 'captured', file: new File([blob], `annotation-${ts}.png`, { type: 'image/png' }) };
+    }
+    if (noteTrimmed || extraFilesCount > 0)
+        return { kind: 'skipped' };
+    return { kind: 'warned', message: selectNoScreenshotMessage({ captureViewport, hasInk, hasBox, hasCaptureTarget }, t) };
+}
+/** Assembles the `AnnotationSubmitDetail` passed to `port.onSubmit` — the two "omit when empty" ternaries (`bounds`, `extraFiles`) that used to sit inline in the object literal. */
+export function buildSubmitPayload(input) {
+    const { file, note, action, filePath, captureTarget, markKind, bounds, extraFiles } = input;
+    return {
+        file,
+        note,
+        action,
+        filePath: captureTarget?.filePath || filePath,
+        markKind,
+        bounds: markKind ? bounds : undefined,
+        target: captureTarget,
+        extraFiles: extraFiles.length ? extraFiles : undefined,
+    };
+}
+/** Falls back to a default failure message when the port resolves `ok:false` with none of its own. */
+export function describeSubmitFailure(result, t) {
+    return result.message || t('Could not submit this annotation.');
+}
+/** After a successful submit: flags it when capture was attempted but no file made it through (submitted on note/attachments alone). */
+export function deriveSentWarning(input, t) {
+    const { shouldCapture, file, action } = input;
+    return shouldCapture && !file ? { action, message: t('Sent without a screenshot — the note still went through.') } : null;
+}
+/** Builds every `SubmitOptionController` (send/draft/queue) plus the currently-selected one. */
+export function buildSubmitOptionControllers(input) {
+    const { submitRules, sendDisabled, sendDisabledReason, submitAction, t } = input;
+    const submitOptions = submitRules.map((rule) => ({
+        action: rule.action,
+        label: t(rule.labelKey),
+        pendingLabel: t(rule.pendingLabelKey),
+        title: rule.action === 'send' && sendDisabled ? sendDisabledReason ?? t('Sending is unavailable right now.') : t(rule.labelKey),
+        enabled: rule.enabled,
+    }));
+    // The `?? submitOptions[0]!` fallback is a TS-only safety net: at the
+    // hook's real call site `submitAction` is typed `AnnotationAction`, and
+    // `buildSubmitOptionRules` always returns exactly one entry per
+    // `AnnotationAction` value, so `.find` can never actually miss there —
+    // not covered by a test for the same reason a `!` assertion isn't. As a
+    // standalone pure function, though, a caller can supply a `submitRules`
+    // list that omits `submitAction`'s entry, which is exactly how this
+    // module's own tests exercise the fallback honestly.
+    const currentSubmit = submitOptions.find((opt) => opt.action === submitAction) ?? submitOptions[0];
+    return { submitOptions, currentSubmit };
+}
+/** Builds every `MarkToolOptionController` (box/pen/text) plus the currently-selected one. */
+export function buildMarkToolOptionControllers(input) {
+    const { markTool, t } = input;
+    const markToolOptions = MARK_TOOL_OPTION_RULES.map((rule) => ({ tool: rule.tool, label: t(rule.labelKey) }));
+    // Same reasoning as `buildSubmitOptionControllers`'s `currentSubmit` above:
+    // `markTool` is typed `MarkTool` and `MARK_TOOL_OPTION_RULES` covers every
+    // `MarkTool` value, so `.find` can never miss at the real call site.
+    const currentMarkTool = markToolOptions.find((item) => item.tool === markTool) ?? markToolOptions[0];
+    return { markToolOptions, currentMarkTool };
+}
+//# sourceMappingURL=useAnnotationCanvas.controller.js.map

package/dist/renderers/annotation-canvas/react/hooks/useAnnotationCanvas.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAnnotationCanvas.controller.js","sourceRoot":"","sources":["../../../../../src/renderers/annotation-canvas/react/hooks/useAnnotationCanvas.controller.ts"],"names":[],"mappings":"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"}

package/dist/renderers/annotation-canvas/react/hooks/useAnnotationCanvas.d.ts

@@ -0,0 +1,101 @@
+import type { ChangeEvent as ReactChangeEvent, ClipboardEvent as ReactClipboardEvent, KeyboardEvent as ReactKeyboardEvent, PointerEvent as ReactPointerEvent, RefObject } from 'react';
+import type { AnnotationCanvasPort } from '../../ports.js';
+import type { AnnotationAction, CaptureTarget, DockPlacement, DrawToolbarElement, MarkTool, TextMark } from '../../types.js';
+export interface UseAnnotationCanvasOptions {
+    /** Whether the overlay is currently in drawing mode (canvas pointer-events on, toolbar visible). */
+    active: boolean;
+    onActiveChange?: ((active: boolean) => void) | undefined;
+    /** Submit even with no ink/box/text mark at all — used for a whole-viewport screenshot annotation. */
+    captureViewport?: boolean | undefined;
+    captureTarget?: CaptureTarget | null | undefined;
+    filePath?: string | undefined;
+    /** Disables the `send` action (e.g. a run is already streaming) — `draft`/`queue` stay usable. */
+    sendDisabled?: boolean | undefined;
+    sendDisabledReason?: string | undefined;
+    /** Hides the canvas/toolbar chrome without deactivating drawing — used by a host to hide marks during its own screenshot capture (mirrors the internal `capturing` state, which does the same thing automatically around `port.captureSnapshot`). */
+    hideChrome?: boolean | undefined;
+    onToolbarClick?: ((element: DrawToolbarElement, submitAction?: AnnotationAction) => void) | undefined;
+    port: AnnotationCanvasPort;
+}
+export interface SubmitOptionController {
+    action: AnnotationAction;
+    label: string;
+    pendingLabel: string;
+    title: string;
+    enabled: boolean;
+}
+export interface MarkToolOptionController {
+    tool: MarkTool;
+    label: string;
+}
+export interface TextMarkController extends TextMark {
+    editing: boolean;
+}
+export interface AnnotationCanvasController {
+    wrapRef: RefObject<HTMLDivElement | null>;
+    canvasRef: RefObject<HTMLCanvasElement | null>;
+    dockRef: RefObject<HTMLDivElement | null>;
+    markToolMenuRef: RefObject<HTMLDivElement | null>;
+    submitMenuRef: RefObject<HTMLDivElement | null>;
+    fileInputRef: RefObject<HTMLInputElement | null>;
+    showCanvas: boolean;
+    textLayerVisible: boolean;
+    chromeHidden: boolean;
+    textFontPx: number;
+    dockPlacement: DockPlacement;
+    markTool: MarkTool;
+    markToolMenuOpen: boolean;
+    markToolOptions: MarkToolOptionController[];
+    currentMarkTool: MarkToolOptionController;
+    setMarkToolMenuOpen: (open: boolean) => void;
+    selectMarkTool: (tool: MarkTool) => void;
+    textMarks: TextMarkController[];
+    updateTextMark: (id: number, text: string) => void;
+    removeTextMark: (id: number) => void;
+    handleTextBlur: (id: number) => void;
+    handleTextEscape: (id: number, el: HTMLTextAreaElement) => void;
+    autosizeTextArea: (el: HTMLTextAreaElement | null) => void;
+    registerTextArea: (id: number, el: HTMLTextAreaElement | null) => void;
+    onTextPointerDown: (e: ReactPointerEvent, mark: TextMark) => void;
+    onTextPointerMove: (e: ReactPointerEvent, mark: TextMark) => void;
+    onTextPointerUp: (e: ReactPointerEvent, mark: TextMark) => void;
+    onPointerDown: (e: ReactPointerEvent) => void;
+    onPointerMove: (e: ReactPointerEvent) => void;
+    onPointerUp: (e: ReactPointerEvent) => void;
+    undoStroke: () => void;
+    redoStroke: () => void;
+    canUndo: boolean;
+    canRedo: boolean;
+    note: string;
+    setNote: (note: string) => void;
+    onNotePaste: (e: ReactClipboardEvent<HTMLInputElement>) => void;
+    onNoteKeyDown: (e: ReactKeyboardEvent<HTMLInputElement>) => void;
+    onCompositionStart: () => void;
+    onCompositionEnd: () => void;
+    extraFiles: File[];
+    imagePreviews: {
+        file: File;
+        url: string;
+    }[];
+    previewIndex: number | null;
+    setPreviewIndex: (index: number | null) => void;
+    addExtraFiles: (files: FileList | File[] | null) => void;
+    onFileInputChange: (e: ReactChangeEvent<HTMLInputElement>) => void;
+    removeExtraFile: (index: number) => void;
+    submitAction: AnnotationAction;
+    submitMenuOpen: boolean;
+    setSubmitMenuOpen: (open: boolean) => void;
+    submitOptions: SubmitOptionController[];
+    currentSubmit: SubmitOptionController;
+    chooseSubmitAction: (action: AnnotationAction) => void;
+    send: (action: AnnotationAction) => Promise<void>;
+    sending: boolean;
+    canSubmit: boolean;
+    captureWarning: {
+        action: AnnotationAction;
+        message: string;
+    } | null;
+    closeOverlay: () => void;
+}
+export declare function useAnnotationCanvas(options: UseAnnotationCanvasOptions): AnnotationCanvasController;
+//# sourceMappingURL=useAnnotationCanvas.d.ts.map

package/dist/renderers/annotation-canvas/react/hooks/useAnnotationCanvas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAnnotationCanvas.d.ts","sourceRoot":"","sources":["../../../../../src/renderers/annotation-canvas/react/hooks/useAnnotationCanvas.ts"],"names":[],"mappings":"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"}