@kernlang/react 2.0.0

package/dist/artifact-utils.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Shared utilities for building multi-file artifacts from structure plans.
+ *
+ * Used by all 3 React transpilers (Tailwind, Next.js, Web) when
+ * structure !== 'flat' to convert a StructurePlan into GeneratedArtifact[].
+ */
+import type { GeneratedArtifact, IRNode, ResolvedKernConfig } from '@kernlang/core';
+import type { StructurePlan, PlannedFile } from './structure.js';
+export interface StructuredResult {
+    entryCode: string;
+    artifacts: GeneratedArtifact[];
+}
+/**
+ * Build artifacts from a structure plan.
+ *
+ * @param plan - The structure plan from planStructure()
+ * @param renderFile - Callback to render a single file's nodes to code string.
+ *   Receives the planned file, and returns the rendered code for that file.
+ * @param root - The root IR node
+ * @param config - Resolved config
+ */
+export declare function buildStructuredArtifacts(plan: StructurePlan, renderFile: (file: PlannedFile, config: ResolvedKernConfig) => string, root: IRNode, config: ResolvedKernConfig): StructuredResult;

package/dist/artifact-utils.js

@@ -0,0 +1,87 @@
+/**
+ * Shared utilities for building multi-file artifacts from structure plans.
+ *
+ * Used by all 3 React transpilers (Tailwind, Next.js, Web) when
+ * structure !== 'flat' to convert a StructurePlan into GeneratedArtifact[].
+ */
+import { extractHooks, generateStateHookCode, generateLogicHookCode, generateTypesCode, generateBarrelCode, } from './structure.js';
+/**
+ * Build artifacts from a structure plan.
+ *
+ * @param plan - The structure plan from planStructure()
+ * @param renderFile - Callback to render a single file's nodes to code string.
+ *   Receives the planned file, and returns the rendered code for that file.
+ * @param root - The root IR node
+ * @param config - Resolved config
+ */
+export function buildStructuredArtifacts(plan, renderFile, root, config) {
+    const featureName = root.props?.name || 'Component';
+    const artifacts = [];
+    let entryCode = '';
+    // Collect state and logic nodes from root children
+    const stateNodes = [];
+    const logicNodes = [];
+    for (const child of root.children || []) {
+        if (child.type === 'state')
+            stateNodes.push(child);
+        if (child.type === 'logic' || child.type === 'handler')
+            logicNodes.push(child);
+    }
+    // Determine hooks directory from plan
+    const hookFiles = plan.files.filter(f => f.artifactType === 'hook');
+    const hooksDir = hookFiles.length > 0
+        ? hookFiles[0].path.substring(0, hookFiles[0].path.lastIndexOf('/'))
+        : 'hooks';
+    const hooks = extractHooks(featureName, stateNodes, logicNodes, hooksDir);
+    for (const file of plan.files) {
+        if (file.artifactType === 'hook') {
+            // Generate hook code
+            const matchingHook = hooks.find(h => h.path === file.path);
+            if (matchingHook) {
+                const code = matchingHook.stateDecls.length > 0
+                    ? generateStateHookCode(matchingHook)
+                    : generateLogicHookCode(matchingHook, hooks.find(h => h.stateDecls.length > 0)?.hookName);
+                artifacts.push({ path: file.path, content: code, type: 'hook' });
+            }
+            continue;
+        }
+        if (file.artifactType === 'types') {
+            const stateDecls = stateNodes.map(n => ({
+                name: n.props?.name || 'value',
+                initial: String(n.props?.initial ?? ''),
+            }));
+            const code = generateTypesCode(featureName, stateDecls);
+            artifacts.push({ path: file.path, content: code, type: 'types' });
+            continue;
+        }
+        if (file.artifactType === 'theme') {
+            // Theme nodes are meta — just export the theme object
+            const themeNodes = file.nodes;
+            const themeLines = [];
+            for (const tn of themeNodes) {
+                const name = tn.props?.name || 'theme';
+                const styles = tn.props?.styles || {};
+                themeLines.push(`export const ${name} = ${JSON.stringify(styles, null, 2)};`);
+            }
+            artifacts.push({ path: file.path, content: themeLines.join('\n\n'), type: 'theme' });
+            continue;
+        }
+        // Render component/entry/page/template files
+        const code = renderFile(file, config);
+        if (file.isEntry) {
+            entryCode = code;
+            // Also add as artifact so CLI can write it to the correct path
+            artifacts.push({ path: file.path, content: code, type: file.artifactType });
+        }
+        else {
+            artifacts.push({ path: file.path, content: code, type: file.artifactType });
+        }
+    }
+    // Barrel exports
+    for (const barrel of plan.barrels) {
+        const code = generateBarrelCode(barrel);
+        artifacts.push({ path: barrel.path, content: code, type: 'barrel' });
+    }
+    return { entryCode, artifacts };
+}
+//# sourceMappingURL=artifact-utils.js.map

package/dist/artifact-utils.js.map

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

package/dist/codegen-react.d.ts

@@ -0,0 +1,13 @@
+/**
+ * React-specific codegen — generates JSX/TSX code for provider and effect nodes.
+ *
+ * These nodes live in @kernlang/react because they produce JSX output,
+ * unlike hook which generates pure TypeScript and lives in @kernlang/core.
+ */
+import type { IRNode } from '@kernlang/core';
+export declare function generateProvider(node: IRNode): string[];
+export declare function generateEffect(node: IRNode): string[];
+/** Check if a node is a React codegen node (provider or top-level effect). */
+export declare function isReactNode(type: string): boolean;
+/** Generate TSX for a React codegen node. */
+export declare function generateReactNode(node: IRNode): string[];

package/dist/codegen-react.js

@@ -0,0 +1,188 @@
+/**
+ * React-specific codegen — generates JSX/TSX code for provider and effect nodes.
+ *
+ * These nodes live in @kernlang/react because they produce JSX output,
+ * unlike hook which generates pure TypeScript and lives in @kernlang/core.
+ */
+// ── Helpers ──────────────────────────────────────────────────────────────
+function p(node) {
+    return node.props || {};
+}
+function kids(node, type) {
+    const c = node.children || [];
+    return type ? c.filter(n => n.type === type) : c;
+}
+function firstChild(node, type) {
+    return kids(node, type)[0];
+}
+function dedent(code) {
+    const lines = code.split('\n');
+    const nonEmpty = lines.filter(l => l.trim().length > 0);
+    if (nonEmpty.length === 0)
+        return code;
+    const min = Math.min(...nonEmpty.map(l => l.match(/^(\s*)/)?.[1].length ?? 0));
+    return lines.map(l => l.slice(min)).join('\n');
+}
+function handlerCode(node) {
+    const handler = firstChild(node, 'handler');
+    if (!handler)
+        return '';
+    const raw = p(handler).code || '';
+    return dedent(raw);
+}
+// ── Provider ─────────────────────────────────────────────────────────────
+// provider name=Search type=UseSearchResult
+//   prop name=initialQuery type=string
+//   prop name=category type=string optional=true
+//   handler <<<
+//     const value = useSearch({ query: initialQuery, category });
+//   >>>
+//
+// Generates 3 pieces:
+//   1. SearchContext = createContext<UseSearchResult | null>(null)
+//   2. SearchProvider component with props + <SearchContext.Provider>
+//   3. useSearchContext() consumer hook with null-check
+export function generateProvider(node) {
+    const props = p(node);
+    const name = props.name;
+    const valueType = props.type;
+    const lines = [];
+    lines.push("'use client';");
+    lines.push('');
+    lines.push("import { createContext, useContext } from 'react';");
+    lines.push(`import type { ReactNode } from 'react';`);
+    lines.push('');
+    // 1. Context
+    lines.push(`const ${name}Context = createContext<${valueType} | null>(null);`);
+    lines.push('');
+    // 2. Props interface
+    const propNodes = kids(node, 'prop');
+    lines.push(`export interface ${name}ProviderProps {`);
+    lines.push(`  children: ReactNode;`);
+    for (const prop of propNodes) {
+        const pp = p(prop);
+        const opt = pp.optional === 'true' || pp.optional === true ? '?' : '';
+        lines.push(`  ${pp.name}${opt}: ${pp.type};`);
+    }
+    lines.push('}');
+    lines.push('');
+    // 3. Provider component
+    const propNames = propNodes.map(pn => p(pn).name);
+    const destructured = ['children', ...propNames].join(', ');
+    lines.push(`export function ${name}Provider({ ${destructured} }: ${name}ProviderProps) {`);
+    const code = handlerCode(node);
+    if (code) {
+        for (const line of code.split('\n')) {
+            lines.push(`  ${line}`);
+        }
+    }
+    lines.push('');
+    lines.push(`  return (`);
+    lines.push(`    <${name}Context.Provider value={value}>`);
+    lines.push(`      {children}`);
+    lines.push(`    </${name}Context.Provider>`);
+    lines.push(`  );`);
+    lines.push('}');
+    lines.push('');
+    // 4. Consumer hook
+    lines.push(`export function use${name}Context(): ${valueType} {`);
+    lines.push(`  const ctx = useContext(${name}Context);`);
+    lines.push(`  if (ctx === null) {`);
+    lines.push(`    throw new Error('use${name}Context must be used within a ${name}Provider');`);
+    lines.push(`  }`);
+    lines.push(`  return ctx;`);
+    lines.push('}');
+    return lines;
+}
+// ── Effect (Component) ──────────────────────────────────────────────────
+// effect name=TrackingContainer generic=T once=true
+//   prop name=entities type="T[]"
+//   prop name=generator type="(items: T[]) => Promise<TrackingEvent>"
+//   deps="entities,generator"
+//   handler <<<
+//     generator(entities).then(event => trackPageLoadEvent(event));
+//   >>>
+//   cleanup <<<
+//     abortCtrl.abort();
+//   >>>
+//
+// Generates: props interface + component with useRef guard (once=true) +
+// useEffect with deps + optional cleanup + return null
+export function generateEffect(node) {
+    const props = p(node);
+    const name = props.name;
+    const generic = props.generic;
+    const once = props.once === 'true' || props.once === true;
+    const deps = props.deps || '';
+    const lines = [];
+    const reactImports = ['useEffect'];
+    if (once)
+        reactImports.push('useRef');
+    lines.push("'use client';");
+    lines.push('');
+    lines.push(`import { ${reactImports.sort().join(', ')} } from 'react';`);
+    lines.push('');
+    // Generic type parameter
+    const genericParam = generic ? `<${generic}>` : '';
+    const genericConstraint = generic ? `<${generic}>` : '';
+    // Props interface
+    const propNodes = kids(node, 'prop');
+    lines.push(`export interface ${name}Props${genericParam} {`);
+    for (const prop of propNodes) {
+        const pp = p(prop);
+        const opt = pp.optional === 'true' || pp.optional === true ? '?' : '';
+        lines.push(`  ${pp.name}${opt}: ${pp.type};`);
+    }
+    lines.push('}');
+    lines.push('');
+    // Component
+    const propNames = propNodes.map(pn => p(pn).name);
+    const destructured = propNames.join(', ');
+    lines.push(`export function ${name}${genericConstraint}({ ${destructured} }: ${name}Props${genericConstraint}) {`);
+    // Once guard — useRef for React 18 Strict Mode double-mount safety
+    if (once) {
+        lines.push(`  const hasRun = useRef(false);`);
+    }
+    // useEffect
+    const depsArr = deps ? `[${deps}]` : '[]';
+    lines.push(`  useEffect(() => {`);
+    if (once) {
+        lines.push(`    if (hasRun.current) return;`);
+        lines.push(`    hasRun.current = true;`);
+    }
+    const code = handlerCode(node);
+    if (code) {
+        for (const line of code.split('\n')) {
+            lines.push(`    ${line}`);
+        }
+    }
+    // Cleanup
+    const cleanupNode = firstChild(node, 'cleanup');
+    if (cleanupNode) {
+        const cleanupCode = p(cleanupNode).code || '';
+        const cleanupDedented = dedent(cleanupCode);
+        lines.push(`    return () => {`);
+        for (const line of cleanupDedented.split('\n')) {
+            lines.push(`      ${line}`);
+        }
+        lines.push(`    };`);
+    }
+    lines.push(`  }, ${depsArr});`);
+    lines.push('');
+    lines.push(`  return null;`);
+    lines.push('}');
+    return lines;
+}
+/** Check if a node is a React codegen node (provider or top-level effect). */
+export function isReactNode(type) {
+    return type === 'provider' || type === 'effect';
+}
+/** Generate TSX for a React codegen node. */
+export function generateReactNode(node) {
+    switch (node.type) {
+        case 'provider': return generateProvider(node);
+        case 'effect': return generateEffect(node);
+        default: return [];
+    }
+}
+//# sourceMappingURL=codegen-react.js.map

package/dist/codegen-react.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @kernlang/react — React transpilers (Tailwind, Next.js, Web) + React codegen
+ */
+export { transpileTailwind } from './transpiler-tailwind.js';
+export { transpileNextjs } from './transpiler-nextjs.js';
+export { transpileWeb } from './transpiler-web.js';
+export { planStructure, classifyNode } from './structure.js';
+export type { StructurePlan, PlannedFile, NodeRole, ExtractedHook } from './structure.js';
+export { buildStructuredArtifacts } from './artifact-utils.js';
+export { generateProvider, generateEffect, generateReactNode, isReactNode } from './codegen-react.js';

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * @kernlang/react — React transpilers (Tailwind, Next.js, Web) + React codegen
+ */
+export { transpileTailwind } from './transpiler-tailwind.js';
+export { transpileNextjs } from './transpiler-nextjs.js';
+export { transpileWeb } from './transpiler-web.js';
+export { planStructure, classifyNode } from './structure.js';
+export { buildStructuredArtifacts } from './artifact-utils.js';
+export { generateProvider, generateEffect, generateReactNode, isReactNode } from './codegen-react.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":"AAAA;;GAEG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/structure.d.ts

@@ -0,0 +1,53 @@
+/**
+ * KERN Structure Planner
+ *
+ * Target-agnostic module that splits an IRNode tree into multiple files
+ * based on a structure pattern (bulletproof, atomic, kern, flat).
+ *
+ * The planner classifies nodes by role, assigns them to files with correct
+ * paths per pattern, extracts hooks (state/logic), and resolves imports.
+ */
+import type { IRNode, GeneratedArtifact, ResolvedKernConfig } from '@kernlang/core';
+export type NodeRole = 'surface' | 'block' | 'element' | 'container' | 'state' | 'logic' | 'theme' | 'meta';
+export interface PlannedFile {
+    path: string;
+    artifactType: GeneratedArtifact['type'];
+    nodes: IRNode[];
+    rootNode: IRNode;
+    dependsOn: string[];
+    isEntry: boolean;
+    componentName?: string;
+}
+export interface StructurePlan {
+    files: PlannedFile[];
+    barrels: BarrelExport[];
+}
+export interface BarrelExport {
+    path: string;
+    exports: {
+        name: string;
+        from: string;
+    }[];
+}
+export interface ExtractedHook {
+    hookName: string;
+    path: string;
+    stateDecls: {
+        name: string;
+        initial: string;
+    }[];
+    logicBlocks: string[];
+    returnedValues: string[];
+    importedBy: string[];
+}
+export declare function classifyNode(node: IRNode): NodeRole;
+export declare function extractHooks(featureName: string, stateNodes: IRNode[], logicNodes: IRNode[], hooksDir: string): ExtractedHook[];
+export declare function generateStateHookCode(hook: ExtractedHook): string;
+export declare function generateLogicHookCode(hook: ExtractedHook, stateHookName?: string): string;
+export declare function generateTypesCode(featureName: string, stateDecls: {
+    name: string;
+    initial: string;
+}[]): string;
+export declare function generateBarrelCode(barrel: BarrelExport): string;
+export declare function adaptPlanForNextjs(plan: StructurePlan, root: IRNode): StructurePlan;
+export declare function planStructure(root: IRNode, config: ResolvedKernConfig): StructurePlan | null;