@kabel-project/kabel 1.0.7 → 1.0.9

package/{src/inject.ts → dist/src/inject.d.ts}

@@ -1,213 +1,142 @@
-import WorkspaceController from "../controllers/base";
-import Renderer from "../renderers/renderer";
-import { clearMainWorkspace, getMainWorkspace, setMainWorkspace } from "./main-workspace";
-import WorkspaceSvg, { WSTheme } from "./workspace-svg";
-import NodePrototypes from "./prototypes"; // Object
-import { FieldOptions } from "./field";
-import { Color, Hex } from "./visual-types";
-import styler from '../util/styler';
-// @ts-ignore
-import _kabelStyles from './styles.css';
-import env from "../util/env";
-
-const kabelStyles: string = _kabelStyles;
-
-/**
- * Represents a field in a toolbox node.
- * Can contain any extra properties as needed by the field type.
- */
-export interface TblxFieldStruct {
-    /** Field value */
-    value: any;
-
-    /** Additional field-specific properties */
-    [key: string]: any;
-}
-
-/**
- * Represents a node in a toolbox.
- */
-export interface TblxNodeStruct {
-    /** Node type (matches NodePrototypes key or arbitrary string) */
-    type: keyof typeof NodePrototypes | string;
-
-    /** Map of field names to field data */
-    arguments: {
-        [key: string]: TblxFieldStruct;
-    };
-}
-
-/**
- * Represents a category in the toolbox, which contains multiple nodes.
- */
-export interface TblxCategoryStruct {
-    /** Category name */
-    name: string;
-
-    /** Category color */
-    color: Color;
-
-    /** Nodes contained in this category */
-    contents: TblxNodeStruct[];
-}
-
-/**
- * Discriminated union type representing possible toolbox structures.
- * Can be a flyout (list of nodes) or a categorized toolbox.
- */
-export type TblxObjStruct =
-    | {
-        /** Flyout toolbox type */
-        type: 'flyout';
-        contents: TblxNodeStruct[];
-    }
-    | {
-        /** Categorized toolbox type */
-        type?: 'category';
-        contents: TblxCategoryStruct[];
-    }
-    | {
-        /** When type is omitted, defaults to categories */
-        type?: undefined;
-        contents: TblxCategoryStruct[];
-    };
-export interface GridOptions {
-    /**
-     * The grid's type.
-     * 'celled' - The grid is celled.
-     * 'dotted' - The grid is dotted.
-     */
-	type: 'celled' | 'dotted';
-    /**
-     * Spacing, optional. Default is 40.
-     */
-	spacing?: number;
-    /**
-     * Dot size for 'dotted' grid type.
-     */
-	dotSize?: number;
-    /**
-     * stroke width for 'celled' grid type.
-     */
-	strokeWidth?: number;
-    /**
-     * Option color for any grid type. Color is #bebebeff by default.
-     */
-    color?: Hex
-}
-/**
- * Options used when injecting a new workspace.
- */
-export interface InjectOptions {
-    /** Optional renderer overrides */
-    rendererOverrides?: { [key: string]: any };
-    /** Theme for the workspace */
-    theme?: string|WSTheme;
-    /** Optional custom controller class */
-    Controller?: typeof WorkspaceController;
-    /** Init the workspace's undo state for you, or not. */
-    initUndoRedo?: boolean;
-    /** Optional controls configuration */
-    controls?: {
-        zoomSpeed?: number;
-        minZoom?: number;
-        maxZoom?: number;
-        wasd?: boolean;
-        wasdSmooth?: boolean;
-        wasdAccelerate?: number;
-        wasdFriction?: number;
-    };
-
-    /** Optional toolbox structure */
-    toolbox?: TblxObjStruct;
-
-    /** Optional movement speed of the workspace */
-    moveSpeed?: number;
-
-    /** Optional renderer: name string or class */
-    renderer?: string | typeof Renderer;
-    /**
-     * Optional grid settings.
-     */
-    grid?: GridOptions;
-}
-
-/**
- * Utility class for logging injection messages in a structured way.
- */
-export class InjectMsg {
-    /** Message content */
-    msg: string;
-
-    /**
-     * Creates a new InjectMsg instance.
-     * @param msg - Message text
-     */
-    constructor(msg: string) {
-        this.msg = msg;
-    }
-
-    /** Log as error */
-    err() {
-        console.error(`Failed to inject workspace: ${this.msg}`);
-    }
-
-    /** Log as warning */
-    wrn() {
-        console.warn(`Inject warning: ${this.msg}`);
-    }
-
-    /** Log as info */
-    info() {
-        console.info(`Inject info: ${this.msg}`);
-    }
-}
-
-/**
- * Injects a new Kabel workspace into the document.
- * Appends the workspace container to the given element (or element ID) and
- * sets it as the main workspace.
- *
- * @param element - HTMLElement or string ID to attach the workspace to
- * @param options - Optional InjectOptions to configure the workspace
- * @returns The newly created WorkspaceSvg instance, or undefined if injection failed
- */
-export default function inject(
-    element: HTMLElement | string,
-    options: InjectOptions = {}
-): WorkspaceSvg | undefined {
-    if (!env.isBrowser) {
-        new InjectMsg(`Cannot inject workspace-svg in non-browser environment (use Kabel.injectHeadless).`).err();
-        return;
-    }
-    // Apply global Kabel styles
-    styler.appendStyles('KabelStyles', kabelStyles);
-
-    const root =
-        typeof element === 'string'
-            ? document.querySelector(`#${element}`) as HTMLElement
-            : element as HTMLElement;
-
-    if (!root) {
-        new InjectMsg(`Document does not contain root element (Check element ID).`).err();
-        return;
-    }
-
-    if (!document.contains(root)) {
-        new InjectMsg(`Document does not contain root element.`).err();
-        return;
-    }
-
-    // Create workspace wrapper element
-    const wsTop = document.createElement('div');
-    wsTop.className = `KabelWorkspaceWrapper`;
-    root.appendChild(wsTop);
-
-    // Initialize workspace
-    const ws = new WorkspaceSvg(root, wsTop, options);
-
-    // Set as the main workspace globally
-    setMainWorkspace(ws);
-
-    return ws;
-}
+import WorkspaceController from "../controllers/base";
+import Renderer from "../renderers/renderer";
+import WorkspaceSvg, { WSTheme } from "./workspace-svg";
+import NodePrototypes from "./prototypes";
+import { Color, Hex } from "./visual-types";
+/**
+ * Represents a field in a toolbox node.
+ * Can contain any extra properties as needed by the field type.
+ */
+export interface TblxFieldStruct {
+    /** Field value */
+    value: any;
+    /** Additional field-specific properties */
+    [key: string]: any;
+}
+/**
+ * Represents a node in a toolbox.
+ */
+export interface TblxNodeStruct {
+    /** Node type (matches NodePrototypes key or arbitrary string) */
+    type: keyof typeof NodePrototypes | string;
+    /** Map of field names to field data */
+    arguments: {
+        [key: string]: TblxFieldStruct;
+    };
+}
+/**
+ * Represents a category in the toolbox, which contains multiple nodes.
+ */
+export interface TblxCategoryStruct {
+    /** Category name */
+    name: string;
+    /** Category color */
+    color: Color;
+    /** Nodes contained in this category */
+    contents: TblxNodeStruct[];
+}
+/**
+ * Discriminated union type representing possible toolbox structures.
+ * Can be a flyout (list of nodes) or a categorized toolbox.
+ */
+export type TblxObjStruct = {
+    /** Flyout toolbox type */
+    type: 'flyout';
+    contents: TblxNodeStruct[];
+} | {
+    /** Categorized toolbox type */
+    type?: 'category';
+    contents: TblxCategoryStruct[];
+} | {
+    /** When type is omitted, defaults to categories */
+    type?: undefined;
+    contents: TblxCategoryStruct[];
+};
+export interface GridOptions {
+    /**
+     * The grid's type.
+     * 'celled' - The grid is celled.
+     * 'dotted' - The grid is dotted.
+     */
+    type: 'celled' | 'dotted';
+    /**
+     * Spacing, optional. Default is 40.
+     */
+    spacing?: number;
+    /**
+     * Dot size for 'dotted' grid type.
+     */
+    dotSize?: number;
+    /**
+     * stroke width for 'celled' grid type.
+     */
+    strokeWidth?: number;
+    /**
+     * Option color for any grid type. Color is #bebebeff by default.
+     */
+    color?: Hex;
+}
+/**
+ * Options used when injecting a new workspace.
+ */
+export interface InjectOptions {
+    /** Optional renderer overrides */
+    rendererOverrides?: {
+        [key: string]: any;
+    };
+    /** Theme for the workspace */
+    theme?: string | WSTheme;
+    /** Optional custom controller class */
+    Controller?: typeof WorkspaceController;
+    /** Init the workspace's undo state for you, or not. */
+    initUndoRedo?: boolean;
+    /** Optional controls configuration */
+    controls?: {
+        zoomSpeed?: number;
+        minZoom?: number;
+        maxZoom?: number;
+        wasd?: boolean;
+        wasdSmooth?: boolean;
+        wasdAccelerate?: number;
+        wasdFriction?: number;
+    };
+    /** Optional toolbox structure */
+    toolbox?: TblxObjStruct;
+    /** Optional movement speed of the workspace */
+    moveSpeed?: number;
+    /** Optional renderer: name string or class */
+    renderer?: string | typeof Renderer;
+    /**
+     * Optional grid settings.
+     */
+    grid?: GridOptions;
+}
+/**
+ * Utility class for logging injection messages in a structured way.
+ */
+export declare class InjectMsg {
+    /** Message content */
+    msg: string;
+    /**
+     * Creates a new InjectMsg instance.
+     * @param msg - Message text
+     */
+    constructor(msg: string);
+    /** Log as error */
+    err(): void;
+    /** Log as warning */
+    wrn(): void;
+    /** Log as info */
+    info(): void;
+}
+/**
+ * Injects a new Kabel workspace into the document.
+ * Appends the workspace container to the given element (or element ID) and
+ * sets it as the main workspace.
+ *
+ * @param element - HTMLElement or string ID to attach the workspace to
+ * @param options - Optional InjectOptions to configure the workspace
+ * @returns The newly created WorkspaceSvg instance, or undefined if injection failed
+ */
+export default function inject(element: HTMLElement | string, options?: InjectOptions): WorkspaceSvg | undefined;
+//# sourceMappingURL=inject.d.ts.map

package/dist/src/inject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject.d.ts","sourceRoot":"","sources":["../../src/inject.ts"],"names":[],"mappings":"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"}

package/{src/main-workspace.ts → dist/src/main-workspace.d.ts}

@@ -1,51 +1,31 @@
-import Workspace from "./workspace";
-import WorkspaceSvg from "./workspace-svg";
-
-/**
- * Holds a reference to the main WorkspaceSvg instance.
- * Mimics Blockly's getMainWorkspace API for Kabel.
- */
-let mainws: WorkspaceSvg | Workspace | null = null;
-
-/**
- * Returns the current main workspace instance.
- * 
- * @returns The main WorkspaceSvg or null if none is set.
- */
-function getMainWorkspace(): WorkspaceSvg | Workspace | null {
-    return mainws;
-}
-
-/**
- * Sets the main workspace reference.
- * Calling this updates the global "main workspace" for Kabel.
- * 
- * @param ws - The WorkspaceSvg instance to set as main, or null to clear.
- * @returns The workspace that was set.
- */
-function setMainWorkspace(ws: WorkspaceSvg | Workspace | null) {
-    return (mainws = ws);
-}
-
-/**
- * Clears the main workspace reference.
- * After calling, getMainWorkspace() will return null.
- * 
- * @returns Always returns null.
- */
-function clearMainWorkspace() {
-    return (mainws = null);
-}
-
-export {
-    getMainWorkspace,
-    setMainWorkspace,
-    clearMainWorkspace
-};
-
-/**
- * Note:
- * This mimics the Blockly.getMainWorkspace API.
- * When you inject a new workspace in Kabel, calling setMainWorkspace
- * sets the global main workspace reference, so you can easily retrieve it later.
- */
+import Workspace from "./workspace";
+import WorkspaceSvg from "./workspace-svg";
+/**
+ * Returns the current main workspace instance.
+ *
+ * @returns The main WorkspaceSvg or null if none is set.
+ */
+declare function getMainWorkspace(): WorkspaceSvg | Workspace | null;
+/**
+ * Sets the main workspace reference.
+ * Calling this updates the global "main workspace" for Kabel.
+ *
+ * @param ws - The WorkspaceSvg instance to set as main, or null to clear.
+ * @returns The workspace that was set.
+ */
+declare function setMainWorkspace(ws: WorkspaceSvg | Workspace | null): WorkspaceSvg | Workspace | null;
+/**
+ * Clears the main workspace reference.
+ * After calling, getMainWorkspace() will return null.
+ *
+ * @returns Always returns null.
+ */
+declare function clearMainWorkspace(): null;
+export { getMainWorkspace, setMainWorkspace, clearMainWorkspace };
+/**
+ * Note:
+ * This mimics the Blockly.getMainWorkspace API.
+ * When you inject a new workspace in Kabel, calling setMainWorkspace
+ * sets the global main workspace reference, so you can easily retrieve it later.
+ */
+//# sourceMappingURL=main-workspace.d.ts.map

package/dist/src/main-workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main-workspace.d.ts","sourceRoot":"","sources":["../../src/main-workspace.ts"],"names":[],"mappings":"AAAA,OAAO,SAAS,MAAM,aAAa,CAAC;AACpC,OAAO,YAAY,MAAM,iBAAiB,CAAC;AAQ3C;;;;GAIG;AACH,iBAAS,gBAAgB,IAAI,YAAY,GAAG,SAAS,GAAG,IAAI,CAE3D;AAED;;;;;;GAMG;AACH,iBAAS,gBAAgB,CAAC,EAAE,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI,mCAE5D;AAED;;;;;GAKG;AACH,iBAAS,kBAAkB,SAE1B;AAED,OAAO,EACH,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EACrB,CAAC;AAEF;;;;;GAKG"}

package/dist/src/mutator.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=mutator.d.ts.map

package/dist/src/mutator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutator.d.ts","sourceRoot":"","sources":["../../src/mutator.ts"],"names":[],"mappings":""}

package/{src/node-types.ts → dist/src/node-types.d.ts}

@@ -1,27 +1,26 @@
-import NodeSvg from "./nodesvg";
-
-/**
- * Represents a prototype definition for a NodeSvg.
- * Prototypes define behavior for initialization and removal of nodes.
- */
-export interface NodePrototype {
-    /**
-     * Called when a node is initialized.
-     * Use this to set up fields, connections, or any runtime state for the node.
-     * 
-     * @param this - The NodeSvg instance being initialized
-     * @param prototype - The prototype object itself
-     * @param block - The NodeSvg instance (same as `this`) for convenience
-     */
-    init: (this: NodeSvg, prototype: NodePrototype, block: NodeSvg) => void;
-
-    /**
-     * Called when a node is being removed from the workspace.
-     * Use this to clean up references, event listeners, or related resources.
-     * 
-     * @param this - The NodeSvg instance being removed
-     * @param prototype - The prototype object itself
-     * @param block - The NodeSvg instance (same as `this`) for convenience
-     */
-    removed: (this: NodeSvg, prototype: NodePrototype, block: NodeSvg) => void;
-}
+import NodeSvg from "./nodesvg";
+/**
+ * Represents a prototype definition for a NodeSvg.
+ * Prototypes define behavior for initialization and removal of nodes.
+ */
+export interface NodePrototype {
+    /**
+     * Called when a node is initialized.
+     * Use this to set up fields, connections, or any runtime state for the node.
+     *
+     * @param this - The NodeSvg instance being initialized
+     * @param prototype - The prototype object itself
+     * @param block - The NodeSvg instance (same as `this`) for convenience
+     */
+    init: (this: NodeSvg, prototype: NodePrototype, block: NodeSvg) => void;
+    /**
+     * Called when a node is being removed from the workspace.
+     * Use this to clean up references, event listeners, or related resources.
+     *
+     * @param this - The NodeSvg instance being removed
+     * @param prototype - The prototype object itself
+     * @param block - The NodeSvg instance (same as `this`) for convenience
+     */
+    removed: (this: NodeSvg, prototype: NodePrototype, block: NodeSvg) => void;
+}
+//# sourceMappingURL=node-types.d.ts.map

package/dist/src/node-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-types.d.ts","sourceRoot":"","sources":["../../src/node-types.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,WAAW,CAAC;AAEhC;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC1B;;;;;;;OAOG;IACH,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IAExE;;;;;;;OAOG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC9E"}