efficient-easel 16.1.0 → 17.0.0

package/dist/gold/index.d.ts

@@ -1,283 +0,0 @@
-import * as react from 'react';
-import { Ref } from 'react';
-import { InlineRule, InlineKind } from 'efficient-shell/markup';
-
-/**
- * The type-in-place box: a controlled leaf, and NOTHING else.
- *
- * It holds no string of its own, knows no document, and performs no write. The
- * host owns the value and decides what a commit means — which is what lets the
- * same component serve the storefront editor and the campaign designer without
- * either one leaking into it.
- */
-interface GoldTextInputProps {
-    /** The authored string, delimiters and all. The single source of truth. */
-    value: string;
-    /**
-     * Every keystroke. The layer repaints from what the host sends back, so a host
-     * that drops this on the floor gets a box that does not type — deliberately:
-     * one value, one owner.
-     */
-    onInput: (value: string) => void;
-    /**
-     * The edit is finished and may be written: on blur, and on Enter when
-     * {@link multiline} is false. Fires ONCE per editing session, and never at all
-     * if nothing was typed — clicking into a part and back out must not dirty the
-     * page (owner ruling 6), and one session is one undo step (ruling 2).
-     */
-    onCommit?: (value: string) => void;
-    /**
-     * Escape. The argument is the value the component was given when it gained
-     * focus; the HOST puts it back, because the host owns the string. After a
-     * cancel the pending edit is forgotten, so the blur that follows writes
-     * nothing.
-     */
-    onCancel?: (restored: string) => void;
-    /**
-     * What Enter means — NOT how the text wraps. Both modes soft-wrap exactly as
-     * the box does, because the layer under it has to wrap identically.
-     *
-     *   - `false` (default): Enter commits and never inserts a newline;
-     *   - `true`: Enter inserts a newline and commits nothing.
-     */
-    multiline?: boolean;
-    /** Shown while the value is empty — through the first focus, and away on the
-     *  first keystroke. */
-    placeholder?: string;
-    /** Extra class(es) merged onto the wrapper. */
-    className?: string;
-    /**
-     * The grammar's rule set — `STOREFRONT_MARKUP` in the shop,
-     * `CAMPAIGN_MARKUP` in the campaign designer, both from
-     * `efficient-shell/markup`. Defaults to `STANDARD_MARKUP`, which is the subset
-     * every product shares; a product with legacy runs (the storefront's
-     * `*phrase*` accent) MUST pass its own set or those runs draw as plain text
-     * here while the page paints them gold.
-     */
-    rules?: readonly InlineRule[];
-    /** Accessible name for the box. In-place editing has no visible label. */
-    ariaLabel?: string;
-    /**
-     * Nothing may be typed. The box goes out of the tab order and announces the
-     * state itself, rather than a parent dimming a control that is still
-     * focusable — the regression the 2026-08-06 audit closed.
-     *
-     * The LAYER still paints, deliberately: a sent campaign opens read-only, and
-     * a merchant reading it should see their own formatting, not raw delimiters.
-     */
-    disabled?: boolean;
-    /**
-     * A handle on the textarea.
-     *
-     * A plain prop rather than `ref`, for the same reason {@link GoldLayerProps}
-     * gives for `layerRef`: React 18 would need `forwardRef` and React 19 takes
-     * `ref` as an ordinary prop, and this package supports both.
-     *
-     * It exists because a caret operation — a mark button, an inserted merge tag —
-     * has to read the live selection off this element and put it back after the
-     * repaint. `efficient-easel/copy` is the caller that does that.
-     */
-    inputRef?: Ref<HTMLTextAreaElement>;
-}
-interface GoldLayerProps {
-    value: string;
-    rules?: readonly InlineRule[];
-    className?: string;
-    /**
-     * A handle on the layer element.
-     *
-     * A plain prop rather than `ref` on purpose: React 18 would need
-     * `forwardRef` and React 19 takes `ref` as an ordinary prop, and this package
-     * supports both (`peerDependencies: react >=18`). One named prop behaves
-     * identically on either and needs no version branch.
-     */
-    layerRef?: Ref<HTMLDivElement>;
-}
-
-/**
- * Type where the text sits, and watch the gold appear as you type.
- *
- * The arrangement, in one paragraph: a textarea whose own text is TRANSPARENT
- * sits on top of a layer holding the same characters, painted. What you read is
- * the layer; what the caret walks is the box. Both take their type styles from
- * whatever the host renders them inside (`font: inherit` all the way down), so
- * the glyphs land on top of each other instead of near each other, and the box
- * inherits the page's own type rather than a size this package invented.
- *
- * The layer is the element IN FLOW and the box is absolutely positioned over it,
- * which is deliberate: the layer holds the same characters, so it wraps to the
- * same height, so the box grows as the merchant types without anyone measuring
- * anything.
- *
- * WHAT IT DOES NOT DO: write. It has no document, no section, no Puck, no shop.
- * `onCommit` says "this edit is finished"; what that means is the host's
- * business. That is what makes it shareable by both editors (constitution E2)
- * and testable without any of them.
- *
- * No `'use client'` — same reason as the rail: the directive is the HOST's to
- * place, and both editors' chrome are already client components. Unlike the
- * rail, though, this leaf has hooks, so it must be rendered inside that client
- * boundary; a server component can import the module but cannot render it.
- *
- * Requires `efficient-easel/gold.css`, imported once from a client entry.
- */
-declare function GoldTextInput({ value, onInput, onCommit, onCancel, multiline, placeholder, className, rules, ariaLabel, disabled, inputRef, }: GoldTextInputProps): react.JSX.Element;
-
-/**
- * The formatted text, drawn UNDER the box.
- *
- * It is a MARKER layer, not a preview of the page. That distinction is the whole
- * design, and it is why a bold run here is not drawn at weight 600:
- *
- *   the caret, the selection and the line breaks all come from the transparent
- *   textarea on top, which has ONE font. A heavier or slanted face down here is
- *   wider, so a marked line would wrap a word earlier than the box does and
- *   every line after it would sit on top of the wrong text.
- *
- * So the layer may only paint what cannot move a glyph — colour, opacity,
- * text-decoration, a shadow. A merchant sees WHERE the formatting starts and
- * ends and in which colour it will land; the real weight and slant appear on the
- * page the moment they click away. Full WYSIWYG (asterisks gone, real faces) is
- * a second text engine and is deliberately out of scope — see
- * docs/agents/text-and-grammar.md, gold rule 2.
- *
- * The elements mirror the storefront's own renderer (`goldPhrases.tsx`):
- * `<strong>` for bold, `<em>` for italic and for the gold accent, `<s>` for
- * struck-out. The classes carry the paint; the tokens carry the values.
- */
-declare function GoldLayer({ value, rules, className, layerRef }: GoldLayerProps): react.JSX.Element;
-
-/**
- * Cutting an authored string into the pieces the layer paints — WITHOUT losing a
- * character.
- *
- * The grammar is not re-implemented here and never will be (constitution E8):
- * {@link tokenizeInline} from `efficient-shell/markup` decides what is a run and
- * what is not, exactly as it does for the published page. What it does not
- * return is the delimiters — it hands back a run's INNER text, because every
- * other consumer wants the words without the asterisks.
- *
- * This layer wants the asterisks. It draws underneath a transparent box whose
- * caret walks the stored string, so the two surfaces must hold the same
- * characters in the same order: drop the `**` and every glyph after it sits two
- * columns left of the caret that is supposed to be inside it.
- *
- * So each parsed run is located back in the source and cut into three pieces —
- * opening delimiter, inner text, closing delimiter — and EVERY piece is sliced
- * out of the original string rather than rebuilt from the token. Nothing is
- * retyped, so nothing can be retyped wrong.
- */
-/** A piece of the source: a parsed run's kind, or the delimiters around one. */
-type GoldSegmentKind = InlineKind | 'delimiter';
-interface GoldSegment {
-    kind: GoldSegmentKind;
-    /** Verbatim source text. Concatenating every segment reproduces the input. */
-    text: string;
-}
-/**
- * Split `value` into paint-able segments under `rules`.
- *
- * GUARANTEE: `segments.map(s => s.text).join('') === value`, always. If the walk
- * below cannot line a run up with the rule that produced it — which would mean
- * the grammar and this function disagree — the whole string comes back as one
- * plain `text` segment. Losing the gold is a disappointment; losing a character
- * puts the caret in the wrong place, so the fallback is never in doubt.
- */
-declare function goldSegments(value: string, rules: readonly InlineRule[]): GoldSegment[];
-
-/**
- * Gold-layer paint tokens.
- *
- * SHORT LIST BY DESIGN. The layer draws inside whatever the host renders it in
- * and inherits that context's type entirely — family, size, weight, line-height,
- * letter-spacing — because it has to sit on top of a box that inherits the same
- * (see `GoldTextInput`). So there is no type here to tokenise; what is left is
- * the paint, and only the paint that cannot move a glyph.
- *
- * NOTHING HERE IS INVENTED (docs/agents/leaves-and-tokens.md, "the tokens are
- * not ours to invent"):
- *   - the gold defers to the page's own `--gold`, falling back to the
- *     storefront's light-theme value (`efficient-storefront/app/globals.css` → `--gold:
- *     #c9a461`), so the mark in the box matches the mark on the page;
- *   - the caret and the placeholder defer to the shell layer's `--es-text` /
- *     `--es-field-placeholder` (see `shell/tokens.ts`), falling back to the
- *     efficient-shell tokens those resolve to (UI-24), for a box drawn outside
- *     an `.es-editor` root;
- *   - the FOCUSED dim is the rail's existing disabled opacity (0.35), not a new
- *     number. Its RESTING sibling (0.25) is the one value in this file picked by
- *     eye rather than borrowed: nothing else in the product paints a mark that
- *     has to hold its width while it stops being read, so there was nothing to
- *     copy. The owner chose it against a picker rendering the candidates at
- *     heading and body size; 0.18 was tried there first and still read too
- *     faint (card 8807). That history is here on purpose: a later reader who
- *     finds 0.25 with nothing behind it will "fix" it to match some other
- *     number, and this is the paragraph that stops them.
- *
- * Every value is a STRING, unlike the rail's and shell's pixel magnitudes:
- * none of these is a length, so nothing here gains a unit on the way into CSS.
- *
- * Exposed BOTH ways, per the same value: `goldTokens` (this object) and
- * `gold.css` (the stylesheet, which declares them on `.es-gold` — names in
- * {@link goldCssVars}). The parity gate in `tests/gold-leaf-safety.test.ts`
- * proves the two never drift.
- */
-declare const goldTokens: {
-    /** The mark colour — `==phrase==` and the legacy `*phrase*`. */
-    readonly accent: "var(--gold, #c9a461)";
-    /** Quiet — `^^phrase^^`. Colour only: the page draws it smaller, but a
-     *  smaller glyph down here would pull the layer off the caret. */
-    readonly quiet: "var(--es-muted, var(--ink-faint))";
-    /** The caret. Set explicitly because the box's own text is transparent, and
-     *  `caret-color: auto` would make the caret transparent with it. */
-    readonly caret: "var(--es-text, var(--ink-strongest))";
-    /** The hint shown while the value is empty. */
-    readonly placeholder: "var(--es-field-placeholder, var(--ink-faintest))";
-    /** How far the asterisks are dimmed WHILE THE BOX HAS FOCUS — the moment they
-     *  are what the merchant is aiming at, so this is the louder of the pair.
-     *  Out of focus they drop to {@link goldTokens.delimiterRestingOpacity}. */
-    readonly delimiterOpacity: "0.35";
-    /** How far they are dimmed AT REST, when nobody is typing (card 8807). A
-     *  whisper, and deliberately not 0.
-     *
-     *  FADED, never removed: the characters stay in the layer at their full width
-     *  in BOTH states, which is the deal — anything that took them out would move
-     *  a glyph. So the width is spent either way, and 0 spends it with nothing to
-     *  show for it: a short, heavily marked string loses about a quarter of its
-     *  line to blanks that read as a rendering bug. Faint, the same space reads as
-     *  punctuation. */
-    readonly delimiterRestingOpacity: "0.25";
-    /**
-     * Faux-bold. A real `font-weight: 600` is wider, and a wider run down here
-     * wraps a line earlier than the transparent box on top of it — after which
-     * every following line is drawn over the wrong text. The shadow reads heavier
-     * and moves nothing.
-     */
-    readonly boldShadow: "0 0 0.4px currentColor";
-    /** Italic, marked rather than slanted — an italic FACE has its own widths, and
-     *  the layer may not change a glyph's advance. Same reason as the bold. */
-    readonly italicDecoration: "underline dotted";
-    /** Strike-through is metric-safe, so it is drawn exactly as it will print. */
-    readonly strikeDecoration: "line-through";
-    /**
-     * The field's inner inset, applied to the LAYER, the BOX and the
-     * PLACEHOLDER together — never to the wrapper.
-     *
-     * ⚠️ ZERO IS THE ONLY SAFE DEFAULT AND A HOST MUST NOT PAD `.es-gold`.
-     * The box is `position: absolute; inset: 0`, which resolves to the
-     * wrapper's PADDING box, while the layer is in flow and starts at its
-     * CONTENT box — so padding the wrapper moves the glyphs and leaves the
-     * caret behind. That shipped: `.es-copy-box` padded the wrapper and every
-     * character sat 6px right of its caret and 4px down (reported 2026-09-26).
-     * A host that wants an inset sets this token.
-     */
-    readonly pad: "0";
-};
-type GoldTokens = typeof goldTokens;
-/**
- * The CSS custom-property name behind each token. `gold.css` sets these on
- * `.es-gold`, so overriding one on (or above) the box re-themes it without
- * shipping new CSS — e.g. `style={{ ['--es-gold-accent']: brand }}`.
- */
-declare const goldCssVars: Record<keyof GoldTokens, string>;
-
-export { GoldLayer, type GoldLayerProps, type GoldSegment, type GoldSegmentKind, GoldTextInput, type GoldTextInputProps, type GoldTokens, goldCssVars, goldSegments, goldTokens };

package/dist/gold/index.js

@@ -1 +0,0 @@
-export{GoldLayer,GoldTextInput,goldSegments}from"../chunk-H4UMY7QF.js";var e={accent:"var(--gold, #c9a461)",quiet:"var(--es-muted, var(--ink-faint))",caret:"var(--es-text, var(--ink-strongest))",placeholder:"var(--es-field-placeholder, var(--ink-faintest))",delimiterOpacity:"0.35",delimiterRestingOpacity:"0.25",boldShadow:"0 0 0.4px currentColor",italicDecoration:"underline dotted",strikeDecoration:"line-through",pad:"0"},t={accent:"--es-gold-accent",quiet:"--es-gold-quiet",caret:"--es-gold-caret",placeholder:"--es-gold-placeholder",delimiterOpacity:"--es-gold-delim-opacity",delimiterRestingOpacity:"--es-gold-delim-resting-opacity",boldShadow:"--es-gold-bold-shadow",italicDecoration:"--es-gold-italic-decoration",strikeDecoration:"--es-gold-strike-decoration",pad:"--es-gold-pad"};export{t as goldCssVars,e as goldTokens};

package/dist/icons/meanings.d.ts

@@ -1 +0,0 @@
-export { efficientIconMeanings as iconMeanings } from 'efficient-shell/icons/efficient-meanings';

package/dist/icons/meanings.js

@@ -1 +0,0 @@
-export{efficientIconMeanings as iconMeanings}from"efficient-shell/icons/efficient-meanings";

package/dist/index.d.ts

@@ -1,6 +0,0 @@
-export { EaselRail, EaselRailButton, RailTokens, railCssVars, railTokens } from './rail/index.js';
-export { AddIcon, LayersIcon, MediaIcon, PageIcon as PagesIcon, EfficientIconProps as RailIconProps, SitemapIcon, StylesIcon } from 'efficient-shell/icons/efficient';
-export { W as WordFit } from './wordFit-7XpmhcaW.js';
-export { E as EaselRailButtonProps, a as EaselRailItem, b as EaselRailOrientation, c as EaselRailProps } from './types-CsgMwHHa.js';
-export { SPACING_SCALE, ShellTokens, shellCssVars, shellDarkTokens, shellTokens } from './shell/index.js';
-import 'react';

package/dist/index.js

@@ -1 +0,0 @@
-export{SPACING_SCALE,shellCssVars,shellDarkTokens,shellTokens}from"./chunk-HMXIAMCU.js";export{AddIcon,LayersIcon,MediaIcon,PageIcon as PagesIcon,SitemapIcon,StylesIcon,railCssVars,railTokens}from"./chunk-4VJATVVR.js";export{EaselRail,EaselRailButton}from"./chunk-MJM6SFD3.js";import"./chunk-2OAZYSWJ.js";

package/dist/markup/index.d.ts

@@ -1 +0,0 @@
-export * from 'efficient-shell/markup';

package/dist/markup/index.js

@@ -1 +0,0 @@
-export*from"efficient-shell/markup";

package/dist/shell/index.d.ts

@@ -1,195 +0,0 @@
-/**
- * Editor SHELL design tokens — the chrome's names for efficient-shell's tokens.
- *
- * Where `rail/tokens.ts` owns the slim icon-rail, this owns the rest of the
- * editor chrome theme: accent, surfaces, fields, text, lines, chips, named
- * chrome literals, danger/warning/success, radii, gap, shadows and font.
- *
- * NOTHING HERE IS A VALUE OF OUR OWN (harness UI-24, efficient-harness#117):
- * every colour, radius and the typeface is a `var()` of an efficient-shell
- * token (`efficient-shell/ui.css`), or — where the shell has no token for the
- * role yet, marked SHELL GAP below — a `color-mix()` of shell tokens. Up to
- * 0.106.0 these were hex values mirrored from the storefront editor's `--sf-*`
- * block, light only; now the editor follows the shell's theme, dark included,
- * and its accent themes. The one literal colour is `frameBg`, which is canvas
- * (the page's paper), not chrome.
- *
- * Exposed BOTH ways, per the same value (mirrors the rail):
- *   - `shellTokens` — this JS object, for code that needs the values in an
- *     inline style (they are CSS expressions, so they resolve only where the
- *     host has loaded the shell's CSS — which it must, see README);
- *   - `shell.css` — the stylesheet, which declares the identical values as CSS
- *     custom properties on `.es-editor` (names listed in `shellCssVars`).
- *
- * Numeric fields are pixel magnitudes (unitless) so they compose in code; the
- * CSS applies the `px`. Only spacing is numeric now.
- */
-declare const shellTokens: {
-    /** `--es-accent` — the custom accent (`--accent-600`, stamped by the shell's
-     *  `useTheme()`), else the shell's themed primary fill (`--submit-bg`, which
-     *  the pink / green / grey themes remap). */
-    readonly accent: "var(--accent-600, var(--submit-bg))";
-    /** `--es-accent-tint` — a wash of the accent on the surface. SHELL GAP: the
-     *  shell has no accent-soft token; mixed from shell tokens until it does. */
-    readonly accentTint: "color-mix(in srgb, var(--es-accent) 10%, var(--surface))";
-    /** `--es-accent-tint-strong` — a stronger wash. SHELL GAP, as above. */
-    readonly accentTintStrong: "color-mix(in srgb, var(--es-accent) 18%, var(--surface))";
-    /** `--es-accent-line` — a quiet accent hairline (an empty slot's outline). SHELL GAP. */
-    readonly accentLine: "color-mix(in srgb, var(--es-accent) 32%, var(--surface))";
-    /** `--es-accent-text` — accent as words: darker than the fill on light,
-     *  lighter on dark, because it leans on the ramp's strongest ink. SHELL GAP. */
-    readonly accentText: "color-mix(in srgb, var(--es-accent) 65%, var(--ink-strongest))";
-    /** `--es-accent-ring` — the shell's focus ring wash. */
-    readonly accentRing: "var(--rosh-focus-ring)";
-    /** `--es-accent-shadow` — accent button shadow. SHELL GAP. */
-    readonly accentShadow: "color-mix(in srgb, var(--es-accent) 35%, transparent)";
-    /** `--es-on-accent` — ink on a solid fill. SHELL GAP: the shell's nearest is
-     *  the status tier's `--status-on-solid` (white in both themes). */
-    readonly onAccent: "var(--status-on-solid)";
-    /** `--es-app-bg` — the sunken ground behind the panels. */
-    readonly appBg: "var(--surface-sunken)";
-    /** `--es-preview-bg` — the well round the canvas. */
-    readonly previewBg: "var(--surface-raised)";
-    /** `--es-panel` — panels. */
-    readonly panel: "var(--surface)";
-    /** `--es-raised` — a lifted surface. NOT the active chip since card 66302. */
-    readonly raised: "var(--surface)";
-    /** `--es-topbar-bg`. */
-    readonly topbarBg: "var(--surface)";
-    /** `--es-frame-bg` — the paper behind the preview iframe. CANVAS, not chrome:
-     *  it is the page's own white in every theme (UI-24 leaves output alone). */
-    readonly frameBg: "#ffffff";
-    /** `--es-hover` — row / icon hover. */
-    readonly hover: "var(--surface-raised)";
-    /** `--es-hatch` — 45° upload-slot texture. */
-    readonly hatch: "color-mix(in srgb, var(--ink-strongest) 2%, transparent)";
-    /** `--es-addcard-veil` — add-section card hover wash. */
-    readonly addcardVeil: "color-mix(in srgb, var(--surface-sunken) 66%, transparent)";
-    /** `--es-field-bg`. */
-    readonly fieldBg: "var(--surface)";
-    /** `--es-track-bg` — segmented / search track. */
-    readonly trackBg: "var(--surface-raised)";
-    /** `--es-input-border`. */
-    readonly inputBorder: "var(--line-strong)";
-    /** `--es-field-text`. */
-    readonly fieldText: "var(--ink-strong)";
-    /** `--es-field-placeholder`. */
-    readonly fieldPlaceholder: "var(--ink-faintest)";
-    /** `--es-knob` — toggle knob (the shell's Switch draws it `bg-white`, which
-     *  its dark theme turns into `--surface`). */
-    readonly knob: "var(--surface)";
-    /** `--es-text`. */
-    readonly text: "var(--ink-strongest)";
-    /** `--es-text-strong` — active labels (the ramp has nothing past strongest). */
-    readonly textStrong: "var(--ink-strongest)";
-    /** `--es-text-secondary`. */
-    readonly textSecondary: "var(--ink)";
-    /** `--es-muted`. */
-    readonly muted: "var(--ink-faint)";
-    /** `--es-icon` — icon buttons. */
-    readonly icon: "var(--ink-faint)";
-    /** `--es-disabled` — disabled / faint glyphs. */
-    readonly disabled: "var(--ink-faintest)";
-    /** `--es-divider`. */
-    readonly divider: "var(--line)";
-    /** `--es-line` — hairlines. */
-    readonly line: "var(--line)";
-    /** `--es-btn-border`. */
-    readonly btnBorder: "var(--line-strong)";
-    /** `--es-btn-text`. */
-    readonly btnText: "var(--ink)";
-    /** `--es-chip-bg`. */
-    readonly chipBg: "var(--surface-raised)";
-    /** `--es-chip-fg`. */
-    readonly chipFg: "var(--ink-faint)";
-    /** `--es-brand-square` — wordmark square. */
-    readonly brandSquare: "var(--ink-strongest)";
-    /** `--es-device-border` — tablet/mobile frame. */
-    readonly deviceBorder: "var(--line)";
-    /** `--es-toast-bg` — dark chip / seam pill, white ink on it in both themes:
-     *  the shell's solid status tier (`--status-draft-solid`, 10.3:1 with white). */
-    readonly toastBg: "var(--status-draft-solid)";
-    /** `--es-toggle-off` — toggle track (the shell's Switch: `bg-gray-300`). */
-    readonly toggleOff: "var(--line-strong)";
-    /** `--es-scrollbar`. */
-    readonly scrollbar: "var(--line-strong)";
-    /** `--es-scrollbar-hover`. */
-    readonly scrollbarHover: "var(--ink-faintest)";
-    /** `--es-danger` — danger words and edges: the status tier's ink, which
-     *  clears AA on the surface and on its own wash, light and dark. */
-    readonly danger: "var(--status-danger-soft-ink)";
-    /** `--es-danger-strong` — danger words on `--es-danger-tint`. */
-    readonly dangerStrong: "var(--status-danger-soft-ink)";
-    /** `--es-danger-tint` — the danger wash. */
-    readonly dangerTint: "var(--status-danger-soft)";
-    /** `--es-warning` — the "Preview" pill's words and edge (amber: pending). */
-    readonly warning: "var(--status-pending-soft-ink)";
-    /** `--es-preview-tint` — the "Preview" pill's wash. */
-    readonly previewTint: "var(--status-pending-soft)";
-    /** `--es-success` — a green tick and its label. */
-    readonly success: "var(--status-success-soft-ink)";
-    /** `--es-panel-radius` — 12px, `--radius-xl`. */
-    readonly panelRadius: "var(--radius-xl)";
-    /** `--es-row-radius` — the shell's card radius (`--radius-card`, 8px by default). */
-    readonly rowRadius: "var(--radius-card, var(--radius-lg))";
-    /** `--es-field-radius` — the shell's control radius (`--radius-control`, 6px by default). */
-    readonly fieldRadius: "var(--radius-control, var(--radius-md))";
-    /** `--es-panel-gap` — inter-pane gutter + outer frame padding, ONE token.
-     *  12 since the one spacing scale (was 10, which is not a step). */
-    readonly panelGap: 12;
-    /** `--es-space-2` — between the buttons of one group (B · I · U · S). */
-    readonly space2: 2;
-    /** `--es-space-4` — a sub-name to its control; between the cells of one group. */
-    readonly space4: 4;
-    /** `--es-space-8` — between the layers of ONE setting (bar → box → Show marks). */
-    readonly space8: 8;
-    /** `--es-space-12` — between rows under one heading; inside one setting;
-     *  the panel's padding when it is narrower than 260px. */
-    readonly space12: 12;
-    /** `--es-space-16` — the panel's own padding. */
-    readonly space16: 16;
-    /** `--es-space-32` — between two settings. */
-    readonly space32: 32;
-    /** `--es-panel-shadow`. */
-    readonly panelShadow: "0 1px 2px rgba(0, 0, 0, 0.05), 0 10px 30px rgba(0, 0, 0, 0.06)";
-    /** `--es-topbar-shadow`. */
-    readonly topbarShadow: "0 1px 3px rgba(0, 0, 0, 0.06)";
-    /**
-     * `--es-raised-shadow` — what a small surface sitting ON another one casts:
-     * the chip in the settings tab strip's track (card 66138). Tighter and darker
-     * than `panelShadow`, which is a whole panel floating over the app; this one
-     * has to read across 3px of track without looking like a second panel.
-     */
-    readonly raisedShadow: "0 1px 2px rgba(16, 24, 40, 0.1)";
-    /** `--es-font` — the shell's face. */
-    readonly font: "var(--font-sans)";
-};
-type ShellTokens = typeof shellTokens;
-/**
- * The tokens `shell.css` re-points under the shell's dark theme
- * (`:is([data-theme="dark"], .dark) .es-editor`). Shell tokens only: the shell
- * draws a track and a chip's ground with `bg-gray-100`, and its dark theme
- * remaps that utility to `--surface` rather than `--surface-raised`, so these
- * three follow it. Code that reads `shellTokens` for an inline style under a
- * dark shell reads these over it.
- */
-declare const shellDarkTokens: {
-    readonly previewBg: "var(--surface)";
-    readonly trackBg: "var(--surface)";
-    readonly chipBg: "var(--surface)";
-};
-/**
- * The one spacing scale, smallest first (owner ruling, 2026-10-02): the six
- * `space*` tokens above as a list, for code that must snap a number to it.
- * A seventh step is a new ruling, not a new entry.
- */
-declare const SPACING_SCALE: readonly [2, 4, 8, 12, 16, 32];
-/**
- * The CSS custom-property name behind each `shellTokens` key. `shell.css` sets
- * these on `.es-editor`; override any of them on (or above) the editor root to
- * re-theme without shipping new CSS. The `shell-tokens.test.ts` parity gate
- * proves this map, `shellTokens` and `shell.css` never drift apart.
- */
-declare const shellCssVars: Record<keyof ShellTokens, string>;
-
-export { SPACING_SCALE, type ShellTokens, shellCssVars, shellDarkTokens, shellTokens };

package/dist/shell/index.js

@@ -1 +0,0 @@
-export{SPACING_SCALE,shellCssVars,shellDarkTokens,shellTokens}from"../chunk-HMXIAMCU.js";

package/dist/strings/catalogue.d.ts

@@ -1,139 +0,0 @@
-import { S as SaveWords } from '../words-pgIK0I6g.js';
-import { N as NoticeWords, C as ChromeWords } from '../words-BpiVrsW5.js';
-import { C as CopyWords } from '../words-D-yhjdOg.js';
-import { D as DragWords } from '../words-CvwYvkJm.js';
-import { LockWords } from '../edit-lock/index.js';
-import { F as FieldsWords } from '../words-vhnV8sM7.js';
-import { N as NodeMenuWords } from '../words-DMG4dYq2.js';
-import { P as PanelWords } from '../words-zH1H0WFw.js';
-import { P as PickWords } from '../words-DWvCJXwR.js';
-import { ScreenWords } from '../screen/words.js';
-export { ScreenAddWords } from '../screen/words.js';
-import { S as StyleClipboardWords } from '../words-CnnHb9jo.js';
-import { T as TextStylesWords } from '../words-gIDCeRv3.js';
-import { T as TreeWords } from '../words-Cl9xMUYY.js';
-import '../types-DGyDHiJV.js';
-import '../types-CsgMwHHa.js';
-import '../wordFit-7XpmhcaW.js';
-import 'react';
-import '../panelWidths-D9hTLR25.js';
-import '../engine-CvXpFE86.js';
-import 'efficient-shell/markup';
-import '../buckets-Tj-nkBpg.js';
-
-/**
- * The easel canvas's own words (`efficient-easel/strings`, 0.95.0): what the
- * frame is called when the host does not name it (`title`), and the name of
- * the bar of text tools that floats above words typed on the canvas.
- *
- * A plain module with no import.
- */
-type CanvasWords = {
-    /** The canvas frame's accessible name. */
-    frame: string;
-    /** The floating bar of text tools over the words being typed (its group's name). */
-    textTools: string;
-};
-
-/**
- * The rail's own words. There is one: what the toolbar is called when the host
- * does not name it (`ariaLabel`). Every other word on the rail is an item's
- * `label`, and those are the host's.
- *
- * A plain module with no import, so the rail stays the leaf it is
- * (`tests/rail-leaf-safety.test.tsx`). It is NOT exported from `./index`: the
- * rail's runtime exports are pinned (`tests/rail-public-shape.test.tsx`), and a
- * host reads these through `efficient-easel/strings`.
- */
-type RailWords = {
-    /** The toolbar's accessible name. */
-    label: string;
-};
-
-/**
- * THE ENGINE'S OWN WORDS, as one catalogue a host can translate (0.95.0).
- *
- * Every word and sentence this package itself draws or returns — visible text,
- * `aria-label`s, tooltips, placeholders — is an entry here, grouped by the
- * module that says it. What a HOST supplies (a block's name, a field's label, a
- * tile's caption, the document's noun) was never the engine's and is not here —
- * with one exception: the assembled screen (`efficient-easel/screen`) draws the
- * edit notice itself, so the noun it says it with is a word of its own group,
- * the website's "page" until a host says another.
- *
- *   - A plain word is a `string`.
- *   - Anything with a value in it, or a count that can be one or many, is a
- *     function: the host puts the value where its language wants it and does
- *     its own plural.
- *
- * ── Where the English lives ───────────────────────────────────────────────
- * In each module's own `words.ts`, NOT here. A leaf may only import its own
- * lane (`tests/*-leaf-safety`), and several are held to a bundle that never
- * spells a browser global — while one sentence below does ("another tab or
- * window"). So a module owns its group and its defaults, and this file only
- * puts the groups side by side. `DEFAULT_EASEL_STRINGS.pick` IS the pickers'
- * own default object, not a copy of it.
- *
- * ── Framework-free ────────────────────────────────────────────────────────
- * No React, no browser global, nothing run at import but object literals
- * (`tests/strings-leaf-safety.test.ts`). A server-side test in a host imports
- * this to check its own catalogues against the engine's keys; it is published
- * on its own as `efficient-easel/strings/catalogue`. The provider and the
- * hooks are in ./provider.
- */
-
-/** Every word the engine says, by the module that says it. */
-interface EaselStrings {
-    /** `efficient-easel/chrome` — `EditNotice`: who holds the document, a refused save. */
-    notice: NoticeWords;
-    /** `efficient-easel/edit-lock` — "2 minutes ago", "Someone else". */
-    lock: LockWords;
-    /** `efficient-easel/autosave` — the save pill. */
-    save: SaveWords;
-    /** `efficient-easel/chrome` — the device switch, "up one level", the panel grip. */
-    chrome: ChromeWords;
-    /** `efficient-easel/rail` — the toolbar's name. */
-    rail: RailWords;
-    /** `efficient-easel/tree` — the drag hint and the caret. */
-    tree: TreeWords;
-    /** `efficient-easel/panel` — the tab strip's name and each tab's word. */
-    panel: PanelWords;
-    /** `efficient-easel/fields` — the number box, the dropdown, the list field. */
-    fields: FieldsWords;
-    /** `efficient-easel/pick` — the colour row and the image box. */
-    pick: PickWords;
-    /** `efficient-easel/drag` — the Add panel and the canvas layer. */
-    drag: DragWords;
-    /** `efficient-easel/node-ops` — the right-click rows. */
-    menu: NodeMenuWords;
-    /** `efficient-easel/style-clipboard` — Copy style, Paste style and what a paste says. */
-    styleClipboard: StyleClipboardWords;
-    /** `efficient-easel/copy` — the formatting bar, alignment, the link window, each mark. */
-    copy: CopyWords;
-    /** `efficient-easel/easel` — the canvas frame's name. */
-    canvas: CanvasWords;
-    /** `efficient-easel/text-styles` — the Email styles / Site styles list (E6). */
-    textStyles: TextStylesWords;
-    /** `efficient-easel/screen` — a document opening, one that will not, the
-     *  notice's word for the document, the Layers tree's frame, the Add panel,
-     *  the main button and the block keys. */
-    screen: ScreenWords;
-}
-/** Today's English, word for word. */
-declare const DEFAULT_EASEL_STRINGS: EaselStrings;
-/**
- * A catalogue with any part left out. A function entry is taken whole or not
- * at all: it has no "part" to leave out.
- */
-type DeepPartial<T> = T extends (...args: never[]) => unknown ? T : T extends object ? {
-    [K in keyof T]?: DeepPartial<T[K]>;
-} : T;
-/**
- * `defaults` with every entry `partial` gives laid over it. Whatever `partial`
- * leaves out (or gives as `undefined` / `null`) keeps the default, so a host
- * that has translated half the catalogue shows the other half in English
- * rather than as nothing. Neither argument is changed.
- */
-declare function mergeEaselStrings(defaults: EaselStrings, partial?: DeepPartial<EaselStrings> | null): EaselStrings;
-
-export { type CanvasWords, ChromeWords, CopyWords, DEFAULT_EASEL_STRINGS, type DeepPartial, DragWords, type EaselStrings, FieldsWords, LockWords, NodeMenuWords, NoticeWords, PanelWords, PickWords, type RailWords, SaveWords, ScreenWords, StyleClipboardWords, TextStylesWords, TreeWords, mergeEaselStrings };

package/dist/strings/catalogue.js

@@ -1 +0,0 @@
-export{DEFAULT_EASEL_STRINGS,mergeEaselStrings}from"../chunk-IN22IYOM.js";import"../chunk-OGH6CC3E.js";import"../chunk-OFBZOI6W.js";import"../chunk-VVPZMWJE.js";import"../chunk-6WY6ZXJG.js";import"../chunk-WK3AFPXY.js";import"../chunk-KAML3KQH.js";import"../chunk-TBY3DFKS.js";import"../chunk-K56YDHYQ.js";import"../chunk-KFV7N2DJ.js";import"../chunk-H6DDIBQ4.js";import"../chunk-Z6PVRXVY.js";import"../chunk-RE4LP46F.js";import"../chunk-2OAZYSWJ.js";import"../chunk-B4JN227A.js";import"../chunk-WRFD4EXD.js";