@threadlabs/looma 0.23.20 → 0.23.22

package/vue/editor/LoomaEditor.d.ts

@@ -1,7 +1,7 @@
 import "./looma-editor.css";
 import type { AnyExtension, Editor, JSONContent } from "@tiptap/core";
 import { type PropType, type VNode } from "vue";
-import { type LoomaMentionItem, type LoomaMentionProvider, type LoomaCodeLanguages } from "@threadlabs/looma/editor";
+import { type LoomaSlashCommand, type LoomaMentionItem, type LoomaMentionProvider, type LoomaCodeLanguages } from "@threadlabs/looma/editor";
 import { type LoomaImageActivationDetail, type LoomaImageAttributeResolver, type LoomaImageDescriptor, type LoomaImageRenditionErrorDetail } from "./image-delivery.js";
 /**
  * Host upload result normalized into the editor's durable image descriptor.
@@ -27,6 +27,12 @@ export type LoomaImageUploader = (file: File) => Promise<string | LoomaImageUplo
  * as well as a selection; it does not alter document commands or stored content.
  */
 export type LoomaEditorToolbarMode = "bubble" | "sticky" | "popover" | "contextual";
+/**
+ * Replace the slash inventory, or return retained defaults plus host commands.
+ * @ownership The host owns its command objects and mutations; Looma supplies
+ * fresh defaults and invokes this factory when the inventory prop changes.
+ */
+export type LoomaEditorSlashCommands = LoomaSlashCommand[] | ((defaults: LoomaSlashCommand[]) => LoomaSlashCommand[]);
 /** A destination supplied by the host application, such as a page or record. */
 export interface LoomaLinkTarget {
     id: string;
@@ -91,6 +97,11 @@ export declare const LoomaEditor: import("vue").DefineComponent<import("vue").Ex
         type: PropType<AnyExtension[]>;
         default: () => never[];
     };
+    /** One inventory for the existing slash extension; an empty array intentionally supplies no commands. */
+    slashCommands: {
+        type: PropType<LoomaEditorSlashCommands>;
+        default: undefined;
+    };
     /** Override the lazy built-in catalog with application-owned code grammars. An empty object disables highlighting. */
     codeLanguages: {
         type: PropType<LoomaCodeLanguages | null>;
@@ -202,6 +213,11 @@ export declare const LoomaEditor: import("vue").DefineComponent<import("vue").Ex
         type: PropType<AnyExtension[]>;
         default: () => never[];
     };
+    /** One inventory for the existing slash extension; an empty array intentionally supplies no commands. */
+    slashCommands: {
+        type: PropType<LoomaEditorSlashCommands>;
+        default: undefined;
+    };
     /** Override the lazy built-in catalog with application-owned code grammars. An empty object disables highlighting. */
     codeLanguages: {
         type: PropType<LoomaCodeLanguages | null>;
@@ -271,9 +287,9 @@ export declare const LoomaEditor: import("vue").DefineComponent<import("vue").Ex
         default: boolean;
     };
 }>> & Readonly<{
+    onUpdate?: ((_value: JSONContent) => any) | undefined;
     "onUpdate:modelValue"?: ((_value: JSONContent) => any) | undefined;
     "onUpdate:toolbarOpen"?: ((_value: boolean) => any) | undefined;
-    onUpdate?: ((_value: JSONContent) => any) | undefined;
     onReady?: ((_editor: Editor) => any) | undefined;
     onUploadError?: ((_error: unknown, _file: File) => any) | undefined;
     onImageActivate?: ((_detail: LoomaImageActivationDetail) => any) | undefined;
@@ -287,6 +303,7 @@ export declare const LoomaEditor: import("vue").DefineComponent<import("vue").Ex
     modelValue: JSONContent;
     editable: boolean;
     extensions: AnyExtension[];
+    slashCommands: LoomaEditorSlashCommands;
     mentionItems: LoomaMentionItem[];
     mentionProvider: LoomaMentionProvider | undefined;
     mentionLimit: number;

package/vue/editor/divider.d.ts

@@ -0,0 +1,6 @@
+import type { NodeViewRenderer } from "@tiptap/core";
+/** A pointer-sized document divider using the shared separator's selected state.
+ * @lifecycle The editor owns the node and deletion; destroying the view releases
+ * its Vue app and editability subscription.
+ */
+export declare const dividerNodeView: NodeViewRenderer;

package/vue/editor/expand.d.ts

@@ -0,0 +1,7 @@
+import type { NodeViewRenderer } from "@tiptap/core";
+/**
+ * Composes a section's transient disclosure and saved settings from shared controls.
+ * @lifecycle The content DOM remains owned by ProseMirror; Vue owns surrounding
+ * controls. Unmount removes the app, listeners, and editor subscription.
+ */
+export declare const expandNodeView: NodeViewRenderer;

package/vue/editor/image-controls.d.ts

@@ -0,0 +1,19 @@
+import type { Editor } from "@tiptap/core";
+import { type PropType } from "vue";
+/** One contextual editing bar; sizing belongs to the image's corner handles.
+ * @contract Placement applies immediately. Alt text is a secondary draft with
+ * Save/Cancel; editing another node cancels it rather than changing that node.
+ */
+export declare const ImageControls: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    editor: {
+        type: PropType<Editor>;
+        required: true;
+    };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    editor: {
+        type: PropType<Editor>;
+        required: true;
+    };
+}>> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/vue/editor/image-delivery.d.ts

@@ -1,4 +1,5 @@
 import { Extension, type Editor, type JSONContent } from "@tiptap/core";
+export { normalizeImageDimension } from "../../editor/extensions/image.js";
 /** What caused an overlay to open or close. */
 type OverlayTrigger = "keyboard" | "pointer" | "programmatic";
 /**
@@ -49,8 +50,8 @@ export interface LoomaImageRenditionErrorDetail extends LoomaImageDescriptor {
 }
 interface LoomaImageDeliveryExtensionOptions {
     resolveAttributes: () => LoomaImageAttributeResolver | undefined;
+    isEditable: () => boolean;
 }
-export declare function normalizeImageDimension(value: unknown): number | undefined;
 export declare function imageDescriptorFromAttrs(attrs: Record<string, unknown>): LoomaImageDescriptor | null;
 export declare function createLoomaImageDeliveryController(options: LoomaImageDeliveryExtensionOptions): {
     extension: Extension;
@@ -58,4 +59,3 @@ export declare function createLoomaImageDeliveryController(options: LoomaImageDe
     reset: (editor: Editor) => void;
 };
 export declare function imageUploadContent(image: LoomaImageDescriptor): JSONContent;
-export {};

package/vue/editor/image.d.ts

@@ -0,0 +1,7 @@
+import type { NodeViewRenderer } from "@tiptap/core";
+/** Projects the shared image's resize intent into a single document transaction.
+ * @ownership Delivery decorations belong to the inner image, never the figure;
+ * persisted attributes remain independent of host renditions and drag previews.
+ * @lifecycle Each atom owns a Vue app and an editability subscription.
+ */
+export declare const imageNodeView: NodeViewRenderer;

package/vue/editor/index.d.ts

@@ -1,4 +1,4 @@
 export * from "@threadlabs/looma/editor";
 export * from "./primitives.js";
-export { LoomaEditor, type LoomaEditorToolbarMode, type LoomaLinkTarget, type LoomaLinkSearch, type LoomaLinkResolve, type LoomaImageUploader, type LoomaImageUploadResult, } from "./LoomaEditor.js";
+export { LoomaEditor, type LoomaEditorToolbarMode, type LoomaEditorSlashCommands, type LoomaLinkTarget, type LoomaLinkSearch, type LoomaLinkResolve, type LoomaImageUploader, type LoomaImageUploadResult, } from "./LoomaEditor.js";
 export type { LoomaImageActivationDetail, LoomaImageActivationTrigger, LoomaImageAttributeResolver, LoomaImageDescriptor, LoomaImageRenditionErrorDetail, LoomaImageRenditionAttributes, } from "./image-delivery.js";