@embedpdf/plugin-selection 3.0.0-next.14 → 3.0.0-next.15

package/dist/contract/host.cjs

@@ -1,3 +1,17 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_types = require("../types-D9kEBMFj.cjs");
-exports.SelectionToken = require_types.SelectionToken;
+const require_contract = require("../contract-BUiw1d8F.cjs");
+//#region src/host-contract.ts
+/**
+* @embedpdf/plugin-selection/contract/host — the host lens.
+*
+* What render layers, the interaction hub and sibling plugins need on top
+* of the public contract: gesture bracketing, geometry warming and the
+* highlight-visibility handshake. Same runtime token as the public one,
+* typed wider. Never use this from application code.
+*/
+const SelectionToken = (0, require("@embedpdf/core").createHostToken)(require_contract.SelectionToken);
+//#endregion
+exports.SELECTION_DEFAULTS = require_contract.SELECTION_DEFAULTS;
+exports.SelectionToken = SelectionToken;
+
+//# sourceMappingURL=host.cjs.map

package/dist/contract/host.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.cjs","names":["PublicSelectionToken"],"sources":["../../src/host-contract.ts"],"sourcesContent":["/**\n * @embedpdf/plugin-selection/contract/host — the host lens.\n *\n * What render layers, the interaction hub and sibling plugins need on top\n * of the public contract: gesture bracketing, geometry warming and the\n * highlight-visibility handshake. Same runtime token as the public one,\n * typed wider. Never use this from application code.\n */\nimport { createHostToken, type PageRef } from '@embedpdf/core';\nimport type { Point } from '@embedpdf/core-geometry';\nimport { SelectionToken as PublicSelectionToken, type SelectionCapability } from './contract';\n\nexport * from './contract';\n\nexport interface SelectionHostCapability extends SelectionCapability {\n  /** Warm a page's text geometry. Resolves once loaded; resolves immediately\n   *  (nothing requested) without `doc.text.select` or for an unknown page. A\n   *  failed read resolves too — the layer simply has nothing to paint. */\n  ensureLoaded(page: PageRef): Promise<void>;\n  /** Whether the page's text geometry is loaded and current. */\n  isLoaded(page: PageRef): boolean;\n  /** Is a page-space point on (or near) text? Drives the I-beam cursor. */\n  isOverText(page: PageRef, point: Point): boolean;\n  /**\n   * A pointer gesture that drives the selection opened (pointer-down). From\n   * here until {@link endGesture}, `isSelecting()` is true and\n   * selection-scoped UI hides. Programmatic writes never open a gesture.\n   */\n  beginGesture(): void;\n  /** Open a caret selection at a page point (the first drag step). Returns\n   *  false when the point has no text — the caller lets the gesture go. */\n  beginGestureAt(page: PageRef, point: Point): boolean;\n  /** The gesture ended (pointer-up). Settles first, then emits `onCommitted`\n   *  when a selection is in place. */\n  endGesture(): void;\n  /** Suppress / restore the default highlight visual (a consumer drawing its\n   *  own preview — the markup ghost). */\n  setHighlightVisible(visible: boolean): void;\n  isHighlightVisible(): boolean;\n}\n\nexport const SelectionToken = createHostToken<SelectionHostCapability>(PublicSelectionToken);\n"],"mappings":";;;;;;;;;;;AAyCA,MAAa,kBAAA,2BAAA,CAAA,CAAA,gBAAA,CAA0DA,iBAAAA,cAAoB"}

package/dist/contract/host.d.cts

@@ -1,2 +1,3 @@
-import { a as SelectionHostCapability, d as SelectionToken, n as SelectionAction, s as SelectionRange, t as GlyphPointer, u as SelectionState } from "../types-CUrUVl6K.cjs";
-export { type GlyphPointer, type SelectionAction, type SelectionHostCapability, type SelectionRange, type SelectionState, SelectionToken };
+import { a as SelectionClearedEvent, c as SelectionEndpoint, d as SelectionSnapshot, f as TextPosition, h as SelectionSegment, i as SelectionChangedEvent, l as SelectionRangeInput, n as SelectionAnchor, o as SelectionCommittedEvent, p as TextRange, r as SelectionCapability, s as SelectionConfig, t as SELECTION_DEFAULTS, u as SelectionSettings } from "../contract-DLs4vXVt.cjs";
+import { n as SelectionToken, t as SelectionHostCapability } from "../host-contract-Ddo4PcJJ.cjs";
+export { SELECTION_DEFAULTS, SelectionAnchor, SelectionCapability, SelectionChangedEvent, SelectionClearedEvent, SelectionCommittedEvent, SelectionConfig, SelectionEndpoint, SelectionHostCapability, SelectionRangeInput, type SelectionSegment, SelectionSettings, SelectionSnapshot, SelectionToken, TextPosition, TextRange };

package/dist/contract/host.d.ts

@@ -1,2 +1,3 @@
-import { a as SelectionHostCapability, d as SelectionToken, n as SelectionAction, s as SelectionRange, t as GlyphPointer, u as SelectionState } from "../types-CUrUVl6K.js";
-export { type GlyphPointer, type SelectionAction, type SelectionHostCapability, type SelectionRange, type SelectionState, SelectionToken };
+import { a as SelectionClearedEvent, c as SelectionEndpoint, d as SelectionSnapshot, f as TextPosition, h as SelectionSegment, i as SelectionChangedEvent, l as SelectionRangeInput, n as SelectionAnchor, o as SelectionCommittedEvent, p as TextRange, r as SelectionCapability, s as SelectionConfig, t as SELECTION_DEFAULTS, u as SelectionSettings } from "../contract-DLs4vXVt.js";
+import { n as SelectionToken, t as SelectionHostCapability } from "../host-contract-DO2aLU2e.js";
+export { SELECTION_DEFAULTS, SelectionAnchor, SelectionCapability, SelectionChangedEvent, SelectionClearedEvent, SelectionCommittedEvent, SelectionConfig, SelectionEndpoint, SelectionHostCapability, SelectionRangeInput, type SelectionSegment, SelectionSettings, SelectionSnapshot, SelectionToken, TextPosition, TextRange };

package/dist/contract/host.js

@@ -1,2 +1,16 @@
-import { t as SelectionToken } from "../types-BVUcOsCh.js";
-export { SelectionToken };
+import { n as SelectionToken$1, t as SELECTION_DEFAULTS } from "../contract-DBXA64ep.js";
+import { createHostToken } from "@embedpdf/core";
+//#region src/host-contract.ts
+/**
+* @embedpdf/plugin-selection/contract/host — the host lens.
+*
+* What render layers, the interaction hub and sibling plugins need on top
+* of the public contract: gesture bracketing, geometry warming and the
+* highlight-visibility handshake. Same runtime token as the public one,
+* typed wider. Never use this from application code.
+*/
+const SelectionToken = createHostToken(SelectionToken$1);
+//#endregion
+export { SELECTION_DEFAULTS, SelectionToken };
+
+//# sourceMappingURL=host.js.map

package/dist/contract/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","names":["PublicSelectionToken"],"sources":["../../src/host-contract.ts"],"sourcesContent":["/**\n * @embedpdf/plugin-selection/contract/host — the host lens.\n *\n * What render layers, the interaction hub and sibling plugins need on top\n * of the public contract: gesture bracketing, geometry warming and the\n * highlight-visibility handshake. Same runtime token as the public one,\n * typed wider. Never use this from application code.\n */\nimport { createHostToken, type PageRef } from '@embedpdf/core';\nimport type { Point } from '@embedpdf/core-geometry';\nimport { SelectionToken as PublicSelectionToken, type SelectionCapability } from './contract';\n\nexport * from './contract';\n\nexport interface SelectionHostCapability extends SelectionCapability {\n  /** Warm a page's text geometry. Resolves once loaded; resolves immediately\n   *  (nothing requested) without `doc.text.select` or for an unknown page. A\n   *  failed read resolves too — the layer simply has nothing to paint. */\n  ensureLoaded(page: PageRef): Promise<void>;\n  /** Whether the page's text geometry is loaded and current. */\n  isLoaded(page: PageRef): boolean;\n  /** Is a page-space point on (or near) text? Drives the I-beam cursor. */\n  isOverText(page: PageRef, point: Point): boolean;\n  /**\n   * A pointer gesture that drives the selection opened (pointer-down). From\n   * here until {@link endGesture}, `isSelecting()` is true and\n   * selection-scoped UI hides. Programmatic writes never open a gesture.\n   */\n  beginGesture(): void;\n  /** Open a caret selection at a page point (the first drag step). Returns\n   *  false when the point has no text — the caller lets the gesture go. */\n  beginGestureAt(page: PageRef, point: Point): boolean;\n  /** The gesture ended (pointer-up). Settles first, then emits `onCommitted`\n   *  when a selection is in place. */\n  endGesture(): void;\n  /** Suppress / restore the default highlight visual (a consumer drawing its\n   *  own preview — the markup ghost). */\n  setHighlightVisible(visible: boolean): void;\n  isHighlightVisible(): boolean;\n}\n\nexport const SelectionToken = createHostToken<SelectionHostCapability>(PublicSelectionToken);\n"],"mappings":";;;;;;;;;;;AAyCA,MAAa,iBAAiB,gBAAyCA,gBAAoB"}

package/dist/contract-BUiw1d8F.cjs

@@ -0,0 +1,36 @@
+//#region src/token.ts
+/** The package token — created once here; `contract.ts` re-exports it and
+*  `host-contract.ts` widens it. */
+const SelectionToken = (0, require("@embedpdf/core").createCapabilityToken)("selection", {
+	hint: `add selectionPlugin() from '@embedpdf/plugin-selection' to your plugins list`,
+	promises: {
+		readText: true,
+		readTextInRange: true
+	}
+});
+//#endregion
+//#region src/contract.ts
+/** What the selection settings are when the app registers none. */
+const SELECTION_DEFAULTS = {
+	dragThreshold: 4,
+	color: null,
+	handles: {
+		color: null,
+		shadow: "0 1px 4px rgb(0 0 0 / 0.35)"
+	}
+};
+//#endregion
+Object.defineProperty(exports, "SELECTION_DEFAULTS", {
+	enumerable: true,
+	get: function() {
+		return SELECTION_DEFAULTS;
+	}
+});
+Object.defineProperty(exports, "SelectionToken", {
+	enumerable: true,
+	get: function() {
+		return SelectionToken;
+	}
+});
+
+//# sourceMappingURL=contract-BUiw1d8F.cjs.map

package/dist/contract-BUiw1d8F.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-BUiw1d8F.cjs","names":[],"sources":["../src/token.ts","../src/contract.ts"],"sourcesContent":["/** The package token — created once here; `contract.ts` re-exports it and\n *  `host-contract.ts` widens it. */\nimport { createCapabilityToken } from '@embedpdf/core';\n\nimport type { SelectionCapability } from './contract';\n\nexport const SelectionToken = createCapabilityToken<SelectionCapability>('selection', {\n  hint: `add selectionPlugin() from '@embedpdf/plugin-selection' to your plugins list`,\n  // Without a document, an adapter's stand-in rejects these with `not-ready`, as the\n  // capability would; the type asks for every member that returns a promise.\n  promises: {\n    readText: true,\n    readTextInRange: true,\n  },\n});\n","/**\n * @embedpdf/plugin-selection/contract — the public selection vocabulary.\n *\n * Selection ranges live in character space (half-open `TextRange`, the same\n * space search hits address). Geometry needs `doc.text.select`, text\n * extraction needs `doc.text.copy`, and neither permission implies the other.\n * Segments, endpoints and anchors are in page space (page space: y-down,\n * PDF units, crop-relative), the space every layer paints in.\n */\nimport type {\n  DeepPartial,\n  EventHook,\n  OperationOptions,\n  PageRef,\n  SettingsApi,\n} from '@embedpdf/core';\nimport type { Point, Rect, Quad } from '@embedpdf/core-geometry';\nimport type { SelectionSegment } from './geometry';\n\nexport type { SelectionSegment } from './geometry';\n\n// ── settings ────────────────────────────────────────────────────────────────\n\n/**\n * The selection plugin's settings. `selectionPlugin(config)` registers them\n * over {@link SELECTION_DEFAULTS}, and `updateSettings()` changes them for\n * every document while the app runs. The colors and the shadow can also come\n * from CSS (`--epdf-text-selection`, `--epdf-text-selection-handle`,\n * `--epdf-text-selection-handle-shadow`), which wins over the setting.\n */\nexport interface SelectionSettings {\n  /** How far, in viewport pixels, the pointer travels before a press becomes a drag that selects. */\n  readonly dragThreshold: number;\n  /** The color of selected text: a CSS color, or `null` for the viewer's accent at 35%. */\n  readonly color: string | null;\n  /** The grips at the selection's ends, on touch screens. */\n  readonly handles: {\n    /** A CSS color, or `null` for the viewer's accent. */\n    readonly color: string | null;\n    /** A CSS `box-shadow`. */\n    readonly shadow: string;\n  };\n}\n\n/** What the selection settings are when the app registers none. */\nexport const SELECTION_DEFAULTS: SelectionSettings = {\n  dragThreshold: 4,\n  color: null,\n  handles: { color: null, shadow: '0 1px 4px rgb(0 0 0 / 0.35)' },\n};\n\n/** What `selectionPlugin(config)` takes: any of the settings, merged over the defaults. */\nexport type SelectionConfig = DeepPartial<SelectionSettings>;\n\n// ── the range vocabulary ────────────────────────────────────────────────────\n\n/**\n * A position in a page's character space — the space the engine's geometry\n * runs tile (`PageGeometryRun.charStart`) and search hits address\n * (`SearchMatch.charStart`). Not a string offset into extracted text; the\n * two spaces are joined by the engine's `charMap` (see engine-core\n * `text/charmap.ts`), which `readText()` applies for you.\n */\nexport interface TextPosition {\n  page: PageRef;\n  /** Character index, 0-based. */\n  index: number;\n}\n\n/**\n * A half-open range in character space: `start` inclusive, `end` exclusive,\n * in document order (`start` at or before `end`). `end.index` may be 0 to\n * end a range exactly at a page boundary.\n */\nexport interface TextRange {\n  start: TextPosition;\n  end: TextPosition;\n}\n\n/**\n * What {@link SelectionCapability.select} accepts: a cross-page\n * {@link TextRange}, or a single-page span — the shape of a search hit, so\n * `select({ page: hit.page, start: hit.charStart, count: hit.charCount })`\n * needs no conversion.\n */\nexport type SelectionRangeInput = TextRange | { page: PageRef; start: number; count: number };\n\n// ── the read model ──────────────────────────────────────────────────────────\n\n/**\n * A selection boundary, anchored to the boundary glyph's own oriented cell.\n * `advance` is the reading direction of the segment it belongs to (+1 = the\n * frame's +x), so caret consumers place at the trailing edge without\n * re-deriving bidi from geometry. `rect` is the AABB (scroll targets).\n */\nexport interface SelectionEndpoint {\n  page: PageRef;\n  glyphQuad: Quad;\n  advance: 1 | -1;\n  rect: Rect;\n}\n\n/** Where selection-scoped floating UI attaches: a page + the selection's\n *  union box on it, in page space. See {@link SelectionCapability.getAnchor}. */\nexport interface SelectionAnchor {\n  page: PageRef;\n  bounds: Rect;\n}\n\nexport interface SelectionSnapshot {\n  /** Per-page canonical segments — the one geometry consumers act on.\n   *  Boxes are derived views (`segment.rect`, or `listRects()`). */\n  readonly pages: readonly { page: PageRef; segments: readonly SelectionSegment[] }[];\n  readonly start: SelectionEndpoint | null;\n  readonly end: SelectionEndpoint | null;\n  readonly direction: 'forward' | 'backward';\n  /**\n   * The selection as a half-open character range in document order — a\n   * valid {@link SelectionCapability.select} input (persist and restore).\n   * Null when nothing is selected. Until a boundary page's text geometry\n   * has loaded, its index may still exceed the page's character count\n   * (`selectAll` settles as geometry arrives); consumers of the range\n   * (`select`, `readTextInRange`) clamp, so round-tripping is always safe.\n   */\n  readonly range: TextRange | null;\n}\n\n// ── events ──────────────────────────────────────────────────────────────────\n\n/**\n * The selection's range or segments changed: a gesture step, a programmatic\n * select, a boundary page's text geometry arriving, or a clear. Selection is\n * session state, so the event carries no document origin.\n */\nexport interface SelectionChangedEvent {\n  readonly range: TextRange | null;\n  /** The pages that carry a segment right now. */\n  readonly pages: readonly PageRef[];\n}\n\n/** A selection gesture ended (pointer-up, handle release) with a selection in\n *  place — the commit point markup creation and clipboard prefetch act on.\n *  Never fires for programmatic selection. */\nexport interface SelectionCommittedEvent {\n  readonly range: TextRange;\n}\n\n/** The selection went from a range to nothing. */\nexport type SelectionClearedEvent = Record<string, never>;\n\n// ── the public capability ───────────────────────────────────────────────────\n\n/**\n * The public selection API — the documented, stable surface for application\n * code (toolbars, context menus, automation).\n *\n * The permission model: geometry enables selection (`doc.text.select`),\n * text enables extraction (`doc.text.copy`) — neither implies the other.\n * Everything here except the `readText` pair works with the select scope\n * alone, so a deployment can allow selecting and highlighting while denying\n * copy. Writes without the scope throw `PluginError('permission-denied')`;\n * gate UI with {@link canSelect} / {@link canCopy}.\n *\n * Every gesture has a programmatic twin: drag = {@link select} (or\n * `beginGestureAt` + {@link extendTo} for point-driven code on the host\n * lens), double-click = {@link selectWordAt}, triple-click =\n * {@link selectLineAt}, handle drag = {@link extendTo}, click on empty space\n * = {@link clear}, select-all = {@link selectAll}.\n *\n * A page argument is a `PageRef` or a zero-based index. A verb given a page\n * that isn't in the document throws `not-found`; a read returns empty.\n *\n * The settings (`getSettings`, `updateSettings`, `resetSettings`,\n * `onSettingsChanged`) belong to the plugin, not to a document: a change\n * reaches every open document.\n *\n * Framework-only plumbing (gesture bracketing, geometry warming, the\n * highlight-visibility handshake) lives on `SelectionHostCapability`,\n * reachable through `@embedpdf/plugin-selection/contract/host`. Both are the\n * same runtime object — two typed lenses on one token.\n */\nexport interface SelectionCapability extends SettingsApi<SelectionSettings> {\n  // ── authorization (mirrors the engine's own enforcement) ──\n  /** Whether this caller may create selections at all (`doc.text.select`). */\n  canSelect(): boolean;\n  /** Whether this caller may extract literal text (`doc.text.copy`). */\n  canCopy(): boolean;\n\n  // ── writes (character space, half-open) ──\n  /**\n   * Select a range — the same path gestures use, so the highlight, events\n   * and markup bridges behave identically. An empty range clears. Throws\n   * `permission-denied` without `doc.text.select`, `not-found` for a page\n   * that is not in this document. Fires `onChanged`, or `onCleared`.\n   */\n  select(range: SelectionRangeInput): void;\n  /** Select every character of the document. Throws `permission-denied` without `doc.text.select`. */\n  selectAll(): void;\n  /**\n   * Select every character on one page. Throws `permission-denied` without\n   * `doc.text.select`, `not-found` for a page that is not in this document.\n   */\n  selectPage(page: PageRef | number): void;\n  /**\n   * Select the word around a page point. Returns false when the point has no\n   * selectable text (geometry not loaded yet, or no glyph there). Throws\n   * `permission-denied` without `doc.text.select`, `not-found` for a page that\n   * is not in this document.\n   */\n  selectWordAt(page: PageRef | number, point: Point): boolean;\n  /** Select the visual line around a page point. Same result and errors as {@link selectWordAt}. */\n  selectLineAt(page: PageRef | number, point: Point): boolean;\n  /**\n   * Extend the current selection to a page point (a drag step). No selection\n   * → no-op; a page whose geometry has not loaded is warmed and the extension\n   * lands when it arrives. Errors as {@link selectPage}.\n   */\n  extendTo(page: PageRef | number, point: Point): void;\n  /** Clear the selection. Always allowed. Fires `onCleared` when something was selected. */\n  clear(): void;\n\n  // ── reads ──\n  /** Whether anything is selected. */\n  hasSelection(): boolean;\n  /**\n   * Whether the user is still selecting: from the press of a drag, a\n   * double-click or a handle until it lifts. A selection made from code is\n   * never in progress.\n   */\n  isSelecting(): boolean;\n  /** Per-page segments, endpoints, direction and the range. Reference-stable\n   *  until the selection changes. */\n  getSnapshot(): SelectionSnapshot;\n  /** The selected character range, or null. */\n  getRange(): TextRange | null;\n  /** The pages the current selection covers (those with at least one\n   *  segment), in document order — so a cross-page action can fan out per page. */\n  listSelectedPages(): readonly PageRef[];\n  /** Per-line oriented segments for a page, in page space — build your own\n   *  highlight layer from these. Reference-stable per page. */\n  listSegments(page: PageRef | number): readonly SelectionSegment[];\n  /** The segments' AABBs — for consumers that genuinely want boxes (scroll,\n   *  conservative regions). Never a substitute for the oriented quads in\n   *  geometry that gets drawn or persisted. */\n  listRects(page: PageRef | number): readonly Rect[];\n  /**\n   * Where selection-scoped floating UI should attach: the union box of the\n   * selection's segments on its end page (where the gesture finished),\n   * falling back to the last page with materialized segments while a\n   * boundary page's geometry is still loading. One anchor regardless of\n   * cross-page selection. Null when nothing is selected (or nothing has\n   * materialized yet).\n   */\n  getAnchor(): SelectionAnchor | null;\n\n  // ── text extraction (requires doc.text.copy) ──\n  /**\n   * The selected text. Each page's text snapshot is fetched once per content\n   * version and sliced through the engine's `charMap`; pages are joined with\n   * `\\n`. Resolves `''` when nothing is selected. Rejects `permission-denied`\n   * without `doc.text.copy`, and `operation-cancelled` when `options.signal`\n   * fires. Clipboard writes are deliberately not here — this package is\n   * DOM-free; use `@embedpdf/web`'s clipboard helpers.\n   */\n  readText(options?: OperationOptions): Promise<string>;\n  /**\n   * Text for any range, without touching the selection. Rejects as\n   * {@link readText} does, and `not-found` for a page that is not in this\n   * document.\n   */\n  readTextInRange(range: TextRange, options?: OperationOptions): Promise<string>;\n\n  // ── events ──\n  /** The range or its segments changed, whoever changed them. */\n  readonly onChanged: EventHook<SelectionChangedEvent>;\n  /** A selection gesture ended with a selection in place. */\n  readonly onCommitted: EventHook<SelectionCommittedEvent>;\n  /** The selection went from a range to nothing: a clear, an empty range, or\n   *  its pages' content changed or left the document. */\n  readonly onCleared: EventHook<SelectionClearedEvent>;\n}\n\nexport { SelectionToken } from './token';\n"],"mappings":";;;AAMA,MAAa,kBAAA,2BAAA,CAAA,CAAA,sBAAA,CAA4D,aAAa;CACpF,MAAM;CAGN,UAAU;EACR,UAAU;EACV,iBAAiB;CACnB;AACF,CAAC;;;;AC+BD,MAAa,qBAAwC;CACnD,eAAe;CACf,OAAO;CACP,SAAS;EAAE,OAAO;EAAM,QAAQ;CAA8B;AAChE"}

package/dist/contract-DBXA64ep.js

@@ -0,0 +1,26 @@
+import { createCapabilityToken } from "@embedpdf/core";
+//#region src/token.ts
+/** The package token — created once here; `contract.ts` re-exports it and
+*  `host-contract.ts` widens it. */
+const SelectionToken = createCapabilityToken("selection", {
+	hint: `add selectionPlugin() from '@embedpdf/plugin-selection' to your plugins list`,
+	promises: {
+		readText: true,
+		readTextInRange: true
+	}
+});
+//#endregion
+//#region src/contract.ts
+/** What the selection settings are when the app registers none. */
+const SELECTION_DEFAULTS = {
+	dragThreshold: 4,
+	color: null,
+	handles: {
+		color: null,
+		shadow: "0 1px 4px rgb(0 0 0 / 0.35)"
+	}
+};
+//#endregion
+export { SelectionToken as n, SELECTION_DEFAULTS as t };
+
+//# sourceMappingURL=contract-DBXA64ep.js.map

package/dist/contract-DBXA64ep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract-DBXA64ep.js","names":[],"sources":["../src/token.ts","../src/contract.ts"],"sourcesContent":["/** The package token — created once here; `contract.ts` re-exports it and\n *  `host-contract.ts` widens it. */\nimport { createCapabilityToken } from '@embedpdf/core';\n\nimport type { SelectionCapability } from './contract';\n\nexport const SelectionToken = createCapabilityToken<SelectionCapability>('selection', {\n  hint: `add selectionPlugin() from '@embedpdf/plugin-selection' to your plugins list`,\n  // Without a document, an adapter's stand-in rejects these with `not-ready`, as the\n  // capability would; the type asks for every member that returns a promise.\n  promises: {\n    readText: true,\n    readTextInRange: true,\n  },\n});\n","/**\n * @embedpdf/plugin-selection/contract — the public selection vocabulary.\n *\n * Selection ranges live in character space (half-open `TextRange`, the same\n * space search hits address). Geometry needs `doc.text.select`, text\n * extraction needs `doc.text.copy`, and neither permission implies the other.\n * Segments, endpoints and anchors are in page space (page space: y-down,\n * PDF units, crop-relative), the space every layer paints in.\n */\nimport type {\n  DeepPartial,\n  EventHook,\n  OperationOptions,\n  PageRef,\n  SettingsApi,\n} from '@embedpdf/core';\nimport type { Point, Rect, Quad } from '@embedpdf/core-geometry';\nimport type { SelectionSegment } from './geometry';\n\nexport type { SelectionSegment } from './geometry';\n\n// ── settings ────────────────────────────────────────────────────────────────\n\n/**\n * The selection plugin's settings. `selectionPlugin(config)` registers them\n * over {@link SELECTION_DEFAULTS}, and `updateSettings()` changes them for\n * every document while the app runs. The colors and the shadow can also come\n * from CSS (`--epdf-text-selection`, `--epdf-text-selection-handle`,\n * `--epdf-text-selection-handle-shadow`), which wins over the setting.\n */\nexport interface SelectionSettings {\n  /** How far, in viewport pixels, the pointer travels before a press becomes a drag that selects. */\n  readonly dragThreshold: number;\n  /** The color of selected text: a CSS color, or `null` for the viewer's accent at 35%. */\n  readonly color: string | null;\n  /** The grips at the selection's ends, on touch screens. */\n  readonly handles: {\n    /** A CSS color, or `null` for the viewer's accent. */\n    readonly color: string | null;\n    /** A CSS `box-shadow`. */\n    readonly shadow: string;\n  };\n}\n\n/** What the selection settings are when the app registers none. */\nexport const SELECTION_DEFAULTS: SelectionSettings = {\n  dragThreshold: 4,\n  color: null,\n  handles: { color: null, shadow: '0 1px 4px rgb(0 0 0 / 0.35)' },\n};\n\n/** What `selectionPlugin(config)` takes: any of the settings, merged over the defaults. */\nexport type SelectionConfig = DeepPartial<SelectionSettings>;\n\n// ── the range vocabulary ────────────────────────────────────────────────────\n\n/**\n * A position in a page's character space — the space the engine's geometry\n * runs tile (`PageGeometryRun.charStart`) and search hits address\n * (`SearchMatch.charStart`). Not a string offset into extracted text; the\n * two spaces are joined by the engine's `charMap` (see engine-core\n * `text/charmap.ts`), which `readText()` applies for you.\n */\nexport interface TextPosition {\n  page: PageRef;\n  /** Character index, 0-based. */\n  index: number;\n}\n\n/**\n * A half-open range in character space: `start` inclusive, `end` exclusive,\n * in document order (`start` at or before `end`). `end.index` may be 0 to\n * end a range exactly at a page boundary.\n */\nexport interface TextRange {\n  start: TextPosition;\n  end: TextPosition;\n}\n\n/**\n * What {@link SelectionCapability.select} accepts: a cross-page\n * {@link TextRange}, or a single-page span — the shape of a search hit, so\n * `select({ page: hit.page, start: hit.charStart, count: hit.charCount })`\n * needs no conversion.\n */\nexport type SelectionRangeInput = TextRange | { page: PageRef; start: number; count: number };\n\n// ── the read model ──────────────────────────────────────────────────────────\n\n/**\n * A selection boundary, anchored to the boundary glyph's own oriented cell.\n * `advance` is the reading direction of the segment it belongs to (+1 = the\n * frame's +x), so caret consumers place at the trailing edge without\n * re-deriving bidi from geometry. `rect` is the AABB (scroll targets).\n */\nexport interface SelectionEndpoint {\n  page: PageRef;\n  glyphQuad: Quad;\n  advance: 1 | -1;\n  rect: Rect;\n}\n\n/** Where selection-scoped floating UI attaches: a page + the selection's\n *  union box on it, in page space. See {@link SelectionCapability.getAnchor}. */\nexport interface SelectionAnchor {\n  page: PageRef;\n  bounds: Rect;\n}\n\nexport interface SelectionSnapshot {\n  /** Per-page canonical segments — the one geometry consumers act on.\n   *  Boxes are derived views (`segment.rect`, or `listRects()`). */\n  readonly pages: readonly { page: PageRef; segments: readonly SelectionSegment[] }[];\n  readonly start: SelectionEndpoint | null;\n  readonly end: SelectionEndpoint | null;\n  readonly direction: 'forward' | 'backward';\n  /**\n   * The selection as a half-open character range in document order — a\n   * valid {@link SelectionCapability.select} input (persist and restore).\n   * Null when nothing is selected. Until a boundary page's text geometry\n   * has loaded, its index may still exceed the page's character count\n   * (`selectAll` settles as geometry arrives); consumers of the range\n   * (`select`, `readTextInRange`) clamp, so round-tripping is always safe.\n   */\n  readonly range: TextRange | null;\n}\n\n// ── events ──────────────────────────────────────────────────────────────────\n\n/**\n * The selection's range or segments changed: a gesture step, a programmatic\n * select, a boundary page's text geometry arriving, or a clear. Selection is\n * session state, so the event carries no document origin.\n */\nexport interface SelectionChangedEvent {\n  readonly range: TextRange | null;\n  /** The pages that carry a segment right now. */\n  readonly pages: readonly PageRef[];\n}\n\n/** A selection gesture ended (pointer-up, handle release) with a selection in\n *  place — the commit point markup creation and clipboard prefetch act on.\n *  Never fires for programmatic selection. */\nexport interface SelectionCommittedEvent {\n  readonly range: TextRange;\n}\n\n/** The selection went from a range to nothing. */\nexport type SelectionClearedEvent = Record<string, never>;\n\n// ── the public capability ───────────────────────────────────────────────────\n\n/**\n * The public selection API — the documented, stable surface for application\n * code (toolbars, context menus, automation).\n *\n * The permission model: geometry enables selection (`doc.text.select`),\n * text enables extraction (`doc.text.copy`) — neither implies the other.\n * Everything here except the `readText` pair works with the select scope\n * alone, so a deployment can allow selecting and highlighting while denying\n * copy. Writes without the scope throw `PluginError('permission-denied')`;\n * gate UI with {@link canSelect} / {@link canCopy}.\n *\n * Every gesture has a programmatic twin: drag = {@link select} (or\n * `beginGestureAt` + {@link extendTo} for point-driven code on the host\n * lens), double-click = {@link selectWordAt}, triple-click =\n * {@link selectLineAt}, handle drag = {@link extendTo}, click on empty space\n * = {@link clear}, select-all = {@link selectAll}.\n *\n * A page argument is a `PageRef` or a zero-based index. A verb given a page\n * that isn't in the document throws `not-found`; a read returns empty.\n *\n * The settings (`getSettings`, `updateSettings`, `resetSettings`,\n * `onSettingsChanged`) belong to the plugin, not to a document: a change\n * reaches every open document.\n *\n * Framework-only plumbing (gesture bracketing, geometry warming, the\n * highlight-visibility handshake) lives on `SelectionHostCapability`,\n * reachable through `@embedpdf/plugin-selection/contract/host`. Both are the\n * same runtime object — two typed lenses on one token.\n */\nexport interface SelectionCapability extends SettingsApi<SelectionSettings> {\n  // ── authorization (mirrors the engine's own enforcement) ──\n  /** Whether this caller may create selections at all (`doc.text.select`). */\n  canSelect(): boolean;\n  /** Whether this caller may extract literal text (`doc.text.copy`). */\n  canCopy(): boolean;\n\n  // ── writes (character space, half-open) ──\n  /**\n   * Select a range — the same path gestures use, so the highlight, events\n   * and markup bridges behave identically. An empty range clears. Throws\n   * `permission-denied` without `doc.text.select`, `not-found` for a page\n   * that is not in this document. Fires `onChanged`, or `onCleared`.\n   */\n  select(range: SelectionRangeInput): void;\n  /** Select every character of the document. Throws `permission-denied` without `doc.text.select`. */\n  selectAll(): void;\n  /**\n   * Select every character on one page. Throws `permission-denied` without\n   * `doc.text.select`, `not-found` for a page that is not in this document.\n   */\n  selectPage(page: PageRef | number): void;\n  /**\n   * Select the word around a page point. Returns false when the point has no\n   * selectable text (geometry not loaded yet, or no glyph there). Throws\n   * `permission-denied` without `doc.text.select`, `not-found` for a page that\n   * is not in this document.\n   */\n  selectWordAt(page: PageRef | number, point: Point): boolean;\n  /** Select the visual line around a page point. Same result and errors as {@link selectWordAt}. */\n  selectLineAt(page: PageRef | number, point: Point): boolean;\n  /**\n   * Extend the current selection to a page point (a drag step). No selection\n   * → no-op; a page whose geometry has not loaded is warmed and the extension\n   * lands when it arrives. Errors as {@link selectPage}.\n   */\n  extendTo(page: PageRef | number, point: Point): void;\n  /** Clear the selection. Always allowed. Fires `onCleared` when something was selected. */\n  clear(): void;\n\n  // ── reads ──\n  /** Whether anything is selected. */\n  hasSelection(): boolean;\n  /**\n   * Whether the user is still selecting: from the press of a drag, a\n   * double-click or a handle until it lifts. A selection made from code is\n   * never in progress.\n   */\n  isSelecting(): boolean;\n  /** Per-page segments, endpoints, direction and the range. Reference-stable\n   *  until the selection changes. */\n  getSnapshot(): SelectionSnapshot;\n  /** The selected character range, or null. */\n  getRange(): TextRange | null;\n  /** The pages the current selection covers (those with at least one\n   *  segment), in document order — so a cross-page action can fan out per page. */\n  listSelectedPages(): readonly PageRef[];\n  /** Per-line oriented segments for a page, in page space — build your own\n   *  highlight layer from these. Reference-stable per page. */\n  listSegments(page: PageRef | number): readonly SelectionSegment[];\n  /** The segments' AABBs — for consumers that genuinely want boxes (scroll,\n   *  conservative regions). Never a substitute for the oriented quads in\n   *  geometry that gets drawn or persisted. */\n  listRects(page: PageRef | number): readonly Rect[];\n  /**\n   * Where selection-scoped floating UI should attach: the union box of the\n   * selection's segments on its end page (where the gesture finished),\n   * falling back to the last page with materialized segments while a\n   * boundary page's geometry is still loading. One anchor regardless of\n   * cross-page selection. Null when nothing is selected (or nothing has\n   * materialized yet).\n   */\n  getAnchor(): SelectionAnchor | null;\n\n  // ── text extraction (requires doc.text.copy) ──\n  /**\n   * The selected text. Each page's text snapshot is fetched once per content\n   * version and sliced through the engine's `charMap`; pages are joined with\n   * `\\n`. Resolves `''` when nothing is selected. Rejects `permission-denied`\n   * without `doc.text.copy`, and `operation-cancelled` when `options.signal`\n   * fires. Clipboard writes are deliberately not here — this package is\n   * DOM-free; use `@embedpdf/web`'s clipboard helpers.\n   */\n  readText(options?: OperationOptions): Promise<string>;\n  /**\n   * Text for any range, without touching the selection. Rejects as\n   * {@link readText} does, and `not-found` for a page that is not in this\n   * document.\n   */\n  readTextInRange(range: TextRange, options?: OperationOptions): Promise<string>;\n\n  // ── events ──\n  /** The range or its segments changed, whoever changed them. */\n  readonly onChanged: EventHook<SelectionChangedEvent>;\n  /** A selection gesture ended with a selection in place. */\n  readonly onCommitted: EventHook<SelectionCommittedEvent>;\n  /** The selection went from a range to nothing: a clear, an empty range, or\n   *  its pages' content changed or left the document. */\n  readonly onCleared: EventHook<SelectionClearedEvent>;\n}\n\nexport { SelectionToken } from './token';\n"],"mappings":";;;;AAMA,MAAa,iBAAiB,sBAA2C,aAAa;CACpF,MAAM;CAGN,UAAU;EACR,UAAU;EACV,iBAAiB;CACnB;AACF,CAAC;;;;AC+BD,MAAa,qBAAwC;CACnD,eAAe;CACf,OAAO;CACP,SAAS;EAAE,OAAO;EAAM,QAAQ;CAA8B;AAChE"}

package/dist/contract-DLs4vXVt.d.cts

@@ -0,0 +1,252 @@
+import { DeepPartial, EventHook, OperationOptions, PageRef, SettingsApi } from "@embedpdf/core";
+import { Point, Quad, Rect } from "@embedpdf/core-geometry";
+import { PdfTextSegment } from "@embedpdf/engine-core/runtime";
+//#region src/geometry.d.ts
+/**
+ * One merged visual line of a selection, as the engine's layout gives it.
+ * `quad` carries the corners, named in the line's own frame; `advance` is the
+ * reading direction along the baseline (+1 = toward the right end), derived
+ * from the glyph sequence, so geometry and bidi stay separate concerns.
+ * `rect` is its bounding box.
+ */
+type SelectionSegment = PdfTextSegment;
+//#endregion
+//#region src/token.d.ts
+declare const SelectionToken: import("@embedpdf/core").CapabilityToken<SelectionCapability>;
+//#endregion
+//#region src/contract.d.ts
+/**
+ * The selection plugin's settings. `selectionPlugin(config)` registers them
+ * over {@link SELECTION_DEFAULTS}, and `updateSettings()` changes them for
+ * every document while the app runs. The colors and the shadow can also come
+ * from CSS (`--epdf-text-selection`, `--epdf-text-selection-handle`,
+ * `--epdf-text-selection-handle-shadow`), which wins over the setting.
+ */
+interface SelectionSettings {
+  /** How far, in viewport pixels, the pointer travels before a press becomes a drag that selects. */
+  readonly dragThreshold: number;
+  /** The color of selected text: a CSS color, or `null` for the viewer's accent at 35%. */
+  readonly color: string | null;
+  /** The grips at the selection's ends, on touch screens. */
+  readonly handles: {
+    /** A CSS color, or `null` for the viewer's accent. */
+    readonly color: string | null;
+    /** A CSS `box-shadow`. */
+    readonly shadow: string;
+  };
+}
+/** What the selection settings are when the app registers none. */
+declare const SELECTION_DEFAULTS: SelectionSettings;
+/** What `selectionPlugin(config)` takes: any of the settings, merged over the defaults. */
+type SelectionConfig = DeepPartial<SelectionSettings>;
+/**
+ * A position in a page's character space — the space the engine's geometry
+ * runs tile (`PageGeometryRun.charStart`) and search hits address
+ * (`SearchMatch.charStart`). Not a string offset into extracted text; the
+ * two spaces are joined by the engine's `charMap` (see engine-core
+ * `text/charmap.ts`), which `readText()` applies for you.
+ */
+interface TextPosition {
+  page: PageRef;
+  /** Character index, 0-based. */
+  index: number;
+}
+/**
+ * A half-open range in character space: `start` inclusive, `end` exclusive,
+ * in document order (`start` at or before `end`). `end.index` may be 0 to
+ * end a range exactly at a page boundary.
+ */
+interface TextRange {
+  start: TextPosition;
+  end: TextPosition;
+}
+/**
+ * What {@link SelectionCapability.select} accepts: a cross-page
+ * {@link TextRange}, or a single-page span — the shape of a search hit, so
+ * `select({ page: hit.page, start: hit.charStart, count: hit.charCount })`
+ * needs no conversion.
+ */
+type SelectionRangeInput = TextRange | {
+  page: PageRef;
+  start: number;
+  count: number;
+};
+/**
+ * A selection boundary, anchored to the boundary glyph's own oriented cell.
+ * `advance` is the reading direction of the segment it belongs to (+1 = the
+ * frame's +x), so caret consumers place at the trailing edge without
+ * re-deriving bidi from geometry. `rect` is the AABB (scroll targets).
+ */
+interface SelectionEndpoint {
+  page: PageRef;
+  glyphQuad: Quad;
+  advance: 1 | -1;
+  rect: Rect;
+}
+/** Where selection-scoped floating UI attaches: a page + the selection's
+ *  union box on it, in page space. See {@link SelectionCapability.getAnchor}. */
+interface SelectionAnchor {
+  page: PageRef;
+  bounds: Rect;
+}
+interface SelectionSnapshot {
+  /** Per-page canonical segments — the one geometry consumers act on.
+   *  Boxes are derived views (`segment.rect`, or `listRects()`). */
+  readonly pages: readonly {
+    page: PageRef;
+    segments: readonly SelectionSegment[];
+  }[];
+  readonly start: SelectionEndpoint | null;
+  readonly end: SelectionEndpoint | null;
+  readonly direction: 'forward' | 'backward';
+  /**
+   * The selection as a half-open character range in document order — a
+   * valid {@link SelectionCapability.select} input (persist and restore).
+   * Null when nothing is selected. Until a boundary page's text geometry
+   * has loaded, its index may still exceed the page's character count
+   * (`selectAll` settles as geometry arrives); consumers of the range
+   * (`select`, `readTextInRange`) clamp, so round-tripping is always safe.
+   */
+  readonly range: TextRange | null;
+}
+/**
+ * The selection's range or segments changed: a gesture step, a programmatic
+ * select, a boundary page's text geometry arriving, or a clear. Selection is
+ * session state, so the event carries no document origin.
+ */
+interface SelectionChangedEvent {
+  readonly range: TextRange | null;
+  /** The pages that carry a segment right now. */
+  readonly pages: readonly PageRef[];
+}
+/** A selection gesture ended (pointer-up, handle release) with a selection in
+ *  place — the commit point markup creation and clipboard prefetch act on.
+ *  Never fires for programmatic selection. */
+interface SelectionCommittedEvent {
+  readonly range: TextRange;
+}
+/** The selection went from a range to nothing. */
+type SelectionClearedEvent = Record<string, never>;
+/**
+ * The public selection API — the documented, stable surface for application
+ * code (toolbars, context menus, automation).
+ *
+ * The permission model: geometry enables selection (`doc.text.select`),
+ * text enables extraction (`doc.text.copy`) — neither implies the other.
+ * Everything here except the `readText` pair works with the select scope
+ * alone, so a deployment can allow selecting and highlighting while denying
+ * copy. Writes without the scope throw `PluginError('permission-denied')`;
+ * gate UI with {@link canSelect} / {@link canCopy}.
+ *
+ * Every gesture has a programmatic twin: drag = {@link select} (or
+ * `beginGestureAt` + {@link extendTo} for point-driven code on the host
+ * lens), double-click = {@link selectWordAt}, triple-click =
+ * {@link selectLineAt}, handle drag = {@link extendTo}, click on empty space
+ * = {@link clear}, select-all = {@link selectAll}.
+ *
+ * A page argument is a `PageRef` or a zero-based index. A verb given a page
+ * that isn't in the document throws `not-found`; a read returns empty.
+ *
+ * The settings (`getSettings`, `updateSettings`, `resetSettings`,
+ * `onSettingsChanged`) belong to the plugin, not to a document: a change
+ * reaches every open document.
+ *
+ * Framework-only plumbing (gesture bracketing, geometry warming, the
+ * highlight-visibility handshake) lives on `SelectionHostCapability`,
+ * reachable through `@embedpdf/plugin-selection/contract/host`. Both are the
+ * same runtime object — two typed lenses on one token.
+ */
+interface SelectionCapability extends SettingsApi<SelectionSettings> {
+  /** Whether this caller may create selections at all (`doc.text.select`). */
+  canSelect(): boolean;
+  /** Whether this caller may extract literal text (`doc.text.copy`). */
+  canCopy(): boolean;
+  /**
+   * Select a range — the same path gestures use, so the highlight, events
+   * and markup bridges behave identically. An empty range clears. Throws
+   * `permission-denied` without `doc.text.select`, `not-found` for a page
+   * that is not in this document. Fires `onChanged`, or `onCleared`.
+   */
+  select(range: SelectionRangeInput): void;
+  /** Select every character of the document. Throws `permission-denied` without `doc.text.select`. */
+  selectAll(): void;
+  /**
+   * Select every character on one page. Throws `permission-denied` without
+   * `doc.text.select`, `not-found` for a page that is not in this document.
+   */
+  selectPage(page: PageRef | number): void;
+  /**
+   * Select the word around a page point. Returns false when the point has no
+   * selectable text (geometry not loaded yet, or no glyph there). Throws
+   * `permission-denied` without `doc.text.select`, `not-found` for a page that
+   * is not in this document.
+   */
+  selectWordAt(page: PageRef | number, point: Point): boolean;
+  /** Select the visual line around a page point. Same result and errors as {@link selectWordAt}. */
+  selectLineAt(page: PageRef | number, point: Point): boolean;
+  /**
+   * Extend the current selection to a page point (a drag step). No selection
+   * → no-op; a page whose geometry has not loaded is warmed and the extension
+   * lands when it arrives. Errors as {@link selectPage}.
+   */
+  extendTo(page: PageRef | number, point: Point): void;
+  /** Clear the selection. Always allowed. Fires `onCleared` when something was selected. */
+  clear(): void;
+  /** Whether anything is selected. */
+  hasSelection(): boolean;
+  /**
+   * Whether the user is still selecting: from the press of a drag, a
+   * double-click or a handle until it lifts. A selection made from code is
+   * never in progress.
+   */
+  isSelecting(): boolean;
+  /** Per-page segments, endpoints, direction and the range. Reference-stable
+   *  until the selection changes. */
+  getSnapshot(): SelectionSnapshot;
+  /** The selected character range, or null. */
+  getRange(): TextRange | null;
+  /** The pages the current selection covers (those with at least one
+   *  segment), in document order — so a cross-page action can fan out per page. */
+  listSelectedPages(): readonly PageRef[];
+  /** Per-line oriented segments for a page, in page space — build your own
+   *  highlight layer from these. Reference-stable per page. */
+  listSegments(page: PageRef | number): readonly SelectionSegment[];
+  /** The segments' AABBs — for consumers that genuinely want boxes (scroll,
+   *  conservative regions). Never a substitute for the oriented quads in
+   *  geometry that gets drawn or persisted. */
+  listRects(page: PageRef | number): readonly Rect[];
+  /**
+   * Where selection-scoped floating UI should attach: the union box of the
+   * selection's segments on its end page (where the gesture finished),
+   * falling back to the last page with materialized segments while a
+   * boundary page's geometry is still loading. One anchor regardless of
+   * cross-page selection. Null when nothing is selected (or nothing has
+   * materialized yet).
+   */
+  getAnchor(): SelectionAnchor | null;
+  /**
+   * The selected text. Each page's text snapshot is fetched once per content
+   * version and sliced through the engine's `charMap`; pages are joined with
+   * `\n`. Resolves `''` when nothing is selected. Rejects `permission-denied`
+   * without `doc.text.copy`, and `operation-cancelled` when `options.signal`
+   * fires. Clipboard writes are deliberately not here — this package is
+   * DOM-free; use `@embedpdf/web`'s clipboard helpers.
+   */
+  readText(options?: OperationOptions): Promise<string>;
+  /**
+   * Text for any range, without touching the selection. Rejects as
+   * {@link readText} does, and `not-found` for a page that is not in this
+   * document.
+   */
+  readTextInRange(range: TextRange, options?: OperationOptions): Promise<string>;
+  /** The range or its segments changed, whoever changed them. */
+  readonly onChanged: EventHook<SelectionChangedEvent>;
+  /** A selection gesture ended with a selection in place. */
+  readonly onCommitted: EventHook<SelectionCommittedEvent>;
+  /** The selection went from a range to nothing: a clear, an empty range, or
+   *  its pages' content changed or left the document. */
+  readonly onCleared: EventHook<SelectionClearedEvent>;
+}
+//#endregion
+export { SelectionClearedEvent as a, SelectionEndpoint as c, SelectionSnapshot as d, TextPosition as f, SelectionSegment as h, SelectionChangedEvent as i, SelectionRangeInput as l, SelectionToken as m, SelectionAnchor as n, SelectionCommittedEvent as o, TextRange as p, SelectionCapability as r, SelectionConfig as s, SELECTION_DEFAULTS as t, SelectionSettings as u };
+//# sourceMappingURL=contract-DLs4vXVt.d.cts.map