anniedrawing 0.3.1

package/dist/board.d.ts

@@ -0,0 +1,193 @@
+import type { KindCatalogSnapshot } from './core/catalog.js';
+import type { LinkPreview } from './core/links.js';
+import type { AgentPresenceOptions, AnnieDoc, ApplyOptions, ApplyResult, Box, ChangeEvent, ChangeLog, DescribeOptions, DocModel, ExportFormat, ExportOptions, Item, LensState, Op, Point, Query, Scope, Style } from './core/types.js';
+import { Stage } from './stage/stage.js';
+import { type KindDef } from './kinds/index.js';
+import { type UiOptions } from './ui/index.js';
+export type { UiOptions, UiExportFormat } from './ui/index.js';
+export interface BoardOptions {
+    doc?: AnnieDoc;
+    /** Used when origin starts with `agent:` and apply() omits agentName. */
+    agentName?: string;
+    /**
+     * `shared` (default): undo/redo walk every origin.
+     * `hidden`: default undo/redo skip origins that start with `agent:`.
+     */
+    agentHistory?: 'shared' | 'hidden';
+    /** Default reveal for origins that start with `agent:`. Default `fit`. */
+    agentReveal?: 'none' | 'fit';
+    /** Used when origin starts with `agent:` and place.gap is omitted. Default 32. */
+    agentPlaceGap?: number;
+    agentPresence?: boolean | AgentPresenceOptions;
+    readonly?: boolean;
+    /** `'light'` when omitted, `'dark'`, or `'auto'` for `prefers-color-scheme`. */
+    theme?: 'light' | 'dark' | 'auto';
+    /** `false` omits chrome. An object keeps the tools and sets the header. Default `true`. */
+    ui?: boolean | UiOptions;
+    kinds?: KindDef[];
+    autosaveKey?: string;
+    /** Register on `window.__anniedrawing`. Default false. The local demo sets true. */
+    exposeGlobal?: boolean;
+    allowedImageOrigins?: string[];
+    sanitizeHTML?: (html: string) => string;
+    unfurl?: false | ((url: string) => Promise<LinkPreview | undefined>);
+}
+type Events = {
+    change: ChangeEvent;
+    select: string[];
+    view: LensState;
+    tool: string;
+    page: string;
+    save: {
+        status: 'saving' | 'saved' | 'error';
+        message?: string;
+    };
+};
+/** Browser editor: document session, pointer input, and the public Board API. */
+export declare class Board {
+    readonly host: HTMLElement;
+    /** @internal Renderer. Use `view` and documented Board methods. */
+    readonly stage: Stage;
+    readonly model: DocModel;
+    readonly ready: Promise<void>;
+    readonly readonly: boolean;
+    readonly agentName?: string;
+    readonly selectionSignal: import("@preact/signals-core").Signal<string[]>;
+    readonly toolSignal: import("@preact/signals-core").Signal<string>;
+    readonly drafts: Map<string, Partial<Item>>;
+    /** Drawing tools fill paper; compact JSON omits fill and treats missing fill as none. */
+    defaultStyle: Style;
+    grid: boolean;
+    pageId: string;
+    private document;
+    private spatial;
+    private geometryLookup;
+    private hiddenGeometry;
+    private lockedGeometry;
+    private listeners;
+    private cleanup;
+    private uiCleanup?;
+    private frame;
+    private drag?;
+    private rect;
+    private space;
+    private clipboard;
+    private pointers;
+    private pinch?;
+    private editor?;
+    private finishEditor?;
+    private longPressTimer?;
+    private lastTouchTap?;
+    private touchDoubleAt;
+    private enteredGroup?;
+    private destroyed;
+    private themeValue;
+    private drawPreview?;
+    private previewDocument?;
+    private previewBase?;
+    private observer;
+    private unfurl?;
+    private agentReveal;
+    private pendingReveal?;
+    constructor(host: HTMLElement, options?: BoardOptions);
+    get selection(): string[];
+    get tool(): string;
+    get theme(): "auto" | "dark" | "light";
+    get canUndo(): boolean;
+    get canRedo(): boolean;
+    get revision(): number;
+    changesSince(since: number, options?: {
+        origin?: string | 'user' | 'agent';
+    }): ChangeLog;
+    get items(): Item[];
+    get view(): {
+        fit(ids?: string[]): void;
+        flyTo(box: Box): void;
+        zoom: number;
+        center: Point;
+    };
+    read(scope?: Scope | {
+        scope?: Scope;
+        includeDrafts?: boolean;
+    }): AnnieDoc;
+    get(id: string): Item | undefined;
+    isLocked(id: string): boolean;
+    private lockedResult;
+    query(selector?: Query): Item[];
+    describe(options?: DescribeOptions): string;
+    /** Built-in kinds added or last changed after `since`. Omit or pass 0 for the full catalog. */
+    kindsSince(since?: number): KindCatalogSnapshot;
+    boundsOf(ids?: string[]): Box;
+    apply(ops: Op[], options?: ApplyOptions): ApplyResult;
+    private queueReveal;
+    private flushReveal;
+    private revealCreated;
+    undo(options?: {
+        origin?: string;
+    }): boolean;
+    redo(): boolean;
+    load(doc: AnnieDoc): void;
+    clear(): void;
+    select(ids: string[]): void;
+    setTool(id: string): void;
+    setTheme(theme: 'light' | 'dark' | 'auto'): void;
+    setPage(id: string): void;
+    setGrid(value: boolean): void;
+    on<K extends keyof Events>(name: K, callback: (event: Events[K]) => void): () => boolean;
+    emit<K extends keyof Events>(name: K, event: Events[K]): void;
+    export(format: ExportFormat, options?: ExportOptions): Promise<string | Blob>;
+    destroy(): void;
+    addCleanup(fn: () => void): void;
+    focus(): void;
+    add(kind: string, point?: Point): ApplyResult;
+    updateSelection(patch: Partial<Item>): ApplyResult;
+    deleteSelection(): void;
+    duplicate(offset?: number): ApplyResult;
+    group(): void;
+    ungroup(): void;
+    align(mode: 'left' | 'center' | 'right' | 'top' | 'middle' | 'bottom' | 'horizontal' | 'vertical'): void;
+    addImage(file: File, point?: Point): Promise<void>;
+    /** Replace a video or link href. Editor helper; agents should `apply` a `set`. */
+    setHref(id: string, href: string): Promise<ApplyResult>;
+    private pasteHost;
+    editText(id: string): void;
+    cancel(): void;
+    private schedule;
+    private render;
+    private visible;
+    private isUI;
+    private point;
+    private updateCursor;
+    private topSelection;
+    private pageItems;
+    private movable;
+    private outline;
+    /** Hit-testing uses committed geometry; drafts do not update this index. */
+    private refreshGeometry;
+    private hit;
+    private zoomAt;
+    private pointerDown;
+    private pointerMove;
+    private pointerUp;
+    private pointerCancel;
+    private wheel;
+    private doubleClick;
+    private openContext;
+    private activateAt;
+    private activateEmbedded;
+    private clearInteractive;
+    private keyDown;
+    private withDrafts;
+    private copyEvent;
+    private cutEvent;
+    private pasteEvent;
+    private pasteFrom;
+    private drop;
+}
+/** Mount a board in `host`. See `BoardOptions` for theme, chrome, and export. */
+export declare function createBoard(host: HTMLElement, options?: BoardOptions): Board;
+declare global {
+    interface Window {
+        __anniedrawing?: Board[];
+    }
+}

package/dist/core/catalog.d.ts

@@ -0,0 +1,22 @@
+/** Bump when a built-in kind is added or its create/read contract changes. */
+export declare const CATALOG_VERSION = 1;
+export interface KindCatalogEntry {
+    kind: string;
+    /** Catalog version that added this kind or last changed its create/read fields. */
+    since: number;
+    w: number;
+    h: number;
+    note: string;
+}
+export interface KindCatalogSnapshot {
+    version: number;
+    since: number;
+    kinds: KindCatalogEntry[];
+}
+/** Built-in kinds. `since` is the catalog version that introduced or last changed the kind. */
+export declare const KIND_CATALOG: readonly KindCatalogEntry[];
+/**
+ * Built-in kinds added or last changed after `since`.
+ * Omit `since` or pass 0 to list every built-in kind.
+ */
+export declare function kindsSince(since?: number): KindCatalogSnapshot;

package/dist/core/clipboard.d.ts

@@ -0,0 +1,2 @@
+/** First non-comment `text/uri-list` line, then `text/plain`. */
+export declare function clipboardText(data: DataTransfer | null | undefined): string;

package/dist/core/defaults.d.ts

@@ -0,0 +1,19 @@
+import type { AnnieDoc, Endpoint, EndpointInput, Item, NewItem, Style } from './types.js';
+export declare const KIND_ALIASES: Record<string, string>;
+export declare const COLOR_ALIASES: Record<string, string>;
+export declare function storedKind(kind: string): string;
+export declare function storedColor(value?: string): string | undefined;
+export declare function storedEndpoint(value?: EndpointInput): Endpoint | undefined;
+export declare function aliasStyle(style?: Style): Style | undefined;
+export declare const CARD_CORNER = 12;
+export declare const DEFAULT_STYLE: Required<Style>;
+export declare const DEFAULT_SIZES: Record<string, [number, number]>;
+export declare function clone<T>(value: T): T;
+export declare function sizeOf(kind: string): [number, number];
+export declare function kindDefaultsFrom(kinds?: {
+    kind: string;
+    defaults?: Partial<Item>;
+}[]): Record<string, Partial<Item>>;
+export declare function defaultDoc(): AnnieDoc;
+export declare function normalizeItem(input: NewItem, kindDefaults?: Record<string, Partial<Item>>): Item;
+export declare function minimalItem(item: Item, kindDefaults?: Record<string, Partial<Item>>): Item;

package/dist/core/doc.d.ts

@@ -0,0 +1,2 @@
+import type { AnnieDoc, DocModel, DocOptions } from './types.js';
+export declare function createDoc(initial?: AnnieDoc, options?: DocOptions): DocModel;

package/dist/core/ids.d.ts

@@ -0,0 +1,5 @@
+export declare const itemId: () => string;
+export declare const pageId: () => string;
+export declare const mediaId: () => string;
+/** Next free id: keep `requested` when unused, otherwise `stem_1`, `stem_2`, … */
+export declare function uniqueItemId(requested: string, taken: Set<string>): string;

package/dist/core/index.d.ts

@@ -0,0 +1,16 @@
+/** Headless document, validation, history, and geometry. */
+export type * from './types.js';
+export { CATALOG_VERSION, KIND_CATALOG, kindsSince } from './catalog.js';
+export type { KindCatalogEntry, KindCatalogSnapshot } from './catalog.js';
+export { createDoc } from './doc.js';
+export { DEFAULT_STYLE, CARD_CORNER, DEFAULT_SIZES, clone, sizeOf, kindDefaultsFrom, defaultDoc, normalizeItem, minimalItem, storedKind, storedColor, storedEndpoint, } from './defaults.js';
+export { itemId, pageId, mediaId } from './ids.js';
+export { LIMITS, VISION_PNG, ItemSchema, PlacementSchema, DocumentSchema, OpSchema, OpsSchema, QuerySchema, DescribeSchema, } from './schema.js';
+export { migrate } from './migrate.js';
+export { IMAGE_DATA_URL, MEDIA_DATA_URL, normalizeHref, hostnameOf, parseVideo, videoEmbed, } from './links.js';
+export type { VideoRef, LinkPreview } from './links.js';
+export { clipboardText } from './clipboard.js';
+export { imageMime, classifyPaste, parseLinkPreview, unfurlPage, displayUrl, prettyTitle, linkFallback, decodeEntities, } from './paste.js';
+export { allItems, applyDraft, translateItem, copyItems, detachMissingEndpoints } from './item.js';
+export type { ItemPatch } from './item.js';
+export * from '../geo/index.js';

package/dist/core/index.js

@@ -0,0 +1 @@
+import{a as s,c as a,d as r,f as o,i as e,n as m,o as p,p as t,s as d,t as i,u as f}from"../shared/picker-Dv_i4iNP.js";import{a as h,b as c,c as j,d as u,f as b,g as n,h as g,l as k,m as l,n as v,o as x,p as y,r as w,s as A,t as C,u as D,v as E,y as F}from"../shared/defaults-C-aC_B4z.js";import{A as I,C as L,D as M,E as N,F as O,I as P,L as S,M as T,N as _,O as q,P as z,S as B,T as G,_ as H,a as J,b as K,d as Q,f as R,g as U,h as V,i as W,j as X,k as Y,m as Z,o as $,p as ss,s as as,u as rs,v as os,w as es,x as ms,y as ps}from"../shared/describe-DaWyf3qV.js";import{a as ts,c as ds,i as is,n as fs,o as hs,r as cs,s as js,t as us}from"../shared/paste-C22i8o-g.js";export{C as CARD_CORNER,E as CATALOG_VERSION,v as DEFAULT_SIZES,w as DEFAULT_STYLE,Y as DescribeSchema,I as DocumentSchema,p as IMAGE_DATA_URL,X as ItemSchema,F as KIND_CATALOG,T as LIMITS,d as MEDIA_DATA_URL,_ as OpSchema,z as OpsSchema,O as PlacementSchema,P as QuerySchema,i as SpatialIndex,S as VISION_PNG,W as allItems,J as applyDraft,Q as boundsOf,R as boxCorners,ss as boxFromPoints,Z as centerOf,us as classifyPaste,e as clipboardText,h as clone,V as contains,U as containsPoint,$ as copyItems,s as createDoc,fs as decodeEntities,x as defaultDoc,as as detachMissingEndpoints,cs as displayUrl,L as distance,H as flattenItems,m as hitTest,a as hostnameOf,is as imageMime,os as intersects,ps as itemBounds,l as itemId,A as kindDefaultsFrom,c as kindsSince,ts as linkFallback,K as lookupItem,g as mediaId,t as migrate,j as minimalItem,f as normalizeHref,k as normalizeItem,n as pageId,hs as parseLinkPreview,r as parseVideo,es as pointInPolygon,js as prettyTitle,ms as resolveEndpoint,G as rotatePoint,B as routeConnector,N as segmentDistance,M as simplifyPoints,q as simplifyStroke,D as sizeOf,u as storedColor,b as storedEndpoint,y as storedKind,rs as translateItem,ds as unfurlPage,o as videoEmbed};

package/dist/core/item.d.ts

@@ -0,0 +1,25 @@
+import type { AnnieDoc, ApplyIssue, Item, ItemText, Op, Style } from './types.js';
+import { itemId } from './ids.js';
+import { type ItemLookup } from '../geo/box.js';
+import { type OutlineResolver } from '../geo/router.js';
+export declare function pageRoots(doc: AnnieDoc): Item[];
+export declare function allItems(doc: AnnieDoc): Item[];
+export type ItemPatch = Omit<Partial<Item>, 'style' | 'text' | 'data'> & {
+    style?: Partial<Style>;
+    text?: Partial<ItemText>;
+    data?: Record<string, unknown>;
+};
+/** Nested style, text, and data patches merge; other fields replace. */
+export declare function applyDraft(item: Item, patch?: ItemPatch): Item;
+export declare function translateItem(item: Item, dx: number, dy: number): Partial<Item>;
+/**
+ * Agent creates keep colliding ids by storing `id_1`, `id_2`, … and rewriting
+ * same-batch place, parent, and endpoint refs. Mutates a clone of `ops`.
+ */
+export declare function remapAgentCreateIds(doc: AnnieDoc, ops: Op[]): {
+    ops: Op[];
+    warnings: ApplyIssue[];
+};
+export declare function copyItems(items: Item[], offset: number, nextId?: typeof itemId): Item[];
+/** Bound ends whose targets are missing become page points. Mutates `items`. */
+export declare function detachMissingEndpoints(items: Iterable<Item>, lookup: ItemLookup, outline?: OutlineResolver): Op[];

package/dist/core/links.d.ts

@@ -0,0 +1,21 @@
+export type VideoProvider = 'youtube' | 'vimeo';
+export interface VideoRef {
+    provider: VideoProvider;
+    id: string;
+    hash?: string;
+}
+export interface LinkPreview {
+    title?: string;
+    description?: string;
+    image?: string;
+}
+/** Raster image data URLs accepted as image items. */
+export declare const IMAGE_DATA_URL: RegExp;
+/** Image media table sources, including SVG. */
+export declare const MEDIA_DATA_URL: RegExp;
+export declare function normalizeHref(value?: string): string | undefined;
+/** True for http(s) URLs whose host is not loopback, link-local, ULA, or RFC1918. */
+export declare function isPublicHttpUrl(value: string): boolean;
+export declare function hostnameOf(href: string): string;
+export declare function parseVideo(href?: string): VideoRef | undefined;
+export declare function videoEmbed(href?: string): string | undefined;

package/dist/core/locks.d.ts

@@ -0,0 +1,3 @@
+import type { Item } from './types.js';
+/** Moving a group must not move a locked descendant; locked groups protect their children. */
+export declare function lockedItems(items: Item[]): Set<string>;

package/dist/core/migrate.d.ts

@@ -0,0 +1,5 @@
+import type { AnnieDoc, Item } from './types.js';
+export declare const CURRENT_VERSION = 2;
+export declare const migrations: Record<number, (doc: Record<string, unknown>) => Record<string, unknown>>;
+/** Load any supported version. Retired `frame` items become groups on every import. */
+export declare function migrate(input: unknown, kindDefaults?: Record<string, Partial<Item>>): AnnieDoc;

package/dist/core/paste.d.ts

@@ -0,0 +1,27 @@
+import { type LinkPreview, type VideoRef } from './links.js';
+export declare function imageMime(href: string): string;
+export type PastedContent = {
+    kind: 'video';
+    href: string;
+    video: VideoRef;
+} | {
+    kind: 'image';
+    href: string;
+} | {
+    kind: 'link';
+    href: string;
+} | {
+    kind: 'text';
+    value: string;
+};
+export declare function decodeEntities(value: string): string;
+export declare function classifyPaste(value: string): PastedContent;
+export declare function parseLinkPreview(html: string, base: string): LinkPreview;
+export declare function unfurlPage(href: string): Promise<LinkPreview | undefined>;
+export declare function displayUrl(href: string): string;
+export declare function prettyTitle(href: string): string;
+export declare function linkFallback(href: string): {
+    title: string;
+    description: string;
+    host: string;
+};