@docmentis/udoc-editor 0.0.1 → 0.8.0

package/dist/paint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paint.d.ts","sourceRoot":"","sources":["../src/paint.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAGR,UAAU,EAEV,SAAS,EAKZ,MAAM,sBAAsB,CAAC;AAU9B,OAAO,KAAK,EACR,QAAQ,EACR,YAAY,EAEZ,SAAS,EAET,aAAa,EACb,gBAAgB,EAChB,WAAW,EAGX,WAAW,EACd,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAQ5C;;;wEAGwE;AACxE,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,IAAI,CAcvE;AAED;gDACgD;AAChD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAG9D;AAkFD;;+DAE+D;AAC/D,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,SAAS,CAAC;IACjB,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;CAClB;AAED,yEAAyE;AACzE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW;2BAShB,SAAS,KAAG,OAAO,CAAC,IAAI,CAAC;8BAgBtB,UAAU,KAAG,OAAO,CAAC,IAAI,CAAC;EAgB9D;AAED,4DAA4D;AAC5D,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAiB7D;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IACpD,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;CACpC;AAED,6CAA6C;AAC7C,wBAAgB,iBAAiB,IAAI,WAAW,CAU/C;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CACxB,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,EAC5D,KAAK,EAAE,SAAS,GACjB,aAAa,CA4Ff"}

package/dist/paint.js

@@ -0,0 +1,262 @@
+import { applyPaintBar, buildPaintPanel, createDropdownButton, DEFAULT_OFFICE_THEME, displayToActivePaint, paintSwatch, themeSwatches, } from "@docmentis/udoc-ui/internal";
+import { editState } from "./state.js";
+/** Split an `#rrggbb` hex into its three bytes (`0..255`). */
+function hexToRgbBytes(hex) {
+    const n = parseInt(hex.replace("#", ""), 16);
+    return [(n >> 16) & 0xff, (n >> 8) & 0xff, n & 0xff];
+}
+/** A picker paint as a `PaintColor`, or `null` for "no fill": a solid sRGB
+ *  color, or a theme pick kept as a `schemeClr` reference with its tint/shade
+ *  transforms so it re-themes. The shared color construction behind
+ *  {@link paintToDrawingFill} and the text highlight (a bare color). */
+export function paintToDrawingColor(paint) {
+    switch (paint.kind) {
+        case "none":
+            return null;
+        case "solid": {
+            const [r, g, b] = hexToRgbBytes(paint.hex);
+            return { base: { sRgb: { r, g, b } }, transforms: [] };
+        }
+        case "theme":
+            return {
+                base: { scheme: schemeSlot(paint.slot) },
+                transforms: paint.transforms.map(toDrawingTransform),
+            };
+    }
+}
+/** A picker paint as a `PaintFill`: a solid / theme color wrapped as a solid
+ *  fill, or explicit `"none"` for "no fill". */
+export function paintToDrawingFill(paint) {
+    const color = paintToDrawingColor(paint);
+    return color ? { solid: color } : "none";
+}
+function toDrawingTransform(t) {
+    return t.kind === "tint" ? { tint: t.value } : { shade: t.value };
+}
+/** Map a `schemeClr` slot token to the `PaintSchemeColor` wire name. */
+const SCHEME_TOKEN = {
+    tx1: "text1",
+    bg1: "background1",
+    tx2: "text2",
+    bg2: "background2",
+    accent1: "accent1",
+    accent2: "accent2",
+    accent3: "accent3",
+    accent4: "accent4",
+    accent5: "accent5",
+    accent6: "accent6",
+};
+function schemeSlot(slot) {
+    return SCHEME_TOKEN[slot] ?? "text1";
+}
+/** A composed stroke as a `DrawingML` `Line`: its paint plus weight (points) and
+ *  a preset dash. */
+function paintToDrawingLine(stroke) {
+    return {
+        width: stroke.weight,
+        cap: null,
+        compound: null,
+        align: null,
+        fill: paintToDrawingFill(stroke.paint),
+        dash: dashToDrawing(stroke.dash),
+        join: null,
+        headEnd: null,
+        tailEnd: null,
+    };
+}
+function dashToDrawing(dash) {
+    switch (dash) {
+        case "solid":
+            return { preset: "solid" };
+        case "dash":
+            return { preset: "dash" };
+        case "dot":
+            return { preset: "dot" };
+        case "dashDot":
+            return { preset: "dashDot" };
+    }
+}
+function paintToBrush(paint) {
+    if (paint.kind === "none")
+        return null;
+    const [r, g, b] = hexToRgbBytes(paint.hex);
+    return { solid: { colorSpace: "deviceRgb", components: [r / 255, g / 255, b / 255] } };
+}
+/** A PDF stroking line: the weight (points) and a dash array derived from the
+ *  preset, scaled by the width so it reads consistently at any weight. */
+function portableStrokeLine(weight, dash) {
+    const line = {
+        width: weight,
+        lineCap: dash === "dot" || dash === "dashDot" ? "round" : "butt",
+        lineJoin: "miter",
+        miterLimit: 10,
+        dashArray: null,
+        dashOffset: 0,
+    };
+    const w = weight || 1;
+    const array = dash === "dash"
+        ? [3 * w, 3 * w]
+        : dash === "dot"
+            ? [w, 2 * w]
+            : dash === "dashDot"
+                ? [3 * w, 2 * w, w, 2 * w]
+                : null;
+    if (array)
+        line.dashArray = array;
+    return line;
+}
+/** The Fill / Line edits of the selection, on the shell `host` lends. */
+export function createPaintEdits(host) {
+    const { store, client, commit } = host;
+    // Fill / Line — the picker's paint applied to the current selection. The
+    // payload is the open doc type's own model style, built here (the host builds
+    // model JSON, like `insertObject`), then sent through the same `executeOnSelection`
+    // seam; the doc-type binder replaces the shape's fill / line or the path's
+    // non-stroking / stroking style. "No Fill" on a PDF path (not expressible as a
+    // device style) is skipped.
+    function fillSelection(paint) {
+        if (store.getState().docType === "presentation") {
+            return commit(() => client.executeOnSelection({ kind: "setShapeFill", fill: paintToDrawingFill(paint) }));
+        }
+        const brush = paintToBrush(paint);
+        if (!brush)
+            return Promise.resolve();
+        return commit(() => client.executeOnSelection({
+            kind: "object",
+            edit: { kind: "setNonstrokingStyle", style: { brush, alpha: 1, overprint: false } },
+        }));
+    }
+    // The whole composed stroke (color + weight + dash), since the engine sets the
+    // outline as one value.
+    function strokeSelection(stroke) {
+        if (store.getState().docType === "presentation") {
+            return commit(() => client.executeOnSelection({ kind: "setShapeLine", line: paintToDrawingLine(stroke) }));
+        }
+        const brush = paintToBrush(stroke.paint);
+        if (!brush)
+            return Promise.resolve();
+        const line = portableStrokeLine(stroke.weight, stroke.dash);
+        return commit(() => client.executeOnSelection({
+            kind: "object",
+            edit: { kind: "setStrokingStyle", style: { brush, alpha: 1, overprint: false, line } },
+        }));
+    }
+    return { fillSelection, strokeSelection };
+}
+/**
+ * The doc types whose color pickers show the "Theme Colors" block above the
+ * standard swatches: the OOXML office types, whose color model is
+ * theme-relative (a `schemeClr` re-themes) — not PDF or images (device colors
+ * only). The block shows the document's resolved palette (from the engine's
+ * `themePalette()`) when it has landed, the stand-in Office palette until then.
+ */
+const THEMED = new Set(["presentation", "spreadsheet", "wordprocessing"]);
+/** The picker's Theme Colors row: the current slide's resolved palette mapped
+ *  to swatches, or the stand-in when the engine reported no theme. */
+function mapThemeColors(palette) {
+    return palette ? themeSwatches(palette) : DEFAULT_OFFICE_THEME;
+}
+/** A {@link PaintMemory} at its defaults. */
+export function createPaintMemory() {
+    return {
+        lastPaint: {
+            fill: { kind: "solid", hex: "#4472c4" },
+            stroke: { kind: "solid", hex: "#000000" },
+            text: { kind: "solid", hex: "#000000" },
+            highlight: { kind: "solid", hex: "#ffff00" },
+        },
+        lastStroke: { weight: 1, dash: "solid" },
+    };
+}
+/**
+ * A Fill / Line / Text Color dropdown of `channel`, for command `id` drawn with
+ * `icon`: the channel glyph over a color bar reflecting the *selection's* color,
+ * the caret opening the color panel (rebuilt on each open). A mirror — clicking
+ * always opens the picker (no last-color re-apply); each render keeps the
+ * swatch in sync with the selection.
+ */
+export function paintControl(env, command, tools) {
+    const { i18n, paintMemory: memory } = tools;
+    const { channel } = command;
+    const selectionPaint = () => editState(env.store.getState()).selectionPaint;
+    // Apply the current stroke (color + weight + dash) to the selection — the
+    // whole composed value, since the engine sets the outline as one thing;
+    // the color rides from the last pick.
+    const applyStroke = () => void tools.paint.strokeSelection({
+        paint: memory.lastPaint.stroke,
+        weight: memory.lastStroke.weight,
+        dash: memory.lastStroke.dash,
+    });
+    // Apply a picked paint: fill / text / highlight send the color; stroke
+    // sends the composed stroke (its last-used weight / dash ride along).
+    const applyPaint = (paint) => {
+        if (channel === "fill")
+            void tools.paint.fillSelection(paint);
+        else if (channel === "text")
+            void tools.text.textFillSelection(paint);
+        else if (channel === "highlight")
+            void tools.text.textHighlightSelection(paint);
+        else
+            applyStroke();
+    };
+    // Commit a picked paint: remember it (for the composed stroke re-send and
+    // the recent row) and apply it. The trigger swatch isn't touched here — it
+    // mirrors the selection, so it updates when the resulting report lands.
+    const commitPaint = (paint) => {
+        memory.lastPaint[channel] = paint;
+        if (paint.kind !== "none")
+            env.pushRecent(channel, paint.hex);
+        applyPaint(paint);
+    };
+    // The color panel — doc-type aware (Office shows the theme block, PDF
+    // standard colors only). Rebuilt on each open so recent / active reflect
+    // current state. `close` is the dropdown's.
+    const panelConfig = (close) => {
+        const state = env.store.getState();
+        return {
+            i18n,
+            variant: channel,
+            // Office docs ({@link THEMED}) show the Theme Colors
+            // block — the document's resolved palette when the engine reported
+            // one, else the stand-in; PDF passes `null` for standard colors only.
+            theme: state.docType !== null && THEMED.has(state.docType)
+                ? mapThemeColors(editState(state).themePalette)
+                : null,
+            recent: env.recentPaint[channel],
+            // Ring the *selection's* color as active (the design's true
+            // "active"): a solid color or explicit no-fill; nothing for mixed /
+            // unknown.
+            active: displayToActivePaint(selectionPaint()[channel]),
+            stroke: channel === "stroke" ? memory.lastStroke : null,
+            onPick: (paint) => {
+                commitPaint(paint);
+                close();
+            },
+            onWeight: (pt) => {
+                memory.lastStroke.weight = pt;
+                applyStroke();
+                close();
+            },
+            onDash: (dash) => {
+                memory.lastStroke.dash = dash;
+                applyStroke();
+                close();
+            },
+            // No `onMoreOptions`: the More Options row waits for the advanced
+            // dialog to hold the richer fill / line surface.
+        };
+    };
+    const dd = createDropdownButton({ icon: paintSwatch(command.icon, selectionPaint()[channel]), label: env.label }, {
+        menuLabel: i18n.t("ribbon.paintOptions", { label: env.label }),
+        onOpen: () => buildPaintPanel(dd.menu, panelConfig(() => dd.controller.close())),
+    });
+    dd.trigger.dataset.command = command.id;
+    return {
+        el: dd.el,
+        // The swatch mirrors the selection.
+        sync: (state) => applyPaintBar(dd.trigger, editState(state).selectionPaint[channel]),
+        close: () => dd.controller.close(),
+        destroy: () => dd.destroy(),
+    };
+}
+//# sourceMappingURL=paint.js.map

package/dist/paint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paint.js","sourceRoot":"","sources":["../src/paint.ts"],"names":[],"mappings":"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"}

package/dist/ruler.d.ts

@@ -0,0 +1,10 @@
+import type { Action, GuideBand, Store, UIState } from "@docmentis/udoc-ui/internal";
+/** The ruler band. Paints only a ruler projection; any other leaves the strips
+ *  cleared to their band background until one lands. */
+export declare const RULER: GuideBand;
+/** Whether the ruler shows in `state`: a ruled doc type in edit mode, with the
+ *  preference on. */
+export declare function rulerShown(state: UIState): boolean;
+/** Show or hide the ruler in `store` — a user preference, kept across documents. */
+export declare function setShowRuler(store: Store<UIState, Action>, visible: boolean): void;
+//# sourceMappingURL=ruler.d.ts.map

package/dist/ruler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ruler.d.ts","sourceRoot":"","sources":["../src/ruler.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAc,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAyFjG;wDACwD;AACxD,eAAO,MAAM,KAAK,EAAE,SAKnB,CAAC;AAEF;qBACqB;AACrB,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAElD;AAED,oFAAoF;AACpF,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAElF"}

package/dist/ruler.js

@@ -0,0 +1,97 @@
+import { editState, updateEditState } from "./state.js";
+/** The doc types the engine measures with a ruler: the paged ones. */
+const RULED = new Set(["portable", "presentation", "wordprocessing"]);
+/** A screen-fixed UI font for the labels — not the document's fonts. */
+const UI_FONT = `-apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif`;
+function stroke(ctx, color, x0, y0, x1, y1) {
+    ctx.strokeStyle = color;
+    ctx.lineWidth = 1;
+    ctx.beginPath();
+    ctx.moveTo(x0, y0);
+    ctx.lineTo(x1, y1);
+    ctx.stroke();
+}
+function drawAxis(canvas, ctx, axis, thickness, orient) {
+    const { colors } = canvas;
+    const size = Math.min(11, Math.max(8, thickness * 0.5));
+    ctx.font = `${size}px ${UI_FONT}`;
+    const majorLen = thickness * 0.3;
+    const minorLen = thickness * 0.16;
+    const figCenter = (thickness - majorLen) / 2;
+    // Shift the horizontal ruler's marks (along x) to ride the content canvas
+    // mid-resize; the vertical ruler tracks height, which isn't shifted. See
+    // `GuideBands.setContentShift`. `0` when settled.
+    ctx.save();
+    if (orient === "h")
+        ctx.translate(canvas.shiftX, 0);
+    for (const m of axis.marks) {
+        const len = m.major ? majorLen : minorLen;
+        const p = m.position;
+        // Ticks hang from the inner (content) edge toward the outer, on the
+        // soft `grid` they share with the ruler edge and the header separators.
+        if (orient === "h")
+            stroke(ctx, colors.grid, p, thickness, p, thickness - len);
+        else
+            stroke(ctx, colors.grid, thickness, p, thickness - len, p);
+        if (m.label != null) {
+            ctx.fillStyle = colors.text;
+            if (orient === "h")
+                ctx.fillText(m.label, m.position, figCenter);
+            else
+                ctx.fillText(m.label, figCenter, m.position);
+        }
+    }
+    ctx.restore();
+}
+/**
+ * Fill the ruler's corner box and mark only the junction dot — the single
+ * pixel both the top ruler's bottom edge and the left ruler's right edge pass
+ * through, which each stops just short of, leaving the corner open. Unlike the
+ * header the ruler frames only its content-facing edge and has no grid to
+ * continue, so the corner takes the meeting point alone rather than edges drawn
+ * across the box.
+ */
+function drawCorner(canvas) {
+    const corner = canvas.prepare("corner");
+    if (!corner)
+        return;
+    const { ctx, w, h } = corner;
+    ctx.fillStyle = canvas.colors.grid;
+    ctx.fillRect(w - 1, h - 1, 1, 1);
+}
+function drawRuler(guide, canvas) {
+    const { colors } = canvas;
+    const top = canvas.prepare("top");
+    if (top && guide.horizontal) {
+        drawAxis(canvas, top.ctx, guide.horizontal, top.h, "h");
+        // The ruler's inner (content-facing) edge line — a baseline the ticks
+        // hang from, framing the ruler off the page below (mirrors the header
+        // band's bottom border). The same soft `grid` as the ticks.
+        stroke(top.ctx, colors.grid, 0, top.h - 0.5, top.w, top.h - 0.5);
+    }
+    const left = canvas.prepare("left");
+    if (left && guide.vertical) {
+        drawAxis(canvas, left.ctx, guide.vertical, left.w, "v");
+        stroke(left.ctx, colors.grid, left.w - 0.5, 0, left.w - 0.5, left.h);
+    }
+    drawCorner(canvas);
+}
+/** The ruler band. Paints only a ruler projection; any other leaves the strips
+ *  cleared to their band background until one lands. */
+export const RULER = {
+    thickness: 22,
+    draw(guide, canvas) {
+        if (guide.type === "ruler")
+            drawRuler(guide, canvas);
+    },
+};
+/** Whether the ruler shows in `state`: a ruled doc type in edit mode, with the
+ *  preference on. */
+export function rulerShown(state) {
+    return editState(state).showRuler && state.mode === "edit" && state.docType !== null && RULED.has(state.docType);
+}
+/** Show or hide the ruler in `store` — a user preference, kept across documents. */
+export function setShowRuler(store, visible) {
+    updateEditState(store, { showRuler: visible });
+}
+//# sourceMappingURL=ruler.js.map

package/dist/ruler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ruler.js","sourceRoot":"","sources":["../src/ruler.ts"],"names":[],"mappings":"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"}

package/dist/state.d.ts

@@ -0,0 +1,85 @@
+import type { FontFamilySummary } from "@docmentis/udoc-wasm";
+import type { Action, CommandContext, SelectionPaint, SelectionTextFormat, Store, ThemePalette, UIState } from "@docmentis/udoc-ui/internal";
+import type { EditorMode } from "./mode.js";
+export interface EditState {
+    /**
+     * Whether formatting marks (`¶`, a dot per space, a tab's arrow, `↵`) are
+     * drawn over the text — the ribbon's Show Formatting Marks toggle. A user
+     * preference, off by default; the marks are editing chrome, so what reaches
+     * the engine is `showFormattingMarks` in edit mode on a wordprocessing
+     * document.
+     */
+    showFormattingMarks: boolean;
+    /**
+     * Whether the page ruler is shown (paged doc types — PDF / DOCX / PPTX). A
+     * user preference the host toggles; the ruler is additionally suppressed in
+     * `view` mode (a reading pose needs no measurement chrome). A spreadsheet's
+     * row/column headers are essential and never gated by this.
+     */
+    showRuler: boolean;
+    /**
+     * The current slide's resolved theme color palette (the picker's "Theme
+     * Colors"), or null with no document open or for doc types without a theme
+     * (only presentations carry one). Pulled on open and on slide change; the
+     * color dropdowns map it to swatches for the picker.
+     */
+    themePalette: ThemePalette | null;
+    /**
+     * Every available font family, sorted by name — the Text tab's font picker
+     * list. Each carries its name and its `sourceType`, which is what a picker
+     * showing specimens needs: the browser can draw a `Local` / `Url` /
+     * `Google` family in its own face, and the rest have no bytes outside wasm.
+     * Not the faces — nothing here reads them, and at ~1800 families they are
+     * three quarters of what would cross.
+     *
+     * Stable across the session (only opening a document changes it), so it's
+     * pulled **once** on open and cached. Empty with no document open or for a
+     * doc type with no text font registry (PDF/image).
+     */
+    fontFamilies: readonly FontFamilySummary[];
+    /**
+     * The subset of {@link fontFamilies} that is loaded — parsed and in hand —
+     * which the picker lists first, above a divider.
+     *
+     * Re-pulled whenever the picker opens rather than cached with the full list:
+     * fonts materialize lazily, so this grows through the session as the
+     * document composes and as fonts are picked, while the full list stays put.
+     */
+    loadedFontFamilyNames: readonly string[];
+    /**
+     * The current selection's resolved character format (font / bold / italic)
+     * — the Text tab mirrors it. Pushed from the worker's selection reports,
+     * projected from the engine's selection properties; never derived here.
+     * `EMPTY_SELECTION_TEXT_FORMAT` with no document open, a non-text
+     * selection, or none.
+     */
+    selectionText: SelectionTextFormat;
+    /**
+     * The current selection's resolved color per channel (fill / stroke / text)
+     * — the Fill / Line / Text Color dropdowns swatch it. Pushed from the
+     * worker's selection reports, projected from the engine's selection
+     * properties; never derived here. `EMPTY_SELECTION_PAINT` with no document
+     * open, a channel the doc type doesn't surface, or none.
+     */
+    selectionPaint: SelectionPaint;
+    /** The modes the host lets the user switch between (drives the mode
+     *  switcher, which offers those the session is entitled to —
+     *  `modeEntitled`). */
+    allowedModes: readonly EditorMode[];
+    /** Whether the mode switcher is shown (host override; default
+     *  `allowedModes.length > 1`). */
+    showModeSwitch: boolean;
+    /** Whether the Align dropdown aligns to the page/slide instead of the
+     *  selection's own bounds (the "Align to page" toggle). Sticky across menu
+     *  opens so the chosen reference persists. */
+    alignToPage: boolean;
+}
+/** Edit mode's state at start. */
+export declare const INITIAL_EDIT_STATE: EditState;
+/** Edit mode's state in `state`. */
+export declare function editState(state: UIState): EditState;
+/** Edit mode's state in a command's context — what its predicates read. */
+export declare function editStateOf(context: CommandContext): EditState;
+/** Change edit mode's state in `store` by `change`. */
+export declare function updateEditState(store: Store<UIState, Action>, change: Partial<EditState>): void;
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,KAAK,EACR,MAAM,EACN,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,KAAK,EACL,YAAY,EACZ,OAAO,EACV,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,WAAW,SAAS;IACtB;;;;;;OAMG;IACH,mBAAmB,EAAE,OAAO,CAAC;IAE7B;;;;;OAKG;IACH,SAAS,EAAE,OAAO,CAAC;IAEnB;;;;;OAKG;IACH,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAElC;;;;;;;;;;;OAWG;IACH,YAAY,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAE3C;;;;;;;OAOG;IACH,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAC;IAEzC;;;;;;OAMG;IACH,aAAa,EAAE,mBAAmB,CAAC;IAEnC;;;;;;OAMG;IACH,cAAc,EAAE,cAAc,CAAC;IAE/B;;2BAEuB;IACvB,YAAY,EAAE,SAAS,UAAU,EAAE,CAAC;IAEpC;sCACkC;IAClC,cAAc,EAAE,OAAO,CAAC;IAExB;;kDAE8C;IAC9C,WAAW,EAAE,OAAO,CAAC;CACxB;AAED,kCAAkC;AAClC,eAAO,MAAM,kBAAkB,EAAE,SAWhC,CAAC;AAEF,oCAAoC;AACpC,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAEnD;AAED,2EAA2E;AAC3E,wBAAgB,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,CAE9D;AAED,uDAAuD;AACvD,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI,CAE/F"}

package/dist/state.js

@@ -0,0 +1,28 @@
+import { EMPTY_SELECTION_PAINT, EMPTY_SELECTION_TEXT_FORMAT } from "@docmentis/udoc-ui/internal";
+import { ALL_MODES } from "./mode.js";
+/** Edit mode's state at start. */
+export const INITIAL_EDIT_STATE = {
+    showFormattingMarks: false,
+    showRuler: true,
+    themePalette: null,
+    fontFamilies: [],
+    loadedFontFamilyNames: [],
+    selectionText: EMPTY_SELECTION_TEXT_FORMAT,
+    selectionPaint: EMPTY_SELECTION_PAINT,
+    allowedModes: ALL_MODES,
+    showModeSwitch: true,
+    alignToPage: false,
+};
+/** Edit mode's state in `state`. */
+export function editState(state) {
+    return state.extension;
+}
+/** Edit mode's state in a command's context — what its predicates read. */
+export function editStateOf(context) {
+    return context.extension;
+}
+/** Change edit mode's state in `store` by `change`. */
+export function updateEditState(store, change) {
+    store.dispatch({ type: "SET_EXTENSION_STATE", extension: { ...editState(store.getState()), ...change } });
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAC;AAUjG,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAsFtC,kCAAkC;AAClC,MAAM,CAAC,MAAM,kBAAkB,GAAc;IACzC,mBAAmB,EAAE,KAAK;IAC1B,SAAS,EAAE,IAAI;IACf,YAAY,EAAE,IAAI;IAClB,YAAY,EAAE,EAAE;IAChB,qBAAqB,EAAE,EAAE;IACzB,aAAa,EAAE,2BAA2B;IAC1C,cAAc,EAAE,qBAAqB;IACrC,YAAY,EAAE,SAAS;IACvB,cAAc,EAAE,IAAI;IACpB,WAAW,EAAE,KAAK;CACrB,CAAC;AAEF,oCAAoC;AACpC,MAAM,UAAU,SAAS,CAAC,KAAc;IACpC,OAAO,KAAK,CAAC,SAAsB,CAAC;AACxC,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,WAAW,CAAC,OAAuB;IAC/C,OAAO,OAAO,CAAC,SAAsB,CAAC;AAC1C,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,eAAe,CAAC,KAA6B,EAAE,MAA0B;IACrF,KAAK,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE,SAAS,EAAE,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,EAAE,GAAG,MAAM,EAAE,EAAE,CAAC,CAAC;AAC9G,CAAC"}

package/dist/styles.d.ts

@@ -0,0 +1,2 @@
+export declare const editorStyles: string;
+//# sourceMappingURL=styles.d.ts.map

package/dist/styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../src/styles.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,YAAY,QA6uBxB,CAAC"}