@clepit/core 0.3.0-beta.339 → 0.4.0-beta.340

package/dist/types.d.ts

@@ -818,12 +818,31 @@ export interface BlockTune {
     save: (element: HTMLElement) => BlockTuneData;
 }
 export type UploadFunction = (file: File) => Promise<string>;
-export type BlockTuneData = {
-    [key: string]: string | number | boolean | null | undefined;
-};
+/**
+ * One tune's value.
+ *
+ * Flat, because every path that reads or writes a tune treats it as a scalar: `getBlockTunes` reads
+ * `data-value` off the DOM, the renderer writes `String(value)` into an attribute, and the server's
+ * block reconciler round-trips `{"align": "center"}` through `__tunes`.
+ */
+export type BlockTuneValue = string | number | boolean | null | undefined;
+/**
+ * A block's tunes.
+ *
+ * NARROWED 2026-08-27. This was declared as `{ [key: string]: BlockTuneData }`, one level deeper
+ * than anything that has ever written or read it, and three `as` casts existed only to get the flat
+ * runtime shape past it. A nested value reached the renderer as `String(object)` and rendered
+ * `[object Object]`. The per-tune data bag existed for the `BlockTune` interface, which has zero
+ * implementations in either the TypeScript or the Dart port.
+ */
 export type BlockTunes = {
-    [key: string]: BlockTuneData;
+    [key: string]: BlockTuneValue;
 };
+/**
+ * @deprecated The nested per-tune bag the old `BlockTunes` pointed at. Nothing implements it; kept
+ * as an alias for one release so an external consumer's import does not fail to resolve.
+ */
+export type BlockTuneData = BlockTunes;
 export type BlockTypeOutputConfigs = {
     [K in ToolType]: OutputConfig;
 };
@@ -914,7 +933,7 @@ export type EditorAPI = {
     blocks: {
         getAll: () => Block[];
         get: (blockId: string) => Block | null;
-        insert: <T extends BlockToolType>(type: T, data: Block<T>['data'], index: number) => HTMLElement | null;
+        insert: <T extends BlockToolType>(type: T, data: Block<T>['data'], index: number, id?: string) => HTMLElement | null;
         update: <T extends BlockToolType>(blockId: string, data: Block<T>['data']) => void;
         remove: (index: number) => void;
         move: (fromIndex: number, toIndex: number) => void;

package/package.json

@@ -53,5 +53,5 @@
   },
   "sideEffects": false,
   "types": "dist/index.d.ts",
-  "version": "0.3.0-beta.339"
+  "version": "0.4.0-beta.340"
 }