fix: restore full vs compact model distinction

The v0.3.0 migration accidentally made full and compact files identical
by applying withCompactUris() to both. This fix restores the semantic
difference from v0.2.x:

- <name>.json (full): expanded URIs, source maps on by default.
  Intended for editing tools and validators. Source maps can be
  disabled via sourceMaps: false in ApiConfiguration.

- <name>-compact.json: compact URIs (apiContract:WebAPI prefixes),
  never includes source maps. Optimized for display/browsing (e.g.
  API Console). Can reduce model size by up to 80% for large APIs.

Both files share the same parse and transform step; only the render
options differ, so there is no performance regression.

Made-with: Cursor

Author: alexpmule

README.md

@@ -30,7 +30,16 @@ If the value is an array then first element must be API format and second is API
 `ApiDefinition.mime` ⇒ `String`. API media type. Default to `application/yaml`. For GRPC use `application/x-protobuf`.
 `ApiDefinition.resolution` ⇒ `String`. AMF resolution pipeline. Default to `editing` which is the original resolution pipeline for API Console. Future releases of AMF can support different options.
 `ApiDefinition.flattened` ⇒ `Boolean`. When `true`, generates a compact JSON-LD model using `@graph` instead of an expanded array. Recommended for large APIs. Default to `false`.
-`ApiDefinition.sourceMaps` ⇒ `Boolean`. When `false`, omits AMF source map nodes from the generated model. Source maps are only needed for editing tooling (e.g. API designers). Disabling them can reduce model size by up to 80% for large APIs like gRPC. Default to `true`.
+`ApiDefinition.sourceMaps` ⇒ `Boolean`. Controls source maps in the **full** model (`<name>.json`) only. When `false`, source map nodes are omitted — useful when no editing tooling will consume this API. The compact model (`<name>-compact.json`) never includes source maps. Default to `true`.
+
+### Output files
+
+Each API produces two files:
+
+| File | URIs | Source maps | Intended consumer |
+|------|------|-------------|-------------------|
+| `<name>.json` | Expanded (`http://a.ml/...`) | Yes (controlled by `sourceMaps`) | Editing tools, validators |
+| `<name>-compact.json` | Compact (`apiContract:WebAPI`) | Never | API Console, display/browsing |
 
 
 ### Example apis.json

index.js

@@ -40,6 +40,10 @@ function getConfiguration(type) {
 /**
  * Generates json/ld file from parsed document using AMF v5 API.
  *
+ * Produces two output files:
+ *   - `<name>.json`         — full model, expanded URIs, source maps controlled by `sourceMaps`
+ *   - `<name>-compact.json` — compact URIs, never includes source maps (optimized for display)
+ *
  * @param {string} sourceFile
  * @param {string} file
  * @param {string} type
@@ -55,45 +59,51 @@ async function processFile(sourceFile, file, type, destPath, resolution, flatten
     dest = dest.substr(dest.lastIndexOf('/'));
   }
 
-  // Setup render options
-  let renderOpts = new RenderOptions().withCompactUris();
-  if (sourceMaps) {
-    renderOpts = renderOpts.withSourceMaps();
-  }
-  if (flattened) {
-    renderOpts = renderOpts.withCompactedEmission();
-  }
-
-  // Get configuration for API type
-  const apiConfiguration = getConfiguration(type).withRenderOptions(renderOpts);
-  const client = apiConfiguration.baseUnitClient();
-
-  // Parse the file
-  const parseResult = await client.parse(sourceFile);
+  // Parse and transform using a base client (render options don't affect parsing)
+  const parseClient = getConfiguration(type).baseUnitClient();
+  const parseResult = await parseClient.parse(sourceFile);
 
   if (!parseResult.conforms) {
     /* eslint-disable-next-line no-console */
     console.log('Validation warnings/errors:');
     console.log(parseResult.toString());
   }
 
-  // Transform using resolution pipeline
   const pipelineId = resolution === 'editing' ? PipelineId.Editing : PipelineId.Default;
-  const transformed = client.transform(parseResult.baseUnit, pipelineId);
+  const transformed = parseClient.transform(parseResult.baseUnit, pipelineId);
 
-  // Render to JSON-LD
   const fullFile = path.join(destPath, dest);
   const compactDest = dest.replace('.json', '-compact.json');
   const compactFile = path.join(destPath, compactDest);
 
-  // Generate full model (same as compact in v5 with withCompactUris)
-  const modelData = await client.render(transformed.baseUnit, 'application/ld+json');
+  // Full model: expanded URIs, source maps controlled by option (for editing tooling)
+  let fullRenderOpts = new RenderOptions();
+  if (sourceMaps) {
+    fullRenderOpts = fullRenderOpts.withSourceMaps();
+  }
+  if (flattened) {
+    fullRenderOpts = fullRenderOpts.withCompactedEmission();
+  }
+  const fullData = await getConfiguration(type)
+    .withRenderOptions(fullRenderOpts)
+    .baseUnitClient()
+    .render(transformed.baseUnit, 'application/ld+json');
 
   await fs.ensureFile(fullFile);
-  await fs.writeFile(fullFile, modelData, 'utf8');
+  await fs.writeFile(fullFile, fullData, 'utf8');
+
+  // Compact model: compact URIs, no source maps (optimized for display/browsing)
+  let compactRenderOpts = new RenderOptions().withCompactUris();
+  if (flattened) {
+    compactRenderOpts = compactRenderOpts.withCompactedEmission();
+  }
+  const compactData = await getConfiguration(type)
+    .withRenderOptions(compactRenderOpts)
+    .baseUnitClient()
+    .render(transformed.baseUnit, 'application/ld+json');
 
   await fs.ensureFile(compactFile);
-  await fs.writeFile(compactFile, modelData, 'utf8');
+  await fs.writeFile(compactFile, compactData, 'utf8');
 }
 
 /**