@kernlang/core 2.0.0

package/dist/styles-tailwind.js

@@ -0,0 +1,197 @@
+import { STYLE_SHORTHANDS, VALUE_SHORTHANDS } from './spec.js';
+// ── Default color palette (canonical source of truth) ────────────────────
+export const DEFAULT_COLORS = {
+    '#18181b': 'zinc-900',
+    '#27272a': 'zinc-800',
+    '#3f3f46': 'zinc-700',
+    '#52525b': 'zinc-600',
+    '#71717a': 'zinc-500',
+    '#a1a1aa': 'zinc-400',
+    '#d4d4d8': 'zinc-300',
+    '#e4e4e7': 'zinc-200',
+    '#f4f4f5': 'zinc-100',
+    '#fafafa': 'zinc-50',
+    '#09090b': 'zinc-950',
+    '#ffffff': 'white',
+    '#fff': 'white',
+    '#FFF': 'white',
+    '#f97316': 'orange-500',
+    '#ea580c': 'orange-600',
+    '#F8F9FA': 'gray-50',
+};
+// ── Style-to-Tailwind mapping ───────────────────────────────────────────
+export function stylesToTailwind(styles, colors) {
+    const classes = [];
+    for (const [key, val] of Object.entries(styles)) {
+        const expanded = STYLE_SHORTHANDS[key] || key;
+        const v = VALUE_SHORTHANDS[val] || val;
+        switch (expanded) {
+            case 'padding':
+                classes.push(pxToTw('p', v));
+                break;
+            case 'paddingTop':
+                classes.push(pxToTw('pt', v));
+                break;
+            case 'paddingBottom':
+                classes.push(pxToTw('pb', v));
+                break;
+            case 'paddingLeft':
+                classes.push(pxToTw('pl', v));
+                break;
+            case 'paddingRight':
+                classes.push(pxToTw('pr', v));
+                break;
+            case 'margin':
+                classes.push(pxToTw('m', v));
+                break;
+            case 'marginTop':
+                classes.push(pxToTw('mt', v));
+                break;
+            case 'marginBottom':
+                classes.push(pxToTw('mb', v));
+                break;
+            case 'marginLeft':
+                classes.push(pxToTw('ml', v));
+                break;
+            case 'marginRight':
+                classes.push(pxToTw('mr', v));
+                break;
+            case 'backgroundColor':
+                classes.push(colorToTw('bg', v, colors));
+                break;
+            case 'color':
+                classes.push(colorToTw('text', v, colors));
+                break;
+            case 'fontSize':
+                classes.push(fsTw(v));
+                break;
+            case 'fontWeight':
+                classes.push(fwTw(v));
+                break;
+            case 'borderRadius':
+                classes.push(pxToTw('rounded', v));
+                break;
+            case 'width':
+                v === '100%' ? classes.push('w-full') : classes.push(`w-[${addPx(v)}]`);
+                break;
+            case 'height':
+                v === '100%' ? classes.push('h-full') : classes.push(`h-[${addPx(v)}]`);
+                break;
+            case 'justifyContent':
+                if (v === 'space-between')
+                    classes.push('justify-between');
+                else if (v === 'space-around')
+                    classes.push('justify-around');
+                else if (v === 'center')
+                    classes.push('justify-center');
+                else if (v === 'flex-end')
+                    classes.push('justify-end');
+                else
+                    classes.push('justify-start');
+                break;
+            case 'alignItems':
+                if (v === 'center')
+                    classes.push('items-center');
+                else if (v === 'flex-start')
+                    classes.push('items-start');
+                else if (v === 'flex-end')
+                    classes.push('items-end');
+                else if (v === 'stretch')
+                    classes.push('items-stretch');
+                break;
+            case 'flexDirection':
+                if (v === 'row')
+                    classes.push('flex-row');
+                break;
+            case 'flex':
+                classes.push(`flex-${v}`);
+                break;
+            case 'gap':
+                classes.push(pxToTw('gap', v));
+                break;
+            case 'borderColor':
+                classes.push(colorToTw('border', v, colors));
+                break;
+            case 'borderWidth':
+                classes.push('border');
+                break;
+            case 'overflow':
+                classes.push(`overflow-${v}`);
+                break;
+            case 'textAlign':
+                classes.push(`text-${v}`);
+                break;
+            case 'elevation':
+                classes.push(`shadow-${v === '0' ? 'none' : v}`);
+                break;
+            case 'opacity':
+                classes.push(`opacity-${Math.round(Number(v) * 100) || v}`);
+                break;
+            case 'position':
+                classes.push(v);
+                break;
+            case 'display':
+                classes.push(v === 'none' ? 'hidden' : v);
+                break;
+            case 'zIndex':
+                classes.push(`z-${v}`);
+                break;
+            default:
+                // Pass through as arbitrary Tailwind property
+                const twVal = v.replace(/ /g, '_');
+                classes.push(`[${cssKebab(expanded)}:${twVal}]`);
+        }
+    }
+    return classes.join(' ');
+}
+export function pxToTw(prefix, v) {
+    const n = Number(v);
+    if (isNaN(n))
+        return `${prefix}-[${v}]`;
+    // Special handling for border-radius → Tailwind rounded classes
+    if (prefix === 'rounded') {
+        const roundedMap = {
+            0: 'rounded-none', 2: 'rounded-sm', 4: 'rounded', 6: 'rounded-md',
+            8: 'rounded-lg', 12: 'rounded-xl', 16: 'rounded-2xl', 20: 'rounded-[20px]',
+            9999: 'rounded-full',
+        };
+        return roundedMap[n] || `rounded-[${n}px]`;
+    }
+    // Tailwind spacing scale: 1=4px, 2=8px, 3=12px, 4=16px, 5=20px, 6=24px, 8=32px
+    const twMap = {
+        0: '0', 1: 'px', 2: '0.5', 4: '1', 6: '1.5', 8: '2', 10: '2.5',
+        12: '3', 14: '3.5', 16: '4', 20: '5', 24: '6', 28: '7', 32: '8',
+        36: '9', 40: '10', 44: '11', 48: '12',
+    };
+    return twMap[n] !== undefined ? `${prefix}-${twMap[n]}` : `${prefix}-[${n}px]`;
+}
+export function colorToTw(prefix, v, colors) {
+    const colorMap = colors ?? DEFAULT_COLORS;
+    const mapped = colorMap[v];
+    return mapped ? `${prefix}-${mapped}` : `${prefix}-[${v}]`;
+}
+export function fsTw(v) {
+    const map = {
+        '10': 'text-[10px]', '11': 'text-[11px]', '12': 'text-xs', '13': 'text-[13px]',
+        '14': 'text-sm', '16': 'text-base', '18': 'text-lg', '20': 'text-xl',
+        '24': 'text-2xl', '28': 'text-[28px]', '30': 'text-3xl',
+    };
+    return map[v] || `text-[${v}px]`;
+}
+export function fwTw(v) {
+    const map = {
+        '300': 'font-light', '400': 'font-normal', '500': 'font-medium',
+        '600': 'font-semibold', '700': 'font-bold', '800': 'font-extrabold',
+        '900': 'font-black', 'bold': 'font-bold', 'normal': 'font-normal',
+        'medium': 'font-medium', 'semibold': 'font-semibold',
+    };
+    return map[v] || `font-[${v}]`;
+}
+export function addPx(v) {
+    const n = Number(v);
+    return isNaN(n) ? v : `${n}px`;
+}
+export function cssKebab(s) {
+    return s.replace(/([A-Z])/g, '-$1').toLowerCase();
+}
+//# sourceMappingURL=styles-tailwind.js.map

package/dist/styles-tailwind.js.map

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

package/dist/template-catalog.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Kern Template Catalog — built-in templates for popular libraries
+ *
+ * `kern init-templates` reads package.json, matches against this catalog,
+ * and scaffolds template .kern files for detected libraries.
+ *
+ * Any AI assistant just runs `kern init-templates` and the project is ready.
+ */
+export interface CatalogEntry {
+    /** npm package name that triggers this template */
+    packageName: string;
+    /** Human-friendly library name */
+    libraryName: string;
+    /** Template files to scaffold: filename → content */
+    templates: Record<string, string>;
+}
+export declare const TEMPLATE_CATALOG: CatalogEntry[];
+/** Always-included templates (framework-agnostic patterns) */
+export declare const COMMON_TEMPLATES: Record<string, string>;
+/**
+ * Detect which catalog entries match a project's package.json.
+ */
+export declare function detectTemplates(packageJson: {
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+}): CatalogEntry[];

package/dist/template-catalog.js

@@ -0,0 +1,228 @@
+/**
+ * Kern Template Catalog — built-in templates for popular libraries
+ *
+ * `kern init-templates` reads package.json, matches against this catalog,
+ * and scaffolds template .kern files for detected libraries.
+ *
+ * Any AI assistant just runs `kern init-templates` and the project is ready.
+ */
+// ── Zustand ─────────────────────────────────────────────────────────────
+const ZUSTAND_STORE = `template name=zustand-store
+  slot name=storeName type=identifier
+  slot name=stateType type=identifier
+  import from=zustand names=create
+  body <<<
+    export const use{{storeName}}Store = create<{{stateType}}>((set, get) => ({
+      {{CHILDREN}}
+    }));
+  >>>
+`;
+const ZUSTAND_SELECTOR = `template name=zustand-selector
+  slot name=selectorName type=identifier
+  slot name=stateType type=identifier
+  slot name=field type=expr
+  body <<<
+    export const select{{selectorName}} = (s: {{stateType}}) => s.{{field}};
+  >>>
+`;
+// ── SWR ─────────────────────────────────────────────────────────────────
+const SWR_HOOK = `template name=swr-hook
+  slot name=hookName type=identifier
+  slot name=cacheKey type=expr
+  slot name=fetcher type=expr optional=true default=defaultFetcher
+  import from=swr names=useSWR
+  body <<<
+    export function {{hookName}}() {
+      const { data, error, isLoading } = useSWR(
+        {{cacheKey}},
+        {{fetcher}}
+      );
+
+      {{CHILDREN}}
+
+      return { data, error, isLoading };
+    }
+  >>>
+`;
+// ── React Query / TanStack Query ────────────────────────────────────────
+const REACT_QUERY_HOOK = `template name=query-hook
+  slot name=hookName type=identifier
+  slot name=queryKey type=expr
+  slot name=queryFn type=expr
+  import from=@tanstack/react-query names=useQuery
+  body <<<
+    export function {{hookName}}() {
+      const { data, error, isLoading, refetch } = useQuery({
+        queryKey: [{{queryKey}}],
+        queryFn: {{queryFn}},
+      });
+
+      {{CHILDREN}}
+
+      return { data, error, isLoading, refetch };
+    }
+  >>>
+`;
+const REACT_MUTATION = `template name=mutation-hook
+  slot name=hookName type=identifier
+  slot name=mutationFn type=expr
+  import from=@tanstack/react-query names=useMutation
+  body <<<
+    export function {{hookName}}() {
+      const mutation = useMutation({
+        mutationFn: {{mutationFn}},
+        {{CHILDREN}}
+      });
+
+      return mutation;
+    }
+  >>>
+`;
+// ── tRPC ────────────────────────────────────────────────────────────────
+const TRPC_QUERY = `template name=trpc-query
+  slot name=hookName type=identifier
+  slot name=route type=expr
+  slot name=input type=expr optional=true
+  body <<<
+    export function {{hookName}}({{input}}) {
+      const query = api.{{route}}.useQuery({{input}});
+
+      {{CHILDREN}}
+
+      return query;
+    }
+  >>>
+`;
+// ── XState ──────────────────────────────────────────────────────────────
+const XSTATE_MACHINE = `template name=xstate-machine
+  slot name=machineName type=identifier
+  slot name=contextType type=identifier optional=true
+  import from=xstate names="setup,assign"
+  body <<<
+    export const {{machineName}}Machine = setup({
+      types: {
+        context: {} as {{contextType}},
+      },
+      guards: {
+        {{CHILDREN}}
+      },
+    }).createMachine({
+      id: '{{machineName}}',
+      context: ({input}) => input,
+    });
+  >>>
+`;
+// ── Jotai ───────────────────────────────────────────────────────────────
+const JOTAI_ATOM = `template name=jotai-atom
+  slot name=atomName type=identifier
+  slot name=atomType type=type
+  slot name=initialValue type=expr
+  import from=jotai names=atom
+  body <<<
+    export const {{atomName}}Atom = atom<{{atomType}}>({{initialValue}});
+  >>>
+`;
+const JOTAI_DERIVED = `template name=jotai-derived
+  slot name=atomName type=identifier
+  slot name=sourceAtom type=identifier
+  import from=jotai names="atom,useAtomValue"
+  body <<<
+    export const {{atomName}}Atom = atom((get) => {
+      const source = get({{sourceAtom}}Atom);
+      {{CHILDREN}}
+    });
+  >>>
+`;
+// ── Arrow Function Export ───────────────────────────────────────────────
+const ARROW_FN = `template name=arrow-fn
+  slot name=name type=identifier
+  slot name=params type=expr optional=true
+  slot name=returnType type=type optional=true
+  body <<<
+    export const {{name}} = ({{params}}){{returnType}} => {
+      {{CHILDREN}}
+    };
+  >>>
+`;
+// ── Window Event Hook ───────────────────────────────────────────────────
+const WINDOW_EVENT = `template name=window-event
+  slot name=hookName type=identifier
+  slot name=eventName type=expr
+  import from=react names="useEffect,useCallback"
+  body <<<
+    export function {{hookName}}() {
+      const handleEvent = useCallback((e: Event) => {
+        {{CHILDREN}}
+      }, []);
+
+      useEffect(() => {
+        window.addEventListener({{eventName}}, handleEvent);
+        return () => window.removeEventListener({{eventName}}, handleEvent);
+      }, [handleEvent]);
+    }
+  >>>
+`;
+// ── Catalog ─────────────────────────────────────────────────────────────
+export const TEMPLATE_CATALOG = [
+    {
+        packageName: 'zustand',
+        libraryName: 'Zustand',
+        templates: {
+            'zustand-store.kern': ZUSTAND_STORE,
+            'zustand-selector.kern': ZUSTAND_SELECTOR,
+        },
+    },
+    {
+        packageName: 'swr',
+        libraryName: 'SWR',
+        templates: {
+            'swr-hook.kern': SWR_HOOK,
+        },
+    },
+    {
+        packageName: '@tanstack/react-query',
+        libraryName: 'TanStack Query',
+        templates: {
+            'query-hook.kern': REACT_QUERY_HOOK,
+            'mutation-hook.kern': REACT_MUTATION,
+        },
+    },
+    {
+        packageName: '@trpc/react-query',
+        libraryName: 'tRPC',
+        templates: {
+            'trpc-query.kern': TRPC_QUERY,
+        },
+    },
+    {
+        packageName: 'xstate',
+        libraryName: 'XState',
+        templates: {
+            'xstate-machine.kern': XSTATE_MACHINE,
+        },
+    },
+    {
+        packageName: 'jotai',
+        libraryName: 'Jotai',
+        templates: {
+            'jotai-atom.kern': JOTAI_ATOM,
+            'jotai-derived.kern': JOTAI_DERIVED,
+        },
+    },
+];
+/** Always-included templates (framework-agnostic patterns) */
+export const COMMON_TEMPLATES = {
+    'arrow-fn.kern': ARROW_FN,
+    'window-event.kern': WINDOW_EVENT,
+};
+/**
+ * Detect which catalog entries match a project's package.json.
+ */
+export function detectTemplates(packageJson) {
+    const allDeps = {
+        ...packageJson.dependencies,
+        ...packageJson.devDependencies,
+    };
+    return TEMPLATE_CATALOG.filter(entry => entry.packageName in allDeps);
+}
+//# sourceMappingURL=template-catalog.js.map

package/dist/template-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-catalog.js","sourceRoot":"","sources":["../src/template-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAWH,2EAA2E;AAE3E,MAAM,aAAa,GAAG;;;;;;;;;CASrB,CAAC;AAEF,MAAM,gBAAgB,GAAG;;;;;;;CAOxB,CAAC;AAEF,2EAA2E;AAE3E,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;CAiBhB,CAAC;AAEF,2EAA2E;AAE3E,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;CAiBxB,CAAC;AAEF,MAAM,cAAc,GAAG;;;;;;;;;;;;;;CActB,CAAC;AAEF,2EAA2E;AAE3E,MAAM,UAAU,GAAG;;;;;;;;;;;;;CAalB,CAAC;AAEF,2EAA2E;AAE3E,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;CAiBtB,CAAC;AAEF,2EAA2E;AAE3E,MAAM,UAAU,GAAG;;;;;;;;CAQlB,CAAC;AAEF,MAAM,aAAa,GAAG;;;;;;;;;;CAUrB,CAAC;AAEF,2EAA2E;AAE3E,MAAM,QAAQ,GAAG;;;;;;;;;CAShB,CAAC;AAEF,2EAA2E;AAE3E,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;CAgBpB,CAAC;AAEF,2EAA2E;AAE3E,MAAM,CAAC,MAAM,gBAAgB,GAAmB;IAC9C;QACE,WAAW,EAAE,SAAS;QACtB,WAAW,EAAE,SAAS;QACtB,SAAS,EAAE;YACT,oBAAoB,EAAE,aAAa;YACnC,uBAAuB,EAAE,gBAAgB;SAC1C;KACF;IACD;QACE,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,KAAK;QAClB,SAAS,EAAE;YACT,eAAe,EAAE,QAAQ;SAC1B;KACF;IACD;QACE,WAAW,EAAE,uBAAuB;QACpC,WAAW,EAAE,gBAAgB;QAC7B,SAAS,EAAE;YACT,iBAAiB,EAAE,gBAAgB;YACnC,oBAAoB,EAAE,cAAc;SACrC;KACF;IACD;QACE,WAAW,EAAE,mBAAmB;QAChC,WAAW,EAAE,MAAM;QACnB,SAAS,EAAE;YACT,iBAAiB,EAAE,UAAU;SAC9B;KACF;IACD;QACE,WAAW,EAAE,QAAQ;QACrB,WAAW,EAAE,QAAQ;QACrB,SAAS,EAAE;YACT,qBAAqB,EAAE,cAAc;SACtC;KACF;IACD;QACE,WAAW,EAAE,OAAO;QACpB,WAAW,EAAE,OAAO;QACpB,SAAS,EAAE;YACT,iBAAiB,EAAE,UAAU;YAC7B,oBAAoB,EAAE,aAAa;SACpC;KACF;CACF,CAAC;AAEF,8DAA8D;AAC9D,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACtD,eAAe,EAAE,QAAQ;IACzB,mBAAmB,EAAE,YAAY;CAClC,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,WAG/B;IACC,MAAM,OAAO,GAAG;QACd,GAAG,WAAW,CAAC,YAAY;QAC3B,GAAG,WAAW,CAAC,eAAe;KAC/B,CAAC;IAEF,OAAO,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,WAAW,IAAI,OAAO,CAAC,CAAC;AACxE,CAAC"}

package/dist/template-engine.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Kern Template Engine — dynamic pattern support
+ *
+ * Users define reusable code patterns in .kern files with typed slots.
+ * Templates are registered at config/CLI time, then expanded during codegen.
+ */
+import type { IRNode, TemplateDefinition } from './types.js';
+export declare class KernTemplateError extends Error {
+    constructor(message: string);
+}
+/**
+ * Register a template from a parsed 'template' IRNode.
+ * Extracts slot definitions, import declarations, and body from children.
+ */
+export declare function registerTemplate(node: IRNode, sourceFile?: string): void;
+/** Check if a node type matches a registered template. */
+export declare function isTemplateNode(type: string): boolean;
+/** Clear all registered templates (for test isolation). */
+export declare function clearTemplates(): void;
+/** Get a registered template definition by name. */
+export declare function getTemplate(name: string): TemplateDefinition | undefined;
+/** Get count of registered templates. */
+export declare function templateCount(): number;
+/**
+ * Expand a template instance node into TypeScript lines.
+ *
+ * 1. Look up template definition
+ * 2. Validate required slots against node.props
+ * 3. Replace {{slotName}} placeholders in body
+ * 4. Handle {{CHILDREN}}: iterate child nodes through codegen
+ * 5. Prepend import lines
+ */
+export declare function expandTemplateNode(node: IRNode, _depth?: number): string[];