lumiverse-spindle-types 0.6.3 → 0.6.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lumiverse-spindle-types",
-  "version": "0.6.3",
+  "version": "0.6.4",
   "types": "./src/index.ts",
   "keywords": [
     "lumiverse",

package/src/components.ts

@@ -22,6 +22,33 @@
  * Components inherit the active Lumiverse theme via CSS variables, so they
  * visually match the rest of the host UI without any additional wiring.
  */
+import type { PromptBlockDTO, PromptVariableValuesDTO } from "./api";
+
+// ──────────────────────────────────────────────────────────────────────────
+// Loom block editor
+// ──────────────────────────────────────────────────────────────────────────
+
+/** Editable public value rendered by the native Loom block editor. */
+export interface SpindleLoomBlockEditorValue {
+  blocks: PromptBlockDTO[];
+  promptVariableValues: PromptVariableValuesDTO;
+}
+
+/** Controlled options for the native Loom block editor. */
+export interface SpindleLoomBlockEditorOptions {
+  value: SpindleLoomBlockEditorValue;
+  onChange?: (value: SpindleLoomBlockEditorValue) => void;
+  readOnly?: boolean;
+  compact?: boolean;
+}
+
+/** Handle returned by `mountLoomBlockEditor`. */
+export interface SpindleLoomBlockEditorHandle
+  extends SpindleMountedComponent<SpindleLoomBlockEditorOptions> {
+  getValue(): SpindleLoomBlockEditorValue;
+  refreshMacros(): Promise<void>;
+}
+
 
 // ──────────────────────────────────────────────────────────────────────────
 // Shared base shapes
@@ -39,10 +66,7 @@ export interface SpindleMountedComponent<TOptions> {
   readonly componentId: string;
   /** The container element the component was mounted into. Same node passed as `target`. */
   readonly element: HTMLElement;
-  /**
-   * Merge a partial set of options into the live component. Pass any subset of
-   * the original mount options — undefined fields are ignored.
-   */
+  /** Merge supplied option fields into the live component. Omitted fields remain unchanged. */
   update(patch: Partial<TOptions>): void;
   /** Unmount the React tree and release host resources. The target element is left in place. */
   destroy(): void;
@@ -655,4 +679,9 @@ export interface SpindleComponentsHelper {
   mountCollapsibleSection(target: SpindleComponentTarget, options: SpindleCollapsibleSectionOptions): SpindleCollapsibleSectionHandle;
   mountPagination(target: SpindleComponentTarget, options: SpindlePaginationOptions): SpindlePaginationHandle;
   mountCloseButton(target: SpindleComponentTarget, options?: SpindleCloseButtonOptions): SpindleCloseButtonHandle;
+  // Loom editor
+  mountLoomBlockEditor(
+    target: SpindleComponentTarget,
+    options: SpindleLoomBlockEditorOptions,
+  ): SpindleLoomBlockEditorHandle;
 }

package/src/index.ts

@@ -319,6 +319,9 @@ export type {
   SpindlePaginationHandle,
   SpindleCloseButtonOptions,
   SpindleCloseButtonHandle,
+  SpindleLoomBlockEditorValue,
+  SpindleLoomBlockEditorOptions,
+  SpindleLoomBlockEditorHandle,
   SpindleComponentsHelper,
 } from "./components";
 

package/test/loom-block-editor-consumer.ts

@@ -0,0 +1,39 @@
+import type {
+  SpindleComponentTarget,
+  SpindleComponentsHelper,
+  SpindleLoomBlockEditorHandle,
+  SpindleLoomBlockEditorOptions,
+  SpindleLoomBlockEditorValue,
+} from "lumiverse-spindle-types";
+
+/**
+ * Package-root consumer fixture: this function is never called at runtime.
+ * Its body intentionally exercises the complete controlled Loom editor API so
+ * a consumer is checked against the package entry point rather than an
+ * internal source module.
+ */
+export function compileLoomBlockEditorContract(
+  helper: SpindleComponentsHelper,
+  target: SpindleComponentTarget,
+  options: SpindleLoomBlockEditorOptions,
+): Promise<void> {
+  const handle: SpindleLoomBlockEditorHandle = helper.mountLoomBlockEditor(target, options);
+  const initial: SpindleLoomBlockEditorValue = handle.getValue();
+
+  handle.update({
+    value: initial,
+    onChange: (next: SpindleLoomBlockEditorValue) => {
+      const checked: SpindleLoomBlockEditorValue = next;
+      void checked;
+    },
+    readOnly: !options.readOnly,
+    compact: !options.compact,
+  });
+
+  const updated: SpindleLoomBlockEditorValue = handle.getValue();
+  const refreshed: Promise<void> = handle.refreshMacros();
+  handle.destroy();
+
+  void updated;
+  return refreshed;
+}

package/tsconfig.consumer.json

@@ -0,0 +1,9 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "rootDir": ".",
+    "outDir": "./.consumer-dist",
+    "declaration": false
+  },
+  "include": ["test/loom-block-editor-consumer.ts"]
+}

package/tsconfig.json

@@ -6,7 +6,8 @@
     "strict": true,
     "declaration": true,
     "skipLibCheck": true,
-    "outDir": "./dist"
+    "outDir": "./dist",
+    "rootDir": "./src"
   },
   "include": ["src"]
 }