@zod-to-form/codegen 0.6.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-present Pradeep Mouli
+
+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/dist/config-template.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Browser-safe config template generator.
+ * Produces the defineConfig({...}) source string used by both the CLI
+ * init command and the playground.
+ */
+export type ConfigTemplateOptions = {
+    /** Component module import path (e.g. './components/ui') */
+    componentSource: string;
+    /** Component type import specifier for generics (e.g. './components/ui') */
+    componentTypeImport?: string;
+    /** Schema type import specifier (e.g. './schema') */
+    schemaTypeImport?: string;
+    /** Schema export names for the schemas block */
+    schemaExports?: string[];
+    /** Preset name: 'shadcn' | 'html' */
+    preset?: 'shadcn' | 'html';
+    /** Component overrides (name → { controlled?: boolean }) */
+    overrides?: Record<string, {
+        controlled?: boolean;
+    }>;
+    /** Defaults block */
+    defaults?: {
+        mode?: 'submit' | 'auto-save';
+        ui?: 'shadcn' | 'html';
+        overwrite?: boolean;
+        serverAction?: boolean;
+        formProvider?: boolean;
+        optimization?: {
+            level?: 1 | 2 | 3;
+        };
+    };
+    /** Per-field overrides */
+    fields?: Record<string, Record<string, unknown>>;
+};
+export declare function buildConfigSource(opts: ConfigTemplateOptions): string;
+//# sourceMappingURL=config-template.d.ts.map

package/dist/config-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-template.d.ts","sourceRoot":"","sources":["../src/config-template.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,qBAAqB,GAAG;IAClC,4DAA4D;IAC5D,eAAe,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,qCAAqC;IACrC,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC3B,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACrD,qBAAqB;IACrB,QAAQ,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;QAC9B,EAAE,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,YAAY,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;SAAE,CAAC;KACtC,CAAC;IACF,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAClD,CAAC;AAOF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,CAmHrE"}

package/dist/config-template.js

@@ -0,0 +1,113 @@
+/**
+ * Browser-safe config template generator.
+ * Produces the defineConfig({...}) source string used by both the CLI
+ * init command and the playground.
+ */
+const PRESET_IMPORT_NAME = {
+    shadcn: 'SHADCN_OVERRIDES',
+    html: 'DEFAULT_OVERRIDES'
+};
+export function buildConfigSource(opts) {
+    const preset = opts.preset;
+    const presetImportName = preset ? PRESET_IMPORT_NAME[preset] : undefined;
+    // Imports
+    const importNames = ['defineConfig'];
+    if (presetImportName)
+        importNames.push(presetImportName);
+    const lines = [`import { ${importNames.join(', ')} } from '@zod-to-form/core';`];
+    const componentTypeImport = opts.componentTypeImport ?? opts.componentSource;
+    lines.push('');
+    lines.push(`import type * as Components from '${componentTypeImport}';`);
+    if (opts.schemaTypeImport) {
+        lines.push(`import type * as ZodSchemas from '${opts.schemaTypeImport}';`);
+    }
+    // defineConfig opening
+    const hasSchemas = opts.schemaTypeImport || (opts.schemaExports && opts.schemaExports.length > 0);
+    const generics = hasSchemas ? '<typeof Components, typeof ZodSchemas>' : '<typeof Components>';
+    lines.push('');
+    lines.push(`export default defineConfig${generics}({`);
+    // components block
+    lines.push(`  components: {`);
+    lines.push(`    source: '${opts.componentSource}',`);
+    if (preset) {
+        lines.push(`    preset: '${preset}',`);
+    }
+    // overrides
+    const overrideEntries = opts.overrides
+        ? Object.entries(opts.overrides).filter(([, v]) => v.controlled)
+        : [];
+    if (presetImportName || overrideEntries.length > 0) {
+        lines.push(`    overrides: {`);
+        if (presetImportName) {
+            const comma = overrideEntries.length > 0 ? ',' : '';
+            lines.push(`      ...${presetImportName}${comma}`);
+        }
+        overrideEntries.forEach(([name], i) => {
+            const comma = i < overrideEntries.length - 1 ? ',' : '';
+            lines.push(`      ${name}: { controlled: true }${comma}`);
+        });
+        lines.push(`    }`);
+    }
+    lines.push(`  },`);
+    // defaults block
+    const defaults = {
+        mode: 'submit',
+        ui: preset === 'shadcn' ? 'shadcn' : 'html',
+        overwrite: false,
+        serverAction: false,
+        formProvider: false,
+        ...opts.defaults
+    };
+    lines.push(`  defaults: {`);
+    lines.push(`    mode: '${defaults.mode}',`);
+    lines.push(`    ui: '${defaults.ui}',`);
+    lines.push(`    overwrite: ${defaults.overwrite},`);
+    lines.push(`    serverAction: ${defaults.serverAction},`);
+    lines.push(`    formProvider: ${defaults.formProvider},`);
+    if (defaults.optimization?.level) {
+        lines.push(`    optimization: { level: ${defaults.optimization.level} }`);
+    }
+    else {
+        lines.push(`    // optimization: { level: 2 }  // 1 = decompose, 2 = native rules, 3 = cross-field`);
+    }
+    lines.push(`  },`);
+    // include/exclude
+    lines.push(`  include: [],`);
+    // fields block
+    const fieldEntries = opts.fields
+        ? Object.entries(opts.fields).filter(([, v]) => {
+            return v && Object.values(v).some((val) => val !== undefined);
+        })
+        : [];
+    if (fieldEntries.length > 0) {
+        lines.push(`  exclude: [],`);
+        lines.push(`  fields: {`);
+        fieldEntries.forEach(([key, config], i) => {
+            const props = Object.entries(config)
+                .filter(([, v]) => v !== undefined)
+                .map(([k, v]) => `${k}: ${JSON.stringify(v)}`)
+                .join(', ');
+            const comma = i < fieldEntries.length - 1 ? ',' : '';
+            lines.push(`    '${key}': { ${props} }${comma}`);
+        });
+        lines.push(`  }`);
+    }
+    else {
+        lines.push(`  exclude: []`);
+    }
+    // schemas block
+    const schemaExports = opts.schemaExports ?? [];
+    if (schemaExports.length > 0) {
+        lines[lines.length - 1] += ',';
+        lines.push(`  schemas: {`);
+        schemaExports.forEach((name, i) => {
+            const comma = i < schemaExports.length - 1 ? ',' : '';
+            lines.push(`    ${name}: {}${comma}`);
+        });
+        lines.push(`  }`);
+    }
+    lines.push(`});`);
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=config-template.js.map

package/dist/config-template.js.map

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

package/dist/field-templates.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Preset field template source code, emitted as standalone files alongside generated forms.
+ * Each template is a React component implementing FieldTemplateProps.
+ */
+export declare const SHADCN_FIELD_TEMPLATE = "import type { ReactNode } from 'react';\nimport {\n  FormControl,\n  FormDescription,\n  FormField,\n  FormItem,\n  FormLabel,\n  FormMessage\n} from './ui/form';\n\nexport interface FieldTemplateProps {\n  children: ReactNode;\n  label: string;\n  description?: string;\n  helpText?: string;\n  error?: string;\n  name: string;\n  required?: boolean;\n  disabled?: boolean;\n  deprecated?: boolean;\n}\n\nexport function FieldTemplate({\n  children,\n  label,\n  description,\n  helpText,\n  error,\n  name,\n  deprecated\n}: FieldTemplateProps) {\n  return (\n    <FormItem>\n      <FormLabel htmlFor={name}>\n        {deprecated ? <s>{label}</s> : label}\n        {deprecated ? (\n          <span aria-hidden=\"true\" title=\"Deprecated\"> \u26A0</span>\n        ) : null}\n      </FormLabel>\n      <FormControl>{children}</FormControl>\n      {description ? <FormDescription>{description}</FormDescription> : null}\n      {helpText ? (\n        <p className=\"text-sm text-muted-foreground mt-1\">{helpText}</p>\n      ) : null}\n      {error ? <FormMessage>{error}</FormMessage> : null}\n    </FormItem>\n  );\n}\n";
+export declare const HTML_FIELD_TEMPLATE = "import type { ReactNode } from 'react';\n\nexport interface FieldTemplateProps {\n  children: ReactNode;\n  label: string;\n  description?: string;\n  helpText?: string;\n  error?: string;\n  name: string;\n  required?: boolean;\n  disabled?: boolean;\n  deprecated?: boolean;\n}\n\nexport function FieldTemplate({\n  children,\n  label,\n  description,\n  helpText,\n  error,\n  name,\n  deprecated\n}: FieldTemplateProps) {\n  return (\n    <div>\n      <label htmlFor={name}>\n        {deprecated ? <s>{label}</s> : label}\n        {deprecated ? (\n          <span aria-hidden=\"true\" title=\"Deprecated\"> \u26A0</span>\n        ) : null}\n      </label>\n      {children}\n      {description ? <p>{description}</p> : null}\n      {helpText ? (\n        <p style={{ fontSize: '0.875rem', color: '#6b7280', marginTop: '0.25rem' }}>\n          {helpText}\n        </p>\n      ) : null}\n      {error ? <p role=\"alert\">{error}</p> : null}\n    </div>\n  );\n}\n";
+/** Components that each preset's field template imports from the component source */
+export declare const PRESET_TEMPLATE_IMPORTS: Record<string, string[]>;
+export declare function getFieldTemplateSource(preset: 'shadcn' | 'html'): string;
+//# sourceMappingURL=field-templates.d.ts.map

package/dist/field-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-templates.d.ts","sourceRoot":"","sources":["../src/field-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,qBAAqB,qmCAgDjC,CAAC;AAEF,eAAO,MAAM,mBAAmB,08BA0C/B,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAG5D,CAAC;AAEF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAExE"}

package/dist/field-templates.js

@@ -0,0 +1,105 @@
+/**
+ * Preset field template source code, emitted as standalone files alongside generated forms.
+ * Each template is a React component implementing FieldTemplateProps.
+ */
+export const SHADCN_FIELD_TEMPLATE = `import type { ReactNode } from 'react';
+import {
+  FormControl,
+  FormDescription,
+  FormField,
+  FormItem,
+  FormLabel,
+  FormMessage
+} from './ui/form';
+
+export interface FieldTemplateProps {
+  children: ReactNode;
+  label: string;
+  description?: string;
+  helpText?: string;
+  error?: string;
+  name: string;
+  required?: boolean;
+  disabled?: boolean;
+  deprecated?: boolean;
+}
+
+export function FieldTemplate({
+  children,
+  label,
+  description,
+  helpText,
+  error,
+  name,
+  deprecated
+}: FieldTemplateProps) {
+  return (
+    <FormItem>
+      <FormLabel htmlFor={name}>
+        {deprecated ? <s>{label}</s> : label}
+        {deprecated ? (
+          <span aria-hidden="true" title="Deprecated"> ⚠</span>
+        ) : null}
+      </FormLabel>
+      <FormControl>{children}</FormControl>
+      {description ? <FormDescription>{description}</FormDescription> : null}
+      {helpText ? (
+        <p className="text-sm text-muted-foreground mt-1">{helpText}</p>
+      ) : null}
+      {error ? <FormMessage>{error}</FormMessage> : null}
+    </FormItem>
+  );
+}
+`;
+export const HTML_FIELD_TEMPLATE = `import type { ReactNode } from 'react';
+
+export interface FieldTemplateProps {
+  children: ReactNode;
+  label: string;
+  description?: string;
+  helpText?: string;
+  error?: string;
+  name: string;
+  required?: boolean;
+  disabled?: boolean;
+  deprecated?: boolean;
+}
+
+export function FieldTemplate({
+  children,
+  label,
+  description,
+  helpText,
+  error,
+  name,
+  deprecated
+}: FieldTemplateProps) {
+  return (
+    <div>
+      <label htmlFor={name}>
+        {deprecated ? <s>{label}</s> : label}
+        {deprecated ? (
+          <span aria-hidden="true" title="Deprecated"> ⚠</span>
+        ) : null}
+      </label>
+      {children}
+      {description ? <p>{description}</p> : null}
+      {helpText ? (
+        <p style={{ fontSize: '0.875rem', color: '#6b7280', marginTop: '0.25rem' }}>
+          {helpText}
+        </p>
+      ) : null}
+      {error ? <p role="alert">{error}</p> : null}
+    </div>
+  );
+}
+`;
+/** Components that each preset's field template imports from the component source */
+export const PRESET_TEMPLATE_IMPORTS = {
+    shadcn: ['FormControl', 'FormDescription', 'FormField', 'FormItem', 'FormLabel', 'FormMessage'],
+    html: []
+};
+export function getFieldTemplateSource(preset) {
+    return preset === 'shadcn' ? SHADCN_FIELD_TEMPLATE : HTML_FIELD_TEMPLATE;
+}
+//# sourceMappingURL=field-templates.js.map

package/dist/field-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-templates.js","sourceRoot":"","sources":["../src/field-templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgDpC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0ClC,CAAC;AAEF,qFAAqF;AACrF,MAAM,CAAC,MAAM,uBAAuB,GAA6B;IAC/D,MAAM,EAAE,CAAC,aAAa,EAAE,iBAAiB,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,CAAC;IAC/F,IAAI,EAAE,EAAE;CACT,CAAC;AAEF,MAAM,UAAU,sBAAsB,CAAC,MAAyB;IAC9D,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,mBAAmB,CAAC;AAC3E,CAAC"}

package/dist/generate.d.ts

@@ -0,0 +1,31 @@
+import type { FormField } from '@zod-to-form/core';
+import type { ComponentOverride, FieldConfig, ZodFormsConfig } from '@zod-to-form/core';
+export type CodegenConfig = {
+    /** Optional pre-computed import path for the schema (e.g., './schema.js'). Defaults to './schema'. The CLI typically computes this from file paths; the browser playground can pass it explicitly. */
+    schemaImportPath?: string;
+    exportName: string;
+    componentName: string;
+    mode: 'submit' | 'auto-save';
+    componentConfig?: ZodFormsConfig<Record<string, unknown>>;
+    ui: 'shadcn' | 'html';
+    /** @deprecated Currently unused. Reserved for future server action codegen support. */
+    serverAction?: boolean;
+    /** Force FormProvider wrapper in submit mode. Auto-save mode always uses FormProvider regardless. */
+    formProvider?: boolean;
+    /** Validation optimization level. When set, generated code uses per-field validation instead of zodResolver. */
+    validationLevel?: 1 | 2 | 3;
+    /** SchemaLite for submit-time validation of top-level effects (null when no effects exist) */
+    schemaLite?: import('zod/v4/core').$ZodType | null;
+    /** Codegen metadata for generating the .lite.ts file */
+    schemaLiteInfo?: import('@zod-to-form/core').SchemaLiteInfo;
+    /** Output path of the form component — used to compute the .lite.ts import path */
+    outputPath?: string;
+};
+export declare function resolveFieldMapping<TComponents extends Record<string, unknown>>(fieldKey: string, componentName: string | undefined, componentConfig: ZodFormsConfig<TComponents> | undefined): {
+    componentOverride?: ComponentOverride;
+    override?: FieldConfig;
+    componentName?: string;
+    source: 'fields' | 'components' | 'none';
+};
+export declare function generateFormComponent(fields: FormField[], config: CodegenConfig): string;
+//# sourceMappingURL=generate.d.ts.map

package/dist/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../src/generate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AASxF,MAAM,MAAM,aAAa,GAAG;IAC1B,sMAAsM;IACtM,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC7B,eAAe,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,EAAE,EAAE,QAAQ,GAAG,MAAM,CAAC;IACtB,uFAAuF;IACvF,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qGAAqG;IACrG,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gHAAgH;IAChH,eAAe,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,8FAA8F;IAC9F,UAAU,CAAC,EAAE,OAAO,aAAa,EAAE,QAAQ,GAAG,IAAI,CAAC;IACnD,wDAAwD;IACxD,cAAc,CAAC,EAAE,OAAO,mBAAmB,EAAE,cAAc,CAAC;IAC5D,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AA4IF,wBAAgB,mBAAmB,CAAC,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7E,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,eAAe,EAAE,cAAc,CAAC,WAAW,CAAC,GAAG,SAAS,GACvD;IACD,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,QAAQ,GAAG,YAAY,GAAG,MAAM,CAAC;CAC1C,CAkCA;AA4WD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,CAyLxF"}