@stonecrop/schema 0.8.7 → 0.8.9

package/dist/cli.cjs

@@ -38,3 +38,4 @@ EXAMPLES:
   stonecrop-schema generate -e http://localhost:5000/graphql -o ./schemas \\
     --include "User,Post,Comment"
 `)}$().catch(e=>{console.error("Error:",e.message),process.exit(1)});
+//# sourceMappingURL=cli.cjs.map

package/dist/cli.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.cjs","sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * Stonecrop Schema CLI\n *\n * Converts GraphQL introspection results to Stonecrop doctype JSON schemas.\n *\n * Usage:\n *   stonecrop-schema generate --endpoint <url> --output <dir>\n *   stonecrop-schema generate --introspection <file.json> --output <dir>\n *   stonecrop-schema generate --sdl <file.graphql> --output <dir>\n *\n * @packageDocumentation\n */\n\nimport { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs'\nimport { resolve, join } from 'node:path'\nimport { parseArgs } from 'node:util'\nimport { getIntrospectionQuery, type IntrospectionQuery } from 'graphql'\n\nimport { convertGraphQLSchema } from './converter/index'\nimport { validateDoctype } from './validation'\nimport type { GraphQLConversionOptions } from './converter/types'\n\n/**\n * Fetch an introspection result from a live GraphQL endpoint.\n *\n * @param endpoint - The GraphQL endpoint URL\n * @param headers - Optional HTTP headers\n * @returns The introspection query result\n */\nasync function fetchIntrospection(endpoint: string, headers?: Record<string, string>): Promise<IntrospectionQuery> {\n\tconst response = await fetch(endpoint, {\n\t\tmethod: 'POST',\n\t\theaders: {\n\t\t\t'Content-Type': 'application/json',\n\t\t\t...headers,\n\t\t},\n\t\tbody: JSON.stringify({\n\t\t\tquery: getIntrospectionQuery(),\n\t\t}),\n\t})\n\n\tif (!response.ok) {\n\t\tthrow new Error(`Failed to fetch introspection: ${response.status} ${response.statusText}`)\n\t}\n\n\tconst json = (await response.json()) as {\n\t\tdata?: IntrospectionQuery\n\t\terrors?: Array<{ message: string }>\n\t}\n\n\tif (json.errors?.length) {\n\t\tthrow new Error(`GraphQL errors: ${json.errors.map(e => e.message).join(', ')}`)\n\t}\n\n\tif (!json.data) {\n\t\tthrow new Error('No data in introspection response')\n\t}\n\n\treturn json.data\n}\n\nasync function main(): Promise<void> {\n\tconst { values, positionals } = parseArgs({\n\t\tallowPositionals: true,\n\t\toptions: {\n\t\t\tendpoint: { type: 'string', short: 'e' },\n\t\t\tintrospection: { type: 'string', short: 'i' },\n\t\t\tsdl: { type: 'string', short: 's' },\n\t\t\toutput: { type: 'string', short: 'o' },\n\t\t\tinclude: { type: 'string' },\n\t\t\texclude: { type: 'string' },\n\t\t\toverrides: { type: 'string' },\n\t\t\t'custom-scalars': { type: 'string' },\n\t\t\t'include-unmapped': { type: 'boolean', default: false },\n\t\t\thelp: { type: 'boolean', short: 'h' },\n\t\t},\n\t})\n\n\tconst command = positionals[0]\n\n\tif (values.help || !command) {\n\t\tprintHelp()\n\t\tprocess.exit(command ? 0 : 1)\n\t}\n\n\tif (command !== 'generate') {\n\t\tconsole.error(`Unknown command: ${command}`)\n\t\tconsole.error('Available commands: generate')\n\t\tprocess.exit(1)\n\t}\n\n\t// Determine source\n\tconst sourceCount = [values.endpoint, values.introspection, values.sdl].filter(Boolean).length\n\tif (sourceCount !== 1) {\n\t\tconsole.error('Exactly one of --endpoint, --introspection, or --sdl must be provided')\n\t\tprocess.exit(1)\n\t}\n\n\tif (!values.output) {\n\t\tconsole.error('--output <dir> is required')\n\t\tprocess.exit(1)\n\t}\n\n\tconst outputDir = resolve(values.output)\n\n\t// Build conversion options\n\tconst options: GraphQLConversionOptions = {\n\t\tincludeUnmappedMeta: values['include-unmapped'],\n\t}\n\n\tif (values.include) {\n\t\toptions.include = values.include.split(',').map(s => s.trim())\n\t}\n\n\tif (values.exclude) {\n\t\toptions.exclude = values.exclude.split(',').map(s => s.trim())\n\t}\n\n\tif (values.overrides) {\n\t\tconst overridesPath = resolve(values.overrides)\n\t\tconst overridesContent = readFileSync(overridesPath, 'utf-8')\n\t\toptions.typeOverrides = JSON.parse(overridesContent)\n\t}\n\n\tif (values['custom-scalars']) {\n\t\tconst scalarsPath = resolve(values['custom-scalars'])\n\t\tconst scalarsContent = readFileSync(scalarsPath, 'utf-8')\n\t\toptions.customScalars = JSON.parse(scalarsContent)\n\t}\n\n\t// Resolve source\n\tlet source: IntrospectionQuery | string\n\n\tif (values.endpoint) {\n\t\tconsole.log(`Fetching introspection from ${values.endpoint}...`)\n\t\tsource = await fetchIntrospection(values.endpoint)\n\t} else if (values.introspection) {\n\t\tconst filePath = resolve(values.introspection)\n\t\tconst content = readFileSync(filePath, 'utf-8')\n\t\tconst parsed = JSON.parse(content)\n\t\t// Handle both { data: { __schema: ... } } and { __schema: ... } formats\n\t\tsource = parsed.data ?? parsed\n\t} else {\n\t\tconst filePath = resolve(values.sdl!)\n\t\tsource = readFileSync(filePath, 'utf-8')\n\t}\n\n\t// Convert\n\tconst doctypes = convertGraphQLSchema(source, options)\n\n\tif (doctypes.length === 0) {\n\t\tconsole.warn('No entity types found in the schema. Check your include/exclude filters.')\n\t\tprocess.exit(0)\n\t}\n\n\t// Write output\n\tif (!existsSync(outputDir)) {\n\t\tmkdirSync(outputDir, { recursive: true })\n\t}\n\n\tlet warnings = 0\n\tlet errors = 0\n\n\tfor (const doctype of doctypes) {\n\t\tconst fileName = `${doctype.slug}.json`\n\t\tconst filePath = join(outputDir, fileName)\n\t\tconst json = JSON.stringify(doctype, null, '\\t')\n\n\t\twriteFileSync(filePath, json + '\\n', 'utf-8')\n\n\t\t// Validate the output\n\t\tconst validation = validateDoctype(doctype)\n\t\tif (!validation.success) {\n\t\t\terrors++\n\t\t\tconsole.error(`  ERROR: ${fileName} failed validation:`)\n\t\t\tfor (const err of validation.errors) {\n\t\t\t\tconsole.error(`    ${err.path.join('.')}: ${err.message}`)\n\t\t\t}\n\t\t} else {\n\t\t\t// Check for unmapped fields\n\t\t\tconst unmappedFields = doctype.fields.filter((f: any) => f._unmapped)\n\t\t\tif (unmappedFields.length > 0) {\n\t\t\t\twarnings++\n\t\t\t\tconsole.warn(\n\t\t\t\t\t`  WARN: ${fileName} has ${unmappedFields.length} unmapped field(s): ${unmappedFields\n\t\t\t\t\t\t.map((f: any) => f.fieldname)\n\t\t\t\t\t\t.join(', ')}`\n\t\t\t\t)\n\t\t\t}\n\t\t}\n\t}\n\n\tconsole.log(\n\t\t`\\nGenerated ${doctypes.length} doctype(s) in ${outputDir}` +\n\t\t\t(warnings ? ` (${warnings} with warnings)` : '') +\n\t\t\t(errors ? ` (${errors} with errors)` : '')\n\t)\n\n\tif (errors > 0) {\n\t\tprocess.exit(1)\n\t}\n}\n\nfunction printHelp(): void {\n\tconsole.log(`\nstonecrop-schema - Convert GraphQL schemas to Stonecrop doctypes\n\nUSAGE:\n  stonecrop-schema generate [options]\n\nSOURCE (exactly one required):\n  --endpoint, -e <url>         Fetch introspection from a live GraphQL endpoint\n  --introspection, -i <file>   Read from a saved introspection JSON file\n  --sdl, -s <file>             Read from a GraphQL SDL (.graphql) file\n\nOUTPUT:\n  --output, -o <dir>           Directory to write doctype JSON files (required)\n\nOPTIONS:\n  --include <types>            Comma-separated list of type names to include\n  --exclude <types>            Comma-separated list of type names to exclude\n  --overrides <file>           JSON file with per-type field overrides\n  --custom-scalars <file>      JSON file mapping custom scalar names to field templates\n  --include-unmapped           Include _graphqlType metadata on unmapped fields\n  --help, -h                   Show this help message\n\nEXAMPLES:\n  # From a live PostGraphile server\n  stonecrop-schema generate -e http://localhost:5000/graphql -o ./schemas\n\n  # From a saved introspection result\n  stonecrop-schema generate -i introspection.json -o ./schemas\n\n  # From an SDL file with custom scalars\n  stonecrop-schema generate -s schema.graphql -o ./schemas \\\\\n    --custom-scalars custom-scalars.json\n\n  # Only convert specific types\n  stonecrop-schema generate -e http://localhost:5000/graphql -o ./schemas \\\\\n    --include \"User,Post,Comment\"\n`)\n}\n\nmain().catch(err => {\n\tconsole.error('Error:', err.message)\n\tprocess.exit(1)\n})\n"],"names":["fetchIntrospection","endpoint","headers","response","getIntrospectionQuery","json","e","main","values","positionals","parseArgs","command","printHelp","outputDir","resolve","options","s","overridesPath","overridesContent","readFileSync","scalarsPath","scalarsContent","source","filePath","content","parsed","doctypes","convertGraphQLSchema","existsSync","mkdirSync","warnings","errors","doctype","fileName","join","writeFileSync","validation","validateDoctype","unmappedFields","f","err"],"mappings":"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"}

package/dist/cli.js

@@ -128,3 +128,4 @@ EXAMPLES:
 E().catch((e) => {
   console.error("Error:", e.message), process.exit(1);
 });
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sources":["../src/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * Stonecrop Schema CLI\n *\n * Converts GraphQL introspection results to Stonecrop doctype JSON schemas.\n *\n * Usage:\n *   stonecrop-schema generate --endpoint <url> --output <dir>\n *   stonecrop-schema generate --introspection <file.json> --output <dir>\n *   stonecrop-schema generate --sdl <file.graphql> --output <dir>\n *\n * @packageDocumentation\n */\n\nimport { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs'\nimport { resolve, join } from 'node:path'\nimport { parseArgs } from 'node:util'\nimport { getIntrospectionQuery, type IntrospectionQuery } from 'graphql'\n\nimport { convertGraphQLSchema } from './converter/index'\nimport { validateDoctype } from './validation'\nimport type { GraphQLConversionOptions } from './converter/types'\n\n/**\n * Fetch an introspection result from a live GraphQL endpoint.\n *\n * @param endpoint - The GraphQL endpoint URL\n * @param headers - Optional HTTP headers\n * @returns The introspection query result\n */\nasync function fetchIntrospection(endpoint: string, headers?: Record<string, string>): Promise<IntrospectionQuery> {\n\tconst response = await fetch(endpoint, {\n\t\tmethod: 'POST',\n\t\theaders: {\n\t\t\t'Content-Type': 'application/json',\n\t\t\t...headers,\n\t\t},\n\t\tbody: JSON.stringify({\n\t\t\tquery: getIntrospectionQuery(),\n\t\t}),\n\t})\n\n\tif (!response.ok) {\n\t\tthrow new Error(`Failed to fetch introspection: ${response.status} ${response.statusText}`)\n\t}\n\n\tconst json = (await response.json()) as {\n\t\tdata?: IntrospectionQuery\n\t\terrors?: Array<{ message: string }>\n\t}\n\n\tif (json.errors?.length) {\n\t\tthrow new Error(`GraphQL errors: ${json.errors.map(e => e.message).join(', ')}`)\n\t}\n\n\tif (!json.data) {\n\t\tthrow new Error('No data in introspection response')\n\t}\n\n\treturn json.data\n}\n\nasync function main(): Promise<void> {\n\tconst { values, positionals } = parseArgs({\n\t\tallowPositionals: true,\n\t\toptions: {\n\t\t\tendpoint: { type: 'string', short: 'e' },\n\t\t\tintrospection: { type: 'string', short: 'i' },\n\t\t\tsdl: { type: 'string', short: 's' },\n\t\t\toutput: { type: 'string', short: 'o' },\n\t\t\tinclude: { type: 'string' },\n\t\t\texclude: { type: 'string' },\n\t\t\toverrides: { type: 'string' },\n\t\t\t'custom-scalars': { type: 'string' },\n\t\t\t'include-unmapped': { type: 'boolean', default: false },\n\t\t\thelp: { type: 'boolean', short: 'h' },\n\t\t},\n\t})\n\n\tconst command = positionals[0]\n\n\tif (values.help || !command) {\n\t\tprintHelp()\n\t\tprocess.exit(command ? 0 : 1)\n\t}\n\n\tif (command !== 'generate') {\n\t\tconsole.error(`Unknown command: ${command}`)\n\t\tconsole.error('Available commands: generate')\n\t\tprocess.exit(1)\n\t}\n\n\t// Determine source\n\tconst sourceCount = [values.endpoint, values.introspection, values.sdl].filter(Boolean).length\n\tif (sourceCount !== 1) {\n\t\tconsole.error('Exactly one of --endpoint, --introspection, or --sdl must be provided')\n\t\tprocess.exit(1)\n\t}\n\n\tif (!values.output) {\n\t\tconsole.error('--output <dir> is required')\n\t\tprocess.exit(1)\n\t}\n\n\tconst outputDir = resolve(values.output)\n\n\t// Build conversion options\n\tconst options: GraphQLConversionOptions = {\n\t\tincludeUnmappedMeta: values['include-unmapped'],\n\t}\n\n\tif (values.include) {\n\t\toptions.include = values.include.split(',').map(s => s.trim())\n\t}\n\n\tif (values.exclude) {\n\t\toptions.exclude = values.exclude.split(',').map(s => s.trim())\n\t}\n\n\tif (values.overrides) {\n\t\tconst overridesPath = resolve(values.overrides)\n\t\tconst overridesContent = readFileSync(overridesPath, 'utf-8')\n\t\toptions.typeOverrides = JSON.parse(overridesContent)\n\t}\n\n\tif (values['custom-scalars']) {\n\t\tconst scalarsPath = resolve(values['custom-scalars'])\n\t\tconst scalarsContent = readFileSync(scalarsPath, 'utf-8')\n\t\toptions.customScalars = JSON.parse(scalarsContent)\n\t}\n\n\t// Resolve source\n\tlet source: IntrospectionQuery | string\n\n\tif (values.endpoint) {\n\t\tconsole.log(`Fetching introspection from ${values.endpoint}...`)\n\t\tsource = await fetchIntrospection(values.endpoint)\n\t} else if (values.introspection) {\n\t\tconst filePath = resolve(values.introspection)\n\t\tconst content = readFileSync(filePath, 'utf-8')\n\t\tconst parsed = JSON.parse(content)\n\t\t// Handle both { data: { __schema: ... } } and { __schema: ... } formats\n\t\tsource = parsed.data ?? parsed\n\t} else {\n\t\tconst filePath = resolve(values.sdl!)\n\t\tsource = readFileSync(filePath, 'utf-8')\n\t}\n\n\t// Convert\n\tconst doctypes = convertGraphQLSchema(source, options)\n\n\tif (doctypes.length === 0) {\n\t\tconsole.warn('No entity types found in the schema. Check your include/exclude filters.')\n\t\tprocess.exit(0)\n\t}\n\n\t// Write output\n\tif (!existsSync(outputDir)) {\n\t\tmkdirSync(outputDir, { recursive: true })\n\t}\n\n\tlet warnings = 0\n\tlet errors = 0\n\n\tfor (const doctype of doctypes) {\n\t\tconst fileName = `${doctype.slug}.json`\n\t\tconst filePath = join(outputDir, fileName)\n\t\tconst json = JSON.stringify(doctype, null, '\\t')\n\n\t\twriteFileSync(filePath, json + '\\n', 'utf-8')\n\n\t\t// Validate the output\n\t\tconst validation = validateDoctype(doctype)\n\t\tif (!validation.success) {\n\t\t\terrors++\n\t\t\tconsole.error(`  ERROR: ${fileName} failed validation:`)\n\t\t\tfor (const err of validation.errors) {\n\t\t\t\tconsole.error(`    ${err.path.join('.')}: ${err.message}`)\n\t\t\t}\n\t\t} else {\n\t\t\t// Check for unmapped fields\n\t\t\tconst unmappedFields = doctype.fields.filter((f: any) => f._unmapped)\n\t\t\tif (unmappedFields.length > 0) {\n\t\t\t\twarnings++\n\t\t\t\tconsole.warn(\n\t\t\t\t\t`  WARN: ${fileName} has ${unmappedFields.length} unmapped field(s): ${unmappedFields\n\t\t\t\t\t\t.map((f: any) => f.fieldname)\n\t\t\t\t\t\t.join(', ')}`\n\t\t\t\t)\n\t\t\t}\n\t\t}\n\t}\n\n\tconsole.log(\n\t\t`\\nGenerated ${doctypes.length} doctype(s) in ${outputDir}` +\n\t\t\t(warnings ? ` (${warnings} with warnings)` : '') +\n\t\t\t(errors ? ` (${errors} with errors)` : '')\n\t)\n\n\tif (errors > 0) {\n\t\tprocess.exit(1)\n\t}\n}\n\nfunction printHelp(): void {\n\tconsole.log(`\nstonecrop-schema - Convert GraphQL schemas to Stonecrop doctypes\n\nUSAGE:\n  stonecrop-schema generate [options]\n\nSOURCE (exactly one required):\n  --endpoint, -e <url>         Fetch introspection from a live GraphQL endpoint\n  --introspection, -i <file>   Read from a saved introspection JSON file\n  --sdl, -s <file>             Read from a GraphQL SDL (.graphql) file\n\nOUTPUT:\n  --output, -o <dir>           Directory to write doctype JSON files (required)\n\nOPTIONS:\n  --include <types>            Comma-separated list of type names to include\n  --exclude <types>            Comma-separated list of type names to exclude\n  --overrides <file>           JSON file with per-type field overrides\n  --custom-scalars <file>      JSON file mapping custom scalar names to field templates\n  --include-unmapped           Include _graphqlType metadata on unmapped fields\n  --help, -h                   Show this help message\n\nEXAMPLES:\n  # From a live PostGraphile server\n  stonecrop-schema generate -e http://localhost:5000/graphql -o ./schemas\n\n  # From a saved introspection result\n  stonecrop-schema generate -i introspection.json -o ./schemas\n\n  # From an SDL file with custom scalars\n  stonecrop-schema generate -s schema.graphql -o ./schemas \\\\\n    --custom-scalars custom-scalars.json\n\n  # Only convert specific types\n  stonecrop-schema generate -e http://localhost:5000/graphql -o ./schemas \\\\\n    --include \"User,Post,Comment\"\n`)\n}\n\nmain().catch(err => {\n\tconsole.error('Error:', err.message)\n\tprocess.exit(1)\n})\n"],"names":["fetchIntrospection","endpoint","headers","response","getIntrospectionQuery","json","e","main","values","positionals","parseArgs","command","printHelp","outputDir","resolve","options","s","overridesPath","overridesContent","readFileSync","scalarsPath","scalarsContent","source","filePath","content","parsed","doctypes","convertGraphQLSchema","existsSync","mkdirSync","warnings","errors","doctype","fileName","join","writeFileSync","validation","validateDoctype","unmappedFields","f","err"],"mappings":";;;;;;AA8BA,eAAeA,EAAmBC,GAAkBC,GAA+D;AAClH,QAAMC,IAAW,MAAM,MAAMF,GAAU;AAAA,IACtC,QAAQ;AAAA,IACR,SAAS;AAAA,MACR,gBAAgB;AAAA,MAChB,GAAGC;AAAA,IAAA;AAAA,IAEJ,MAAM,KAAK,UAAU;AAAA,MACpB,OAAOE,EAAA;AAAA,IAAsB,CAC7B;AAAA,EAAA,CACD;AAED,MAAI,CAACD,EAAS;AACb,UAAM,IAAI,MAAM,kCAAkCA,EAAS,MAAM,IAAIA,EAAS,UAAU,EAAE;AAG3F,QAAME,IAAQ,MAAMF,EAAS,KAAA;AAK7B,MAAIE,EAAK,QAAQ;AAChB,UAAM,IAAI,MAAM,mBAAmBA,EAAK,OAAO,IAAI,CAAAC,MAAKA,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC,EAAE;AAGhF,MAAI,CAACD,EAAK;AACT,UAAM,IAAI,MAAM,mCAAmC;AAGpD,SAAOA,EAAK;AACb;AAEA,eAAeE,IAAsB;AACpC,QAAM,EAAE,QAAAC,GAAQ,aAAAC,EAAA,IAAgBC,EAAU;AAAA,IACzC,kBAAkB;AAAA,IAClB,SAAS;AAAA,MACR,UAAU,EAAE,MAAM,UAAU,OAAO,IAAA;AAAA,MACnC,eAAe,EAAE,MAAM,UAAU,OAAO,IAAA;AAAA,MACxC,KAAK,EAAE,MAAM,UAAU,OAAO,IAAA;AAAA,MAC9B,QAAQ,EAAE,MAAM,UAAU,OAAO,IAAA;AAAA,MACjC,SAAS,EAAE,MAAM,SAAA;AAAA,MACjB,SAAS,EAAE,MAAM,SAAA;AAAA,MACjB,WAAW,EAAE,MAAM,SAAA;AAAA,MACnB,kBAAkB,EAAE,MAAM,SAAA;AAAA,MAC1B,oBAAoB,EAAE,MAAM,WAAW,SAAS,GAAA;AAAA,MAChD,MAAM,EAAE,MAAM,WAAW,OAAO,IAAA;AAAA,IAAI;AAAA,EACrC,CACA,GAEKC,IAAUF,EAAY,CAAC;AAE7B,GAAID,EAAO,QAAQ,CAACG,OACnBC,EAAA,GACA,QAAQ,KAAKD,IAAU,IAAI,CAAC,IAGzBA,MAAY,eACf,QAAQ,MAAM,oBAAoBA,CAAO,EAAE,GAC3C,QAAQ,MAAM,8BAA8B,GAC5C,QAAQ,KAAK,CAAC,IAIK,CAACH,EAAO,UAAUA,EAAO,eAAeA,EAAO,GAAG,EAAE,OAAO,OAAO,EAAE,WACpE,MACnB,QAAQ,MAAM,uEAAuE,GACrF,QAAQ,KAAK,CAAC,IAGVA,EAAO,WACX,QAAQ,MAAM,4BAA4B,GAC1C,QAAQ,KAAK,CAAC;AAGf,QAAMK,IAAYC,EAAQN,EAAO,MAAM,GAGjCO,IAAoC;AAAA,IACzC,qBAAqBP,EAAO,kBAAkB;AAAA,EAAA;AAW/C,MARIA,EAAO,YACVO,EAAQ,UAAUP,EAAO,QAAQ,MAAM,GAAG,EAAE,IAAI,CAAAQ,MAAKA,EAAE,KAAA,CAAM,IAG1DR,EAAO,YACVO,EAAQ,UAAUP,EAAO,QAAQ,MAAM,GAAG,EAAE,IAAI,CAAAQ,MAAKA,EAAE,KAAA,CAAM,IAG1DR,EAAO,WAAW;AACrB,UAAMS,IAAgBH,EAAQN,EAAO,SAAS,GACxCU,IAAmBC,EAAaF,GAAe,OAAO;AAC5D,IAAAF,EAAQ,gBAAgB,KAAK,MAAMG,CAAgB;AAAA,EACpD;AAEA,MAAIV,EAAO,gBAAgB,GAAG;AAC7B,UAAMY,IAAcN,EAAQN,EAAO,gBAAgB,CAAC,GAC9Ca,IAAiBF,EAAaC,GAAa,OAAO;AACxD,IAAAL,EAAQ,gBAAgB,KAAK,MAAMM,CAAc;AAAA,EAClD;AAGA,MAAIC;AAEJ,MAAId,EAAO;AACV,YAAQ,IAAI,+BAA+BA,EAAO,QAAQ,KAAK,GAC/Dc,IAAS,MAAMtB,EAAmBQ,EAAO,QAAQ;AAAA,WACvCA,EAAO,eAAe;AAChC,UAAMe,IAAWT,EAAQN,EAAO,aAAa,GACvCgB,IAAUL,EAAaI,GAAU,OAAO,GACxCE,IAAS,KAAK,MAAMD,CAAO;AAEjC,IAAAF,IAASG,EAAO,QAAQA;AAAA,EACzB,OAAO;AACN,UAAMF,IAAWT,EAAQN,EAAO,GAAI;AACpC,IAAAc,IAASH,EAAaI,GAAU,OAAO;AAAA,EACxC;AAGA,QAAMG,IAAWC,EAAqBL,GAAQP,CAAO;AAErD,EAAIW,EAAS,WAAW,MACvB,QAAQ,KAAK,0EAA0E,GACvF,QAAQ,KAAK,CAAC,IAIVE,EAAWf,CAAS,KACxBgB,EAAUhB,GAAW,EAAE,WAAW,GAAA,CAAM;AAGzC,MAAIiB,IAAW,GACXC,IAAS;AAEb,aAAWC,KAAWN,GAAU;AAC/B,UAAMO,IAAW,GAAGD,EAAQ,IAAI,SAC1BT,IAAWW,EAAKrB,GAAWoB,CAAQ,GACnC5B,IAAO,KAAK,UAAU2B,GAAS,MAAM,GAAI;AAE/C,IAAAG,EAAcZ,GAAUlB,IAAO;AAAA,GAAM,OAAO;AAG5C,UAAM+B,IAAaC,EAAgBL,CAAO;AAC1C,QAAKI,EAAW,SAMT;AAEN,YAAME,IAAiBN,EAAQ,OAAO,OAAO,CAACO,MAAWA,EAAE,SAAS;AACpE,MAAID,EAAe,SAAS,MAC3BR,KACA,QAAQ;AAAA,QACP,WAAWG,CAAQ,QAAQK,EAAe,MAAM,uBAAuBA,EACrE,IAAI,CAACC,MAAWA,EAAE,SAAS,EAC3B,KAAK,IAAI,CAAC;AAAA,MAAA;AAAA,IAGf,OAjByB;AACxB,MAAAR,KACA,QAAQ,MAAM,YAAYE,CAAQ,qBAAqB;AACvD,iBAAWO,KAAOJ,EAAW;AAC5B,gBAAQ,MAAM,OAAOI,EAAI,KAAK,KAAK,GAAG,CAAC,KAAKA,EAAI,OAAO,EAAE;AAAA,IAE3D;AAAA,EAYD;AAEA,UAAQ;AAAA,IACP;AAAA,YAAed,EAAS,MAAM,kBAAkBb,CAAS,MACvDiB,IAAW,KAAKA,CAAQ,oBAAoB,OAC5CC,IAAS,KAAKA,CAAM,kBAAkB;AAAA,EAAA,GAGrCA,IAAS,KACZ,QAAQ,KAAK,CAAC;AAEhB;AAEA,SAASnB,IAAkB;AAC1B,UAAQ,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CAoCZ;AACD;AAEAL,IAAO,MAAM,CAAAiC,MAAO;AACnB,UAAQ,MAAM,UAAUA,EAAI,OAAO,GACnC,QAAQ,KAAK,CAAC;AACf,CAAC;"}

package/dist/converter/heuristics.js

@@ -0,0 +1,254 @@
+/**
+ * Default heuristics for identifying entity types and fields in a GraphQL schema.
+ *
+ * These heuristics work across common GraphQL servers (PostGraphile, Hasura, Apollo, etc.)
+ * by detecting widely-adopted conventions like the Relay connection pattern.
+ *
+ * All heuristics can be overridden via the `isEntityType`, `isEntityField`, and
+ * `classifyField` options in `GraphQLConversionOptions`.
+ *
+ * @packageDocumentation
+ */
+import { isScalarType, isEnumType, isObjectType, isListType, isNonNullType, } from 'graphql';
+import { buildScalarMap, INTERNAL_SCALARS } from './scalars';
+import { toSlug, camelToLabel } from '../naming';
+/**
+ * Suffixes that identify synthetic/framework types generated by GraphQL servers.
+ * Types ending with these suffixes are typically not entities.
+ */
+const SYNTHETIC_SUFFIXES = [
+    'Connection',
+    'Edge',
+    'Input',
+    'Patch',
+    'Payload',
+    'Condition',
+    'Filter',
+    'OrderBy',
+    'Aggregate',
+    'AggregateResult',
+    'AggregateFilter',
+    'DeleteResponse',
+    'InsertResponse',
+    'UpdateResponse',
+    'MutationResponse',
+];
+/**
+ * Root operation type names that are never entities.
+ */
+const ROOT_TYPE_NAMES = new Set(['Query', 'Mutation', 'Subscription']);
+/**
+ * Default heuristic to determine if a GraphQL object type represents an entity.
+ * An entity type becomes a Stonecrop doctype.
+ *
+ * This heuristic excludes:
+ * - Introspection types (`__*`)
+ * - Root operation types (`Query`, `Mutation`, `Subscription`)
+ * - Types with synthetic suffixes (e.g., `*Connection`, `*Edge`, `*Input`)
+ * - Types starting with `Node` interface marker (exact match only)
+ *
+ * @param typeName - The GraphQL type name
+ * @param type - The GraphQL object type definition
+ * @returns `true` if this type should become a Stonecrop doctype
+ * @public
+ */
+export function defaultIsEntityType(typeName, type) {
+    // Exclude introspection types
+    if (typeName.startsWith('__')) {
+        return false;
+    }
+    // Exclude root operation types
+    if (ROOT_TYPE_NAMES.has(typeName)) {
+        return false;
+    }
+    // Exclude the Node interface marker type
+    if (typeName === 'Node') {
+        return false;
+    }
+    // Exclude types matching synthetic suffixes
+    for (const suffix of SYNTHETIC_SUFFIXES) {
+        if (typeName.endsWith(suffix)) {
+            return false;
+        }
+    }
+    // Must have at least one field
+    const fields = type.getFields();
+    if (Object.keys(fields).length === 0) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Fields to skip by default on entity types.
+ * These are internal to GraphQL servers and don't represent semantic data.
+ */
+const SKIP_FIELDS = new Set(['nodeId', '__typename', 'clientMutationId']);
+/**
+ * Default heuristic to filter fields on entity types.
+ * Skips internal fields that don't represent meaningful data.
+ *
+ * @param fieldName - The GraphQL field name
+ * @param _field - The GraphQL field definition (unused in default implementation)
+ * @param _parentType - The parent entity type (unused in default implementation)
+ * @returns `true` if this field should be included
+ * @public
+ */
+export function defaultIsEntityField(fieldName, _field, _parentType) {
+    return !SKIP_FIELDS.has(fieldName);
+}
+/**
+ * Unwrap NonNull and List wrappers from a GraphQL type, tracking nullability.
+ *
+ * @param type - The GraphQL output type
+ * @returns The unwrapped named type, whether it's required, and whether it's a list
+ * @internal
+ */
+function unwrapType(type) {
+    let required = false;
+    let isList = false;
+    let current = type;
+    // Unwrap outer NonNull
+    if (isNonNullType(current)) {
+        required = true;
+        current = current.ofType;
+    }
+    // Unwrap List
+    if (isListType(current)) {
+        isList = true;
+        current = current.ofType;
+        // Unwrap inner NonNull (e.g., [Type!])
+        if (isNonNullType(current)) {
+            current = current.ofType;
+        }
+    }
+    // At this point, current should be a named type
+    return { namedType: current, required, isList };
+}
+/**
+ * Check if a GraphQL object type looks like a Relay Connection type.
+ * A connection type has an `edges` field returning a list of edge types,
+ * where each edge has a `node` field.
+ *
+ * @param type - The GraphQL object type to check
+ * @returns The node type name if this is a connection, or `undefined`
+ * @internal
+ */
+function getConnectionNodeType(type) {
+    const fields = type.getFields();
+    // Must have an 'edges' field
+    const edgesField = fields['edges'];
+    if (!edgesField)
+        return undefined;
+    // edges must be a list
+    const { namedType: edgesType, isList: edgesIsList } = unwrapType(edgesField.type);
+    if (!edgesIsList || !isObjectType(edgesType))
+        return undefined;
+    // Each edge must have a 'node' field
+    const edgeFields = edgesType.getFields();
+    const nodeField = edgeFields['node'];
+    if (!nodeField)
+        return undefined;
+    const { namedType: nodeType } = unwrapType(nodeField.type);
+    if (!isObjectType(nodeType))
+        return undefined;
+    return nodeType.name;
+}
+/**
+ * Classify a single GraphQL field into a Stonecrop field definition.
+ *
+ * Classification rules (in order):
+ * 1. Scalar types → look up in merged scalar map
+ * 2. Enum types → `Select` with enum values as options
+ * 3. Object types that are entities → `Link` with slug as options
+ * 4. Object types that are Connections → `Doctype` with node type slug as options
+ * 5. List of entity type → `Doctype` with item type slug as options
+ * 6. Anything else → `Data` with `_unmapped: true`
+ *
+ * @param fieldName - The GraphQL field name
+ * @param field - The GraphQL field definition
+ * @param entityTypes - Set of type names classified as entities
+ * @param options - Conversion options (for custom scalars, unmapped meta, etc.)
+ * @returns The Stonecrop field definition
+ * @public
+ */
+export function classifyFieldType(fieldName, field, entityTypes, options = {}) {
+    const { namedType, required, isList } = unwrapType(field.type);
+    const scalarMap = buildScalarMap(options.customScalars);
+    const base = {
+        fieldname: fieldName,
+        label: camelToLabel(fieldName),
+        component: 'ATextInput',
+        fieldtype: 'Data',
+    };
+    if (required) {
+        base.required = true;
+    }
+    // 1. Scalar types
+    if (isScalarType(namedType)) {
+        // Skip internal scalars (e.g., Cursor)
+        if (INTERNAL_SCALARS.has(namedType.name)) {
+            base._unmapped = true;
+            if (options.includeUnmappedMeta) {
+                base._graphqlType = namedType.name;
+            }
+            return base;
+        }
+        const template = scalarMap[namedType.name];
+        if (template) {
+            base.component = template.component;
+            base.fieldtype = template.fieldtype;
+        }
+        else {
+            // Unknown scalar — default to Data with unmapped marker
+            base._unmapped = true;
+            if (options.includeUnmappedMeta) {
+                base._graphqlType = namedType.name;
+            }
+        }
+        return base;
+    }
+    // 2. Enum types → Select
+    if (isEnumType(namedType)) {
+        base.component = 'ADropdown';
+        base.fieldtype = 'Select';
+        base.options = namedType.getValues().map(v => v.name);
+        return base;
+    }
+    // 3–5. Object types
+    if (isObjectType(namedType)) {
+        // 3. Direct reference to an entity type → Link
+        if (!isList && entityTypes.has(namedType.name)) {
+            base.component = 'ALink';
+            base.fieldtype = 'Link';
+            base.options = toSlug(namedType.name);
+            return base;
+        }
+        // 4. Connection type → Doctype (child table)
+        const connectionNodeTypeName = getConnectionNodeType(namedType);
+        if (connectionNodeTypeName && entityTypes.has(connectionNodeTypeName)) {
+            base.component = 'ATable';
+            base.fieldtype = 'Doctype';
+            base.options = toSlug(connectionNodeTypeName);
+            return base;
+        }
+        // 5. List of entity type → Doctype
+        if (isList && entityTypes.has(namedType.name)) {
+            base.component = 'ATable';
+            base.fieldtype = 'Doctype';
+            base.options = toSlug(namedType.name);
+            return base;
+        }
+        // Unknown object type — mark as unmapped
+        base._unmapped = true;
+        if (options.includeUnmappedMeta) {
+            base._graphqlType = namedType.name;
+        }
+        return base;
+    }
+    // Fallback — shouldn't normally be reached
+    base._unmapped = true;
+    if (options.includeUnmappedMeta) {
+        base._graphqlType = namedType.name;
+    }
+    return base;
+}

package/dist/converter/index.js

@@ -0,0 +1,164 @@
+/**
+ * GraphQL Introspection to Stonecrop Schema Converter
+ *
+ * Converts a standard GraphQL introspection result (or SDL string) into
+ * Stonecrop doctype schemas. Source-agnostic — works with any GraphQL server.
+ *
+ * @packageDocumentation
+ */
+import { buildClientSchema, buildSchema, isObjectType } from 'graphql';
+import { toSlug, pascalToSnake } from '../naming';
+import { defaultIsEntityType, defaultIsEntityField, classifyFieldType } from './heuristics';
+/**
+ * Convert a GraphQL schema to Stonecrop doctype schemas.
+ *
+ * Accepts either an `IntrospectionQuery` result object or an SDL string.
+ * Entity types are identified using heuristics (or a custom `isEntityType` function)
+ * and converted to `DoctypeMeta`-compatible JSON objects.
+ *
+ * @param source - GraphQL introspection result or SDL string
+ * @param options - Conversion options for controlling output format and behavior
+ * @returns Array of converted Stonecrop doctype definitions
+ *
+ * @example
+ * ```typescript
+ * // From introspection result (fetched from any GraphQL server)
+ * const introspection = await fetchIntrospection('http://localhost:5000/graphql')
+ * const doctypes = convertGraphQLSchema(introspection)
+ *
+ * // From SDL string
+ * const sdl = fs.readFileSync('schema.graphql', 'utf-8')
+ * const doctypes = convertGraphQLSchema(sdl)
+ *
+ * // With PostGraphile custom scalars
+ * const doctypes = convertGraphQLSchema(introspection, {
+ *   customScalars: {
+ *     BigFloat: { component: 'ADecimalInput', fieldtype: 'Decimal' }
+ *   }
+ * })
+ * ```
+ *
+ * @public
+ */
+export function convertGraphQLSchema(source, options = {}) {
+    const schema = buildGraphQLSchema(source);
+    const typeMap = schema.getTypeMap();
+    // Determine the root operation type names to exclude
+    const rootTypeNames = new Set();
+    const queryType = schema.getQueryType();
+    const mutationType = schema.getMutationType();
+    const subscriptionType = schema.getSubscriptionType();
+    if (queryType)
+        rootTypeNames.add(queryType.name);
+    if (mutationType)
+        rootTypeNames.add(mutationType.name);
+    if (subscriptionType)
+        rootTypeNames.add(subscriptionType.name);
+    // Use custom or default entity type detector
+    const isEntityType = options.isEntityType ?? defaultIsEntityType;
+    // Phase 1: Identify all entity types
+    const entityTypes = new Set();
+    for (const [typeName, type] of Object.entries(typeMap)) {
+        if (!isObjectType(type))
+            continue;
+        // Always skip root operation types (even if custom isEntityType doesn't)
+        if (rootTypeNames.has(typeName))
+            continue;
+        if (isEntityType(typeName, type)) {
+            entityTypes.add(typeName);
+        }
+    }
+    // Phase 2: Apply include/exclude filters
+    let filteredEntityTypes = entityTypes;
+    if (options.include) {
+        const includeSet = new Set(options.include);
+        filteredEntityTypes = new Set([...entityTypes].filter(t => includeSet.has(t)));
+    }
+    if (options.exclude) {
+        const excludeSet = new Set(options.exclude);
+        filteredEntityTypes = new Set([...filteredEntityTypes].filter(t => !excludeSet.has(t)));
+    }
+    // Phase 3: Convert each entity type to a doctype
+    const isEntityField = options.isEntityField ?? defaultIsEntityField;
+    const deriveTableName = options.deriveTableName ?? ((typeName) => pascalToSnake(typeName));
+    const doctypes = [];
+    for (const typeName of filteredEntityTypes) {
+        const type = typeMap[typeName];
+        if (!isObjectType(type))
+            continue;
+        const fields = type.getFields();
+        const typeOverrides = options.typeOverrides?.[typeName];
+        const convertedFields = Object.entries(fields)
+            .filter(([fieldName, field]) => isEntityField(fieldName, field, type))
+            .map(([fieldName, field]) => {
+            // Check for full custom classification first
+            if (options.classifyField) {
+                const custom = options.classifyField(fieldName, field, type);
+                if (custom !== null && custom !== undefined) {
+                    return {
+                        fieldname: fieldName,
+                        label: custom.label ?? fieldName,
+                        component: custom.component ?? 'ATextInput',
+                        fieldtype: custom.fieldtype ?? 'Data',
+                        ...custom,
+                    };
+                }
+            }
+            // Default classification
+            const classified = classifyFieldType(fieldName, field, entityTypes, options);
+            // Apply per-field overrides
+            if (typeOverrides?.[fieldName]) {
+                return { ...classified, ...typeOverrides[fieldName] };
+            }
+            return classified;
+        })
+            // Clean up internal metadata unless requested
+            .map(field => {
+            if (!options.includeUnmappedMeta) {
+                const { _graphqlType, _unmapped, ...clean } = field;
+                return clean;
+            }
+            return field;
+        });
+        const doctype = {
+            name: typeName,
+            slug: toSlug(typeName),
+            fields: convertedFields,
+        };
+        const tableName = deriveTableName(typeName);
+        if (tableName) {
+            doctype.tableName = tableName;
+        }
+        if (options.includeUnmappedMeta) {
+            doctype._graphqlTypeName = typeName;
+        }
+        doctypes.push(doctype);
+    }
+    return doctypes;
+}
+/**
+ * Build a GraphQLSchema from either an introspection result or SDL string.
+ *
+ * @param source - IntrospectionQuery object or SDL string
+ * @returns A complete GraphQLSchema
+ * @internal
+ */
+function buildGraphQLSchema(source) {
+    if (typeof source === 'string') {
+        // SDL string
+        return buildSchema(source);
+    }
+    // IntrospectionQuery result
+    return buildClientSchema(source);
+}
+// ═══════════════════════════════════════════════════════════════
+// Re-exports
+// ═══════════════════════════════════════════════════════════════
+// Main converter (this file)
+export { convertGraphQLSchema as default };
+// Scalar maps
+export { GQL_SCALAR_MAP, WELL_KNOWN_SCALARS, INTERNAL_SCALARS, buildScalarMap } from './scalars';
+// Heuristics
+export { defaultIsEntityType, defaultIsEntityField, classifyFieldType } from './heuristics';
+// Naming utilities
+export { toSlug, toPascalCase, pascalToSnake, snakeToCamel, camelToSnake, snakeToLabel, camelToLabel } from '../naming';

package/dist/converter/scalars.js

@@ -0,0 +1,86 @@
+/**
+ * GraphQL Scalar Type Mappings
+ *
+ * Maps standard GraphQL scalars and well-known custom scalars to Stonecrop field types.
+ * Source-agnostic — covers scalars commonly emitted by PostGraphile, Hasura, Apollo, etc.
+ *
+ * Users can extend these via the `customScalars` option in `GraphQLConversionOptions`.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Mapping from standard GraphQL scalar types to Stonecrop field types.
+ * These are defined by the GraphQL specification and are always available.
+ *
+ * @public
+ */
+export const GQL_SCALAR_MAP = {
+    String: { component: 'ATextInput', fieldtype: 'Data' },
+    Int: { component: 'ANumericInput', fieldtype: 'Int' },
+    Float: { component: 'ANumericInput', fieldtype: 'Float' },
+    Boolean: { component: 'ACheckbox', fieldtype: 'Check' },
+    ID: { component: 'ATextInput', fieldtype: 'Data' },
+};
+/**
+ * Mapping from well-known custom GraphQL scalars to Stonecrop field types.
+ * These cover scalars commonly used across GraphQL servers (PostGraphile, Hasura, etc.)
+ * without baking in knowledge of any specific server.
+ *
+ * Entries here have lower precedence than `customScalars` from options, but higher
+ * precedence than unknown/unmapped scalars.
+ *
+ * @public
+ */
+export const WELL_KNOWN_SCALARS = {
+    // Arbitrary precision / large numbers
+    BigFloat: { component: 'ADecimalInput', fieldtype: 'Decimal' },
+    BigDecimal: { component: 'ADecimalInput', fieldtype: 'Decimal' },
+    Decimal: { component: 'ADecimalInput', fieldtype: 'Decimal' },
+    BigInt: { component: 'ANumericInput', fieldtype: 'Int' },
+    Long: { component: 'ANumericInput', fieldtype: 'Int' },
+    // Identifiers
+    UUID: { component: 'ATextInput', fieldtype: 'Data' },
+    // Date / Time
+    DateTime: { component: 'ADatetimePicker', fieldtype: 'Datetime' },
+    Datetime: { component: 'ADatetimePicker', fieldtype: 'Datetime' },
+    Date: { component: 'ADatePicker', fieldtype: 'Date' },
+    Time: { component: 'ATimeInput', fieldtype: 'Time' },
+    Interval: { component: 'ADurationInput', fieldtype: 'Duration' },
+    Duration: { component: 'ADurationInput', fieldtype: 'Duration' },
+    // Structured data
+    JSON: { component: 'ACodeEditor', fieldtype: 'JSON' },
+    JSONObject: { component: 'ACodeEditor', fieldtype: 'JSON' },
+    JsonNode: { component: 'ACodeEditor', fieldtype: 'JSON' },
+};
+/**
+ * Set of scalar type names that are internal to GraphQL servers and should be skipped
+ * during field conversion (they don't represent meaningful data fields).
+ *
+ * @public
+ */
+export const INTERNAL_SCALARS = new Set(['Cursor']);
+/**
+ * Build a merged scalar map from the built-in maps and user-provided custom scalars.
+ * Precedence (highest to lowest): customScalars → GQL_SCALAR_MAP → WELL_KNOWN_SCALARS
+ *
+ * @param customScalars - User-provided scalar overrides
+ * @returns Merged scalar map
+ * @internal
+ */
+export function buildScalarMap(customScalars) {
+    const merged = { ...WELL_KNOWN_SCALARS };
+    // Standard scalars override well-known
+    for (const [key, value] of Object.entries(GQL_SCALAR_MAP)) {
+        merged[key] = value;
+    }
+    // Custom scalars override everything
+    if (customScalars) {
+        for (const [key, value] of Object.entries(customScalars)) {
+            merged[key] = {
+                component: value.component ?? 'ATextInput',
+                fieldtype: value.fieldtype ?? 'Data',
+            };
+        }
+    }
+    return merged;
+}

package/dist/converter/types.js

@@ -0,0 +1,5 @@
+/**
+ * Types for the GraphQL introspection to Stonecrop schema converter.
+ * Source-agnostic — works with any GraphQL server (PostGraphile, Hasura, Apollo, etc.)
+ * @packageDocumentation
+ */

package/dist/doctype.js

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+import { FieldMeta } from './field';
+/**
+ * Action definition within a workflow
+ * @public
+ */
+export const ActionDefinition = z.object({
+    /** Display label for the action */
+    label: z.string().min(1),
+    /** Handler function name or path */
+    handler: z.string().min(1),
+    /** Fields that must have values before action can execute */
+    requiredFields: z.array(z.string()).optional(),
+    /** Workflow states where this action is available */
+    allowedStates: z.array(z.string()).optional(),
+    /** Whether to show a confirmation dialog */
+    confirm: z.boolean().optional(),
+    /** Additional arguments for the action */
+    args: z.record(z.string(), z.unknown()).optional(),
+});
+/**
+ * Workflow metadata - states and actions for a doctype
+ * @public
+ */
+export const WorkflowMeta = z.object({
+    /** List of workflow states */
+    states: z.array(z.string()).optional(),
+    /** Actions available in this workflow */
+    actions: z.record(z.string(), ActionDefinition).optional(),
+});
+/**
+ * Doctype metadata - complete definition of a doctype
+ * @public
+ */
+export const DoctypeMeta = z.object({
+    /** Display name of the doctype */
+    name: z.string().min(1),
+    /** URL-friendly slug (kebab-case) */
+    slug: z.string().min(1).optional(),
+    /** Database table name */
+    tableName: z.string().optional(),
+    /** Field definitions */
+    fields: z.array(FieldMeta),
+    /** Workflow configuration */
+    workflow: WorkflowMeta.optional(),
+    /** Parent doctype for inheritance */
+    inherits: z.string().optional(),
+    /** Doctype to use for list views */
+    listDoctype: z.string().optional(),
+    /** Parent doctype for child tables */
+    parentDoctype: z.string().optional(),
+});