efficient-easel 0.106.0 → 1.0.0

package/dist/types-Djdq6Xkd.d.ts

@@ -1,138 +0,0 @@
-import { CSSProperties, ReactNode } from 'react';
-
-/** One row of the menu.
- *
- *  Carried over unchanged from `efficient-admin-portal`'s `RowContextMenuItem`
- *  (card 66039), because the campaign designer's registry is typed against it and
- *  what the menus OFFER is not this card's to move. A `label` of `'—'` renders a
- *  separator; `header: true` renders a caption, and the FIRST such caption names
- *  the menu for assistive tech. */
-interface EaselContextMenuItem {
-    label: string;
-    onClick: () => void;
-    danger?: boolean;
-    header?: boolean;
-    /** A SUBMENU: this item opens a flyout of these instead of acting itself.
-     *  One level only — a child carrying its own `children` is drawn as a plain
-     *  item, which is all any caller has needed and keeps the flyout from becoming
-     *  a tree nobody can navigate with a mouse. */
-    children?: EaselContextMenuItem[];
-    /** Draw a tick beside this item — for a submenu whose entries are STATES
-     *  rather than actions, so it can say which one you are already on. */
-    checked?: boolean;
-    /**
-     * A glyph for the row, drawn before the label.
-     *
-     * ⚠️ A TYPE SLOT, NOT A LOOKUP. The box renders what it is handed and does
-     * not know what a glyph means — it must never import the icon set, or the
-     * leaf stops being a leaf (`tests/menu-leaf-safety.test.ts` (a) fails if it
-     * tries). Hosts pass an element from `efficient-easel/icons`, whose four
-     * menu glyphs — copy, paste, move-up, move-down — shipped in 0.30.0 for
-     * exactly this row.
-     *
-     * OMIT IT AND NOTHING IS DRAWN — not an empty span. That is what keeps the
-     * admin portal's three shipped surfaces byte-identical, and it is pinned by
-     * `tests/menu-layer.test.tsx` (g).
-     */
-    icon?: ReactNode;
-    /**
-     * The keyboard shortcut, drawn right-aligned after the label (the `.k`
-     * column of the approved drawing).
-     *
-     * Display text, not a binding — the box neither registers nor honours it;
-     * the host owns the key handling. `aria-hidden`, like the tick and the
-     * chevron: "Duplicate ⌘D" read aloud is worse than "Duplicate".
-     *
-     * OMIT IT AND NOTHING IS DRAWN. Same guard as `icon`.
-     */
-    shortcut?: string;
-}
-/**
- * What the box is dressed in.
- *
- * ⚠️ A SKIN IS TOTAL. Pass one and it replaces {@link ES_MENU_SKIN} outright —
- * nothing from the default is merged in underneath. That is not tidiness, it is
- * the only arrangement that keeps the admin portal's three shipped render sites
- * looking the way they do:
- *
- *   · their look is Tailwind classes, and Tailwind v4 scans the project root and
- *     NOT `node_modules` (`efficient-admin-portal/src/index.css:13-22` says so in
- *     its own words, and adds `@source` lines for efficient-shell because of it);
- *   · so those class strings have to keep living in that project's own `src/`,
- *     where its build still sees them — they cannot move into this package;
- *   · and a merge would append a class of ours to a caller's string, which is
- *     the one thing that stops the rendered markup being byte-identical.
- *
- * A slot left empty is left empty. The default fills all of them.
- */
-interface EaselContextMenuSkin {
-    /** The box. */
-    menu?: string;
-    /** The FLYOUT box. Falls back to {@link menu} when a skin gives only one —
-     *  they are the same surface in the default look, but not everywhere: the
-     *  admin portal's box carries `overflow-y-auto` (it takes a `maxHeight`) and
-     *  its flyout does not. Collapsing the two would quietly change the markup of
-     *  a surface already in front of users. */
-    menuSub?: string;
-    /** A plain row. */
-    item?: string;
-    /** A row that destroys something. */
-    itemDanger?: string;
-    /** The `'—'` separator. */
-    divider?: string;
-    /** A `header: true` caption. */
-    header?: string;
-    /** The label span of a row that has something beside it — a chevron, a tick.
-     *  A row that is only a label renders bare text and takes no class at all,
-     *  which is what the two grid callers have always drawn. */
-    label?: string;
-    /** The label span inside a FLYOUT. Falls back to {@link label} when a skin
-     *  gives only one — the admin portal wants them different, because a state
-     *  name in a flyout can be long enough to need truncating and a row in the box
-     *  never is. */
-    labelSub?: string;
-    /** The glyph column, when a row carries an `icon`. */
-    icon?: string;
-    /** The right-aligned shortcut column, when a row carries a `shortcut`. */
-    shortcut?: string;
-    /** The `›` on a row that opens a flyout. */
-    chevron?: string;
-    /** The tick column of a flyout whose entries are states. */
-    tick?: string;
-    /** Merged into the box's own inline style, under the placement this component
-     *  computes — so a caller can hand it a surface (the admin passes
-     *  `glassStyle()` from efficient-shell) without being able to move it. */
-    surface?: CSSProperties;
-    /** Merged into each row's inline style. */
-    itemStyle?: CSSProperties;
-}
-interface EaselContextMenuProps {
-    /** Where the pointer was. The box is placed from here and then kept on
-     *  screen — see the note on the component. */
-    x: number;
-    y: number;
-    items: EaselContextMenuItem[];
-    onClose: () => void;
-    /** Cap the box's height; it scrolls past that. */
-    maxHeight?: number;
-    /** Defaults to {@link ES_MENU_SKIN}, the storefront editor's approved look. */
-    skin?: EaselContextMenuSkin;
-    /**
-     * Where to portal to. Defaults to `document.body` (`null` means the default).
-     *
-     * A host that OVERRIDES `--es-*` on its own editor root should pass that root
-     * instead: the default skin re-declares the token defaults on the box (see the
-     * component's note), which is right for a box hanging off `<body>` and wrong
-     * for one that should inherit a re-themed editor's values.
-     *
-     * So should a host that wants the box INSIDE ITS LANDMARKS (on the body it
-     * is page content outside every landmark: axe-core's `region`) — through
-     * `menuPortalTarget(root)`, never the bare root: the box is `position:
-     * fixed`, and a transformed, filtered or contained ancestor places and clips
-     * it. `menuPortalTarget` answers the root only when none does. The decision
-     * is recorded in `./portal`.
-     */
-    portalTo?: HTMLElement | null;
-}
-
-export type { EaselContextMenuItem as E, EaselContextMenuProps as a, EaselContextMenuSkin as b };

package/dist/words-DgHcY5qB.d.ts

@@ -1,33 +0,0 @@
-/**
- * The Layers tree's own words (`efficient-easel/strings`, 0.95.0): the drag
- * hint, the caret's and an empty slot's. A row's name, its marks and its
- * actions are the host's.
- *
- * The tree is hook-free, so it does not read the strings provider: `TreeRow`
- * and `TreeEmptySlot` take these as their `words` prop and a host passes
- * `useEaselStrings().tree`.
- */
-type TreeWords = {
-    /** What a draggable row says after 0.7 s on it. */
-    dragHint: string;
-    /** The caret's tooltip while the row is open. */
-    collapse: string;
-    /** The caret's tooltip while the row is folded. */
-    expand: string;
-    /** The caret's accessible name while open. `label` is the host's word for what folds: "section". */
-    collapseNamed: (v: {
-        label: string;
-    }) => string;
-    /** The caret's accessible name while folded. */
-    expandNamed: (v: {
-        label: string;
-    }) => string;
-    /** What an empty slot says when it offers nothing: a read-only tree. */
-    emptySlot?: string;
-    /** What an empty slot's button says. */
-    addBlock?: string;
-    /** What an empty slot says while a drag may land in it. */
-    dropHere?: string;
-};
-
-export type { TreeWords as T };