@pie-element/cli 0.1.4-next.20261006160832 → 0.1.4

package/dist/lib/schemas/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../../src/lib/schemas/generate.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync, readFileSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { createGenerator } from 'ts-json-schema-generator';\n\n/**\n * JSON Schema generation for an element's contract types.\n *\n * An element declares its contract in `src/types.ts` as `<Name>Model`, `<Name>Configuration` and\n * `<Name>Session`, where `<Name>` is the PascalCase package name. Which schemas it publishes is set\n * by its `exports`: each `./schemas/<kind>.schema.json` entry is generated from the matching type.\n */\n\nexport const SCHEMA_KINDS = ['model', 'configuration', 'session'] as const;\n\nexport type SchemaKind = (typeof SCHEMA_KINDS)[number];\n\ntype JsonSchema = Record<string, unknown>;\n\ntype ElementManifest = {\n  name: string;\n  version: string;\n  exports?: Record<string, unknown>;\n};\n\nconst TYPE_SUFFIX: Record<SchemaKind, string> = {\n  model: 'Model',\n  configuration: 'Configuration',\n  session: 'Session',\n};\n\n// The authored model and configuration are closed at the root, as in the legacy schemas, so a\n// misspelled top-level key fails validation. Nested objects and the session, which players and\n// controllers write extra state into, stay open.\nconst CLOSED_ROOT: Record<SchemaKind, boolean> = {\n  model: true,\n  configuration: true,\n  session: false,\n};\n\nexport const schemaExportKey = (kind: SchemaKind) => `./schemas/${kind}.schema.json`;\n\nexport const readElementManifest = (packageDir: string): ElementManifest =>\n  JSON.parse(readFileSync(join(packageDir, 'package.json'), 'utf-8')) as ElementManifest;\n\n/** The schema kinds a package publishes, in `SCHEMA_KINDS` order. */\nexport const declaredSchemaKinds = (manifest: ElementManifest): SchemaKind[] =>\n  SCHEMA_KINDS.filter((kind) => manifest.exports?.[schemaExportKey(kind)] !== undefined);\n\n/** `@pie-element/multiple-choice` → `MultipleChoice`. */\nexport const typeNamePrefix = (packageName: string) =>\n  (packageName.split('/').pop() ?? packageName)\n    .split('-')\n    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))\n    .join('');\n\nexport const schemaTypeName = (packageName: string, kind: SchemaKind) =>\n  `${typeNamePrefix(packageName)}${TYPE_SUFFIX[kind]}`;\n\n/** Where the published schema resolves: the versioned file on jsDelivr. */\nexport const schemaId = (manifest: ElementManifest, kind: SchemaKind) =>\n  `https://cdn.jsdelivr.net/npm/${manifest.name}@${manifest.version}/dist/schemas/${kind}.schema.json`;\n\n// `@deprecated reason` arrives as a string; JSON Schema's `deprecated` is a boolean, so the reason\n// moves into the description.\nconst normalizeDeprecated = (node: unknown): void => {\n  if (Array.isArray(node)) {\n    for (const item of node) normalizeDeprecated(item);\n    return;\n  }\n  if (!node || typeof node !== 'object') return;\n  const schema = node as JsonSchema;\n  if (typeof schema.deprecated === 'string') {\n    const reason = schema.deprecated.trim();\n    schema.description = [schema.description, reason && `Deprecated: ${reason}`]\n      .filter(Boolean)\n      .join('\\n\\n');\n    schema.deprecated = true;\n  }\n  for (const value of Object.values(schema)) normalizeDeprecated(value);\n};\n\n// TypeScript reads `@scope/name` in a JSDoc comment as a tag and drops the description from there\n// on, so a package name in a comment sits in backticks.\nconst assertNoBarePackageNames = (typesPath: string): void => {\n  for (const [comment] of readFileSync(typesPath, 'utf-8').matchAll(/\\/\\*\\*[\\s\\S]*?\\*\\//g)) {\n    const bare = comment.replace(/`[^`]*`/g, '').match(/(?:^|\\s)(@[\\w-]+\\/[\\w-]+)/);\n    if (bare) {\n      throw new Error(`${typesPath}: wrap ${bare[1]} in backticks; JSDoc reads it as a tag`);\n    }\n  }\n};\n\n/** Generates every schema the package at `packageDir` declares, keyed by kind. */\nexport const generateElementSchemas = (\n  packageDir: string\n): Partial<Record<SchemaKind, JsonSchema>> => {\n  const manifest = readElementManifest(packageDir);\n  const kinds = declaredSchemaKinds(manifest);\n  if (kinds.length === 0) return {};\n\n  const typesPath = join(packageDir, 'src/types.ts');\n  if (!existsSync(typesPath)) {\n    throw new Error(`${manifest.name} declares schema exports but has no src/types.ts`);\n  }\n  assertNoBarePackageNames(typesPath);\n\n  const generator = createGenerator({\n    path: typesPath,\n    tsconfig: join(packageDir, 'tsconfig.json'),\n    expose: 'export',\n    topRef: false,\n    jsDoc: 'extended',\n    skipTypeCheck: true,\n    additionalProperties: true,\n  });\n\n  const schemas: Partial<Record<SchemaKind, JsonSchema>> = {};\n  for (const kind of kinds) {\n    const { $schema, ...body } = generator.createSchema(\n      schemaTypeName(manifest.name, kind)\n    ) as JsonSchema;\n    normalizeDeprecated(body);\n    schemas[kind] = {\n      $schema,\n      $id: schemaId(manifest, kind),\n      ...body,\n      ...(CLOSED_ROOT[kind] ? { additionalProperties: false } : {}),\n    };\n  }\n  return schemas;\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pie-element/cli",
-  "version": "0.1.4-next.20261006160832",
+  "version": "0.1.4",
   "description": "CLI tools for managing PIE Elements NG",
   "type": "module",
   "bin": {
@@ -23,10 +23,11 @@
   "dependencies": {
     "@oclif/core": "^5.1.2",
     "@oclif/plugin-help": "^6.2.0",
-    "@pie-element/element-bundler": "0.1.4-next.20261006160832",
+    "@pie-element/element-bundler": "0.1.3",
     "es-module-lexer": "^1.7.0",
     "glob": "^13.0.0",
     "open": "^10.0.3",
+    "ts-json-schema-generator": "^2.9.0",
     "webpack": "^5.104.1"
   },
   "oclif": {