@palantir/pack.document-schema.type-gen 0.31.0 → 0.32.0

package/build/esm/utils/schema/generateVersionedZodFromSchema.js.map

@@ -1 +1 @@
-{"version":3,"file":"generateVersionedZodFromSchema.js","names":["formatVariantName","GENERATED_FILE_HEADER","convertFieldTypeToZodSchema","resolveMinVersion","typesFilePath","versionedSchemaName","versionedTypeName","generateZodSchemasForVersion","version","ir","output","typeNames","modelKey","modelDef","Object","entries","models","type","push","variantName","keys","union","variants","length","sort","join","zodSchemaName","typeName","fieldLines","field","record","fields","zodType","fieldType","isOptional","key","discriminantField","discriminant","variantSchemaNames","variantModelKey","formattedVariant","variantZodSchemaName","variantTypeName","variantModel","recordZodSchemaName","refZodSchemaName","refTypeName","unionZodSchemaName","generateSchemaReExport","reExports","versioned","versionedVariant","generateVersionedZodFromChain","resolved","minSupportedVersion","chain","minVersion","zodSchemas","Map","set","schemaReExport"],"sources":["generateVersionedZodFromSchema.ts"],"sourcesContent":["/*\n * Copyright 2026 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { IRealTimeDocumentSchema } from \"../../lib/pack-docschema-api/pack-docschema-ir/index.js\";\nimport { formatVariantName } from \"../formatVariantName.js\";\nimport { GENERATED_FILE_HEADER } from \"../generatedFileHeader.js\";\nimport { convertFieldTypeToZodSchema } from \"../ir/irFieldHelpers.js\";\nimport type { ResolvedIrChain, VersionedIrEntry } from \"./resolveSchemaChain.js\";\nimport { resolveMinVersion } from \"./resolveSchemaChain.js\";\nimport { typesFilePath, versionedSchemaName, versionedTypeName } from \"./runtimeSchema.js\";\n\nexport interface VersionedZodOutput {\n  /** schema_vN.ts files keyed by version number */\n  zodSchemas: Map<number, string>;\n  /** schema.ts re-export of latest version schemas under unversioned names */\n  schemaReExport: string;\n}\n\n/**\n * Generate Zod schemas for a specific schema version.\n * Uses `.passthrough()` to preserve unknown fields.\n */\nfunction generateZodSchemasForVersion(\n  version: number,\n  ir: IRealTimeDocumentSchema,\n): string {\n  let output = GENERATED_FILE_HEADER;\n\n  // Collect type names for import\n  const typeNames: string[] = [];\n  for (const [modelKey, modelDef] of Object.entries(ir.models)) {\n    if (modelDef.type === \"record\") {\n      typeNames.push(versionedTypeName(modelKey, version));\n    } else if (modelDef.type === \"union\") {\n      typeNames.push(versionedTypeName(modelKey, version));\n      for (const variantName of Object.keys(modelDef.union.variants)) {\n        typeNames.push(\n          `${versionedTypeName(modelKey, version)}${formatVariantName(variantName)}`,\n        );\n      }\n    }\n  }\n\n  output += \"import type { ZodType } from \\\"zod\\\";\\n\";\n  output += \"import { z } from \\\"zod\\\";\\n\";\n\n  if (typeNames.length > 0) {\n    output += `import type { ${typeNames.sort().join(\", \")} } from \"${typesFilePath(version)}\";\\n`;\n  }\n\n  output += \"\\n\";\n\n  // Generate record schemas first (unions may depend on them)\n  for (const [modelKey, modelDef] of Object.entries(ir.models)) {\n    if (modelDef.type !== \"record\") continue;\n\n    const zodSchemaName = versionedSchemaName(modelKey, version);\n    const typeName = versionedTypeName(modelKey, version);\n    const fieldLines: string[] = [];\n\n    for (const field of modelDef.record.fields) {\n      let zodType = convertFieldTypeToZodSchema(field.fieldType, version);\n      if (field.isOptional) {\n        zodType = `${zodType}.optional()`;\n      }\n      fieldLines.push(`  ${field.key}: ${zodType}`);\n    }\n\n    output += `export const ${zodSchemaName} = z.object({\\n${\n      fieldLines.join(\",\\n\")\n    }\\n}).passthrough() satisfies ZodType<${typeName}>;\\n\\n`;\n  }\n\n  // Generate union schemas\n  for (const [modelKey, modelDef] of Object.entries(ir.models)) {\n    if (modelDef.type !== \"union\") continue;\n\n    const union = modelDef.union;\n    const discriminantField = union.discriminant;\n    const variantSchemaNames: string[] = [];\n\n    for (const [variantName, variantModelKey] of Object.entries(union.variants)) {\n      const formattedVariant = formatVariantName(variantName);\n      const variantZodSchemaName = `${versionedSchemaName(modelKey, version)}${formattedVariant}`;\n      const variantTypeName = `${versionedTypeName(modelKey, version)}${formattedVariant}`;\n      variantSchemaNames.push(variantZodSchemaName);\n\n      // Look up the variant's model to check if it's a record\n      const variantModel = ir.models[variantModelKey];\n      if (variantModel != null && variantModel.type === \"record\") {\n        const recordZodSchemaName = versionedSchemaName(variantModelKey, version);\n        output += `export const ${variantZodSchemaName} = ${recordZodSchemaName}.extend({\\n`;\n        output += `  ${discriminantField}: z.literal(\"${variantName}\")\\n`;\n        output += `}) satisfies ZodType<${variantTypeName}>;\\n\\n`;\n      } else {\n        // Non-record variant (e.g. another union): emit a value field referencing the schema\n        const refZodSchemaName = versionedSchemaName(variantModelKey, version);\n        const refTypeName = versionedTypeName(variantModelKey, version);\n        output += `export const ${variantZodSchemaName} = z.object({\\n`;\n        output += `  ${discriminantField}: z.literal(\"${variantName}\"),\\n`;\n        output += `  value: z.lazy((): ZodType<${refTypeName}> => ${refZodSchemaName})\\n`;\n        output += `}) satisfies ZodType<${variantTypeName}>;\\n\\n`;\n      }\n    }\n\n    const unionZodSchemaName = versionedSchemaName(modelKey, version);\n    const typeName = versionedTypeName(modelKey, version);\n    output +=\n      `export const ${unionZodSchemaName} = z.discriminatedUnion(\"${discriminantField}\", [\\n  ${\n        variantSchemaNames.join(\",\\n  \")\n      }\\n]) satisfies ZodType<${typeName}>;\\n\\n`;\n  }\n\n  return output;\n}\n\n/**\n * Generate the schema.ts re-export file mapping unversioned names to latest version.\n */\nfunction generateSchemaReExport(\n  { ir, version }: VersionedIrEntry,\n): string {\n  let output = GENERATED_FILE_HEADER;\n\n  const reExports: string[] = [];\n\n  for (const [modelKey, modelDef] of Object.entries(ir.models)) {\n    if (modelDef.type === \"record\") {\n      const versioned = versionedSchemaName(modelKey, version);\n      reExports.push(\n        `export { ${versioned} as ${modelKey}Schema } from \"./schema_v${version}.js\";`,\n      );\n    } else if (modelDef.type === \"union\") {\n      const versioned = versionedSchemaName(modelKey, version);\n      reExports.push(\n        `export { ${versioned} as ${modelKey}Schema } from \"./schema_v${version}.js\";`,\n      );\n\n      // Also re-export union variant schemas\n      for (const variantName of Object.keys(modelDef.union.variants)) {\n        const formattedVariant = formatVariantName(variantName);\n        const versionedVariant = `${versionedSchemaName(modelKey, version)}${formattedVariant}`;\n        const unversionedVariant = `${modelKey}${formattedVariant}Schema`;\n        reExports.push(\n          `export { ${versionedVariant} as ${unversionedVariant} } from \"./schema_v${version}.js\";`,\n        );\n      }\n    }\n  }\n\n  output += reExports.join(\"\\n\") + \"\\n\";\n\n  return output;\n}\n\n/**\n * Generate per-version Zod schemas from an already-resolved versioned IR chain.\n */\nexport function generateVersionedZodFromChain(\n  resolved: ResolvedIrChain,\n  minSupportedVersion?: number,\n): VersionedZodOutput {\n  const { chain } = resolved;\n  const { minVersion } = resolveMinVersion(chain, minSupportedVersion);\n\n  const zodSchemas = new Map<number, string>();\n\n  for (const { version, ir } of chain) {\n    if (version < minVersion) continue;\n\n    zodSchemas.set(version, generateZodSchemasForVersion(version, ir));\n  }\n\n  const schemaReExport = generateSchemaReExport(chain[chain.length - 1]!);\n\n  return { zodSchemas, schemaReExport };\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"generateVersionedZodFromSchema.js","names":["UNKNOWN_UNION_VARIANT","formatVariantName","GENERATED_FILE_HEADER","convertFieldTypeToZodSchema","UNKNOWN_VARIANT_SUFFIX","resolveMinVersion","typesFilePath","versionedSchemaName","versionedTypeName","generateZodSchemasForVersion","version","ir","output","typeNames","modelKey","modelDef","Object","entries","models","type","push","variantName","keys","union","variants","length","sort","join","zodSchemaName","typeName","fieldLines","field","record","fields","zodType","fieldType","isOptional","key","discriminantField","discriminant","variantSchemaNames","variantModelKey","formattedVariant","variantZodSchemaName","variantTypeName","variantModel","recordZodSchemaName","refZodSchemaName","refTypeName","unknownSchemaName","unknownTypeName","unionZodSchemaName","generateSchemaReExport","reExports","versioned","versionedVariant","generateVersionedZodFromChain","resolved","minSupportedVersion","chain","minVersion","zodSchemas","Map","set","schemaReExport"],"sources":["generateVersionedZodFromSchema.ts"],"sourcesContent":["/*\n * Copyright 2026 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { UNKNOWN_UNION_VARIANT } from \"@palantir/pack.document-schema.model-types\";\nimport { formatVariantName } from \"@palantir/pack.schema\";\nimport type { IRealTimeDocumentSchema } from \"../../lib/pack-docschema-api/pack-docschema-ir/index.js\";\nimport { GENERATED_FILE_HEADER } from \"../generatedFileHeader.js\";\nimport { convertFieldTypeToZodSchema } from \"../ir/irFieldHelpers.js\";\nimport { UNKNOWN_VARIANT_SUFFIX } from \"../unknownVariantSuffix.js\";\nimport type { ResolvedIrChain, VersionedIrEntry } from \"./resolveSchemaChain.js\";\nimport { resolveMinVersion } from \"./resolveSchemaChain.js\";\nimport { typesFilePath, versionedSchemaName, versionedTypeName } from \"./runtimeSchema.js\";\n\nexport interface VersionedZodOutput {\n  /** schema_vN.ts files keyed by version number */\n  zodSchemas: Map<number, string>;\n  /** schema.ts re-export of latest version schemas under unversioned names */\n  schemaReExport: string;\n}\n\n/**\n * Generate Zod schemas for a specific schema version.\n * Uses `.passthrough()` to preserve unknown fields.\n */\nfunction generateZodSchemasForVersion(\n  version: number,\n  ir: IRealTimeDocumentSchema,\n): string {\n  let output = GENERATED_FILE_HEADER;\n\n  // Collect type names for import\n  const typeNames: string[] = [];\n  for (const [modelKey, modelDef] of Object.entries(ir.models)) {\n    if (modelDef.type === \"record\") {\n      typeNames.push(versionedTypeName(modelKey, version));\n    } else if (modelDef.type === \"union\") {\n      typeNames.push(versionedTypeName(modelKey, version));\n      for (const variantName of [...Object.keys(modelDef.union.variants), UNKNOWN_UNION_VARIANT]) {\n        typeNames.push(\n          `${versionedTypeName(modelKey, version)}${formatVariantName(variantName)}`,\n        );\n      }\n    }\n  }\n\n  output += \"import type { ZodType } from \\\"zod\\\";\\n\";\n  output += \"import { z } from \\\"zod\\\";\\n\";\n\n  if (typeNames.length > 0) {\n    output += `import type { ${typeNames.sort().join(\", \")} } from \"${typesFilePath(version)}\";\\n`;\n  }\n\n  output += \"\\n\";\n\n  // Generate record schemas first (unions may depend on them)\n  for (const [modelKey, modelDef] of Object.entries(ir.models)) {\n    if (modelDef.type !== \"record\") continue;\n\n    const zodSchemaName = versionedSchemaName(modelKey, version);\n    const typeName = versionedTypeName(modelKey, version);\n    const fieldLines: string[] = [];\n\n    for (const field of modelDef.record.fields) {\n      let zodType = convertFieldTypeToZodSchema(field.fieldType, version);\n      if (field.isOptional) {\n        zodType = `${zodType}.optional()`;\n      }\n      fieldLines.push(`  ${field.key}: ${zodType}`);\n    }\n\n    output += `export const ${zodSchemaName} = z.object({\\n${\n      fieldLines.join(\",\\n\")\n    }\\n}).passthrough() satisfies ZodType<${typeName}>;\\n\\n`;\n  }\n\n  // Generate union schemas\n  for (const [modelKey, modelDef] of Object.entries(ir.models)) {\n    if (modelDef.type !== \"union\") continue;\n\n    const union = modelDef.union;\n    const discriminantField = union.discriminant;\n    const variantSchemaNames: string[] = [];\n\n    for (const [variantName, variantModelKey] of Object.entries(union.variants)) {\n      const formattedVariant = formatVariantName(variantName);\n      const variantZodSchemaName = `${versionedSchemaName(modelKey, version)}${formattedVariant}`;\n      const variantTypeName = `${versionedTypeName(modelKey, version)}${formattedVariant}`;\n      variantSchemaNames.push(variantZodSchemaName);\n\n      // Look up the variant's model to check if it's a record\n      const variantModel = ir.models[variantModelKey];\n      if (variantModel != null && variantModel.type === \"record\") {\n        const recordZodSchemaName = versionedSchemaName(variantModelKey, version);\n        output += `export const ${variantZodSchemaName} = ${recordZodSchemaName}.extend({\\n`;\n        output += `  ${discriminantField}: z.literal(\"${variantName}\")\\n`;\n        output += `}) satisfies ZodType<${variantTypeName}>;\\n\\n`;\n      } else {\n        // Non-record variant (e.g. another union): emit a value field referencing the schema\n        const refZodSchemaName = versionedSchemaName(variantModelKey, version);\n        const refTypeName = versionedTypeName(variantModelKey, version);\n        output += `export const ${variantZodSchemaName} = z.object({\\n`;\n        output += `  ${discriminantField}: z.literal(\"${variantName}\"),\\n`;\n        output += `  value: z.lazy((): ZodType<${refTypeName}> => ${refZodSchemaName})\\n`;\n        output += `}) satisfies ZodType<${variantTypeName}>;\\n\\n`;\n      }\n    }\n\n    const unknownSchemaName = `${versionedSchemaName(modelKey, version)}${UNKNOWN_VARIANT_SUFFIX}`;\n    const unknownTypeName = `${versionedTypeName(modelKey, version)}${UNKNOWN_VARIANT_SUFFIX}`;\n    output += `export const ${unknownSchemaName} = z.object({\\n`;\n    output += `  ${discriminantField}: z.literal(\"${UNKNOWN_UNION_VARIANT}\"),\\n`;\n    output += `  rawValue: z.unknown()\\n`;\n    output += `}) satisfies ZodType<${unknownTypeName}>;\\n\\n`;\n    variantSchemaNames.push(unknownSchemaName);\n\n    const unionZodSchemaName = versionedSchemaName(modelKey, version);\n    const typeName = versionedTypeName(modelKey, version);\n    output +=\n      `export const ${unionZodSchemaName} = z.discriminatedUnion(\"${discriminantField}\", [\\n  ${\n        variantSchemaNames.join(\",\\n  \")\n      }\\n]) satisfies ZodType<${typeName}>;\\n\\n`;\n  }\n\n  return output;\n}\n\n/**\n * Generate the schema.ts re-export file mapping unversioned names to latest version.\n */\nfunction generateSchemaReExport(\n  { ir, version }: VersionedIrEntry,\n): string {\n  let output = GENERATED_FILE_HEADER;\n\n  const reExports: string[] = [];\n\n  for (const [modelKey, modelDef] of Object.entries(ir.models)) {\n    if (modelDef.type === \"record\") {\n      const versioned = versionedSchemaName(modelKey, version);\n      reExports.push(\n        `export { ${versioned} as ${modelKey}Schema } from \"./schema_v${version}.js\";`,\n      );\n    } else if (modelDef.type === \"union\") {\n      const versioned = versionedSchemaName(modelKey, version);\n      reExports.push(\n        `export { ${versioned} as ${modelKey}Schema } from \"./schema_v${version}.js\";`,\n      );\n\n      // Also re-export union variant schemas\n      for (const variantName of Object.keys(modelDef.union.variants)) {\n        const formattedVariant = formatVariantName(variantName);\n        const versionedVariant = `${versionedSchemaName(modelKey, version)}${formattedVariant}`;\n        const unversionedVariant = `${modelKey}${formattedVariant}Schema`;\n        reExports.push(\n          `export { ${versionedVariant} as ${unversionedVariant} } from \"./schema_v${version}.js\";`,\n        );\n      }\n    }\n  }\n\n  output += reExports.join(\"\\n\") + \"\\n\";\n\n  return output;\n}\n\n/**\n * Generate per-version Zod schemas from an already-resolved versioned IR chain.\n */\nexport function generateVersionedZodFromChain(\n  resolved: ResolvedIrChain,\n  minSupportedVersion?: number,\n): VersionedZodOutput {\n  const { chain } = resolved;\n  const { minVersion } = resolveMinVersion(chain, minSupportedVersion);\n\n  const zodSchemas = new Map<number, string>();\n\n  for (const { version, ir } of chain) {\n    if (version < minVersion) continue;\n\n    zodSchemas.set(version, generateZodSchemasForVersion(version, ir));\n  }\n\n  const schemaReExport = generateSchemaReExport(chain[chain.length - 1]!);\n\n  return { zodSchemas, schemaReExport };\n}\n"],"mappings":"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","ignoreList":[]}

package/build/esm/utils/schema/runtimeSchema.js

@@ -19,6 +19,16 @@ export function versionedTypeName(exportName, version) {
   return `${exportName}_v${version}`;
 }
 
+/** e.g. `NodeShape_v3` -> `KnownNodeShape_v3`: a union's variants without the Unknown case. */
+export function knownTypeName(unionTypeName) {
+  return `Known${unionTypeName}`;
+}
+
+/** e.g. `NodeShape_v3` -> `narrowKnownNodeShape_v3`. */
+export function narrowKnownFunctionName(unionTypeName) {
+  return `narrowKnown${unionTypeName}`;
+}
+
 /** Versioned write type name: `RecordNameUpdate_vN` */
 export function versionedWriteTypeName(exportName, version) {
   return `${exportName}Update_v${version}`;

package/build/esm/utils/schema/runtimeSchema.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtimeSchema.js","names":["versionedTypeName","exportName","version","versionedWriteTypeName","versionedSchemaName","modelName","schemaName","typesFilePath","writeTypesFilePath","TYPES_REEXPORT_PATH","SCHEMA_REEXPORT_PATH","MODELS_PATH","INTERNAL_UPGRADES_PATH","INTERNAL_UPGRADE_FNS_PATH","VERSIONS_PATH","VERSIONED_DOC_REF_PATH","DOCUMENT_TYPE_PATH"],"sources":["runtimeSchema.ts"],"sourcesContent":["/*\n * Copyright 2026 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/** Versioned read type name: `RecordName_vN` */\nexport function versionedTypeName(exportName: string, version: number): string {\n  return `${exportName}_v${version}`;\n}\n\n/** Versioned write type name: `RecordNameUpdate_vN` */\nexport function versionedWriteTypeName(exportName: string, version: number): string {\n  return `${exportName}Update_v${version}`;\n}\n\n/** Versioned Zod schema name: `RecordNameSchema_vN` */\nexport function versionedSchemaName(exportName: string, version: number): string {\n  return `${exportName}Schema_v${version}`;\n}\n\n/** Model constant name: `RecordNameModel` */\nexport function modelName(exportName: string): string {\n  return `${exportName}Model`;\n}\n\n/** Unversioned Zod schema name: `RecordNameSchema` */\nexport function schemaName(exportName: string): string {\n  return `${exportName}Schema`;\n}\n\n/** Per-version types file path: `./types_vN.js` */\nexport function typesFilePath(version: number): string {\n  return `./types_v${version}.js`;\n}\n\n/** Per-version write types file path: `./writeTypes_vN.js` */\nexport function writeTypesFilePath(version: number): string {\n  return `./writeTypes_v${version}.js`;\n}\n\n/** Types re-export file path: `./types.js` */\nexport const TYPES_REEXPORT_PATH = \"./types.js\";\n\n/** Schema re-export file path: `./schema.js` */\nexport const SCHEMA_REEXPORT_PATH = \"./schema.js\";\n\n/** Models file path: `./models.js` */\nexport const MODELS_PATH = \"./models.js\";\n\n/** Internal upgrades file path: `./_internal/upgrades.js` */\nexport const INTERNAL_UPGRADES_PATH = \"./_internal/upgrades.js\";\n\n/** Internal upgrade-functions file path: `./_internal/upgradeFns.js` */\nexport const INTERNAL_UPGRADE_FNS_PATH = \"./_internal/upgradeFns.js\";\n\n/** Versions file path: `./versions.js` */\nexport const VERSIONS_PATH = \"./versions.js\";\n\n/** Versioned doc ref file path: `./versionedDocRef.js` */\nexport const VERSIONED_DOC_REF_PATH = \"./versionedDocRef.js\";\n\n/** Document type identity constants file path: `./documentType.js` */\nexport const DOCUMENT_TYPE_PATH = \"./documentType.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA,OAAO,SAASA,iBAAiBA,CAACC,UAAkB,EAAEC,OAAe,EAAU;EAC7E,OAAO,GAAGD,UAAU,KAAKC,OAAO,EAAE;AACpC;;AAEA;AACA,OAAO,SAASC,sBAAsBA,CAACF,UAAkB,EAAEC,OAAe,EAAU;EAClF,OAAO,GAAGD,UAAU,WAAWC,OAAO,EAAE;AAC1C;;AAEA;AACA,OAAO,SAASE,mBAAmBA,CAACH,UAAkB,EAAEC,OAAe,EAAU;EAC/E,OAAO,GAAGD,UAAU,WAAWC,OAAO,EAAE;AAC1C;;AAEA;AACA,OAAO,SAASG,SAASA,CAACJ,UAAkB,EAAU;EACpD,OAAO,GAAGA,UAAU,OAAO;AAC7B;;AAEA;AACA,OAAO,SAASK,UAAUA,CAACL,UAAkB,EAAU;EACrD,OAAO,GAAGA,UAAU,QAAQ;AAC9B;;AAEA;AACA,OAAO,SAASM,aAAaA,CAACL,OAAe,EAAU;EACrD,OAAO,YAAYA,OAAO,KAAK;AACjC;;AAEA;AACA,OAAO,SAASM,kBAAkBA,CAACN,OAAe,EAAU;EAC1D,OAAO,iBAAiBA,OAAO,KAAK;AACtC;;AAEA;AACA,OAAO,MAAMO,mBAAmB,GAAG,YAAY;;AAE/C;AACA,OAAO,MAAMC,oBAAoB,GAAG,aAAa;;AAEjD;AACA,OAAO,MAAMC,WAAW,GAAG,aAAa;;AAExC;AACA,OAAO,MAAMC,sBAAsB,GAAG,yBAAyB;;AAE/D;AACA,OAAO,MAAMC,yBAAyB,GAAG,2BAA2B;;AAEpE;AACA,OAAO,MAAMC,aAAa,GAAG,eAAe;;AAE5C;AACA,OAAO,MAAMC,sBAAsB,GAAG,sBAAsB;;AAE5D;AACA,OAAO,MAAMC,kBAAkB,GAAG,mBAAmB","ignoreList":[]}
+{"version":3,"file":"runtimeSchema.js","names":["versionedTypeName","exportName","version","knownTypeName","unionTypeName","narrowKnownFunctionName","versionedWriteTypeName","versionedSchemaName","modelName","schemaName","typesFilePath","writeTypesFilePath","TYPES_REEXPORT_PATH","SCHEMA_REEXPORT_PATH","MODELS_PATH","INTERNAL_UPGRADES_PATH","INTERNAL_UPGRADE_FNS_PATH","VERSIONS_PATH","VERSIONED_DOC_REF_PATH","DOCUMENT_TYPE_PATH"],"sources":["runtimeSchema.ts"],"sourcesContent":["/*\n * Copyright 2026 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\n/** Versioned read type name: `RecordName_vN` */\nexport function versionedTypeName(exportName: string, version: number): string {\n  return `${exportName}_v${version}`;\n}\n\n/** e.g. `NodeShape_v3` -> `KnownNodeShape_v3`: a union's variants without the Unknown case. */\nexport function knownTypeName(unionTypeName: string): string {\n  return `Known${unionTypeName}`;\n}\n\n/** e.g. `NodeShape_v3` -> `narrowKnownNodeShape_v3`. */\nexport function narrowKnownFunctionName(unionTypeName: string): string {\n  return `narrowKnown${unionTypeName}`;\n}\n\n/** Versioned write type name: `RecordNameUpdate_vN` */\nexport function versionedWriteTypeName(exportName: string, version: number): string {\n  return `${exportName}Update_v${version}`;\n}\n\n/** Versioned Zod schema name: `RecordNameSchema_vN` */\nexport function versionedSchemaName(exportName: string, version: number): string {\n  return `${exportName}Schema_v${version}`;\n}\n\n/** Model constant name: `RecordNameModel` */\nexport function modelName(exportName: string): string {\n  return `${exportName}Model`;\n}\n\n/** Unversioned Zod schema name: `RecordNameSchema` */\nexport function schemaName(exportName: string): string {\n  return `${exportName}Schema`;\n}\n\n/** Per-version types file path: `./types_vN.js` */\nexport function typesFilePath(version: number): string {\n  return `./types_v${version}.js`;\n}\n\n/** Per-version write types file path: `./writeTypes_vN.js` */\nexport function writeTypesFilePath(version: number): string {\n  return `./writeTypes_v${version}.js`;\n}\n\n/** Types re-export file path: `./types.js` */\nexport const TYPES_REEXPORT_PATH = \"./types.js\";\n\n/** Schema re-export file path: `./schema.js` */\nexport const SCHEMA_REEXPORT_PATH = \"./schema.js\";\n\n/** Models file path: `./models.js` */\nexport const MODELS_PATH = \"./models.js\";\n\n/** Internal upgrades file path: `./_internal/upgrades.js` */\nexport const INTERNAL_UPGRADES_PATH = \"./_internal/upgrades.js\";\n\n/** Internal upgrade-functions file path: `./_internal/upgradeFns.js` */\nexport const INTERNAL_UPGRADE_FNS_PATH = \"./_internal/upgradeFns.js\";\n\n/** Versions file path: `./versions.js` */\nexport const VERSIONS_PATH = \"./versions.js\";\n\n/** Versioned doc ref file path: `./versionedDocRef.js` */\nexport const VERSIONED_DOC_REF_PATH = \"./versionedDocRef.js\";\n\n/** Document type identity constants file path: `./documentType.js` */\nexport const DOCUMENT_TYPE_PATH = \"./documentType.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA,OAAO,SAASA,iBAAiBA,CAACC,UAAkB,EAAEC,OAAe,EAAU;EAC7E,OAAO,GAAGD,UAAU,KAAKC,OAAO,EAAE;AACpC;;AAEA;AACA,OAAO,SAASC,aAAaA,CAACC,aAAqB,EAAU;EAC3D,OAAO,QAAQA,aAAa,EAAE;AAChC;;AAEA;AACA,OAAO,SAASC,uBAAuBA,CAACD,aAAqB,EAAU;EACrE,OAAO,cAAcA,aAAa,EAAE;AACtC;;AAEA;AACA,OAAO,SAASE,sBAAsBA,CAACL,UAAkB,EAAEC,OAAe,EAAU;EAClF,OAAO,GAAGD,UAAU,WAAWC,OAAO,EAAE;AAC1C;;AAEA;AACA,OAAO,SAASK,mBAAmBA,CAACN,UAAkB,EAAEC,OAAe,EAAU;EAC/E,OAAO,GAAGD,UAAU,WAAWC,OAAO,EAAE;AAC1C;;AAEA;AACA,OAAO,SAASM,SAASA,CAACP,UAAkB,EAAU;EACpD,OAAO,GAAGA,UAAU,OAAO;AAC7B;;AAEA;AACA,OAAO,SAASQ,UAAUA,CAACR,UAAkB,EAAU;EACrD,OAAO,GAAGA,UAAU,QAAQ;AAC9B;;AAEA;AACA,OAAO,SAASS,aAAaA,CAACR,OAAe,EAAU;EACrD,OAAO,YAAYA,OAAO,KAAK;AACjC;;AAEA;AACA,OAAO,SAASS,kBAAkBA,CAACT,OAAe,EAAU;EAC1D,OAAO,iBAAiBA,OAAO,KAAK;AACtC;;AAEA;AACA,OAAO,MAAMU,mBAAmB,GAAG,YAAY;;AAE/C;AACA,OAAO,MAAMC,oBAAoB,GAAG,aAAa;;AAEjD;AACA,OAAO,MAAMC,WAAW,GAAG,aAAa;;AAExC;AACA,OAAO,MAAMC,sBAAsB,GAAG,yBAAyB;;AAE/D;AACA,OAAO,MAAMC,yBAAyB,GAAG,2BAA2B;;AAEpE;AACA,OAAO,MAAMC,aAAa,GAAG,eAAe;;AAE5C;AACA,OAAO,MAAMC,sBAAsB,GAAG,sBAAsB;;AAE5D;AACA,OAAO,MAAMC,kBAAkB,GAAG,mBAAmB","ignoreList":[]}

package/build/esm/utils/steps/__tests__/__snapshots__/types/arrayFields.js.map

@@ -1 +1 @@
-{"version":3,"file":"arrayFields.js","names":[],"sources":["arrayFields.ts"],"sourcesContent":["/* Generated by @palantir/pack.document-schema.type-gen@0.31.0 */\n\n\nexport interface Container {\n  readonly items: readonly string[];\n  readonly numbers: readonly number[];\n}\n\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"arrayFields.js","names":[],"sources":["arrayFields.ts"],"sourcesContent":["/* Generated by @palantir/pack.document-schema.type-gen@0.32.0 */\n\n\nexport interface Container {\n  readonly items: readonly string[];\n  readonly numbers: readonly number[];\n}\n\n"],"mappings":"","ignoreList":[]}

package/build/esm/utils/steps/__tests__/__snapshots__/types/customDiscriminant.js

@@ -1,4 +1,4 @@
-/* Generated by @palantir/pack.document-schema.type-gen@0.31.0 */
+/* Generated by @palantir/pack.document-schema.type-gen@0.32.0 */
 
 /**
  * A cat

package/build/esm/utils/steps/__tests__/__snapshots__/types/customDiscriminant.js.map

@@ -1 +1 @@
-{"version":3,"file":"customDiscriminant.js","names":["isAnimalCat","value","kind","isAnimalDog"],"sources":["customDiscriminant.ts"],"sourcesContent":["/* Generated by @palantir/pack.document-schema.type-gen@0.31.0 */\n\n\n/**\n * A cat\n */\nexport interface Cat {\n  readonly meow: string;\n  readonly whiskers: number;\n}\n\n/**\n * A dog\n */\nexport interface Dog {\n  readonly bark: string;\n  readonly tailWags: number;\n}\n\nexport interface AnimalCat extends Cat {\n  readonly kind: \"cat\";\n}\n\nexport interface AnimalDog extends Dog {\n  readonly kind: \"dog\";\n}\n\nexport type Animal = AnimalCat | AnimalDog;\n\nexport function isAnimalCat(value: Animal): value is AnimalCat {\n  return value.kind === \"cat\";\n}\n\nexport function isAnimalDog(value: Animal): value is AnimalDog {\n  return value.kind === \"dog\";\n}\n\n"],"mappings":"AAAA;;AAGA;AACA;AACA;;AAMA;AACA;AACA;;AAgBA,OAAO,SAASA,WAAWA,CAACC,KAAa,EAAsB;EAC7D,OAAOA,KAAK,CAACC,IAAI,KAAK,KAAK;AAC7B;AAEA,OAAO,SAASC,WAAWA,CAACF,KAAa,EAAsB;EAC7D,OAAOA,KAAK,CAACC,IAAI,KAAK,KAAK;AAC7B","ignoreList":[]}
+{"version":3,"file":"customDiscriminant.js","names":["isAnimalCat","value","kind","isAnimalDog"],"sources":["customDiscriminant.ts"],"sourcesContent":["/* Generated by @palantir/pack.document-schema.type-gen@0.32.0 */\n\n\n/**\n * A cat\n */\nexport interface Cat {\n  readonly meow: string;\n  readonly whiskers: number;\n}\n\n/**\n * A dog\n */\nexport interface Dog {\n  readonly bark: string;\n  readonly tailWags: number;\n}\n\nexport interface AnimalCat extends Cat {\n  readonly kind: \"cat\";\n}\n\nexport interface AnimalDog extends Dog {\n  readonly kind: \"dog\";\n}\n\nexport type Animal = AnimalCat | AnimalDog;\n\nexport function isAnimalCat(value: Animal): value is AnimalCat {\n  return value.kind === \"cat\";\n}\n\nexport function isAnimalDog(value: Animal): value is AnimalDog {\n  return value.kind === \"dog\";\n}\n\n"],"mappings":"AAAA;;AAGA;AACA;AACA;;AAMA;AACA;AACA;;AAgBA,OAAO,SAASA,WAAWA,CAACC,KAAa,EAAsB;EAC7D,OAAOA,KAAK,CAACC,IAAI,KAAK,KAAK;AAC7B;AAEA,OAAO,SAASC,WAAWA,CAACF,KAAa,EAAsB;EAC7D,OAAOA,KAAK,CAACC,IAAI,KAAK,KAAK;AAC7B","ignoreList":[]}

package/build/esm/utils/steps/__tests__/__snapshots__/types/generateTypeScriptInterfaces.js

@@ -1,4 +1,4 @@
-/* Generated by @palantir/pack.document-schema.type-gen@0.31.0 */
+/* Generated by @palantir/pack.document-schema.type-gen@0.32.0 */
 
 /**
  * Represents an edge in a graph

package/build/esm/utils/steps/__tests__/__snapshots__/types/generateTypeScriptInterfaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"generateTypeScriptInterfaces.js","names":["isNodeObject","value","type","isNodeTextBox"],"sources":["generateTypeScriptInterfaces.ts"],"sourcesContent":["/* Generated by @palantir/pack.document-schema.type-gen@0.31.0 */\n\n\n/**\n * Represents an edge in a graph\n */\nexport interface Edge {\n  readonly source: ObjectNode;\n  readonly target: ObjectNode;\n}\n\nexport interface ObjectNode {\n  readonly x: number;\n  readonly y: number;\n  readonly label?: string;\n  readonly color?: string;\n}\n\n/**\n * Represents a text box in a graph\n */\nexport interface TextBox {\n  readonly x: number;\n  readonly y: number;\n  readonly text: string;\n}\n\nexport interface NodeObject extends ObjectNode {\n  readonly type: \"object\";\n}\n\nexport interface NodeTextBox extends TextBox {\n  readonly type: \"text-box\";\n}\n\nexport type Node = NodeObject | NodeTextBox;\n\nexport function isNodeObject(value: Node): value is NodeObject {\n  return value.type === \"object\";\n}\n\nexport function isNodeTextBox(value: Node): value is NodeTextBox {\n  return value.type === \"text-box\";\n}\n\n"],"mappings":"AAAA;;AAGA;AACA;AACA;;AAaA;AACA;AACA;;AAiBA,OAAO,SAASA,YAAYA,CAACC,KAAW,EAAuB;EAC7D,OAAOA,KAAK,CAACC,IAAI,KAAK,QAAQ;AAChC;AAEA,OAAO,SAASC,aAAaA,CAACF,KAAW,EAAwB;EAC/D,OAAOA,KAAK,CAACC,IAAI,KAAK,UAAU;AAClC","ignoreList":[]}
+{"version":3,"file":"generateTypeScriptInterfaces.js","names":["isNodeObject","value","type","isNodeTextBox"],"sources":["generateTypeScriptInterfaces.ts"],"sourcesContent":["/* Generated by @palantir/pack.document-schema.type-gen@0.32.0 */\n\n\n/**\n * Represents an edge in a graph\n */\nexport interface Edge {\n  readonly source: ObjectNode;\n  readonly target: ObjectNode;\n}\n\nexport interface ObjectNode {\n  readonly x: number;\n  readonly y: number;\n  readonly label?: string;\n  readonly color?: string;\n}\n\n/**\n * Represents a text box in a graph\n */\nexport interface TextBox {\n  readonly x: number;\n  readonly y: number;\n  readonly text: string;\n}\n\nexport interface NodeObject extends ObjectNode {\n  readonly type: \"object\";\n}\n\nexport interface NodeTextBox extends TextBox {\n  readonly type: \"text-box\";\n}\n\nexport type Node = NodeObject | NodeTextBox;\n\nexport function isNodeObject(value: Node): value is NodeObject {\n  return value.type === \"object\";\n}\n\nexport function isNodeTextBox(value: Node): value is NodeTextBox {\n  return value.type === \"text-box\";\n}\n\n"],"mappings":"AAAA;;AAGA;AACA;AACA;;AAaA;AACA;AACA;;AAiBA,OAAO,SAASA,YAAYA,CAACC,KAAW,EAAuB;EAC7D,OAAOA,KAAK,CAACC,IAAI,KAAK,QAAQ;AAChC;AAEA,OAAO,SAASC,aAAaA,CAACF,KAAW,EAAwB;EAC/D,OAAOA,KAAK,CAACC,IAAI,KAAK,UAAU;AAClC","ignoreList":[]}

package/build/esm/utils/steps/__tests__/__snapshots__/types/refTypes.js.map

@@ -1 +1 @@
-{"version":3,"file":"refTypes.js","names":[],"sources":["refTypes.ts"],"sourcesContent":["/* Generated by @palantir/pack.document-schema.type-gen@0.31.0 */\n\nimport type { DocumentId, MediaId, ObjectId, ResourceRid, UserId } from \"@palantir/pack.document-schema.model-types\";\n\n/**\n * A record containing all reference types\n */\nexport interface Document {\n  readonly id: string;\n  readonly docRef: DocumentId;\n  readonly userRef: UserId;\n  readonly objectRef: ObjectId;\n  readonly mediaRef: MediaId;\n  readonly resourceRef: ResourceRid;\n  readonly optionalDocRef?: DocumentId;\n  readonly docRefArray: readonly DocumentId[];\n  readonly userRefArray: readonly UserId[];\n  readonly optionalResourceRef?: ResourceRid;\n  readonly resourceRefArray: readonly ResourceRid[];\n}\n\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"refTypes.js","names":[],"sources":["refTypes.ts"],"sourcesContent":["/* Generated by @palantir/pack.document-schema.type-gen@0.32.0 */\n\nimport type { DocumentId, MediaId, ObjectId, ResourceRid, UserId } from \"@palantir/pack.document-schema.model-types\";\n\n/**\n * A record containing all reference types\n */\nexport interface Document {\n  readonly id: string;\n  readonly docRef: DocumentId;\n  readonly userRef: UserId;\n  readonly objectRef: ObjectId;\n  readonly mediaRef: MediaId;\n  readonly resourceRef: ResourceRid;\n  readonly optionalDocRef?: DocumentId;\n  readonly docRefArray: readonly DocumentId[];\n  readonly userRefArray: readonly UserId[];\n  readonly optionalResourceRef?: ResourceRid;\n  readonly resourceRefArray: readonly ResourceRid[];\n}\n\n"],"mappings":"","ignoreList":[]}

package/build/esm/utils/steps/__tests__/__snapshots__/types/simpleRecord.js.map

@@ -1 +1 @@
-{"version":3,"file":"simpleRecord.js","names":[],"sources":["simpleRecord.ts"],"sourcesContent":["/* Generated by @palantir/pack.document-schema.type-gen@0.31.0 */\n\n\n/**\n * A person record\n */\nexport interface Person {\n  readonly name: string;\n  readonly age: number;\n  readonly email?: string;\n}\n\n"],"mappings":"","ignoreList":[]}
+{"version":3,"file":"simpleRecord.js","names":[],"sources":["simpleRecord.ts"],"sourcesContent":["/* Generated by @palantir/pack.document-schema.type-gen@0.32.0 */\n\n\n/**\n * A person record\n */\nexport interface Person {\n  readonly name: string;\n  readonly age: number;\n  readonly email?: string;\n}\n\n"],"mappings":"","ignoreList":[]}

package/build/esm/utils/steps/__tests__/__snapshots__/types/simpleSteps.js

@@ -1,4 +1,4 @@
-/* Generated by @palantir/pack.document-schema.type-gen@0.31.0 */
+/* Generated by @palantir/pack.document-schema.type-gen@0.32.0 */
 
 /**
  * A node in the graph

package/build/esm/utils/steps/__tests__/__snapshots__/types/simpleSteps.js.map

@@ -1 +1 @@
-{"version":3,"file":"simpleSteps.js","names":["isNodeObject","value","type","isNodeTextBox"],"sources":["simpleSteps.ts"],"sourcesContent":["/* Generated by @palantir/pack.document-schema.type-gen@0.31.0 */\n\n\n/**\n * A node in the graph\n */\nexport interface ObjectNode {\n  readonly x: number;\n  readonly y: number;\n  readonly object: string;\n  readonly label?: string;\n  readonly edges: readonly Edge[];\n}\n\n/**\n * A text box in the graph\n */\nexport interface TextBox {\n  readonly x: number;\n  readonly y: number;\n  readonly text: string;\n}\n\n/**\n * An edge in the graph\n */\nexport interface Edge {\n  readonly source: ObjectNode;\n  readonly target: ObjectNode;\n}\n\nexport interface NodeObject extends ObjectNode {\n  readonly type: \"object\";\n}\n\nexport interface NodeTextBox extends TextBox {\n  readonly type: \"textBox\";\n}\n\nexport type Node = NodeObject | NodeTextBox;\n\nexport function isNodeObject(value: Node): value is NodeObject {\n  return value.type === \"object\";\n}\n\nexport function isNodeTextBox(value: Node): value is NodeTextBox {\n  return value.type === \"textBox\";\n}\n\n"],"mappings":"AAAA;;AAGA;AACA;AACA;;AASA;AACA;AACA;;AAOA;AACA;AACA;;AAgBA,OAAO,SAASA,YAAYA,CAACC,KAAW,EAAuB;EAC7D,OAAOA,KAAK,CAACC,IAAI,KAAK,QAAQ;AAChC;AAEA,OAAO,SAASC,aAAaA,CAACF,KAAW,EAAwB;EAC/D,OAAOA,KAAK,CAACC,IAAI,KAAK,SAAS;AACjC","ignoreList":[]}
+{"version":3,"file":"simpleSteps.js","names":["isNodeObject","value","type","isNodeTextBox"],"sources":["simpleSteps.ts"],"sourcesContent":["/* Generated by @palantir/pack.document-schema.type-gen@0.32.0 */\n\n\n/**\n * A node in the graph\n */\nexport interface ObjectNode {\n  readonly x: number;\n  readonly y: number;\n  readonly object: string;\n  readonly label?: string;\n  readonly edges: readonly Edge[];\n}\n\n/**\n * A text box in the graph\n */\nexport interface TextBox {\n  readonly x: number;\n  readonly y: number;\n  readonly text: string;\n}\n\n/**\n * An edge in the graph\n */\nexport interface Edge {\n  readonly source: ObjectNode;\n  readonly target: ObjectNode;\n}\n\nexport interface NodeObject extends ObjectNode {\n  readonly type: \"object\";\n}\n\nexport interface NodeTextBox extends TextBox {\n  readonly type: \"textBox\";\n}\n\nexport type Node = NodeObject | NodeTextBox;\n\nexport function isNodeObject(value: Node): value is NodeObject {\n  return value.type === \"object\";\n}\n\nexport function isNodeTextBox(value: Node): value is NodeTextBox {\n  return value.type === \"textBox\";\n}\n\n"],"mappings":"AAAA;;AAGA;AACA;AACA;;AASA;AACA;AACA;;AAOA;AACA;AACA;;AAgBA,OAAO,SAASA,YAAYA,CAACC,KAAW,EAAuB;EAC7D,OAAOA,KAAK,CAACC,IAAI,KAAK,QAAQ;AAChC;AAEA,OAAO,SAASC,aAAaA,CAACF,KAAW,EAAwB;EAC/D,OAAOA,KAAK,CAACC,IAAI,KAAK,SAAS;AACjC","ignoreList":[]}

package/build/esm/utils/{formatVariantName.js → unknownVariantSuffix.js}

@@ -1,5 +1,5 @@
 /*
- * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ * Copyright 2026 Palantir Technologies, Inc. All rights reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -14,8 +14,9 @@
  * limitations under the License.
  */
 
-export function formatVariantName(variantName) {
-  // Convert kebab-case or snake_case to PascalCase
-  return variantName.split(/[-_]/).map(part => part.charAt(0).toUpperCase() + part.slice(1)).join("");
-}
-//# sourceMappingURL=formatVariantName.js.map
+import { UNKNOWN_UNION_VARIANT } from "@palantir/pack.document-schema.model-types";
+import { formatVariantName } from "@palantir/pack.schema";
+
+/** Name suffix for a union's Unknown case, e.g. `NodeShapeUnknown`. */
+export const UNKNOWN_VARIANT_SUFFIX = formatVariantName(UNKNOWN_UNION_VARIANT);
+//# sourceMappingURL=unknownVariantSuffix.js.map

package/build/esm/utils/unknownVariantSuffix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknownVariantSuffix.js","names":["UNKNOWN_UNION_VARIANT","formatVariantName","UNKNOWN_VARIANT_SUFFIX"],"sources":["unknownVariantSuffix.ts"],"sourcesContent":["/*\n * Copyright 2026 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { UNKNOWN_UNION_VARIANT } from \"@palantir/pack.document-schema.model-types\";\nimport { formatVariantName } from \"@palantir/pack.schema\";\n\n/** Name suffix for a union's Unknown case, e.g. `NodeShapeUnknown`. */\nexport const UNKNOWN_VARIANT_SUFFIX: string = formatVariantName(UNKNOWN_UNION_VARIANT);\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,qBAAqB,QAAQ,4CAA4C;AAClF,SAASC,iBAAiB,QAAQ,uBAAuB;;AAEzD;AACA,OAAO,MAAMC,sBAA8B,GAAGD,iBAAiB,CAACD,qBAAqB,CAAC","ignoreList":[]}

package/build/types/utils/ir/generateModelsFromIr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateModelsFromIr.d.ts","sourceRoot":"","sources":["../../../../src/utils/ir/generateModelsFromIr.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yDAAyD,CAAC;AAIvG,MAAM,WAAW,qBAAqB;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,MAAM,EAAE,uBAAuB,EAC/B,OAAO,GAAE,qBAAqB,GAAG,SAAqB;IAGlE,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAyDxC,OAAO,CAAC,sBAAsB;IAuC9B,OAAO,CAAC,qBAAqB;IAkC7B,OAAO,CAAC,4BAA4B;IA2BpC,OAAO,CAAC,sBAAsB;CAqC/B;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,uBAAuB,EAC/B,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAGjB"}
+{"version":3,"file":"generateModelsFromIr.d.ts","sourceRoot":"","sources":["../../../../src/utils/ir/generateModelsFromIr.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yDAAyD,CAAC;AAGvG,MAAM,WAAW,qBAAqB;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBADP,MAAM,EAAE,uBAAuB,EAC/B,OAAO,GAAE,qBAAqB,GAAG,SAAqB;IAGlE,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAyDxC,OAAO,CAAC,sBAAsB;IAuC9B,OAAO,CAAC,qBAAqB;IAkC7B,OAAO,CAAC,4BAA4B;IA2BpC,OAAO,CAAC,sBAAsB;CAqC/B;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,uBAAuB,EAC/B,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAGjB"}

package/build/types/utils/ir/generateZodSchemasFromIr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateZodSchemasFromIr.d.ts","sourceRoot":"","sources":["../../../../src/utils/ir/generateZodSchemasFromIr.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAKV,uBAAuB,EAGxB,MAAM,yDAAyD,CAAC;AAKjE,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AA8WD,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,uBAAuB,EAC/B,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAGjB"}
+{"version":3,"file":"generateZodSchemasFromIr.d.ts","sourceRoot":"","sources":["../../../../src/utils/ir/generateZodSchemasFromIr.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAKV,uBAAuB,EAGxB,MAAM,yDAAyD,CAAC;AAIjE,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AA8WD,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,uBAAuB,EAC/B,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,MAAM,CAAC,CAGjB"}

package/build/types/utils/schema/generateIndexFromSchema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateIndexFromSchema.d.ts","sourceRoot":"","sources":["../../../../src/utils/schema/generateIndexFromSchema.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAa/D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,eAAe,EACzB,mBAAmB,CAAC,EAAE,MAAM,GAC3B,MAAM,CAoDR"}
+{"version":3,"file":"generateIndexFromSchema.d.ts","sourceRoot":"","sources":["../../../../src/utils/schema/generateIndexFromSchema.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAe/D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,eAAe,EACzB,mBAAmB,CAAC,EAAE,MAAM,GAC3B,MAAM,CAwDR"}

package/build/types/utils/schema/generateModelMetadataFromSchema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateModelMetadataFromSchema.d.ts","sourceRoot":"","sources":["../../../../src/utils/schema/generateModelMetadataFromSchema.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAW/D,MAAM,WAAW,mBAAmB;IAClC,sFAAsF;IACtF,UAAU,EAAE,MAAM,CAAC;CACpB;AAeD;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,eAAe,EACzB,mBAAmB,CAAC,EAAE,MAAM,GAC3B,mBAAmB,CAwLrB"}
+{"version":3,"file":"generateModelMetadataFromSchema.d.ts","sourceRoot":"","sources":["../../../../src/utils/schema/generateModelMetadataFromSchema.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAW/D,MAAM,WAAW,mBAAmB;IAClC,sFAAsF;IACtF,UAAU,EAAE,MAAM,CAAC;CACpB;AAeD;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,eAAe,EACzB,mBAAmB,CAAC,EAAE,MAAM,GAC3B,mBAAmB,CAiMrB"}

package/build/types/utils/schema/generateTypesFromSchema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateTypesFromSchema.d.ts","sourceRoot":"","sources":["../../../../src/utils/schema/generateTypesFromSchema.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AA6KpE,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,cAAc,EAC9D,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAChB,MAAM,CA4CR"}
+{"version":3,"file":"generateTypesFromSchema.d.ts","sourceRoot":"","sources":["../../../../src/utils/schema/generateTypesFromSchema.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AA4KpE,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,cAAc,EAC9D,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAChB,MAAM,CA4CR"}

package/build/types/utils/schema/generateVersionedTypesFromSchema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateVersionedTypesFromSchema.d.ts","sourceRoot":"","sources":["../../../../src/utils/schema/generateVersionedTypesFromSchema.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,yBAAyB,CAAC;AAIjF,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,qDAAqD;IACrD,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,yEAAyE;IACzE,aAAa,EAAE,MAAM,CAAC;CACvB;AA8KD;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,eAAe,EACzB,mBAAmB,CAAC,EAAE,MAAM,GAC3B,oBAAoB,CAiBtB"}
+{"version":3,"file":"generateVersionedTypesFromSchema.d.ts","sourceRoot":"","sources":["../../../../src/utils/schema/generateVersionedTypesFromSchema.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,yBAAyB,CAAC;AAUjF,MAAM,WAAW,oBAAoB;IACnC,gDAAgD;IAChD,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,qDAAqD;IACrD,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,yEAAyE;IACzE,aAAa,EAAE,MAAM,CAAC;CACvB;AA2MD;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,eAAe,EACzB,mBAAmB,CAAC,EAAE,MAAM,GAC3B,oBAAoB,CAiBtB"}

package/build/types/utils/schema/generateVersionedZodFromSchema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generateVersionedZodFromSchema.d.ts","sourceRoot":"","sources":["../../../../src/utils/schema/generateVersionedZodFromSchema.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,yBAAyB,CAAC;AAIjF,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,4EAA4E;IAC5E,cAAc,EAAE,MAAM,CAAC;CACxB;AA2ID;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,eAAe,EACzB,mBAAmB,CAAC,EAAE,MAAM,GAC3B,kBAAkB,CAepB"}
+{"version":3,"file":"generateVersionedZodFromSchema.d.ts","sourceRoot":"","sources":["../../../../src/utils/schema/generateVersionedZodFromSchema.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,yBAAyB,CAAC;AAIjF,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,4EAA4E;IAC5E,cAAc,EAAE,MAAM,CAAC;CACxB;AAmJD;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,eAAe,EACzB,mBAAmB,CAAC,EAAE,MAAM,GAC3B,kBAAkB,CAepB"}

package/build/types/utils/schema/runtimeSchema.d.ts

@@ -1,5 +1,9 @@
 /** Versioned read type name: `RecordName_vN` */
 export declare function versionedTypeName(exportName: string, version: number): string;
+/** e.g. `NodeShape_v3` -> `KnownNodeShape_v3`: a union's variants without the Unknown case. */
+export declare function knownTypeName(unionTypeName: string): string;
+/** e.g. `NodeShape_v3` -> `narrowKnownNodeShape_v3`. */
+export declare function narrowKnownFunctionName(unionTypeName: string): string;
 /** Versioned write type name: `RecordNameUpdate_vN` */
 export declare function versionedWriteTypeName(exportName: string, version: number): string;
 /** Versioned Zod schema name: `RecordNameSchema_vN` */

package/build/types/utils/schema/runtimeSchema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtimeSchema.d.ts","sourceRoot":"","sources":["../../../../src/utils/schema/runtimeSchema.ts"],"names":[],"mappings":"AAgBA,gDAAgD;AAChD,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED,uDAAuD;AACvD,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAElF;AAED,uDAAuD;AACvD,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/E;AAED,6CAA6C;AAC7C,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,sDAAsD;AACtD,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,mDAAmD;AACnD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,8CAA8C;AAC9C,eAAO,MAAM,mBAAmB,eAAe,CAAC;AAEhD,gDAAgD;AAChD,eAAO,MAAM,oBAAoB,gBAAgB,CAAC;AAElD,sCAAsC;AACtC,eAAO,MAAM,WAAW,gBAAgB,CAAC;AAEzC,6DAA6D;AAC7D,eAAO,MAAM,sBAAsB,4BAA4B,CAAC;AAEhE,wEAAwE;AACxE,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AAErE,0CAA0C;AAC1C,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAE7C,0DAA0D;AAC1D,eAAO,MAAM,sBAAsB,yBAAyB,CAAC;AAE7D,sEAAsE;AACtE,eAAO,MAAM,kBAAkB,sBAAsB,CAAC"}
+{"version":3,"file":"runtimeSchema.d.ts","sourceRoot":"","sources":["../../../../src/utils/schema/runtimeSchema.ts"],"names":[],"mappings":"AAgBA,gDAAgD;AAChD,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED,+FAA+F;AAC/F,wBAAgB,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wDAAwD;AACxD,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAErE;AAED,uDAAuD;AACvD,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAElF;AAED,uDAAuD;AACvD,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/E;AAED,6CAA6C;AAC7C,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,sDAAsD;AACtD,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,mDAAmD;AACnD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,8CAA8C;AAC9C,eAAO,MAAM,mBAAmB,eAAe,CAAC;AAEhD,gDAAgD;AAChD,eAAO,MAAM,oBAAoB,gBAAgB,CAAC;AAElD,sCAAsC;AACtC,eAAO,MAAM,WAAW,gBAAgB,CAAC;AAEzC,6DAA6D;AAC7D,eAAO,MAAM,sBAAsB,4BAA4B,CAAC;AAEhE,wEAAwE;AACxE,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AAErE,0CAA0C;AAC1C,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAE7C,0DAA0D;AAC1D,eAAO,MAAM,sBAAsB,yBAAyB,CAAC;AAE7D,sEAAsE;AACtE,eAAO,MAAM,kBAAkB,sBAAsB,CAAC"}

package/build/types/utils/unknownVariantSuffix.d.ts

@@ -0,0 +1,3 @@
+/** Name suffix for a union's Unknown case, e.g. `NodeShapeUnknown`. */
+export declare const UNKNOWN_VARIANT_SUFFIX: string;
+//# sourceMappingURL=unknownVariantSuffix.d.ts.map

package/build/types/utils/unknownVariantSuffix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unknownVariantSuffix.d.ts","sourceRoot":"","sources":["../../../src/utils/unknownVariantSuffix.ts"],"names":[],"mappings":"AAmBA,uEAAuE;AACvE,eAAO,MAAM,sBAAsB,EAAE,MAAiD,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@palantir/pack.document-schema.type-gen",
-  "version": "0.31.0",
+  "version": "0.32.0",
   "description": "TypeScript type generation from document schema",
   "license": "Apache-2.0",
   "repository": {
@@ -26,9 +26,9 @@
     "js-yaml": "^4.1.1",
     "tiny-invariant": "^1.3.3",
     "yaml": "^2.8.2",
-    "zod": "^4.1.13",
-    "@palantir/pack.document-schema.model-types": "~0.31.0",
-    "@palantir/pack.schema": "0.31.0"
+    "zod": "^4.6.7",
+    "@palantir/pack.document-schema.model-types": "~0.32.0",
+    "@palantir/pack.schema": "0.32.0"
   },
   "devDependencies": {
     "@types/fs-extra": "^11.0.4",

package/build/esm/utils/formatVariantName.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"formatVariantName.js","names":["formatVariantName","variantName","split","map","part","charAt","toUpperCase","slice","join"],"sources":["formatVariantName.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport function formatVariantName(variantName: string): string {\n  // Convert kebab-case or snake_case to PascalCase\n  return variantName\n    .split(/[-_]/)\n    .map(part => part.charAt(0).toUpperCase() + part.slice(1))\n    .join(\"\");\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAO,SAASA,iBAAiBA,CAACC,WAAmB,EAAU;EAC7D;EACA,OAAOA,WAAW,CACfC,KAAK,CAAC,MAAM,CAAC,CACbC,GAAG,CAACC,IAAI,IAAIA,IAAI,CAACC,MAAM,CAAC,CAAC,CAAC,CAACC,WAAW,CAAC,CAAC,GAAGF,IAAI,CAACG,KAAK,CAAC,CAAC,CAAC,CAAC,CACzDC,IAAI,CAAC,EAAE,CAAC;AACb","ignoreList":[]}

package/build/types/utils/formatVariantName.d.ts

@@ -1,2 +0,0 @@
-export declare function formatVariantName(variantName: string): string;
-//# sourceMappingURL=formatVariantName.d.ts.map

package/build/types/utils/formatVariantName.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"formatVariantName.d.ts","sourceRoot":"","sources":["../../../src/utils/formatVariantName.ts"],"names":[],"mappings":"AAgBA,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAM7D"}