@monbolc/lowcode-renderer-core 2.0.0

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/lib/adapter.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @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 type { IConfigProvider, IRenderComponent, IRendererModules, IRuntime } from './types';
+declare class Adapter {
+    readonly id: string;
+    runtime: IRuntime;
+    renderers: Partial<IRendererModules>;
+    configProvider?: IConfigProvider;
+    env: 'react' | 'unknown';
+    constructor();
+    /**
+     * Install a real runtime. Throws if required modules are missing.
+     */
+    setRuntime(runtime: IRuntime): void;
+    /**
+     * Reset the runtime to the no-op stub. Useful in tests.
+     */
+    initRuntime(): void;
+    /**
+     * Check that all required runtime modules are present (and not null).
+     */
+    isValidRuntime(runtime: IRuntime): boolean;
+    getRuntime(): IRuntime;
+    setEnv(env: 'react' | 'unknown'): void;
+    isReact(): boolean;
+    setRenderers(renderers: Partial<IRendererModules>): void;
+    getRenderers(): Partial<IRendererModules>;
+    setConfigProvider(component: IConfigProvider): void;
+    getConfigProvider(): IConfigProvider | undefined;
+    /**
+     * Walk the configured renderers and find one whose name matches the
+     * provided schema's `componentName`. Returns `undefined` if no match.
+     */
+    pickRenderer(schema: {
+        componentName?: string;
+    }): IRenderComponent | undefined;
+    /**
+     * A no-op runtime for environments that have not yet injected one
+     * (e.g. during tests, or before the React adapter loads).
+     */
+    private makeStubRuntime;
+}
+/** Process-wide singleton. */
+export declare const adapter: Adapter;
+export {};

package/lib/adapter.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * @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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.adapter = void 0;
+const lowcode_utils_1 = require("@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 = (0, lowcode_utils_1.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. */
+exports.adapter = new Adapter();
+//# sourceMappingURL=adapter.js.map

package/lib/adapter.js.map

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

package/lib/base.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @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 type { IRendererProps, IRendererState } from './types';
+/**
+ * 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 declare class BaseRenderer {
+    props: IRendererProps;
+    state: IRendererState;
+    __ref: unknown;
+    setState: (state: Partial<IRendererState>, callback?: () => void) => void;
+    forceUpdate: (callback?: () => void) => void;
+    constructor(props: IRendererProps);
+    /** Subclass-overridable render method. */
+    render(): unknown;
+    /** Called when the renderer is about to mount. */
+    componentDidMount?(): void | Promise<void>;
+    /** Called after every re-render. */
+    componentDidUpdate?(prevProps: IRendererProps): void | Promise<void>;
+    /** Called before unmount. */
+    componentWillUnmount?(): void | Promise<void>;
+    /** Error boundary hook. */
+    componentDidCatch?(error: unknown): void;
+    /** Capture a ref to this renderer instance, e.g. for editor selection. */
+    __getRef: (ref: unknown) => void;
+}
+/**
+ * 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 declare function ensureRuntimeLoaded(): void;

package/lib/base.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * @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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseRenderer = void 0;
+exports.ensureRuntimeLoaded = ensureRuntimeLoaded;
+const adapter_1 = require("./adapter");
+/**
+ * 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.
+ */
+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;
+    }
+}
+exports.BaseRenderer = BaseRenderer;
+/**
+ * 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.
+ */
+function ensureRuntimeLoaded() {
+    const runtime = adapter_1.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/lib/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AA6DH,kDAQC;AAnED,uCAAoC;AAOpC;;;;;;;GAOG;AACH,MAAa,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;AApCD,oCAoCC;AAED;;;;;GAKG;AACH,SAAgB,mBAAmB;IACjC,MAAM,OAAO,GAAG,iBAAO,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/lib/index.d.ts

@@ -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';
+export { BaseRenderer, ensureRuntimeLoaded } from './base';
+export { PageRenderer, ComponentRenderer, BlockRenderer, AddonRenderer, TempRenderer, DivRenderer, pageRendererFactory, componentRendererFactory, blockRendererFactory, addonRendererFactory, tempRendererFactory, divRendererFactory, } from './renderer';
+export type { IConfigProvider, IRenderComponent, IRendererModules, IRendererProps, IRendererState, IRuntime, } from './types';

package/lib/index.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * @monbolc/lowcode-renderer-core — barrel export
+ *
+ * SapuLowcodeEngine renderer abstractions (L2). Framework-agnostic — the
+ * concrete React implementation is in @monbolc/lowcode-react-renderer.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.divRendererFactory = exports.tempRendererFactory = exports.addonRendererFactory = exports.blockRendererFactory = exports.componentRendererFactory = exports.pageRendererFactory = exports.DivRenderer = exports.TempRenderer = exports.AddonRenderer = exports.BlockRenderer = exports.ComponentRenderer = exports.PageRenderer = exports.ensureRuntimeLoaded = exports.BaseRenderer = exports.adapter = void 0;
+var adapter_1 = require("./adapter");
+Object.defineProperty(exports, "adapter", { enumerable: true, get: function () { return adapter_1.adapter; } });
+var base_1 = require("./base");
+Object.defineProperty(exports, "BaseRenderer", { enumerable: true, get: function () { return base_1.BaseRenderer; } });
+Object.defineProperty(exports, "ensureRuntimeLoaded", { enumerable: true, get: function () { return base_1.ensureRuntimeLoaded; } });
+var renderer_1 = require("./renderer");
+Object.defineProperty(exports, "PageRenderer", { enumerable: true, get: function () { return renderer_1.PageRenderer; } });
+Object.defineProperty(exports, "ComponentRenderer", { enumerable: true, get: function () { return renderer_1.ComponentRenderer; } });
+Object.defineProperty(exports, "BlockRenderer", { enumerable: true, get: function () { return renderer_1.BlockRenderer; } });
+Object.defineProperty(exports, "AddonRenderer", { enumerable: true, get: function () { return renderer_1.AddonRenderer; } });
+Object.defineProperty(exports, "TempRenderer", { enumerable: true, get: function () { return renderer_1.TempRenderer; } });
+Object.defineProperty(exports, "DivRenderer", { enumerable: true, get: function () { return renderer_1.DivRenderer; } });
+Object.defineProperty(exports, "pageRendererFactory", { enumerable: true, get: function () { return renderer_1.pageRendererFactory; } });
+Object.defineProperty(exports, "componentRendererFactory", { enumerable: true, get: function () { return renderer_1.componentRendererFactory; } });
+Object.defineProperty(exports, "blockRendererFactory", { enumerable: true, get: function () { return renderer_1.blockRendererFactory; } });
+Object.defineProperty(exports, "addonRendererFactory", { enumerable: true, get: function () { return renderer_1.addonRendererFactory; } });
+Object.defineProperty(exports, "tempRendererFactory", { enumerable: true, get: function () { return renderer_1.tempRendererFactory; } });
+Object.defineProperty(exports, "divRendererFactory", { enumerable: true, get: function () { return renderer_1.divRendererFactory; } });
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAChB,+BAA2D;AAAlD,oGAAA,YAAY,OAAA;AAAE,2GAAA,mBAAmB,OAAA;AAC1C,uCAaoB;AAZlB,wGAAA,YAAY,OAAA;AACZ,6GAAA,iBAAiB,OAAA;AACjB,yGAAA,aAAa,OAAA;AACb,yGAAA,aAAa,OAAA;AACb,wGAAA,YAAY,OAAA;AACZ,uGAAA,WAAW,OAAA;AACX,+GAAA,mBAAmB,OAAA;AACnB,oHAAA,wBAAwB,OAAA;AACxB,gHAAA,oBAAoB,OAAA;AACpB,gHAAA,oBAAoB,OAAA;AACpB,+GAAA,mBAAmB,OAAA;AACnB,8GAAA,kBAAkB,OAAA"}

package/lib/renderer.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @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';
+import type { IRenderComponent } from './types';
+/** Renderer for a Page node (root schema). */
+export declare class PageRenderer extends BaseRenderer {
+    render(): null;
+}
+/** Renderer for an arbitrary component. */
+export declare class ComponentRenderer extends BaseRenderer {
+    render(): null;
+}
+/** Renderer for a Block (a static block of components, no per-component meta). */
+export declare class BlockRenderer extends BaseRenderer {
+    render(): null;
+}
+/** Renderer for an Addon (a UI overlay, like a comment indicator). */
+export declare class AddonRenderer extends BaseRenderer {
+    render(): null;
+}
+/** Renderer for a Temp placeholder (used while data is loading). */
+export declare class TempRenderer extends BaseRenderer {
+    render(): null;
+}
+/** Renderer for an inert Div fallback. */
+export declare class DivRenderer extends BaseRenderer {
+    render(): null;
+}
+/** Factory form: returns a class. Mostly here for API symmetry. */
+export declare function pageRendererFactory(): IRenderComponent;
+export declare function componentRendererFactory(): IRenderComponent;
+export declare function blockRendererFactory(): IRenderComponent;
+export declare function addonRendererFactory(): IRenderComponent;
+export declare function tempRendererFactory(): IRenderComponent;
+export declare function divRendererFactory(): IRenderComponent;

package/lib/renderer.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * @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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DivRenderer = exports.TempRenderer = exports.AddonRenderer = exports.BlockRenderer = exports.ComponentRenderer = exports.PageRenderer = void 0;
+exports.pageRendererFactory = pageRendererFactory;
+exports.componentRendererFactory = componentRendererFactory;
+exports.blockRendererFactory = blockRendererFactory;
+exports.addonRendererFactory = addonRendererFactory;
+exports.tempRendererFactory = tempRendererFactory;
+exports.divRendererFactory = divRendererFactory;
+const base_1 = require("./base");
+/** Renderer for a Page node (root schema). */
+class PageRenderer extends base_1.BaseRenderer {
+    render() {
+        // Real implementation is plugged in by @monbolc/lowcode-react-renderer.
+        return null;
+    }
+}
+exports.PageRenderer = PageRenderer;
+/** Renderer for an arbitrary component. */
+class ComponentRenderer extends base_1.BaseRenderer {
+    render() {
+        return null;
+    }
+}
+exports.ComponentRenderer = ComponentRenderer;
+/** Renderer for a Block (a static block of components, no per-component meta). */
+class BlockRenderer extends base_1.BaseRenderer {
+    render() {
+        return null;
+    }
+}
+exports.BlockRenderer = BlockRenderer;
+/** Renderer for an Addon (a UI overlay, like a comment indicator). */
+class AddonRenderer extends base_1.BaseRenderer {
+    render() {
+        return null;
+    }
+}
+exports.AddonRenderer = AddonRenderer;
+/** Renderer for a Temp placeholder (used while data is loading). */
+class TempRenderer extends base_1.BaseRenderer {
+    render() {
+        return null;
+    }
+}
+exports.TempRenderer = TempRenderer;
+/** Renderer for an inert Div fallback. */
+class DivRenderer extends base_1.BaseRenderer {
+    render() {
+        return null;
+    }
+}
+exports.DivRenderer = DivRenderer;
+/** Factory form: returns a class. Mostly here for API symmetry. */
+function pageRendererFactory() {
+    return PageRenderer;
+}
+function componentRendererFactory() {
+    return ComponentRenderer;
+}
+function blockRendererFactory() {
+    return BlockRenderer;
+}
+function addonRendererFactory() {
+    return AddonRenderer;
+}
+function tempRendererFactory() {
+    return TempRenderer;
+}
+function divRendererFactory() {
+    return DivRenderer;
+}
+//# sourceMappingURL=renderer.js.map

package/lib/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../src/renderer.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;AAiDH,kDAEC;AACD,4DAEC;AACD,oDAEC;AACD,oDAEC;AACD,kDAEC;AACD,gDAEC;AAhED,iCAAsC;AAGtC,8CAA8C;AAC9C,MAAa,YAAa,SAAQ,mBAAY;IACnC,MAAM;QACb,wEAAwE;QACxE,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AALD,oCAKC;AAED,2CAA2C;AAC3C,MAAa,iBAAkB,SAAQ,mBAAY;IACxC,MAAM;QACb,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAJD,8CAIC;AAED,kFAAkF;AAClF,MAAa,aAAc,SAAQ,mBAAY;IACpC,MAAM;QACb,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAJD,sCAIC;AAED,sEAAsE;AACtE,MAAa,aAAc,SAAQ,mBAAY;IACpC,MAAM;QACb,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAJD,sCAIC;AAED,oEAAoE;AACpE,MAAa,YAAa,SAAQ,mBAAY;IACnC,MAAM;QACb,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAJD,oCAIC;AAED,0CAA0C;AAC1C,MAAa,WAAY,SAAQ,mBAAY;IAClC,MAAM;QACb,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAJD,kCAIC;AAED,mEAAmE;AACnE,SAAgB,mBAAmB;IACjC,OAAO,YAA2C,CAAC;AACrD,CAAC;AACD,SAAgB,wBAAwB;IACtC,OAAO,iBAAgD,CAAC;AAC1D,CAAC;AACD,SAAgB,oBAAoB;IAClC,OAAO,aAA4C,CAAC;AACtD,CAAC;AACD,SAAgB,oBAAoB;IAClC,OAAO,aAA4C,CAAC;AACtD,CAAC;AACD,SAAgB,mBAAmB;IACjC,OAAO,YAA2C,CAAC;AACrD,CAAC;AACD,SAAgB,kBAAkB;IAChC,OAAO,WAA0C,CAAC;AACpD,CAAC"}

package/lib/types.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @monbolc/lowcode-renderer-core — public types
+ *
+ * Framework-agnostic renderer surface. The actual React (or other
+ * framework) primitives are injected at runtime via `adapter.setRuntime()`.
+ */
+/**
+ * The slice of React (or any compatible framework) that the renderer
+ * needs. The adapter is initialized with this at app boot.
+ *
+ * The fields are typed as `any` to keep the renderer-core source
+ * framework-agnostic. Concrete type narrowing happens in
+ * @monbolc/lowcode-react-renderer.
+ */
+export interface IRuntime {
+    /** Base class component. Must support `setState`, `forceUpdate`, lifecycle. */
+    Component: any;
+    /** Like Component but does shallow-prop / shallow-state equality. */
+    PureComponent: any;
+    /** Function form: `createElement(type, props, ...children)`. */
+    createElement: any;
+    /** Creates a Context object with Provider / Consumer. */
+    createContext: any;
+    /** Forwards refs to inner components. */
+    forwardRef: any;
+    /**
+     * Optional — React 19 has removed `findDOMNode`. Provided as a stub
+     * by the React adapter for back-compat; returns `null` always.
+     */
+    findDOMNode?: (instance: any) => any;
+}
+/** A renderer constructor. Returned by the factory functions. */
+export type IRenderComponent = new (props: IRendererProps) => any;
+/** What gets passed to every renderer component as props. */
+export interface IRendererProps {
+    /** Per-render helper object (logger, i18n, etc). Optional. */
+    appHelper?: unknown;
+    /** Component implementations, keyed by `IPublicTypeNodeSchema.componentName`. */
+    components?: Record<string, unknown>;
+    /** Design mode: 'design' | 'live' | 'preview' — drives error boundaries etc. */
+    designMode?: 'design' | 'live' | 'preview' | string;
+    /** If true, the renderer skips rendering children. */
+    suspended?: boolean;
+    /** The schema to render. */
+    schema: any;
+    /** Called when a child renderer grabs a ref to its instance. */
+    onCompGetRef?: (schema: any, ref: unknown) => void;
+    /** Called when a child renderer provides a context value. */
+    onCompGetCtx?: (schema: any, ctx: unknown) => void;
+    /** Force the renderer to render even if props suggest otherwise. */
+    thisRequiredInJSE?: boolean;
+}
+/** A bag of named renderer factories. Set via `adapter.setRenderers(...)`. */
+export interface IRendererModules {
+    PageRenderer: IRenderComponent;
+    ComponentRenderer: IRenderComponent;
+    BlockRenderer: IRenderComponent;
+    AddonRenderer: IRenderComponent;
+    TempRenderer: IRenderComponent;
+    DivRenderer?: IRenderComponent;
+}
+/**
+ * Optional theme / locale / i18n provider component. The runtime may
+ * pass a React component (or any framework's component) that wraps the
+ * renderer tree.
+ */
+export type IConfigProvider = unknown;
+/** Internal state shape. Kept loose on purpose — renderers are free
+ * to extend it. */
+export interface IRendererState {
+    /** Last error caught by the renderer's error boundary, if any. */
+    engineRenderError?: boolean;
+    error?: unknown;
+}

package/lib/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * @monbolc/lowcode-renderer-core — public types
+ *
+ * Framework-agnostic renderer surface. The actual React (or other
+ * framework) primitives are injected at runtime via `adapter.setRuntime()`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/lib/types.js.map

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

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@monbolc/lowcode-renderer-core",
+  "version": "2.0.0",
+  "description": "Framework-agnostic renderer core with React-runtime adapter for SapuLowcodeEngine (L2)",
+  "license": "MIT",
+  "main": "lib/index.js",
+  "module": "es/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./es/index.js",
+      "require": "./lib/index.js"
+    }
+  },
+  "files": ["lib", "es"],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "build:es": "tsc -p tsconfig.esm.json && node ../../scripts/add-js-extensions.mjs es",
+    "clean": "rimraf lib es"
+  },
+  "dependencies": {
+    "@monbolc/lowcode-types": "^2.0.0",
+    "@monbolc/lowcode-utils": "^2.0.0"
+  },
+  "peerDependencies": {
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0"
+  },
+  "peerDependenciesMeta": {
+    "react": { "optional": true },
+    "react-dom": { "optional": true }
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
+    "rimraf": "^5.0.5",
+    "typescript": "^5.4.5"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git@github.com:monbolc/sapu-lowcode-engine.git",
+    "directory": "packages/renderer-core"
+  },
+  "keywords": ["lowcode", "engine", "renderer", "react"]
+}