@plannotator/ui 0.45.0 → 0.45.1

package/HANDOFF.md

@@ -450,6 +450,8 @@ The package now owns the reusable two-stage `/embed` authoring flow. The host st
 
 4. **Grammar belongs to the host; splicing belongs to the package.** `buildInsertLine(target)` returns the exact line the host wants stored. `planEmbedInsert()` then normalizes that line into its own blank-line-delimited paragraph and places the caret on the following line. Host-specific path resolution, label escaping, and embed-fragment grammar stay outside the package.
 
+   **Host labels (0.45.1).** `EmbedPickerConfig.labels?: { upload?: string; empty?: string; noMatch?: (query: string) => string }` replaces the three rows that name the target type ("Upload HTML...", "No HTML files in this workspace", "No HTML files match “<query>”") for a host that feeds the picker more than HTML files. Each absent key keeps the built-in text, so a host passing nothing (Plannotator) renders exactly the menu it always did. The "Uploading..." row and the notice row are unchanged.
+
 5. **Upload is optional and single-flight.** When `uploadTarget` is absent, no upload row is rendered. When present, every picker state includes `Upload HTML...`. While its promise is pending, the typed `/embed` text stays visible and a reopened picker shows an inert `Uploading...` row. Resolving with a target inserts it through `buildInsertLine` and the same splice as an existing target; resolving `null` or rejecting leaves the typed command untouched. The package maps the anchor through CodeMirror transactions and silently drops the insert if the command was edited away. The host owns all failure UI.
 
 6. **One CodeMirror dependency graph.** The picker imports `@codemirror/autocomplete`, `@codemirror/state`, and `@codemirror/view` from `@plannotator/ui`'s declared dependencies. `@plannotator/atomic-editor` declares these as peers, so a consumer must resolve one shared copy. A second live copy of `@codemirror/state` breaks extensions just as it does for `wikiLinks`.

package/README.md

@@ -74,7 +74,7 @@ Plannotator's own entries import the eager math and identity modules (`math-eage
   const editorExtensions = [wikiLinks({ suggest, resolve, onOpen })]; // stable reference!
   <MarkdownEditor markdown={md} documentId={docId} editorHandleRef={ref} extensions={editorExtensions} />
   ```
-- **`embedPicker(config)` and `embedSlashItem()` are re-exported from the same surface.** Compose the static item into `slashCommands({ items: [...] })` and pass the picker beside it in the stable `extensions` array. `getTargets`, `buildInsertLine`, optional `uploadTarget`, and optional `getNotice` stay live through callbacks. The host owns embed grammar and upload error UI; the package owns filtering, async anchor mapping, single-flight upload state, and paragraph-safe insertion through the re-exported `planEmbedInsert()`.
+- **`embedPicker(config)` and `embedSlashItem()` are re-exported from the same surface.** Compose the static item into `slashCommands({ items: [...] })` and pass the picker beside it in the stable `extensions` array. `getTargets`, `buildInsertLine`, optional `uploadTarget`, and optional `getNotice` stay live through callbacks. Optional `labels` (`upload`, `empty`, `noMatch(query)`) reword the three rows that say "HTML"; absent keys keep the built-in text. The host owns embed grammar and upload error UI; the package owns filtering, async anchor mapping, single-flight upload state, and paragraph-safe insertion through the re-exported `planEmbedInsert()`.
 - **The viewer resolves wiki-links synchronously.** `InlineMarkdown` takes `resolveLinkedDoc?: (target) => { label?; status?: 'active' | 'deleted' } | null` — called with the raw stored target (opaque ids like `doc_01XYZ`, no `.md` normalization). Return a `label` to display live titles (stored label is the fallback, target the last resort); return `status: 'deleted'` for a muted non-link ("Document deleted") instead of a live link. Absent or `null` → rendering is unchanged. Sync-only by design: back it with an in-memory cache.
 
 Requires `@plannotator/markdown-editor ^0.3.2` and `@plannotator/atomic-editor ^0.7.0`. See HANDOFF.md § "Wiki-link seams (0.27.0)".

package/components/MarkdownEditor/embedPicker.ts

@@ -42,6 +42,19 @@ export interface EmbedPickerConfig {
   readonly uploadTarget?: (kind: EmbedKind) => Promise<EmbedTarget | null>;
   /** Return an optional informational row for the current document text. */
   readonly getNotice?: (docBody: string) => string | null;
+  /**
+   * Host copy for the three rows that name the target type (0.45.1). A host
+   * that feeds the picker more than HTML files passes its own wording; each
+   * absent key keeps the built-in text, so Plannotator's menu is unchanged.
+   */
+  readonly labels?: {
+    /** The upload row. Default: "Upload HTML..." */
+    readonly upload?: string;
+    /** The row shown when there are no targets at all. Default: "No HTML files in this workspace" */
+    readonly empty?: string;
+    /** The row shown when the query matches nothing. Default: "No HTML files match “<query>”" */
+    readonly noMatch?: (query: string) => string;
+  };
 }
 
 type IconCompletion = Completion & {
@@ -175,8 +188,8 @@ function createEmbedPickerSource(
       options.push({
         label:
           targets.length === 0
-            ? 'No HTML files in this workspace'
-            : `No HTML files match “${query.trim()}”`,
+            ? config.labels?.empty ?? 'No HTML files in this workspace'
+            : config.labels?.noMatch?.(query.trim()) ?? `No HTML files match “${query.trim()}”`,
         apply: (view, completion, _from, to) => {
           view.dispatch({
             changes: { from: line.from, to, insert: '' },
@@ -209,7 +222,7 @@ function createEmbedPickerSource(
               },
             }
           : {
-              label: 'Upload HTML...',
+              label: config.labels?.upload ?? 'Upload HTML...',
               slashCommandIcon: UPLOAD_ICON,
               apply: (view, completion, from, to) => {
                 startUpload(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plannotator/ui",
-  "version": "0.45.0",
+  "version": "0.45.1",
   "type": "module",
   "exports": {
     "./components/*": "./components/*.tsx",