@reckona/mreact-next 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tatsuo Kaniwa
+
+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/README.md

@@ -0,0 +1,26 @@
+# @reckona/mreact-next
+
+`@reckona/mreact-next` contains experimental helpers for compiling mreact
+components into modules that can be consumed from a Next.js application.
+
+## Basic Usage
+
+```ts
+import { compileMreactComponentModule } from "@reckona/mreact-next";
+
+const module = compileMreactComponentModule({
+  filename: "components/Card.tsx",
+  source: `export default function Card() { return <article />; }`,
+});
+```
+
+## Core APIs
+
+- `compileMreactComponentModule()` compiles a single source module.
+- `generateMreactComponents()` compiles multiple components from a directory.
+- `formatGeneratedMreactComponents()` formats generated module metadata.
+
+## Status
+
+This package is integration tooling. It is not the main mreact app framework;
+use `@reckona/mreact-router` for mreact-native routing and rendering.

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { resolve } from "node:path";
+import { formatGeneratedMreactComponents, generateMreactComponents, } from "./index.js";
+const rootDir = resolve(process.argv[2] ?? "app");
+const generated = await generateMreactComponents({ rootDir });
+console.log(formatGeneratedMreactComponents(generated, rootDir));
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,+BAA+B,EAC/B,wBAAwB,GACzB,MAAM,YAAY,CAAC;AAEpB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,MAAM,wBAAwB,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;AAE9D,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+export interface GenerateMreactComponentsOptions {
+    rootDir: string;
+}
+export interface GeneratedMreactComponent {
+    source: string;
+    output: string;
+    domOutput: string;
+}
+export interface CompiledMreactComponentModule {
+    wrapperCode: string;
+    domCode: string;
+}
+export declare function generateMreactComponents(options: GenerateMreactComponentsOptions): Promise<GeneratedMreactComponent[]>;
+export interface CompileMreactComponentModuleOptions {
+    domImportPath: string;
+}
+export declare function compileMreactComponentModule(code: string, filename: string, options: CompileMreactComponentModuleOptions): CompiledMreactComponentModule;
+export declare function formatGeneratedMreactComponents(generated: readonly GeneratedMreactComponent[], rootDir: string): string;
+//# 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":"AAIA,MAAM,WAAW,+BAA+B;IAC9C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,6BAA6B;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAkBrC;AAED,MAAM,WAAW,mCAAmC;IAClD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,mCAAmC,GAC3C,6BAA6B,CA0D/B;AA4CD,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,SAAS,wBAAwB,EAAE,EAC9C,OAAO,EAAE,MAAM,GACd,MAAM,CAWR"}

package/dist/index.js

@@ -0,0 +1,111 @@
+import { readdir, readFile, writeFile } from "node:fs/promises";
+import { basename, dirname, join, relative } from "node:path";
+import { transform } from "@reckona/mreact-compiler";
+export async function generateMreactComponents(options) {
+    const sources = await findMreactSources(options.rootDir);
+    const generated = [];
+    for (const source of sources) {
+        const code = await readFile(source, "utf8");
+        const output = outputPathForSource(source);
+        const domOutput = domOutputPathForSource(source);
+        const generatedCode = compileMreactComponentModule(code, source, {
+            domImportPath: importPathForGeneratedModule(output, domOutput),
+        });
+        await writeFile(output, generatedCode.wrapperCode);
+        await writeFile(domOutput, generatedCode.domCode);
+        generated.push({ source, output, domOutput });
+    }
+    return generated;
+}
+export function compileMreactComponentModule(code, filename, options) {
+    const compiled = transform({
+        code,
+        filename,
+        target: "client",
+        dev: true,
+    });
+    if (compiled.metadata.components.length === 0) {
+        throw new Error(`${filename} must export at least one mreact JSX component.`);
+    }
+    const components = compiled.metadata.components
+        .filter((component) => hasCompiledExport(compiled.code, component.name, component.exportName))
+        .map((component) => ({
+        name: component.name,
+        exportName: component.exportName,
+        moduleAccess: component.exportName === "default" ? "module.default" : `module.${component.name}`,
+    }));
+    if (components.length === 0) {
+        throw new Error(`${filename} must export at least one mreact JSX component.`);
+    }
+    const wrappers = components
+        .map((component) => `const ${component.name}$mounted = new WeakMap<Element, Node>();
+const ${component.name}$mounting = new WeakSet<Element>();
+${emitExportFunction(component.exportName, component.name)}(props: Record<string, unknown>): never {
+  return (
+    <span
+      data-mreact-component=${JSON.stringify(component.name)}
+      ref={(node: Element | null) => {
+      if (node === null || ${component.name}$mounted.has(node) || ${component.name}$mounting.has(node)) {
+        return;
+      }
+
+      ${component.name}$mounting.add(node);
+      void import(${JSON.stringify(options.domImportPath)}).then((module) => {
+        const rendered = (${component.moduleAccess} as (props: Record<string, unknown>) => Node)(props);
+        node.replaceChildren(rendered);
+        ${component.name}$mounted.set(node, rendered);
+      });
+      }}
+    />
+  ) as never;
+}`)
+        .join("\n\n");
+    return {
+        wrapperCode: `// @ts-nocheck
+"use client";
+${wrappers}
+`,
+        domCode: `// @ts-nocheck
+${compiled.code}`,
+    };
+}
+async function findMreactSources(rootDir) {
+    const entries = await readdir(rootDir, { withFileTypes: true });
+    const sources = [];
+    for (const entry of entries) {
+        const path = join(rootDir, entry.name);
+        if (entry.isDirectory()) {
+            sources.push(...(await findMreactSources(path)));
+            continue;
+        }
+        if (entry.isFile() && entry.name.endsWith(".mreact.tsx")) {
+            sources.push(path);
+        }
+    }
+    return sources.sort();
+}
+function outputPathForSource(source) {
+    return join(dirname(source), `${basename(source, ".mreact.tsx")}.tsx`);
+}
+function domOutputPathForSource(source) {
+    return join(dirname(source), `${basename(source, ".mreact.tsx")}.mreact-dom.ts`);
+}
+function importPathForGeneratedModule(from, to) {
+    const extensionless = relative(dirname(from), to).replace(/\.ts$/, "");
+    return extensionless.startsWith(".") ? extensionless : `./${extensionless}`;
+}
+function emitExportFunction(exportName, name) {
+    return exportName === "default" ? `export default function ${name}` : `export function ${name}`;
+}
+function hasCompiledExport(code, name, exportName) {
+    return code.includes(`${emitExportFunction(exportName, name)}(`);
+}
+export function formatGeneratedMreactComponents(generated, rootDir) {
+    if (generated.length === 0) {
+        return "No .mreact.tsx components found.";
+    }
+    return generated
+        .map((item) => `${relative(rootDir, item.source)} -> ${relative(rootDir, item.output)}, ${relative(rootDir, item.domOutput)}`)
+        .join("\n");
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@reckona/mreact-next",
+  "version": "0.0.1",
+  "description": "Experimental helpers for consuming compiled mreact components from Next.js.",
+  "keywords": [
+    "compiler",
+    "integration",
+    "jsx",
+    "mreact",
+    "nextjs",
+    "typescript"
+  ],
+  "homepage": "https://github.com/t-k/mreact/tree/main/packages/next#readme",
+  "bugs": {
+    "url": "https://github.com/t-k/mreact/issues"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/t-k/mreact.git",
+    "directory": "packages/next"
+  },
+  "files": [
+    "dist/**/*.js",
+    "dist/**/*.js.map",
+    "dist/**/*.d.ts",
+    "dist/**/*.d.ts.map"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@reckona/mreact-compiler": "0.0.1"
+  }
+}