@formicoidea/labre-core 0.58.0 → 0.59.0

package/dist/_pkgs/affine-gfx-template/contribute.js

@@ -1,6 +1,6 @@
 import { FrameTemplateProvider, } from '../affine-shared/services/index.js';
 import { createIdentifier } from '../global/di/index.js';
-import { builtInTemplates } from './toolbar/builtin-templates.js';
+import { builtInTemplates, loadTemplates, templateMatches, templates as builtInCategories, } from './toolbar/builtin-templates.js';
 import { resolveTemplateName } from './toolbar/resolve-name.js';
 import { TEMPLATE_PANEL_CATEGORY_SAVED_FRAMES } from './translations.js';
 /**
@@ -70,11 +70,6 @@ function savedFramesCategory(std) {
         templates: async () => (await service.list()).map(saved => savedFrameTemplate(service, saved)),
     };
 }
-function loadCategory(category) {
-    return Array.isArray(category.templates)
-        ? Promise.resolve(category.templates)
-        : category.templates();
-}
 /**
  * The catalogue ONE editor sees: the built-in `Other`, then the categories
  * the view extensions mounted on this `std` registered — i.e. exactly the
@@ -103,22 +98,22 @@ export function templateManagerFor(std) {
         list: async (name) => {
             const category = byName(name);
             return [
-                ...(category ? await loadCategory(category) : []),
+                ...(category ? await loadTemplates(category) : []),
                 ...(await builtInTemplates.list(name)),
             ];
         },
         search: async (keyword, name) => {
-            const k = keyword.trim().toLocaleLowerCase();
-            const pool = name ? [byName(name)].filter(c => !!c) : contributed;
-            // Matches the ENGLISH name (`templateFromCommand`'s baked-in `name`,
-            // still what a catalogue-less playground shows) or the host's own
-            // translation of it (`resolveTemplateName`, through the command's
-            // `labelKey`) — a search box must not go blind on a translated tile.
-            const own = (await Promise.all(pool.map(loadCategory)))
+            // Built-in first, then contributed: the tab order. One pool and one
+            // predicate for both halves, so `Other` is searched exactly like a
+            // framework's category — the ENGLISH name (`templateFromCommand`'s
+            // baked-in `name`, still what a catalogue-less playground shows) or the
+            // host's own translation of it (`resolveTemplateName`, through the
+            // tile's `nameKey` or the command's `labelKey`): a search box must not
+            // go blind on a translated tile.
+            const pool = [...builtInCategories, ...contributed].filter(c => !name || c.name === name);
+            return (await Promise.all(pool.map(loadTemplates)))
                 .flat()
-                .filter(t => t.name?.toLocaleLowerCase().includes(k) ||
-                resolveTemplateName(std, t).toLocaleLowerCase().includes(k));
-            return [...(await builtInTemplates.search(keyword, name)), ...own];
+                .filter(t => templateMatches(t, keyword, resolveTemplateName(std, t)));
         },
     };
 }

package/dist/_pkgs/affine-gfx-template/make-snapshot.d.ts

@@ -1,5 +1,13 @@
 /** A surface-elements map as it appears inside a template's DocSnapshot. */
 export type SurfaceElementsJSON = Record<string, Record<string, unknown>>;
+/** A block the surface holds (a frame), as it appears inside a DocSnapshot. */
+export type SurfaceChildBlockJSON = {
+    type: 'block';
+    id: string;
+    flavour: string;
+    props: Record<string, unknown>;
+    children: [];
+};
 /**
  * Serialize a plain string into the surface `Y.Text` JSON form used inside
  * snapshots (the shape inner-text / label field). Mirrors what
@@ -31,8 +39,12 @@ export declare function surfaceYMap(json: Record<string, unknown>): {
  * (group-aware) and only then mints fresh keys — and it skips any element that
  * carries no `index` at all. So a missing `index` is filled in here, in key
  * (insertion) order, which is the order a creation action added the elements.
+ *
+ * `blocks` are the surface's own child blocks — a slide mask's frame. They
+ * keep the props they are given: the template job remaps their ids, their
+ * `childElementIds` and their `index` on insert like any frame's.
  */
-export declare function makeTemplateSnapshot(elements: SurfaceElementsJSON, title?: string): {
+export declare function makeTemplateSnapshot(elements: SurfaceElementsJSON, title?: string, blocks?: SurfaceChildBlockJSON[]): {
     type: string;
     meta: {
         id: string;
@@ -59,7 +71,7 @@ export declare function makeTemplateSnapshot(elements: SurfaceElementsJSON, titl
             props: {
                 elements: SurfaceElementsJSON;
             };
-            children: never[];
+            children: SurfaceChildBlockJSON[];
         }[];
     };
 };

package/dist/_pkgs/affine-gfx-template/make-snapshot.js

@@ -32,8 +32,12 @@ export function surfaceYMap(json) {
  * (group-aware) and only then mints fresh keys — and it skips any element that
  * carries no `index` at all. So a missing `index` is filled in here, in key
  * (insertion) order, which is the order a creation action added the elements.
+ *
+ * `blocks` are the surface's own child blocks — a slide mask's frame. They
+ * keep the props they are given: the template job remaps their ids, their
+ * `childElementIds` and their `index` on insert like any frame's.
  */
-export function makeTemplateSnapshot(elements, title = 'Template') {
+export function makeTemplateSnapshot(elements, title = 'Template', blocks = []) {
     const indexed = {};
     let last = null;
     for (const [id, element] of Object.entries(elements)) {
@@ -81,7 +85,7 @@ export function makeTemplateSnapshot(elements, title = 'Template') {
                     id: 'block:template-surface',
                     flavour: 'affine:surface',
                     props: { elements: indexed },
-                    children: [],
+                    children: blocks,
                 },
             ],
         },

package/dist/_pkgs/affine-gfx-template/services/template-middlewares.d.ts

@@ -10,6 +10,18 @@ import type { TemplateJob } from './template.js';
  */
 export declare const createActiveLayerMiddleware: (std: BlockStdScope) => (job: TemplateJob) => void;
 export declare const replaceIdMiddleware: (job: TemplateJob) => void;
+/**
+ * Every inserted frame takes a fresh `presentationIndex` AFTER the last frame
+ * of the document, the template's frames keeping their relative order. A
+ * saved frame's snapshot carries its source's key, so without this the copy
+ * shared the source's slideshow position, and so did every further insertion;
+ * the clipboard has always minted fresh keys on paste
+ * (`EdgelessClipboardFrameConfig`, `newPresentationIndexes`).
+ *
+ * Keyed by the snapshot OBJECT, not its id, so it works on either side of
+ * `replaceIdMiddleware` (`template-presentation-index.unit.spec.ts`).
+ */
+export declare const createPresentationIndexMiddleware: (job: TemplateJob) => void;
 export declare const createInsertPlaceMiddleware: (targetPlace: Bound) => (job: TemplateJob) => void;
 export declare const createStickerMiddleware: (center: {
     x: number;

package/dist/_pkgs/affine-gfx-template/services/template-middlewares.js

@@ -1,6 +1,7 @@
 import { applyCreationLayer, generateElementId, sortIndex, } from '../../affine-block-surface/index.js';
 import { Bound } from '../../global/gfx/index.js';
 import { assertType } from '../../global/utils/index.js';
+import { generateKeyBetweenV2 } from '../../std/gfx/index.js';
 /**
  * Everything a template inserts lands in the viewer's active layer (ADR 0031
  * §6). The insertion bypasses both stamped paths — its elements are merged
@@ -126,6 +127,53 @@ export const replaceIdMiddleware = (job) => {
         }
     };
 };
+/**
+ * Every inserted frame takes a fresh `presentationIndex` AFTER the last frame
+ * of the document, the template's frames keeping their relative order. A
+ * saved frame's snapshot carries its source's key, so without this the copy
+ * shared the source's slideshow position, and so did every further insertion;
+ * the clipboard has always minted fresh keys on paste
+ * (`EdgelessClipboardFrameConfig`, `newPresentationIndexes`).
+ *
+ * Keyed by the snapshot OBJECT, not its id, so it works on either side of
+ * `replaceIdMiddleware` (`template-presentation-index.unit.spec.ts`).
+ */
+export const createPresentationIndexMiddleware = (job) => {
+    const fresh = new Map();
+    const keyOf = (props) => typeof props.presentationIndex === 'string' ? props.presentationIndex : '';
+    job.slots.beforeInsert.subscribe(payload => {
+        if (payload.type === 'template') {
+            const inserted = [];
+            job.walk(block => {
+                if (block.flavour === 'affine:frame')
+                    inserted.push(block);
+            });
+            if (!inserted.length)
+                return;
+            // The document's frames are all still the existing ones here.
+            let last = null;
+            for (const model of job.model.store.getModelsByFlavour('affine:frame')) {
+                const key = keyOf(model.props);
+                if (key && (last === null || key > last))
+                    last = key;
+            }
+            inserted
+                .sort((a, b) => {
+                const ka = keyOf(a.props);
+                const kb = keyOf(b.props);
+                return ka < kb ? -1 : ka > kb ? 1 : 0;
+            })
+                .forEach(block => {
+                last = generateKeyBetweenV2(last, null);
+                fresh.set(block, last);
+            });
+            return;
+        }
+        const key = fresh.get(payload.data.blockJson);
+        if (key)
+            payload.data.blockJson.props.presentationIndex = key;
+    });
+};
 export const createInsertPlaceMiddleware = (targetPlace) => {
     return (job) => {
         if (job.type !== 'template')

package/dist/_pkgs/affine-gfx-template/services/template.js

@@ -5,7 +5,7 @@ import { assertType } from '../../global/utils/index.js';
 import { GfxControllerIdentifier } from '../../std/gfx/index.js';
 import { DocSnapshotSchema, } from '../../store/index.js';
 import { Subject } from 'rxjs';
-import { createActiveLayerMiddleware, createInsertPlaceMiddleware, createRegenerateIndexMiddleware, createStickerMiddleware, replaceIdMiddleware, } from './template-middlewares.js';
+import { createActiveLayerMiddleware, createInsertPlaceMiddleware, createPresentationIndexMiddleware, createRegenerateIndexMiddleware, createStickerMiddleware, replaceIdMiddleware, } from './template-middlewares.js';
 /**
  * Those block contains other block's id
  * should defer the loading
@@ -238,6 +238,7 @@ export function createTemplateJob(std, type, center) {
         }
         const idxGenerator = layer.createIndexGenerator();
         middlewares.push(createRegenerateIndexMiddleware(() => idxGenerator()));
+        middlewares.push(createPresentationIndexMiddleware);
     }
     if (type === 'sticker') {
         middlewares.push(createStickerMiddleware(center || viewport.center, () => layer.generateIndex()));

package/dist/_pkgs/affine-gfx-template/toolbar/builtin-templates.d.ts

@@ -1,7 +1,21 @@
 import type { Template, TemplateCategory } from './template-type.js';
 export declare const templates: TemplateCategory[];
+/** A category's pack, whichever of its two shapes (array or thunk) it has. */
+export declare function loadTemplates(category: TemplateCategory): Promise<Template[]>;
 /**
- * The catalogue every editor has, whatever is mounted: `Other`. A host or a
+ * The ONE search predicate of the Templates panel, built-in and contributed
+ * categories alike: a case-insensitive substring of the English `name` (the
+ * stable identity, what a catalogue-less playground shows) or of the
+ * displayed name the caller resolved through the translation seam.
+ *
+ * Until 0.58 the built-in half matched the keyword against
+ * `Object.entries(templates)` of an ARRAY, i.e. against "0", "1", … — SWOT,
+ * Kanban, BMC, Fishbone and Gantt were unfindable, and a lazy built-in
+ * category's results were dropped (`template-search.unit.spec.ts`).
+ */
+export declare function templateMatches(template: Template, keyword: string, displayName?: string): boolean;
+/**
+ * The catalogue every editor has, whatever is mounted: `Other` and `Slides`. A host or a
  * framework adds a category per editor with `TemplateCategoryExtension`; the
  * module-level `extend(...)` this object carried until 0.49 appended for every
  * editor of the page and was never emptied.

package/dist/_pkgs/affine-gfx-template/toolbar/builtin-templates.js

@@ -1,23 +1,32 @@
 import { otherTemplateCategory } from '../builtin/other.js';
-export const templates = [otherTemplateCategory];
-function lcs(text1, text2) {
-    const dp = Array.from({
-        length: text1.length + 1,
-    }, () => Array.from({ length: text2.length + 1 }, () => 0));
-    for (let i = 1; i <= text1.length; i++) {
-        for (let j = 1; j <= text2.length; j++) {
-            if (text1[i - 1] === text2[j - 1]) {
-                dp[i][j] = dp[i - 1][j - 1] + 1;
-            }
-            else {
-                dp[i][j] = Math.max(dp[i - 1][j], dp[i][j - 1]);
-            }
-        }
-    }
-    return dp[text1.length][text2.length];
+import { slidesTemplateCategory } from '../builtin/slides/index.js';
+export const templates = [
+    otherTemplateCategory,
+    slidesTemplateCategory,
+];
+/** A category's pack, whichever of its two shapes (array or thunk) it has. */
+export function loadTemplates(category) {
+    return Array.isArray(category.templates)
+        ? Promise.resolve(category.templates)
+        : category.templates();
 }
 /**
- * The catalogue every editor has, whatever is mounted: `Other`. A host or a
+ * The ONE search predicate of the Templates panel, built-in and contributed
+ * categories alike: a case-insensitive substring of the English `name` (the
+ * stable identity, what a catalogue-less playground shows) or of the
+ * displayed name the caller resolved through the translation seam.
+ *
+ * Until 0.58 the built-in half matched the keyword against
+ * `Object.entries(templates)` of an ARRAY, i.e. against "0", "1", … — SWOT,
+ * Kanban, BMC, Fishbone and Gantt were unfindable, and a lazy built-in
+ * category's results were dropped (`template-search.unit.spec.ts`).
+ */
+export function templateMatches(template, keyword, displayName) {
+    const k = keyword.trim().toLocaleLowerCase();
+    return [template.name, displayName].some(name => name !== undefined && name.toLocaleLowerCase().includes(k));
+}
+/**
+ * The catalogue every editor has, whatever is mounted: `Other` and `Slides`. A host or a
  * framework adds a category per editor with `TemplateCategoryExtension`; the
  * module-level `extend(...)` this object carried until 0.49 appended for every
  * editor of the page and was never emptied.
@@ -27,29 +36,16 @@ export const builtInTemplates = {
         const cate = templates.find(cate => cate.name === category);
         if (!cate)
             return [];
-        return cate.templates instanceof Function
-            ? cate.templates()
-            : cate.templates;
+        return loadTemplates(cate);
     },
     categories: async () => templates.map(cate => cate.name),
     categoryLabel: (name) => templates.find(cate => cate.name === name)?.nameKey,
+    // No `std` here, so the English name only; `templateManagerFor` (what the
+    // panel reads) also matches the translated name.
     search: async (keyword, cateName) => {
-        const candidates = [];
-        keyword = keyword.trim().toLocaleLowerCase();
-        await Promise.all(templates.map(async (categroy) => {
-            if (cateName && cateName !== categroy.name) {
-                return;
-            }
-            if (categroy.templates instanceof Function) {
-                return categroy.templates();
-            }
-            return Promise.all(Object.entries(categroy.templates).map(async ([name, template]) => {
-                if (lcs(keyword, name.toLocaleLowerCase()) ===
-                    keyword.length) {
-                    candidates.push(template);
-                }
-            }));
-        }));
-        return candidates;
+        const pool = templates.filter(c => !cateName || c.name === cateName);
+        return (await Promise.all(pool.map(loadTemplates)))
+            .flat()
+            .filter(t => templateMatches(t, keyword));
     },
 };

package/dist/_pkgs/affine-gfx-template/toolbar/template-type.d.ts

@@ -42,6 +42,12 @@ export type Template = {
      * shipped template declares both today.
      */
     nameKey?: string;
+    /**
+     * Plain English words a search may match besides the name ("cover",
+     * "agenda", "kpi"), like `CommandDescriptor.keywords`. Not displayed, so
+     * not keyed: they widen what a search finds, they never label anything.
+     */
+    keywords?: string[];
     /**
      * Rebuild {@link content} in the inserting editor's language — the seeds a
      * template writes into the document (a component's name, a lane's title) go

package/dist/_pkgs/affine-gfx-template/translations.d.ts

@@ -30,6 +30,100 @@ export declare const TEMPLATE_NAME_KANBAN_BOARD: ChromeWording;
 export declare const TEMPLATE_NAME_BUSINESS_MODEL_CANVAS: ChromeWording;
 export declare const TEMPLATE_NAME_FISHBONE: ChromeWording;
 export declare const TEMPLATE_NAME_GANTT_CHART: ChromeWording;
+export declare const TEMPLATE_PANEL_CATEGORY_SLIDES: ChromeWording;
+export declare const SLIDE_NAME_COVER: ChromeWording;
+export declare const SLIDE_NAME_COVER_IMAGE: ChromeWording;
+export declare const SLIDE_NAME_SECTION: ChromeWording;
+export declare const SLIDE_NAME_STATEMENT: ChromeWording;
+export declare const SLIDE_NAME_TEXT_IMAGE: ChromeWording;
+export declare const SLIDE_NAME_FULL_IMAGE: ChromeWording;
+export declare const SLIDE_NAME_TWO_COLUMNS: ChromeWording;
+export declare const SLIDE_NAME_THREE_COLUMNS: ChromeWording;
+export declare const SLIDE_NAME_SIX_POINTS: ChromeWording;
+export declare const SLIDE_NAME_IMAGE_CARDS: ChromeWording;
+export declare const SLIDE_NAME_AGENDA: ChromeWording;
+/** An alias (L7 dedupe): the quote block's own word, one key. */
+export declare const SLIDE_NAME_QUOTE: ChromeWording;
+export declare const SLIDE_NAME_TESTIMONIALS: ChromeWording;
+export declare const SLIDE_NAME_TEAM: ChromeWording;
+export declare const SLIDE_NAME_CONTACT: ChromeWording;
+export declare const SLIDE_NAME_ORG_CHART: ChromeWording;
+export declare const SLIDE_NAME_KEY_FIGURES: ChromeWording;
+export declare const SLIDE_NAME_TIMELINE: ChromeWording;
+export declare const SLIDE_NAME_ROADMAP: ChromeWording;
+export declare const SLIDE_NAME_PROCESS: ChromeWording;
+export declare const SLIDE_NAME_MATRIX: ChromeWording;
+export declare const SLIDE_NAME_VENN: ChromeWording;
+export declare const SLIDE_NAME_MARKET_SIZE: ChromeWording;
+export declare const SLIDE_NAME_PRICING: ChromeWording;
+export declare const SLIDE_NAME_LOGO_WALL: ChromeWording;
+export declare const SLIDE_NAME_GANTT: ChromeWording;
+export declare const SLIDE_NAME_CHART_TEXT: ChromeWording;
+export declare const SLIDE_NAME_THREE_CHARTS: ChromeWording;
+export declare const SLIDE_NAME_COLLAGE: ChromeWording;
+export declare const SLIDE_NAME_BENTO: ChromeWording;
+export declare const SLIDE_NAME_IMAGE_GRID: ChromeWording;
+export declare const SLIDE_NAME_FEATURE_BENTO: ChromeWording;
+export declare const SLIDE_NAME_PHONE: ChromeWording;
+export declare const SLIDE_NAME_TABLET: ChromeWording;
+/**
+ * The slide-mask tile names this package declares (the quote slide's is the
+ * quote block's own, declared in `chrome.ts`).
+ */
+export declare const SLIDE_NAME_WORDINGS: readonly ChromeWording[];
+/** The seeds a slide mask writes into the document, shared by every mask. */
+export declare const SLIDE_SEED_EYEBROW: ChromeWording;
+export declare const SLIDE_SEED_COVER_TITLE: ChromeWording;
+export declare const SLIDE_SEED_DATE: ChromeWording;
+export declare const SLIDE_SEED_TITLE: ChromeWording;
+export declare const SLIDE_SEED_SUBTITLE: ChromeWording;
+export declare const SLIDE_SEED_SECTION_TITLE: ChromeWording;
+export declare const SLIDE_SEED_SECTION_SUBTITLE: ChromeWording;
+export declare const SLIDE_SEED_STATEMENT: ChromeWording;
+export declare const SLIDE_SEED_HEADING: ChromeWording;
+export declare const SLIDE_SEED_BODY: ChromeWording;
+export declare const SLIDE_SEED_IMAGE: ChromeWording;
+export declare const SLIDE_SEED_CAPTION: ChromeWording;
+export declare const SLIDE_SEED_FOOTER: ChromeWording;
+export declare const SLIDE_SEED_AGENDA_TITLE: ChromeWording;
+export declare const SLIDE_SEED_AGENDA_ITEM: ChromeWording;
+export declare const SLIDE_SEED_QUOTE: ChromeWording;
+export declare const SLIDE_SEED_QUOTE_AUTHOR: ChromeWording;
+export declare const SLIDE_SEED_TESTIMONIALS_TITLE: ChromeWording;
+export declare const SLIDE_SEED_TEAM_TITLE: ChromeWording;
+export declare const SLIDE_SEED_PERSON_NAME: ChromeWording;
+export declare const SLIDE_SEED_PERSON_ROLE: ChromeWording;
+export declare const SLIDE_SEED_CONTACT_TITLE: ChromeWording;
+export declare const SLIDE_SEED_CONTACT_ADDRESS: ChromeWording;
+export declare const SLIDE_SEED_CONTACT_PHONE: ChromeWording;
+export declare const SLIDE_SEED_CONTACT_EMAIL: ChromeWording;
+export declare const SLIDE_SEED_CONTACT_VALUE: ChromeWording;
+export declare const SLIDE_SEED_FIGURE: ChromeWording;
+export declare const SLIDE_SEED_DETAIL: ChromeWording;
+export declare const SLIDE_SEED_FIGURE_LABEL: ChromeWording;
+export declare const SLIDE_SEED_MILESTONE: ChromeWording;
+export declare const SLIDE_SEED_QUARTER: ChromeWording;
+export declare const SLIDE_SEED_STEP: ChromeWording;
+export declare const SLIDE_SEED_AXIS_VALUE: ChromeWording;
+export declare const SLIDE_SEED_AXIS_EFFORT: ChromeWording;
+export declare const SLIDE_SEED_QUADRANT: ChromeWording;
+export declare const SLIDE_SEED_VENN_IDEA: ChromeWording;
+export declare const SLIDE_SEED_VENN_OTHER: ChromeWording;
+export declare const SLIDE_SEED_VENN_OVERLAP: ChromeWording;
+export declare const SLIDE_SEED_MARKET_TOTAL: ChromeWording;
+export declare const SLIDE_SEED_MARKET_SERVICEABLE: ChromeWording;
+export declare const SLIDE_SEED_MARKET_OBTAINABLE: ChromeWording;
+export declare const SLIDE_SEED_PLAN: ChromeWording;
+export declare const SLIDE_SEED_PRICE: ChromeWording;
+export declare const SLIDE_SEED_FEATURE: ChromeWording;
+export declare const SLIDE_SEED_LOGO: ChromeWording;
+/** The label of a chart placeholder: a dashed zone, like a picture's. */
+export declare const SLIDE_SEED_CHART: ChromeWording;
+/** The label of a device mockup's screen zone. */
+export declare const SLIDE_SEED_SCREEN: ChromeWording;
+export declare const SLIDE_SEED_TASK: ChromeWording;
+export declare const SLIDE_SEED_MONTH: ChromeWording;
+export declare const SLIDE_SEED_WORDINGS: readonly ChromeWording[];
 export declare const TEMPLATE_PACKAGE_WORDINGS: readonly ChromeWording[];
 /**
  * The generic ("Other") diagrams' own seeds: the captions painted onto the