@twip/web 0.0.0-canary-7dfb59b → 0.0.0-canary-d060d80

package/README.md

@@ -32,6 +32,19 @@ await editor.destroy();
 
 In Node, workers and tests, `HeadlessEditor.create()` gives the same API with no DOM.
 
+## Your own field types
+
+A field whose type isn't one of Word's reads as a bookmark reference, and with no result it shows "Error! Bookmark
+not defined.", as in Word. Declare the types your application fills itself after each `open`:
+
+```ts
+await editor.commands.setApplicationFieldTypes({ types: ['CUSTOMVALUE', 'CUSTOMTEXT'] });
+```
+
+Their fields then keep their results, show nothing when empty (their `setFieldLabels` label, else «first argument»,
+in design mode) and are listed by `fieldsUpdateRequested` on `updateFields`, for `setFieldResults` to fill. Types
+compare without case; each call replaces the list, and `[]` clears it. Setting it doesn't mark the document modified.
+
 ## Serving the engine's files yourself
 
 The engine runs from files in the package's `dist/`: `worker.js`, `twip-wasm.js`, `twip_wasm.wasm`, and the

package/dist/commands.d.ts

@@ -1,5 +1,5 @@
 import type { RichText } from './review.js';
-import type { ControlKind, ControlOptions, DataBinding, ReferenceRule, SubTemplateVersion } from './services/elements.js';
+import type { ControlKind, ControlOptions, DataBinding, ReferenceRule } from './services/elements.js';
 import type { TabAlignment, TabLeader, TabSelector } from './services/ruler.js';
 import type { ViewOptions } from './services/view.js';
 import type { AutoCorrectChange, HighlightColor, HorizontalPosition, LineSpacing, MarkupView, ObjectWrap, RowHeight, TablePosition, TableWidth, UnderlineStyle, VerticalPosition, WrapSide } from './state.js';
@@ -19,10 +19,7 @@ export interface PlaceholderLook {
     } | {
         prefix: string;
     } | 'default';
-    /**
-     * A fill, label and icon, or an image. With `placeholderUi` on, `fill` is the input block's base colour: its tint,
-     * outlines and primary button are derived from it.
-     */
+    /** A fill, label and icon, or an image. */
     look: {
         fill?: Color;
         label?: string;
@@ -31,19 +28,6 @@ export interface PlaceholderLook {
         image: Uint8Array;
         mime: string;
     };
-    /** The hint an input block shows while hovered. Default: "Click to add". */
-    hint?: string;
-    /** The buttons a selected input block shows, in order; none: a press on the block activates it. */
-    actions?: PlaceholderAction[];
-}
-/** A button on a selected input block: a press raises `placeholderActivated` with its `id` as `action`. */
-export interface PlaceholderAction {
-    /** What `placeholderActivated` names as `action`. */
-    id: string;
-    /** Its text. */
-    label: string;
-    /** Filled in the block's colour (the others are outlined); Enter presses it. Default: false. */
-    primary?: boolean;
 }
 /**
  * Every edit, one method per command. Each resolves after its change commits, with `getState()` already at that
@@ -492,22 +476,19 @@ export interface Commands {
         labels: Record<string, string>;
         merge?: boolean;
     }): Promise<void>;
-    /** The type text a field's caption shows, by field code (default: the field type, `MERGEFIELD`). View. */
-    setFieldTypes(options: {
-        types: Record<string, string>;
-        merge?: boolean;
-    }): Promise<void>;
-    /**
-     * The merge fields (by name, their first argument) the data source lacks: drawn neutral, struck through. Replaces
-     * the list, and `[]` clears it. View.
-     */
-    setUnmappedFields(options: {
-        names: string[];
-    }): Promise<void>;
     /** Which fields are sub-template references: replaces the rules; an empty list turns sub-templates off. View. */
     setSubTemplateRules(options: {
         rules: ReferenceRule[];
     }): Promise<void>;
+    /**
+     * The application's own field types (a code's first word, compared without case), replacing those set before:
+     * their fields keep their results, show their labels in design mode ({@link Commands.setFieldLabels}, else
+     * «first argument»), are listed by `fieldsUpdateRequested` and are never read as bookmark references
+     * ("Error! Bookmark not defined."). `[]` clears them. Set it after each `open`, as the rules. View.
+     */
+    setApplicationFieldTypes(options: {
+        types: string[];
+    }): Promise<void>;
     /** Shows references' sub-template bodies in their place, or their fields (default: every reference). View. */
     setSubTemplateView(options: {
         ids?: ElementId[];
@@ -538,10 +519,6 @@ export interface Commands {
         name: string;
         category?: string;
     }): Promise<void>;
-    /** The version text sub-templates' cards and tabs show, and their newer versions; replaces the list. View. */
-    setSubTemplateVersions(options: {
-        versions: SubTemplateVersion[];
-    }): Promise<void>;
     /** Inserts a content control, optionally around the selection. */
     insertControl(options: {
         kind: ControlKind;
@@ -615,14 +592,6 @@ export interface Commands {
         looks: PlaceholderLook[];
         merge?: boolean;
     }): Promise<void>;
-    /** Draws a placeholder hovered until cleared (`null`), as when the application's field list hovers it. View. */
-    highlightElement(options: {
-        id: ElementId | null;
-    }): Promise<void>;
-    /** Selects the next placeholder in document order, wrapping; Tab while one is selected. View. */
-    selectNextPlaceholder(): Promise<void>;
-    /** Selects the previous placeholder in document order, wrapping; Shift+Tab while one is selected. View. */
-    selectPreviousPlaceholder(): Promise<void>;
     /** Fills the selected placeholder, or every unfilled one with `key`: each becomes a plain picture, its content control removed. */
     fillPlaceholder(options: {
         key?: string;
@@ -699,7 +668,7 @@ export interface Commands {
     setZoom(zoom: number | 'pageWidth' | 'wholePage'): Promise<void>;
     /**
      * Sets view options: formatting marks (Ctrl+Shift+8), gridlines, text boundaries, live layout, the chrome's theme
-     * and accent, the page's appearance, the measuring detail, the object grid and the placeholder UI.
+     * and accent, the page's appearance, the measuring detail and the object grid.
      */
     setViewOptions(options: ViewOptions): Promise<void>;
     /** Switches between editing and design mode. */

package/dist/commands.js

@@ -143,16 +143,14 @@ const encodings = {
     unlinkFields: 'spread',
     showFieldCodes: 'spread',
     setFieldLabels: 'spread',
-    setFieldTypes: 'spread',
-    setUnmappedFields: 'spread',
     setSubTemplateRules: 'spread',
+    setApplicationFieldTypes: 'spread',
     setSubTemplateView: 'spread',
     editSubTemplate: 'spread',
     closeSubTemplate: 'none',
     createSubTemplate: 'spread',
     renameSubTemplate: 'spread',
     removeSubTemplate: 'spread',
-    setSubTemplateVersions: 'spread',
     insertControl: 'spread',
     setControl: 'spread',
     removeControl: 'spread',
@@ -163,9 +161,6 @@ const encodings = {
     replaceInElements: 'spread',
     markElements: 'spread',
     setPlaceholderLooks: 'spread',
-    highlightElement: 'spread',
-    selectNextPlaceholder: 'none',
-    selectPreviousPlaceholder: 'none',
     fillPlaceholder: 'spread',
     writeDataPart: 'spread',
     removeDataPart: 'spread',

package/dist/events.d.ts

@@ -2,7 +2,7 @@ import type { EditorError } from './errors.js';
 import type { BalloonPlacement, CommentAnchor } from './review.js';
 import type { AnnouncementKind } from './services/accessibility.js';
 import type { DialogKind } from './services/dialogs.js';
-import type { ElementInfo, SubTemplateReference } from './services/elements.js';
+import type { ElementInfo } from './services/elements.js';
 import type { ContextMenuEvent } from './services/menus.js';
 import type { RulerView } from './services/ruler.js';
 import type { GestureEvent, Popover } from './services/view.js';
@@ -21,28 +21,10 @@ export interface TwipEvents {
         address: string;
         via: 'ctrlClick' | 'click';
     };
-    /**
-     * An unfilled picture placeholder was clicked, or one of its buttons (`action`: the button's id).
-     */
+    /** An unfilled picture placeholder was clicked. */
     placeholderActivated: {
         key: string;
         element: ElementId | null;
-        action?: string;
-    };
-    /**
-     * With `placeholderUi` on, the pointer starts or stops being over a placeholder, or the hovered one's anchor moves;
-     * `null` when it leaves.
-     */
-    placeholderHovered: PlaceholderTarget | null;
-    /**
-     * With `placeholderUi` on, the selection starts or stops covering exactly one placeholder, or the selected one's
-     * anchor moves (scroll, zoom, layout); `null` when it's no longer selected.
-     */
-    placeholderSelected: PlaceholderTarget | null;
-    /** A shown sub-template's newer-version notice (`setSubTemplateVersions`) was pressed: the application updates it. */
-    subTemplateUpdateRequested: {
-        name: string;
-        category: string;
     };
     /**
      * Typing, pasting or dropping was refused: into a sub-template's body shown in place of its reference (edit the
@@ -158,7 +140,7 @@ export type HostCommand = 'save' | 'saveAs' | 'print' | 'open' | 'new' | 'find'
 /** A hover tooltip to show. */
 export interface Tooltip {
     /** What is hovered. */
-    kind: 'link' | 'mark' | 'revision' | 'comment' | 'placeholder';
+    kind: 'link' | 'mark' | 'revision' | 'comment';
     /** The text to show. */
     text: string;
     /** The pointer. */
@@ -166,26 +148,3 @@ export interface Tooltip {
     /** The hovered thing's box. */
     rect: ClientRect;
 }
-/** What kind of placeholder a {@link PlaceholderTarget} is. */
-export type PlaceholderKind = 'field' | 'control' | 'repeatingSection' | 'subTemplate' | 'inputBlock' | 'ifField';
-/** A placeholder the pointer is over or the selection covers, with `placeholderUi` on. */
-export interface PlaceholderTarget {
-    /** The field or control; absent for an input block outside a content control. */
-    element?: ElementId;
-    /** What it is. */
-    kind: PlaceholderKind;
-    /** What it shows, in full: a field's label or result, a control's title. */
-    label: string;
-    /** A field's name (its first argument), a control's tag, or a picture placeholder's key. */
-    key?: string;
-    /** A field's code. */
-    code?: string;
-    /** The caption's type text: `setFieldTypes`' text for the code, else the field type (`MERGEFIELD`), or a control's kind. */
-    typeText: string;
-    /** The data source lacks the field (`setUnmappedFields`). */
-    unmapped: boolean;
-    /** For a sub-template reference: what it names and whether its body shows. */
-    reference?: SubTemplateReference;
-    /** Where it is, in the same space as a popover's anchor: a field's last line, else its box. */
-    anchor: ClientRect;
-}

package/dist/host/chrome.js

@@ -112,7 +112,6 @@ export function startChrome(s, dom, ledger, frames, report, toViewport) {
         setThemeColors: (themeColors) => setLook({ themeColors }),
         setAppearance: (appearance) => setLook({ appearance }),
         setDetail: (detail) => setLook({ detail }),
-        setPlaceholderUi: (placeholderUi) => setLook({ placeholderUi }),
         visiblePages: () => {
             const r = dom.canvas.getBoundingClientRect();
             return pages.map(({ page, rect }) => ({ page, rect: { ...rect, left: rect.left + r.left, top: rect.top + r.top } }));

package/dist/host/mount.js

@@ -34,10 +34,6 @@ export async function mountHost(container, s, options, claims) {
             const t = event;
             return { ...t, at: client(t.at), rect: { ...t.rect, left: t.rect.left + r.left, top: t.rect.top + r.top } };
         }
-        if ((type === 'placeholderHovered' || type === 'placeholderSelected') && event) {
-            const t = event;
-            return { ...t, anchor: { ...t.anchor, left: t.anchor.left + r.left, top: t.anchor.top + r.top } };
-        }
         if (type === 'popoverRequested') {
             const p = event;
             return { ...p, anchor: { ...p.anchor, left: p.anchor.left + r.left, top: p.anchor.top + r.top } };

package/dist/index.d.ts

@@ -7,9 +7,9 @@
 export { Editor, HeadlessEditor } from './editor.js';
 export { configure } from './transport/module.js';
 export type { ExportOptions, ExportResult, MountOptions, PdfOptions, SessionOptions } from './editor.js';
-export type { CommandEntry, CommandId, CommandInfo, Commands, FieldTargets, NoArgumentCommandId, Op, OpArgs, PlaceholderAction, PlaceholderLook, } from './commands.js';
+export type { CommandEntry, CommandId, CommandInfo, Commands, FieldTargets, NoArgumentCommandId, Op, OpArgs, PlaceholderLook, } from './commands.js';
 export type { AutoCorrectChange, AutoCorrectEntry, AutoCorrectOptions, CharacterFormatting, CommandState, CommandValues, EditingTarget, EditorState, ElementContext, HighlightColor, HorizontalPosition, HorizontalReference, LineSpacing, MarkupView, Mixed, ObjectHorizontalAlignment, ObjectPlacement, ObjectSelection, ObjectVerticalAlignment, ObjectWrap, PageFormatting, ParagraphFormatting, ReviewState, RowHeight, SelectionSummary, TablePosition, TableSelection, TableStyleOptions, TableWidth, TextDistance, Tri, UnderlineStyle, VerticalPosition, VerticalReference, ViewState, WrapSide, } from './state.js';
-export type { HostCommand, PlaceholderKind, PlaceholderTarget, Tooltip, TransactionRecord, TwipEvents } from './events.js';
+export type { HostCommand, Tooltip, TransactionRecord, TwipEvents } from './events.js';
 export { EditorError } from './errors.js';
 export type { ErrorCode } from './errors.js';
 export { FontLibrary } from './fonts/library.js';
@@ -19,7 +19,7 @@ export type { ContextMenu, ContextMenuEvent, MenuAction, MenuItem, MenuTarget, M
 export type { AccessibilityDialogSession, DialogKind, DialogSession, DialogSessionOf, DialogValues, Dialogs, FieldInfo, } from './services/dialogs.js';
 export type { Find, FindMatch, FindQuery, FindResult } from './services/find.js';
 export type { Dictionary, Spelling } from './services/spelling.js';
-export type { Block, ControlKind, ControlOptions, DataBinding, DataParts, ElementDetail, ElementInfo, Elements, MountedElements, PlaceholderInfo, ReferenceResolution, ReferenceRule, SubTemplateInfo, SubTemplateReference, SubTemplates, SubTemplateVersion, } from './services/elements.js';
+export type { Block, ControlKind, ControlOptions, DataBinding, DataParts, ElementDetail, ElementInfo, Elements, MountedElements, PlaceholderInfo, ReferenceResolution, ReferenceRule, SubTemplateInfo, SubTemplateReference, SubTemplates, } from './services/elements.js';
 export type { Accessibility, AccessibleId, AccessibleNode, AnnouncementKind, CellPlace, ListPosition, Shortcuts } from './services/accessibility.js';
 export type { Heading, Navigation, StyleInfo, Styles } from './services/navigation.js';
 export type { Ruler, RulerModel, RulerModelSource, RulerUnit, RulerView, TabAlignment, TabLeader, TabSelector, } from './services/ruler.js';

package/dist/services/elements.d.ts

@@ -37,8 +37,6 @@ export interface PlaceholderInfo {
     key: string;
     /** The control it is in. */
     element: ElementId | null;
-    /** The input block's button pressed (its id); absent: the block itself. */
-    action?: string;
 }
 /** {@link Elements} on a mounted editor: adds drop targets and hit testing. */
 export interface MountedElements extends Elements {
@@ -93,17 +91,6 @@ export interface ReferenceRule {
     /** The building block gallery (`custom1`), when it matters. */
     gallery?: string;
 }
-/** A sub-template's version, as its card and its shown body's tab show it (`setSubTemplateVersions`). */
-export interface SubTemplateVersion {
-    /** The sub-template's name. */
-    name: string;
-    /** Its category. Default: the first reference rule's. */
-    category?: string;
-    /** The version text (`v4`). */
-    version: string;
-    /** A newer version's notice (`v5 available`); a press on it raises `subTemplateUpdateRequested`. */
-    newer?: string;
-}
 /** Whether a reference's sub-template resolves, or why its body can't show. */
 export type ReferenceResolution = 'resolved' | 'missing' | 'nearMatch' | 'cycle' | 'tooDeep' | 'notAlone' | 'notInBody';
 /** What a sub-template reference field names and whether its body shows. */

package/dist/services/view.d.ts

@@ -31,12 +31,6 @@ export interface View {
     setAppearance(appearance: DocumentAppearance): Promise<void>;
     /** How much the editor measures while you drag and hover. `setViewOptions` with `detail`. */
     setDetail(detail: MeasureDetail): Promise<void>;
-    /**
-     * Draws placeholders as editor UI (field marks, repeating sections, sub-template cards and input blocks), with the
-     * `placeholderHovered` and `placeholderSelected` events; never changes the output. `setViewOptions` with
-     * `placeholderUi`.
-     */
-    setPlaceholderUi(on: boolean): Promise<void>;
     /** The pages on screen, for a page navigator or a thumbnails strip. */
     visiblePages(): {
         page: number;
@@ -77,8 +71,6 @@ export interface ViewOptions {
     detail?: MeasureDetail;
     /** When the dot grid objects snap to shows (unrelated to `gridlines`, the table gridlines). */
     objectGrid?: ObjectGrid;
-    /** Draws placeholders as editor UI: field marks, repeating sections, sub-template cards and input blocks. Default: off. */
-    placeholderUi?: boolean;
 }
 /**
  * The editor chrome's colour scheme: the desk, rulers, handles, guides and readouts. `highContrast` takes the

package/dist/state.d.ts

@@ -570,8 +570,6 @@ export interface ViewState {
     detail: MeasureDetail;
     /** When the objects' dot grid shows. */
     objectGrid: ObjectGrid;
-    /** Placeholders are drawn as editor UI (`placeholderUi`). */
-    placeholderUi: boolean;
     /** Which fields are sub-template references (`setSubTemplateRules`); absent when none are. */
     subTemplateRules?: ReferenceRule[];
 }

package/dist/transport/protocol.js

@@ -126,7 +126,7 @@ export function decodeEvent(wire) {
     return { type, event: 'value' in fields ? fields.value : fields };
 }
 /** The events whose payload always travels as `value`, an object or not: the engine's optional payloads. */
-const valueEvents = new Set(['tooltip', 'placeholderHovered', 'placeholderSelected']);
+const valueEvents = new Set(['tooltip']);
 /** The inverse of {@link decodeEvent}. */
 export function encodeEvent(type, event) {
     if (event instanceof EditorError)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@twip/web",
-  "version": "0.0.0-canary-7dfb59b",
+  "version": "0.0.0-canary-d060d80",
   "description": "The Twip DOCX editor for the browser and Node: a managed, framework-independent editor over the WebAssembly engine.",
   "type": "module",
   "license": "Apache-2.0",