@monbolc/lowcode-renderer-core 2.1.5 → 2.1.6

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 monbo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/es/adapter.js

@@ -0,0 +1,124 @@
+/**
+ * @monbolc/lowcode-renderer-core — Adapter
+ *
+ * Singleton that holds the injected framework runtime. Renderers read
+ * from here instead of importing React directly. This keeps
+ * renderer-core framework-agnostic — a Vue or Solid adapter could be
+ * plugged in by setting a different runtime.
+ */
+import { uid } from '@monbolc/lowcode-utils';
+/**
+ * The names of runtime fields that must be present for a runtime to
+ * be considered valid. `findDOMNode` is optional because React 19
+ * removed it.
+ */
+const REQUIRED_RUNTIME_MODULES = [
+    'Component',
+    'PureComponent',
+    'createElement',
+    'createContext',
+    'forwardRef',
+];
+class Adapter {
+    constructor() {
+        this.id = uid('adapter');
+        this.renderers = {};
+        this.env = 'unknown';
+        this.runtime = this.makeStubRuntime();
+    }
+    /**
+     * Install a real runtime. Throws if required modules are missing.
+     */
+    setRuntime(runtime) {
+        if (!this.isValidRuntime(runtime)) {
+            throw new Error(`[adapter:${this.id}] runtime is invalid — missing one of ${REQUIRED_RUNTIME_MODULES.join(', ')}`);
+        }
+        this.runtime = runtime;
+        this.env = 'react'; // best guess; concrete adapter overrides if needed
+    }
+    /**
+     * Reset the runtime to the no-op stub. Useful in tests.
+     */
+    initRuntime() {
+        this.runtime = this.makeStubRuntime();
+        this.env = 'unknown';
+    }
+    /**
+     * Check that all required runtime modules are present (and not null).
+     */
+    isValidRuntime(runtime) {
+        if (!runtime || typeof runtime !== 'object')
+            return false;
+        for (const key of REQUIRED_RUNTIME_MODULES) {
+            if (runtime[key] === undefined || runtime[key] === null) {
+                throw new Error(`[adapter] runtime is missing required module "${key}"`);
+            }
+        }
+        return true;
+    }
+    getRuntime() {
+        return this.runtime;
+    }
+    setEnv(env) {
+        this.env = env;
+    }
+    isReact() {
+        return this.env === 'react';
+    }
+    setRenderers(renderers) {
+        this.renderers = renderers;
+    }
+    getRenderers() {
+        return this.renderers;
+    }
+    setConfigProvider(component) {
+        this.configProvider = component;
+    }
+    getConfigProvider() {
+        return this.configProvider;
+    }
+    /**
+     * Walk the configured renderers and find one whose name matches the
+     * provided schema's `componentName`. Returns `undefined` if no match.
+     */
+    pickRenderer(schema) {
+        const name = schema.componentName ?? '';
+        // Convention: schema.componentName === 'Page' → PageRenderer; etc.
+        if (name === 'Page' || name === 'PageRenderer')
+            return this.renderers.PageRenderer;
+        if (name === 'Block' || name === 'BlockRenderer')
+            return this.renderers.BlockRenderer;
+        if (name === 'Addon' || name === 'AddonRenderer')
+            return this.renderers.AddonRenderer;
+        if (name === 'Temp' || name === 'TempRenderer')
+            return this.renderers.TempRenderer;
+        if (name === 'Div' || name === 'DivRenderer')
+            return this.renderers.DivRenderer;
+        return this.renderers.ComponentRenderer;
+    }
+    /**
+     * A no-op runtime for environments that have not yet injected one
+     * (e.g. during tests, or before the React adapter loads).
+     */
+    makeStubRuntime() {
+        return {
+            Component: class Stub {
+                setState() { }
+                forceUpdate() { }
+                render() { return null; }
+            },
+            PureComponent: class Stub {
+                setState() { }
+                forceUpdate() { }
+                render() { return null; }
+            },
+            createElement: () => null,
+            createContext: () => ({ Provider: () => null, Consumer: () => null }),
+            forwardRef: (fn) => fn,
+            findDOMNode: () => null,
+        };
+    }
+}
+/** Process-wide singleton. */
+export const adapter = new Adapter();
+//# sourceMappingURL=adapter.js.map

package/es/adapter.js.map

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

package/es/base.js

@@ -0,0 +1,53 @@
+/**
+ * @monbolc/lowcode-renderer-core — BaseRenderer
+ *
+ * A thin wrapper around the runtime's `Component` class that handles
+ * common renderer concerns: ref capture, error boundary, child
+ * dispatch. Renderers built on top of this class remain framework-
+ * agnostic because they call `createElement(...)` from the runtime.
+ */
+import { adapter } from './adapter.js';
+/**
+ * Base class for all renderers. Holds the runtime-provided Component
+ * and provides a `render()` that subclasses override.
+ *
+ * Concrete renderers (Page, Component, Block, ...) extend this class
+ * and use the `createElement` from the runtime — they never import
+ * React directly.
+ */
+export class BaseRenderer {
+    constructor(props) {
+        this.state = {};
+        // Lifecycle methods below are typed as plain functions; the runtime
+        // wrapper (React 19, etc.) is responsible for invoking them. This
+        // keeps the base class framework-agnostic.
+        this.setState = () => undefined;
+        this.forceUpdate = () => undefined;
+        /** Capture a ref to this renderer instance, e.g. for editor selection. */
+        this.__getRef = (ref) => {
+            this.__ref = ref;
+            if (ref && this.props.onCompGetRef) {
+                this.props.onCompGetRef(this.props.schema, ref);
+            }
+        };
+        this.props = props;
+    }
+    /** Subclass-overridable render method. */
+    render() {
+        return null;
+    }
+}
+/**
+ * Factory helper: ensure the adapter's runtime is loaded before any
+ * renderer factory is called. Concrete renderers are responsible for
+ * using `createElement` to wrap their render output — they should
+ * NOT subclass the runtime's Component.
+ */
+export function ensureRuntimeLoaded() {
+    const runtime = adapter.getRuntime();
+    if (!runtime.Component) {
+        throw new Error('[renderer-core] no Component in adapter runtime. ' +
+            'Did you forget to call adapter.setRuntime({...})?');
+    }
+}
+//# sourceMappingURL=base.js.map

package/es/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC;;;;;;;GAOG;AACH,MAAM,OAAO,YAAY;IAWvB,YAAY,KAAqB;QATjC,UAAK,GAAmB,EAAE,CAAC;QAG3B,oEAAoE;QACpE,kEAAkE;QAClE,2CAA2C;QAC3C,aAAQ,GAAoE,GAAG,EAAE,CAAC,SAAS,CAAC;QAC5F,gBAAW,GAAoC,GAAG,EAAE,CAAC,SAAS,CAAC;QAoB/D,0EAA0E;QAC1E,aAAQ,GAAG,CAAC,GAAY,EAAE,EAAE;YAC1B,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC;YACjB,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;gBACnC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YAClD,CAAC;QACH,CAAC,CAAC;QAvBA,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,0CAA0C;IAC1C,MAAM;QACJ,OAAO,IAAI,CAAC;IACd,CAAC;CAkBF;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IACrC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,mDAAmD;YACjD,mDAAmD,CACtD,CAAC;IACJ,CAAC;AACH,CAAC"}

package/es/index.js

@@ -0,0 +1,10 @@
+/**
+ * @monbolc/lowcode-renderer-core — barrel export
+ *
+ * SapuLowcodeEngine renderer abstractions (L2). Framework-agnostic — the
+ * concrete React implementation is in @monbolc/lowcode-react-renderer.
+ */
+export { adapter } from './adapter.js';
+export { BaseRenderer, ensureRuntimeLoaded } from './base.js';
+export { PageRenderer, ComponentRenderer, BlockRenderer, AddonRenderer, TempRenderer, DivRenderer, pageRendererFactory, componentRendererFactory, blockRendererFactory, addonRendererFactory, tempRendererFactory, divRendererFactory, } from './renderer.js';
+//# sourceMappingURL=index.js.map

package/es/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAC3D,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,YAAY,EACZ,WAAW,EACX,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/es/renderer.js

@@ -0,0 +1,74 @@
+/**
+ * @monbolc/lowcode-renderer-core — renderer factory functions
+ *
+ * Each factory returns a class that, when instantiated, renders a
+ * particular kind of node from the schema:
+ *   - PageRenderer       — root schema
+ *   - ComponentRenderer  — any non-special node
+ *   - BlockRenderer      — block of components
+ *   - AddonRenderer      — read-only "add-on" node (e.g. comments)
+ *   - TempRenderer       — placeholder / loading
+ *
+ * For now the renderers are minimal stubs that return null. The
+ * concrete React-based implementations live in
+ * @monbolc/lowcode-react-renderer, which calls `adapter.setRenderers(...)`
+ * at boot to install richer versions.
+ */
+import { BaseRenderer } from './base.js';
+/** Renderer for a Page node (root schema). */
+export class PageRenderer extends BaseRenderer {
+    render() {
+        // Real implementation is plugged in by @monbolc/lowcode-react-renderer.
+        return null;
+    }
+}
+/** Renderer for an arbitrary component. */
+export class ComponentRenderer extends BaseRenderer {
+    render() {
+        return null;
+    }
+}
+/** Renderer for a Block (a static block of components, no per-component meta). */
+export class BlockRenderer extends BaseRenderer {
+    render() {
+        return null;
+    }
+}
+/** Renderer for an Addon (a UI overlay, like a comment indicator). */
+export class AddonRenderer extends BaseRenderer {
+    render() {
+        return null;
+    }
+}
+/** Renderer for a Temp placeholder (used while data is loading). */
+export class TempRenderer extends BaseRenderer {
+    render() {
+        return null;
+    }
+}
+/** Renderer for an inert Div fallback. */
+export class DivRenderer extends BaseRenderer {
+    render() {
+        return null;
+    }
+}
+/** Factory form: returns a class. Mostly here for API symmetry. */
+export function pageRendererFactory() {
+    return PageRenderer;
+}
+export function componentRendererFactory() {
+    return ComponentRenderer;
+}
+export function blockRendererFactory() {
+    return BlockRenderer;
+}
+export function addonRendererFactory() {
+    return AddonRenderer;
+}
+export function tempRendererFactory() {
+    return TempRenderer;
+}
+export function divRendererFactory() {
+    return DivRenderer;
+}
+//# sourceMappingURL=renderer.js.map

package/es/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC,8CAA8C;AAC9C,MAAM,OAAO,YAAa,SAAQ,YAAY;IACnC,MAAM;QACb,wEAAwE;QACxE,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,2CAA2C;AAC3C,MAAM,OAAO,iBAAkB,SAAQ,YAAY;IACxC,MAAM;QACb,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,kFAAkF;AAClF,MAAM,OAAO,aAAc,SAAQ,YAAY;IACpC,MAAM;QACb,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,sEAAsE;AACtE,MAAM,OAAO,aAAc,SAAQ,YAAY;IACpC,MAAM;QACb,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,oEAAoE;AACpE,MAAM,OAAO,YAAa,SAAQ,YAAY;IACnC,MAAM;QACb,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,0CAA0C;AAC1C,MAAM,OAAO,WAAY,SAAQ,YAAY;IAClC,MAAM;QACb,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,mEAAmE;AACnE,MAAM,UAAU,mBAAmB;IACjC,OAAO,YAA2C,CAAC;AACrD,CAAC;AACD,MAAM,UAAU,wBAAwB;IACtC,OAAO,iBAAgD,CAAC;AAC1D,CAAC;AACD,MAAM,UAAU,oBAAoB;IAClC,OAAO,aAA4C,CAAC;AACtD,CAAC;AACD,MAAM,UAAU,oBAAoB;IAClC,OAAO,aAA4C,CAAC;AACtD,CAAC;AACD,MAAM,UAAU,mBAAmB;IACjC,OAAO,YAA2C,CAAC;AACrD,CAAC;AACD,MAAM,UAAU,kBAAkB;IAChC,OAAO,WAA0C,CAAC;AACpD,CAAC"}

package/es/types.js

@@ -0,0 +1,8 @@
+/**
+ * @monbolc/lowcode-renderer-core — public types
+ *
+ * Framework-agnostic renderer surface. The actual React (or other
+ * framework) primitives are injected at runtime via `adapter.setRuntime()`.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/es/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@monbolc/lowcode-renderer-core",
-  "version": "2.1.5",
+  "version": "2.1.6",
   "description": "Framework-agnostic renderer core with React-runtime adapter for SapuLowcodeEngine (L2)",
   "license": "MIT",
   "main": "lib/index.js",
@@ -15,12 +15,14 @@
   },
   "files": [
     "lib",
-    "es"
+    "es",
+    "LICENSE"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.json",
+    "build": "npm run build:cjs && npm run build:es",
     "build:es": "tsc -p tsconfig.esm.json && node ../../scripts/add-js-extensions.mjs es",
-    "clean": "rimraf lib es"
+    "clean": "rimraf lib es",
+    "build:cjs": "tsc -p tsconfig.json"
   },
   "dependencies": {
     "@monbolc/lowcode-types": "^2.1.5",
@@ -61,5 +63,5 @@
     "renderer",
     "react"
   ],
-  "gitHead": "b23c688931a9afae9f3fc05308d587a2c053f983"
+  "gitHead": "11e98f766bf66eabdae929d0103f798654f13dfb"
 }