efficient-easel 0.0.0 → 0.96.0

package/dist/words-DOhF-4D4.d.ts

@@ -0,0 +1,35 @@
+/**
+ * The right-click rows' own words (`efficient-easel/strings`, 0.95.0), one per
+ * row of `nodeMenuItems`. The menu's caption, the pinned line and what is on
+ * the clipboard are the host's.
+ *
+ * A plain module with no import, in node-ops' own folder (its lane:
+ * `tests/node-ops-leaf-safety.test.ts`). `nodeMenuItems` is a plain function,
+ * so it takes these as `options.words`; a host passes
+ * `useEditorStrings().menu`. A row's `rows` override still wins over them.
+ *
+ * The shortcuts drawn beside Copy, Cut and Paste (⌘C, ⌘X, ⌘V) are key names,
+ * not words, and stay as they are; `rows` changes one.
+ */
+type NodeMenuWords = {
+    layer: string;
+    addInside: string;
+    duplicate: string;
+    moveUp: string;
+    moveDown: string;
+    copy: string;
+    cut: string;
+    paste: string;
+    rename: string;
+    hide: string;
+    show: string;
+    upLevel: string;
+    delete: string;
+    /** The Paste row, naming what is held. `paste` is the row's own word, `label` what was copied. */
+    pasteNamed: (v: {
+        paste: string;
+        label: string;
+    }) => string;
+};
+
+export type { NodeMenuWords as N };

package/dist/words-DagJdwIA.d.ts

@@ -0,0 +1,78 @@
+/**
+ * The editor frame's own words (`efficient-easel/strings`, 0.95.0), in two
+ * groups: what `EditNotice` says (`NoticeWords`) and the few words the rest of
+ * the chrome carries when the host gives none (`ChromeWords`).
+ *
+ * A plain module with no import. Anything with a value in it is a function, so
+ * a host puts the name, the noun and the time where its language wants them.
+ *
+ * `noun` is always the HOST's word for the document (`'email'`, `'page'`), and
+ * `when` / `seen` are `LockWords`' answers (`describeAge`).
+ */
+type NoticeWords = {
+    /** The button that loads what is saved — the only one that throws work away. */
+    reload: string;
+    /** The button that takes the document. */
+    takeOver: string;
+    /** The same button after somebody took it from you. */
+    takeBack: string;
+    /** The button that looks without touching. */
+    viewReadOnly: string;
+    /** A refused save, and it was you: the bold sentence. */
+    savedByYou: (v: {
+        noun: string;
+        when: string;
+    }) => string;
+    /** A refused save, by somebody else: the bold sentence. */
+    savedByOther: (v: {
+        name: string;
+        noun: string;
+        when: string;
+    }) => string;
+    /** A refused save: what it means for the work on screen. */
+    conflictBody: string;
+    /** A refused save: the tooltip on "Take over editing". */
+    takeOverWhileDeciding: string;
+    /** Somebody took the document from you: the bold sentence. */
+    tookOver: (v: {
+        name: string;
+        noun: string;
+        when: string;
+    }) => string;
+    /** Somebody took the document from you: what it means. */
+    tookOverBody: string;
+    /** You chose to look without touching: the bold sentence. */
+    viewingOnly: string;
+    /** You chose to look without touching: who has it. */
+    viewingOnlyBody: (v: {
+        name: string;
+        noun: string;
+        seen: string;
+    }) => string;
+    /** Somebody else is in the document: the bold START of the sentence. */
+    editing: (v: {
+        name: string;
+        noun: string;
+    }) => string;
+    /** Somebody else is in the document: the rest of that sentence, and the next. */
+    editingBody: (v: {
+        seen: string;
+    }) => string;
+    /** Somebody else is in the document: the tooltip on "Take over editing". */
+    takeOverTold: string;
+};
+type ChromeWords = {
+    /** `DeviceSwitch`: the strip's accessible name. */
+    device: string;
+    /** `InspectorUpLevel`: the tooltip. */
+    upLevel: string;
+    /** `InspectorUpLevel`: the accessible name. `label` is the tooltip, `name` the level above. */
+    upLevelTo: (v: {
+        label: string;
+        name: string;
+    }) => string;
+    /** `PanelResizeHandle`: the tooltip. */
+    resize: string;
+};
+
+export type { ChromeWords as C, NoticeWords as N };

package/dist/words-DfxEp_RH.d.ts

@@ -0,0 +1,142 @@
+import { MarkStyle, MarkPlaceholders } from './markup/index.js';
+import { ReactNode } from 'react';
+
+/**
+ * WHICH WAY the text is pointed — the closed vocabulary, in the shell, once.
+ *
+ * The owner's words on 2026-09-26, and they are the specification rather than
+ * the motivation: "I am really fed up that these features are scattered with no
+ * fixed format."
+ *
+ * ── What was measured before this existed ────────────────────────────────────
+ * The campaign designer had ONE builder (`alignmentField`) and FIVE option
+ * tables behind it. The storefront had SIXTEEN alignment rows written THREE
+ * ways: a house `alignField()` (5 rows), four hand-written `segmented(
+ * "Alignment", …)` that bypassed it, and one `select`. They did not agree on the
+ * words — Left / Center / Right in fourteen rows, Start / Center / End in two —
+ * and they did not agree on the STORED value either: one row stores
+ * `start` / `center` / `end` where every other stores `left` / `center` /
+ * `right`.
+ *
+ * Two vocabularies on screen and two in storage, for one question.
+ *
+ * ── The two rules ────────────────────────────────────────────────────────────
+ * 1. ONE WORD SET: Left / Center / Right, plus Justify where a host can honour
+ *    it. Not Start/End. It is what fourteen of the sixteen rows already show and
+ *    what the campaign already uses.
+ * 2. ONE STORED VOCABULARY: `left` / `center` / `right` / `justify`. A host with
+ *    a different stored spelling migrates to this one; it does not teach this
+ *    module a second name for the same direction.
+ *
+ * ── Why the host still picks a SUBSET ────────────────────────────────────────
+ * A closed vocabulary is not the same as a fixed strip. `justify` reads as
+ * ragged, word-gapped nonsense in a ~320px email column, and a block whose
+ * renderer cannot honour a direction must not offer it. So the host names which
+ * of these four apply — and cannot name a fifth, which is the part that was
+ * missing.
+ *
+ * Deliberately NOT here: `inherit`. It is not a direction, it is the absence of
+ * an answer, and it is a property of the row a host draws (an empty value
+ * presses nothing — see `SettingsSegmented`'s `value`) rather than a segment
+ * with a glyph. A strip that drew it would be offering "no answer" as an answer.
+ */
+
+/** Every direction this package knows, in reading order. */
+declare const COPY_ALIGNS: readonly ["left", "center", "right", "justify"];
+type CopyAlign = (typeof COPY_ALIGNS)[number];
+/** The word each direction is called. American spelling, per the product's own
+ *  rule (British is for client-facing design work, not the product). The words
+ *  themselves are ./words' (`EditorStrings.copy.align`); this is their English. */
+declare const COPY_ALIGN_LABELS: Record<CopyAlign, string>;
+/** The mark each direction draws. `justify` is `align-separate` — the icon
+ *  set's own "rows pushed apart to both edges", which is what justified text
+ *  is. The campaign designer already made this choice; it moves here rather
+ *  than being made a second time. */
+declare const COPY_ALIGN_GLYPHS: Record<CopyAlign, ReactNode>;
+/**
+ * How wide this strip's WORDS are, for the drop-to-glyphs threshold.
+ *
+ * The number is the measurement `SettingsSegmented` asks for and nothing else:
+ * the chip's padding, glyph and gaps are the shell's, and `panel.css` adds them.
+ * An over-estimate is safe (the words drop a little early); an under-estimate
+ * draws a button past the strip's edge.
+ *
+ * THREE is measured, not guessed — `efficient-shop/components/PartSettingsPanel`
+ * had this exact pair as its own `ALIGN_FIT`, produced by
+ * `tests/fixtures/segmented-fit.html`. It moves here so the one alignment strip
+ * carries its own measurement, and that constant is deleted when the panel
+ * adopts this control.
+ *
+ * FOUR is an over-estimate, deliberately: "Justify" has never been drawn in a
+ * strip on this desk, so there is no measurement to move. Re-run the fixture and
+ * replace this pair with the real numbers the first time a host offers it.
+ */
+declare const COPY_ALIGN_FIT: {
+    readonly three: {
+        readonly labelsPx: 94.5;
+        readonly widestLabelPx: 39.94;
+    };
+    readonly four: {
+        readonly labelsPx: 140;
+        readonly widestLabelPx: 44;
+    };
+};
+/** The strip's options, for the subset a host can honour. Order is always this
+ *  module's, never the caller's array order — so two hosts offering the same
+ *  three directions cannot draw them in two orders. `labels` is the words in
+ *  the host's language (`useEditorStrings().copy.align`, 0.95.0); left out,
+ *  English. */
+declare function copyAlignOptions(allow: readonly CopyAlign[], labels?: Record<CopyAlign, string>): {
+    id: "left" | "right" | "center" | "justify";
+    label: string;
+    icon: ReactNode;
+    title: string;
+}[];
+
+/**
+ * The copy box's own words (`efficient-easel/strings`, 0.95.0): the bar's and
+ * the alignment strip's names, the four directions, the link window, each mark
+ * button's name and tooltip, and the words a mark writes when nothing is
+ * selected.
+ *
+ * NO REACT here, and no import but the grammar: the marks' names, tooltips and
+ * placeholders are READ from `efficient-easel/markup` (`MARKUP_TOOLS`,
+ * `MARK_PLACEHOLDERS`) rather than typed a second time, so the English lives
+ * once, in the grammar, where the campaign designer's own toolbar reads it too.
+ */
+
+type CopyWords = {
+    /** The formatting bar's accessible name. */
+    formatting: string;
+    /** The alignment strip's accessible name. */
+    alignment: string;
+    /** The word each direction is called. */
+    align: Record<CopyAlign, string>;
+    /** The link button's window. */
+    link: {
+        /** Its accessible name. */
+        title: string;
+        /** The label over the address box. */
+        label: string;
+        /** The address box's placeholder. */
+        placeholder: string;
+        /** Why an address was refused. */
+        refused: string;
+        remove: string;
+        apply: string;
+    };
+    /**
+     * Each mark button, for a bar handed STYLES (`tools={['bold', 'link']}`).
+     * `name` is what the button is called; `title` its tooltip, which also says
+     * what the mark writes and its shortcut. A host's own descriptors
+     * (`MarkupTool[]`) are used as given and never read these.
+     */
+    marks: Record<MarkStyle, {
+        name: string;
+        title: string;
+    }>;
+    /** What a mark writes when nothing is selected — typed over at once. */
+    placeholders: MarkPlaceholders;
+};
+
+export { type CopyWords as C, type CopyAlign as a, COPY_ALIGNS as b, COPY_ALIGN_FIT as c, COPY_ALIGN_GLYPHS as d, COPY_ALIGN_LABELS as e, copyAlignOptions as f };

package/package.json

@@ -1,8 +1,207 @@
 {
   "name": "efficient-easel",
-  "version": "0.0.0",
-  "description": "Reserved for Efficient Easel, the EFFICIENT editors' engine (Efficient Pty Ltd), formerly efficient-editor.",
+  "version": "0.96.0",
+  "description": "Efficient Easel: the EFFICIENT editors' shared engine and chrome: the saved document as pure functions, the published renderer, and the editor frame, panels, Layers tree, text grammar and type-in-place box. Published as editor-shell up to 0.66.0 and as efficient-editor up to 0.95.0.",
   "license": "UNLICENSED",
   "author": "Efficient Pty Ltd",
-  "files": ["README.md"]
+  "homepage": "https://github.com/Efficient-Pty-Ltd/efficient-easel#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Efficient-Pty-Ltd/efficient-easel.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Efficient-Pty-Ltd/efficient-easel/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./rail": {
+      "types": "./dist/rail/index.d.ts",
+      "import": "./dist/rail/index.js",
+      "default": "./dist/rail/index.js"
+    },
+    "./icons": {
+      "types": "./dist/icons/index.d.ts",
+      "import": "./dist/icons/index.js",
+      "default": "./dist/icons/index.js"
+    },
+    "./menu": {
+      "types": "./dist/menu/index.d.ts",
+      "import": "./dist/menu/index.js",
+      "default": "./dist/menu/index.js"
+    },
+    "./menu.css": "./dist/menu/menu.css",
+    "./panel": {
+      "types": "./dist/panel/index.d.ts",
+      "import": "./dist/panel/index.js",
+      "default": "./dist/panel/index.js"
+    },
+    "./panel.css": "./dist/panel/panel.css",
+    "./rail.css": "./dist/rail/rail.css",
+    "./shell": {
+      "types": "./dist/shell/index.d.ts",
+      "import": "./dist/shell/index.js",
+      "default": "./dist/shell/index.js"
+    },
+    "./shell.css": "./dist/shell/shell.css",
+    "./chrome": {
+      "types": "./dist/chrome/index.d.ts",
+      "import": "./dist/chrome/index.js",
+      "default": "./dist/chrome/index.js"
+    },
+    "./chrome.css": "./dist/chrome/chrome.css",
+    "./tree": {
+      "types": "./dist/tree/index.d.ts",
+      "import": "./dist/tree/index.js",
+      "default": "./dist/tree/index.js"
+    },
+    "./tree.css": "./dist/tree/tree.css",
+    "./data": {
+      "types": "./dist/data/index.d.ts",
+      "import": "./dist/data/index.js",
+      "default": "./dist/data/index.js"
+    },
+    "./node-ops": {
+      "types": "./dist/node-ops/index.d.ts",
+      "import": "./dist/node-ops/index.js",
+      "default": "./dist/node-ops/index.js"
+    },
+    "./drag": {
+      "types": "./dist/drag/index.d.ts",
+      "import": "./dist/drag/index.js",
+      "default": "./dist/drag/index.js"
+    },
+    "./drag.css": "./dist/drag/drag.css",
+    "./pick": {
+      "types": "./dist/pick/index.d.ts",
+      "import": "./dist/pick/index.js",
+      "default": "./dist/pick/index.js"
+    },
+    "./pick.css": "./dist/pick/pick.css",
+    "./fields": {
+      "types": "./dist/fields/index.d.ts",
+      "import": "./dist/fields/index.js",
+      "default": "./dist/fields/index.js"
+    },
+    "./fields.css": "./dist/fields/fields.css",
+    "./editor": {
+      "types": "./dist/editor/index.d.ts",
+      "import": "./dist/editor/index.js",
+      "default": "./dist/editor/index.js"
+    },
+    "./editor.css": "./dist/editor/editor.css",
+    "./autosave": {
+      "types": "./dist/autosave/index.d.ts",
+      "import": "./dist/autosave/index.js",
+      "default": "./dist/autosave/index.js"
+    },
+    "./canvas": {
+      "types": "./dist/canvas/index.d.ts",
+      "import": "./dist/canvas/index.js",
+      "default": "./dist/canvas/index.js"
+    },
+    "./blocks": {
+      "types": "./dist/blocks/index.d.ts",
+      "import": "./dist/blocks/index.js",
+      "default": "./dist/blocks/index.js"
+    },
+    "./render": {
+      "types": "./dist/render/index.d.ts",
+      "import": "./dist/render/index.js",
+      "default": "./dist/render/index.js"
+    },
+    "./edit-lock": {
+      "types": "./dist/edit-lock/index.d.ts",
+      "import": "./dist/edit-lock/index.js",
+      "default": "./dist/edit-lock/index.js"
+    },
+    "./copy": {
+      "types": "./dist/copy/index.d.ts",
+      "import": "./dist/copy/index.js",
+      "default": "./dist/copy/index.js"
+    },
+    "./copy.css": "./dist/copy/copy.css",
+    "./gold": {
+      "types": "./dist/gold/index.d.ts",
+      "import": "./dist/gold/index.js",
+      "default": "./dist/gold/index.js"
+    },
+    "./gold.css": "./dist/gold/gold.css",
+    "./markup": {
+      "types": "./dist/markup/index.d.ts",
+      "import": "./dist/markup/index.js",
+      "default": "./dist/markup/index.js"
+    },
+    "./style-clipboard": {
+      "types": "./dist/style-clipboard/index.d.ts",
+      "import": "./dist/style-clipboard/index.js",
+      "default": "./dist/style-clipboard/index.js"
+    },
+    "./strings": {
+      "types": "./dist/strings/index.d.ts",
+      "import": "./dist/strings/index.js",
+      "default": "./dist/strings/index.js"
+    },
+    "./strings/catalogue": {
+      "types": "./dist/strings/catalogue.d.ts",
+      "import": "./dist/strings/catalogue.js",
+      "default": "./dist/strings/catalogue.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "devDependencies": {
+    "@types/jsdom": "^28.0.3",
+    "@types/node": "^22.0.0",
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "esbuild": "^0.27.0",
+    "jsdom": "^26.1.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "terser": "^5.51.2",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  },
+  "scripts": {
+    "build": "tsup && cp src/rail/rail.css dist/rail/rail.css && cp src/shell/shell.css dist/shell/shell.css && cp src/gold/gold.css dist/gold/gold.css && cp src/copy/copy.css dist/copy/copy.css && cp src/panel/panel.css dist/panel/panel.css && cp src/menu/menu.css dist/menu/menu.css && cp src/chrome/chrome.css dist/chrome/chrome.css && cp src/tree/tree.css dist/tree/tree.css && cp src/drag/drag.css dist/drag/drag.css && cp src/pick/pick.css dist/pick/pick.css && cp src/fields/fields.css dist/fields/fields.css && cp src/editor/editor.css dist/editor/editor.css",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit && tsc -p tsconfig.test.json",
+    "test": "node scripts/test.mjs",
+    "verify:exports": "node scripts/verify-exports-resolve.mjs",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "react",
+    "editor",
+    "ui-shell",
+    "rail",
+    "menu",
+    "toolbar",
+    "next",
+    "rsc",
+    "leaf"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "packageManager": "npm@11.19.0"
 }