@omriashke/dynamico-core 0.1.0

package/LICENSE

@@ -0,0 +1,184 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship made available under
+      the License, as indicated by a copyright notice that is included in
+      or attached to the work (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean, as submitted to the Licensor for inclusion
+      in the Work by the copyright owner or by an individual or Legal Entity
+      authorized to submit on behalf of the copyright owner. For the purposes
+      of this definition, "submitted" means any form of electronic, verbal,
+      or written communication sent to the Licensor or its representatives,
+      including but not limited to communication on electronic mailing lists,
+      source code control systems, and issue tracking systems that are managed
+      by, or on behalf of, the Licensor for the purpose of developing and
+      improving the Work, but excluding communication that is conspicuously
+      marked or designated in writing by the copyright owner as "Not a
+      Contribution."
+
+      "Contributor" shall mean Licensor and any Legal Entity on behalf of
+      whom a Contribution has been received by the Licensor and incorporated
+      within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by the combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a cross-claim
+      or counterclaim in a lawsuit) alleging that the Work or any
+      Contribution embodied within the Work constitutes direct or
+      contributory patent infringement, then any patent licenses granted
+      to You under this License for that Work shall terminate as of the
+      date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or Derivative
+          Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, You must include a readable copy of the
+          attribution notices contained within such NOTICE file, in
+          at least one of the following places: within a NOTICE text
+          file distributed as part of the Derivative Works; within
+          the Source form or documentation, if provided along with the
+          Derivative Works; or, within a display generated by the
+          Derivative Works, if and wherever such third-party notices
+          normally appear. The contents of the NOTICE file are for
+          informational purposes only and do not modify the License.
+          You may add Your own attribution notices within Derivative
+          Works that You distribute, alongside or in addition to the
+          NOTICE text from the Work, provided that such additional
+          attribution notices cannot be construed as modifying the License.
+
+      You may add Your own license statement for Your modifications and
+      may provide additional grant of rights to use, reproduce, modify,
+      prepare Derivative Works of, convert to Object form, display,
+      perform, sublicense, and distribute the Work and such Derivative
+      Works in Source or Object form.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or exemplary damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or all other
+      commercial damages or losses), even if such Contributor has been
+      advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may offer such
+      obligations only on Your own behalf and on Your sole responsibility,
+      not on behalf of any other Contributor, and only if You agree to
+      indemnify, defend, and hold each Contributor harmless for any
+      liability incurred by, or claims asserted against, such Contributor
+      by reason of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2024 Omri Askenazi
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export type { Source, SourceUpdate, CompiledModule, CompiledModuleOk, CompiledModuleError, CompiledModuleRemoved, ComponentFactory, RegistryEntry, RegistryListener, Scope, PropsSchema, PropsSchemaField, DynamicError, Diagnostic, Version, } from "./types.js";
+export { Registry } from "./registry.js";
+export { loadModule } from "./loader.js";
+export { createRemoteSource, type RemoteSourceOptions } from "./sources/remote.js";
+export { validateProps, type PropsValidationResult } from "./propsSchema.js";
+export { createRuntime, type RuntimeAPI, type DynamicoProviderProps, type DynamicComponentProps, } from "./react/createRuntime.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,MAAM,EACN,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,KAAK,EACL,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,UAAU,EACV,OAAO,GACR,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,aAAa,EAAE,KAAK,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EACL,aAAa,EACb,KAAK,UAAU,EACf,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,GAC3B,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { Registry } from "./registry.js";
+export { loadModule } from "./loader.js";
+export { createRemoteSource } from "./sources/remote.js";
+export { validateProps } from "./propsSchema.js";
+export { createRuntime, } from "./react/createRuntime.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAA4B,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,aAAa,EAA8B,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EACL,aAAa,GAId,MAAM,0BAA0B,CAAC"}

package/dist/loader.d.ts

@@ -0,0 +1,16 @@
+import type { Scope } from "./types.js";
+/**
+ * Execute a CommonJS-style code string in a controlled scope.
+ *
+ * The compiler (server-side Babel) emits code that uses `require(name)`,
+ * `module.exports`, and `exports`. We give it a `require` that:
+ *   - returns the host-registered binding for any bare specifier in `scope`
+ *   - delegates relative paths ("./Other", "../foo") to `requireRelative`,
+ *     which the registry implements by looking up other dynamic components
+ *   - throws otherwise (no arbitrary npm imports at runtime)
+ *
+ * This is the only place we call `new Function`. It runs in the same realm
+ * as the host app — v1 trusts the registry; sandboxing is a v2 concern.
+ */
+export declare function loadModule(code: string, scope: Scope, requireRelative: (specifier: string) => unknown): unknown;
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,KAAK,EACZ,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,GAC9C,OAAO,CAoBT"}

package/dist/loader.js

@@ -0,0 +1,31 @@
+/**
+ * Execute a CommonJS-style code string in a controlled scope.
+ *
+ * The compiler (server-side Babel) emits code that uses `require(name)`,
+ * `module.exports`, and `exports`. We give it a `require` that:
+ *   - returns the host-registered binding for any bare specifier in `scope`
+ *   - delegates relative paths ("./Other", "../foo") to `requireRelative`,
+ *     which the registry implements by looking up other dynamic components
+ *   - throws otherwise (no arbitrary npm imports at runtime)
+ *
+ * This is the only place we call `new Function`. It runs in the same realm
+ * as the host app — v1 trusts the registry; sandboxing is a v2 concern.
+ */
+export function loadModule(code, scope, requireRelative) {
+    const moduleObj = { exports: {} };
+    const requireFn = (name) => {
+        if (name.startsWith("./") || name.startsWith("../") || name.startsWith("/")) {
+            return requireRelative(name);
+        }
+        if (Object.prototype.hasOwnProperty.call(scope, name)) {
+            return scope[name];
+        }
+        throw new Error(`dynamico: '${name}' is not in host scope. Add it via <DynamicoProvider scope={{...}}>.`);
+    };
+    // The compiled body is just the function body; arguments are well-known.
+    // eslint-disable-next-line no-new-func
+    const fn = new Function("module", "exports", "require", code);
+    fn(moduleObj, moduleObj.exports, requireFn);
+    return moduleObj.exports;
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,UAAU,CACxB,IAAY,EACZ,KAAY,EACZ,eAA+C;IAE/C,MAAM,SAAS,GAAG,EAAE,OAAO,EAAE,EAA6B,EAAE,CAAC;IAC7D,MAAM,SAAS,GAAG,CAAC,IAAY,EAAW,EAAE;QAC1C,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5E,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC;YACtD,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;QACD,MAAM,IAAI,KAAK,CACb,cAAc,IAAI,sEAAsE,CACzF,CAAC;IACJ,CAAC,CAAC;IAEF,yEAAyE;IACzE,uCAAuC;IACvC,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IAC9D,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAE5C,OAAO,SAAS,CAAC,OAAO,CAAC;AAC3B,CAAC"}

package/dist/propsSchema.d.ts

@@ -0,0 +1,7 @@
+import type { PropsSchema } from "./types.js";
+export interface PropsValidationResult {
+    ok: boolean;
+    errors: string[];
+}
+export declare function validateProps(schema: PropsSchema | undefined, props: Record<string, unknown>): PropsValidationResult;
+//# sourceMappingURL=propsSchema.d.ts.map

package/dist/propsSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"propsSchema.d.ts","sourceRoot":"","sources":["../src/propsSchema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAWD,wBAAgB,aAAa,CAC3B,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,qBAAqB,CAiBvB"}

package/dist/propsSchema.js

@@ -0,0 +1,34 @@
+const TYPE_CHECKS = {
+    string: (v) => typeof v === "string",
+    number: (v) => typeof v === "number" && !Number.isNaN(v),
+    boolean: (v) => typeof v === "boolean",
+    object: (v) => typeof v === "object" && v !== null && !Array.isArray(v),
+    array: (v) => Array.isArray(v),
+    any: () => true,
+};
+export function validateProps(schema, props) {
+    if (!schema)
+        return { ok: true, errors: [] };
+    const errors = [];
+    for (const [key, field] of Object.entries(schema)) {
+        const present = Object.prototype.hasOwnProperty.call(props, key);
+        if (!present) {
+            if (field.required)
+                errors.push(`missing required prop '${key}' (${field.type})`);
+            continue;
+        }
+        const checker = TYPE_CHECKS[field.type] ?? TYPE_CHECKS.any;
+        if (!checker(props[key])) {
+            errors.push(`prop '${key}' expected ${field.type}, got ${describe(props[key])}`);
+        }
+    }
+    return { ok: errors.length === 0, errors };
+}
+function describe(v) {
+    if (v === null)
+        return "null";
+    if (Array.isArray(v))
+        return "array";
+    return typeof v;
+}
+//# sourceMappingURL=propsSchema.js.map

package/dist/propsSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"propsSchema.js","sourceRoot":"","sources":["../src/propsSchema.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,GAA4C;IAC3D,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ;IACpC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACxD,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,SAAS;IACtC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACvE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9B,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI;CAChB,CAAC;AAEF,MAAM,UAAU,aAAa,CAC3B,MAA+B,EAC/B,KAA8B;IAE9B,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC7C,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACjE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,IAAI,KAAK,CAAC,QAAQ;gBAAE,MAAM,CAAC,IAAI,CAAC,0BAA0B,GAAG,MAAM,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;YAClF,SAAS;QACX,CAAC;QACD,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,GAAI,CAAC;QAC5D,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,CACT,SAAS,GAAG,cAAc,KAAK,CAAC,IAAI,SAAS,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CACpE,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAC7C,CAAC;AAED,SAAS,QAAQ,CAAC,CAAU;IAC1B,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,OAAO,CAAC;IACrC,OAAO,OAAO,CAAC,CAAC;AAClB,CAAC"}

package/dist/react/createRuntime.d.ts

@@ -0,0 +1,22 @@
+import * as React from "react";
+import type { DynamicError, RegistryEntry, Scope, Source } from "../types.js";
+export interface RuntimeAPI {
+    DynamicoProvider: React.ComponentType<DynamicoProviderProps>;
+    DynamicComponent: React.ComponentType<DynamicComponentProps>;
+    useDynamico: (name: string) => RegistryEntry | undefined;
+}
+export interface DynamicoProviderProps {
+    source: Source;
+    scope?: Scope;
+    children?: React.ReactNode;
+}
+export interface DynamicComponentProps {
+    name: string;
+    props?: Record<string, unknown>;
+    fallback?: React.ReactNode;
+    errorFallback?: React.ComponentType<{
+        error: DynamicError;
+    }> | React.ReactNode;
+}
+export declare function createRuntime(defaultScope: Scope): RuntimeAPI;
+//# sourceMappingURL=createRuntime.d.ts.map

package/dist/react/createRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createRuntime.d.ts","sourceRoot":"","sources":["../../src/react/createRuntime.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAEV,YAAY,EAEZ,aAAa,EACb,KAAK,EACL,MAAM,EACP,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,UAAU;IACzB,gBAAgB,EAAE,KAAK,CAAC,aAAa,CAAC,qBAAqB,CAAC,CAAC;IAC7D,gBAAgB,EAAE,KAAK,CAAC,aAAa,CAAC,qBAAqB,CAAC,CAAC;IAC7D,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,aAAa,GAAG,SAAS,CAAC;CAC1D;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,aAAa,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;QAAE,KAAK,EAAE,YAAY,CAAA;KAAE,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC;CAChF;AAMD,wBAAgB,aAAa,CAAC,YAAY,EAAE,KAAK,GAAG,UAAU,CA8F7D"}

package/dist/react/createRuntime.js

@@ -0,0 +1,116 @@
+import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import * as React from "react";
+import { Registry } from "../registry.js";
+import { validateProps } from "../propsSchema.js";
+export function createRuntime(defaultScope) {
+    const Ctx = React.createContext(null);
+    function DynamicoProvider({ source, scope, children }) {
+        const registry = React.useMemo(() => {
+            const merged = { ...defaultScope, ...(scope ?? {}) };
+            return new Registry(source, merged);
+        }, [source, scope]);
+        const value = React.useMemo(() => ({ registry }), [registry]);
+        return _jsx(Ctx.Provider, { value: value, children: children });
+    }
+    function useRegistry() {
+        const ctx = React.useContext(Ctx);
+        if (!ctx) {
+            throw new Error("dynamico: useDynamico/DynamicComponent must be inside <DynamicoProvider>");
+        }
+        return ctx.registry;
+    }
+    function useDynamico(name) {
+        const registry = useRegistry();
+        const subscribe = React.useCallback((cb) => registry.subscribe(name, cb), [registry, name]);
+        const getSnapshot = React.useCallback(() => registry.peek(name), [registry, name]);
+        const entry = React.useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+        React.useEffect(() => {
+            if (!registry.peek(name))
+                void registry.ensure(name);
+        }, [registry, name]);
+        return entry;
+    }
+    function DynamicComponent({ name, props, fallback = null, errorFallback, }) {
+        const entry = useDynamico(name);
+        if (!entry)
+            return _jsx(_Fragment, { children: fallback });
+        if (entry.error) {
+            return _jsx(_Fragment, { children: renderError(errorFallback, entry.error) });
+        }
+        if (!entry.factory)
+            return _jsx(_Fragment, { children: fallback });
+        const Comp = pickDefault(entry.factory);
+        if (typeof Comp !== "function") {
+            const err = {
+                kind: "load",
+                name,
+                version: entry.version,
+                message: `component '${name}' has no default export of a function/class`,
+            };
+            return _jsx(_Fragment, { children: renderError(errorFallback, err) });
+        }
+        const schema = entry.factory.propsSchema;
+        const validation = validateProps(schema, props ?? {});
+        if (!validation.ok) {
+            const err = {
+                kind: "render",
+                name,
+                version: entry.version,
+                message: `props validation failed: ${validation.errors.join("; ")}`,
+            };
+            return _jsx(_Fragment, { children: renderError(errorFallback, err) });
+        }
+        return (_jsx(ErrorBoundary, { onError: (message, stack) => ({
+                kind: "render",
+                name,
+                version: entry.version,
+                message,
+                stack,
+            }), renderFallback: (err) => renderError(errorFallback, err), children: React.createElement(Comp, props ?? {}) }, `${name}@${entry.version}`));
+    }
+    return { DynamicoProvider, DynamicComponent, useDynamico };
+}
+function pickDefault(factory) {
+    if (factory && typeof factory === "object") {
+        if ("default" in factory && factory.default)
+            return factory.default;
+        // CommonJS interop: the value itself may be the component
+        if (typeof factory === "function")
+            return factory;
+    }
+    if (typeof factory === "function")
+        return factory;
+    return undefined;
+}
+function renderError(errorFallback, error) {
+    if (!errorFallback)
+        return defaultErrorView(error);
+    if (typeof errorFallback === "function") {
+        const Fallback = errorFallback;
+        return _jsx(Fallback, { error: error });
+    }
+    return errorFallback;
+}
+function defaultErrorView(error) {
+    // Renderer-agnostic: plain text node so it works on both DOM and RN.
+    return React.createElement(React.Fragment, null, `[dynamico ${error.kind} error] ${error.name}: ${error.message}`);
+}
+class ErrorBoundary extends React.Component {
+    constructor() {
+        super(...arguments);
+        this.state = { err: null };
+    }
+    static getDerivedStateFromError() {
+        return null; // we set state in componentDidCatch where we have the message
+    }
+    componentDidCatch(error) {
+        const e = error instanceof Error ? error : new Error(String(error));
+        this.setState({ err: this.props.onError(e.message, e.stack) });
+    }
+    render() {
+        if (this.state.err)
+            return this.props.renderFallback(this.state.err);
+        return this.props.children;
+    }
+}
+//# sourceMappingURL=createRuntime.js.map

package/dist/react/createRuntime.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,55 @@
+import type { RegistryEntry, RegistryListener, Scope, Source } from "./types.js";
+/**
+ * In-memory, versioned registry of dynamic components.
+ *
+ * The registry is the single source of truth that runtime packages
+ * (@omriashke/dynamico-web, @omriashke/dynamico-native) subscribe to. It receives compiled
+ * modules from a Source, evaluates them via the loader using a host-provided
+ * Scope, and notifies subscribers when a component's version changes.
+ */
+export declare class Registry {
+    private readonly source;
+    private scope;
+    private entries;
+    private listeners;
+    private anyListeners;
+    private inflight;
+    constructor(source: Source, scope: Scope);
+    /** Replace or extend the current scope (rare; typically set once). */
+    setScope(scope: Scope): void;
+    /** Get the current entry for a name, if any. */
+    peek(name: string): RegistryEntry | undefined;
+    /**
+     * Ensure a component is loaded. Triggers an initial fetch if we don't yet
+     * have an entry for this name. Returns the latest known entry.
+     */
+    ensure(name: string): Promise<RegistryEntry>;
+    /** Subscribe to changes for a specific component. */
+    subscribe(name: string, listener: RegistryListener): () => void;
+    /** Subscribe to all changes (used internally / for debugging). */
+    subscribeAll(listener: RegistryListener): () => void;
+    /**
+     * Resolve a relative-path require from inside a dynamic component.
+     * Cross-component imports look up other components by name in the registry.
+     * v1: we map "./Other" -> "Other" (basename, no extension).
+     *
+     * The returned value is a *lazy proxy module*: it has the same shape as
+     * a real CommonJS module (`{ default, ...rest }`), but every member is a
+     * React function component that re-resolves the target on each render.
+     * This means:
+     *   - Card can `require("./Hello")` at eval time even before Hello has
+     *     loaded — the proxy is returned immediately.
+     *   - When Hello actually arrives (or hot-swaps to a new version), Card's
+     *     next render automatically picks it up; no manual preload needed.
+     */
+    requireByPath(specifier: string): unknown;
+    private lazyProxies;
+    private makeLazyProxy;
+    /**
+     * Take a CompiledModule from the source, evaluate it (or record a compile
+     * error), update the entry, and notify listeners.
+     */
+    private ingest;
+    private notify;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,aAAa,EACb,gBAAgB,EAChB,KAAK,EACL,MAAM,EAEP,MAAM,YAAY,CAAC;AAGpB;;;;;;;GAOG;AACH,qBAAa,QAAQ;IAOjB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,KAAK;IAPf,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,SAAS,CAA4C;IAC7D,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,QAAQ,CAA6C;gBAG1C,MAAM,EAAE,MAAM,EACvB,KAAK,EAAE,KAAK;IAOtB,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAI5B,gDAAgD;IAChD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI7C;;;OAGG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAelD,qDAAqD;IACrD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,MAAM,IAAI;IAa/D,kEAAkE;IAClE,YAAY,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,IAAI;IAOpD;;;;;;;;;;;;;OAaG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAezC,OAAO,CAAC,WAAW,CAA8C;IAEjE,OAAO,CAAC,aAAa;IA6CrB;;;OAGG;IACH,OAAO,CAAC,MAAM;IAiDd,OAAO,CAAC,MAAM;CAoBf"}