@skmtc/core 0.0.29 → 0.0.218

package/script/context/ParseContext.d.ts

@@ -1,23 +1,15 @@
-import type { ReportArgs, Reporter } from './Reporter.js';
-import type { SpecVersion } from '@redocly/openapi-core';
 import type { OpenAPIV3 } from 'openapi-types';
 import type { Trail } from './Trail.js';
 type ParseContextArgs = {
-    specVersion: SpecVersion;
     parsedDocument: OpenAPIV3.Document;
-    reporter?: Reporter | undefined;
 };
 export declare class ParseContext {
-    private reporter;
-    specVersion: SpecVersion;
     parsedDocument: OpenAPIV3.Document;
     refDiffs: Promise<{
         trail: Trail;
         key: string;
     }>[];
-    private constructor();
-    static create({ parsedDocument, specVersion, reporter }: ParseContextArgs): ParseContext;
-    report({ level, phase, trail, message }: ReportArgs): void;
+    constructor({ parsedDocument }: ParseContextArgs);
 }
 export {};
 //# sourceMappingURL=ParseContext.d.ts.map

package/script/context/ParseContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ParseContext.d.ts","sourceRoot":"","sources":["../../src/context/ParseContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAEvC,KAAK,gBAAgB,GAAG;IACtB,WAAW,EAAE,WAAW,CAAA;IACxB,cAAc,EAAE,SAAS,CAAC,QAAQ,CAAA;IAClC,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;CAChC,CAAA;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAsB;IACtC,WAAW,EAAE,WAAW,CAAA;IACxB,cAAc,EAAE,SAAS,CAAC,QAAQ,CAAA;IAClC,QAAQ,EAAE,OAAO,CAAC;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAA;IAElD,OAAO;IAWP,MAAM,CAAC,MAAM,CAAC,EACZ,cAAc,EACd,WAAW,EACX,QAAQ,EACT,EAAE,gBAAgB,GAAG,YAAY;IAIlC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,UAAU;CAQpD"}
+{"version":3,"file":"ParseContext.d.ts","sourceRoot":"","sources":["../../src/context/ParseContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAEvC,KAAK,gBAAgB,GAAG;IACtB,cAAc,EAAE,SAAS,CAAC,QAAQ,CAAA;CACnC,CAAA;AAED,qBAAa,YAAY;IACvB,cAAc,EAAE,SAAS,CAAC,QAAQ,CAAA;IAClC,QAAQ,EAAE,OAAO,CAAC;QAAE,KAAK,EAAE,KAAK,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAA;gBAEtC,EAAE,cAAc,EAAE,EAAE,gBAAgB;CAIjD"}

package/script/context/ParseContext.js

@@ -2,19 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ParseContext = void 0;
 class ParseContext {
-    constructor({ parsedDocument, specVersion, reporter }) {
-        Object.defineProperty(this, "reporter", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
-        Object.defineProperty(this, "specVersion", {
-            enumerable: true,
-            configurable: true,
-            writable: true,
-            value: void 0
-        });
+    constructor({ parsedDocument }) {
         Object.defineProperty(this, "parsedDocument", {
             enumerable: true,
             configurable: true,
@@ -28,15 +16,7 @@ class ParseContext {
             value: void 0
         });
         this.parsedDocument = parsedDocument;
-        this.specVersion = specVersion;
-        this.reporter = reporter;
         this.refDiffs = [];
     }
-    static create({ parsedDocument, specVersion, reporter }) {
-        return new ParseContext({ parsedDocument, specVersion, reporter });
-    }
-    report({ level, phase, trail, message }) {
-        this.reporter?.report({ level, phase, trail, message });
-    }
 }
 exports.ParseContext = ParseContext;

package/script/context/RenderContext.d.ts

@@ -1,32 +1,50 @@
 import type { PrettierConfigType } from '../types/prettierConfig.js';
-import type { ReportArgs } from './Reporter.js';
-import type { Reporter } from './Reporter.js';
-import type { FileContents, RenderOptions } from './types.js';
-import type { Settings } from '../settings/types.js';
+import type { AddGeneratorKeyArgs, FileContents, RenderDependencies, RenderOptions } from './types.js';
+import type { ClientSettings } from '../types/Settings.js';
 import type { Definition } from '../dsl/Definition.js';
 import type { PickArgs } from './GenerateContext.js';
+import type { GeneratorKey } from '../types/GeneratorKeys.js';
 type ConstructorArgs = {
     files: Map<string, FileContents>;
     packageDependencies: Map<string, string>;
-    reporter: Reporter;
     prettier?: PrettierConfigType;
-    settings: Settings | undefined;
+    settings: ClientSettings | undefined;
+    renderDependencies: RenderDependencies;
+    pinnableGenerators: string[];
+};
+type ManifestEntry = {
+    numberOfLines: number;
+    numberOfCharacters: number;
+    hash: string;
+    generatorKeys: GeneratorKey[];
+};
+type Manifest = {
+    createdAt: string;
+    files: Record<string, ManifestEntry>;
+    pinnable: Record<GeneratorKey, string>;
+};
+export type FilesRenderResult = {
+    artifacts: Record<string, string>;
+    manifest: Manifest;
+};
+export type RenderResult = FilesRenderResult & {
+    renderDependencies: Record<string, string[]>;
 };
 export declare class RenderContext {
     files: Map<string, FileContents>;
+    renderDependencies: RenderDependencies;
     packageDependencies: Map<string, string>;
-    private reporter;
     private prettier?;
-    settings: Settings | undefined;
-    private constructor();
-    static create(args: ConstructorArgs): RenderContext;
+    settings: ClientSettings | undefined;
+    currentDestinationPath: string | 'PRE_RENDER' | 'POST_RENDER';
+    pinnableGenerators: string[];
+    constructor({ files, packageDependencies, prettier, settings, renderDependencies, pinnableGenerators }: ConstructorArgs);
     toPackageJson(): string;
-    render({ packageJson }: RenderOptions): Promise<Record<string, string>>;
+    render({ packageJson }: RenderOptions): Promise<RenderResult>;
     private collate;
-    private format;
     getFile(filePath: string): FileContents;
+    addGeneratorKey({ generatorKey }: AddGeneratorKeyArgs): void;
     pick({ name, exportPath }: PickArgs): Definition | undefined;
-    report({ level, phase, trail, message }: ReportArgs): void;
 }
 export {};
 //# sourceMappingURL=RenderContext.d.ts.map

package/script/context/RenderContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RenderContext.d.ts","sourceRoot":"","sources":["../../src/context/RenderContext.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAEpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAK7C,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAEpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAEpD,KAAK,eAAe,GAAG;IACrB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IAChC,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxC,QAAQ,EAAE,QAAQ,CAAA;IAClB,QAAQ,CAAC,EAAE,kBAAkB,CAAA;IAC7B,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAA;CAC/B,CAAA;AAED,qBAAa,aAAa;IACxB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IAChC,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxC,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,QAAQ,CAAC,CAAoB;IACrC,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAAA;IAE9B,OAAO;IAcP,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,aAAa;IAInD,aAAa,IAAI,MAAM;IAQjB,MAAM,CAAC,EACX,WAAW,EACZ,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAUlD,OAAO,CAAC,OAAO;YA+BD,MAAM;IA4BpB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY;IAavC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS;IAI5D,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,UAAU,GAAG,IAAI;CAG3D"}
+{"version":3,"file":"RenderContext.d.ts","sourceRoot":"","sources":["../../src/context/RenderContext.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAMpE,OAAO,KAAK,EACV,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACd,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAG7D,KAAK,eAAe,GAAG;IACrB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IAChC,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxC,QAAQ,CAAC,EAAE,kBAAkB,CAAA;IAC7B,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAA;IACpC,kBAAkB,EAAE,kBAAkB,CAAA;IACtC,kBAAkB,EAAE,MAAM,EAAE,CAAA;CAC7B,CAAA;AAED,KAAK,aAAa,GAAG;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,kBAAkB,EAAE,MAAM,CAAA;IAC1B,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,YAAY,EAAE,CAAA;CAC9B,CAAA;AAED,KAAK,QAAQ,GAAG;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IACpC,QAAQ,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAA;CACvC,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,QAAQ,EAAE,QAAQ,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG,iBAAiB,GAAG;IAC7C,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CAC7C,CAAA;AAED,qBAAa,aAAa;IACxB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IAChC,kBAAkB,EAAE,kBAAkB,CAAA;IACtC,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxC,OAAO,CAAC,QAAQ,CAAC,CAAoB;IACrC,QAAQ,EAAE,cAAc,GAAG,SAAS,CAAA;IACpC,sBAAsB,EAAE,MAAM,GAAG,YAAY,GAAG,aAAa,CAAA;IAC7D,kBAAkB,EAAE,MAAM,EAAE,CAAA;gBAChB,EACV,KAAK,EACL,mBAAmB,EACnB,QAAQ,EACR,QAAQ,EACR,kBAAkB,EAClB,kBAAkB,EACnB,EAAE,eAAe;IAUlB,aAAa,IAAI,MAAM;IAQjB,MAAM,CAAC,EAAE,WAAW,EAAE,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;YAyCrD,OAAO;IAuErB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY;IAavC,eAAe,CAAC,EAAE,YAAY,EAAE,EAAE,mBAAmB;IAarD,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS;CAG7D"}

package/script/context/RenderContext.js

@@ -1,30 +1,55 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RenderContext = void 0;
+const mod_js_1 = require("../deps/jsr.io/@std/encoding/1.0.1/mod.js");
 const Import_js_1 = require("../dsl/Import.js");
 const standalone_1 = require("prettier/standalone");
 const typescript_1 = __importDefault(require("prettier/plugins/typescript"));
 const estree_1 = __importDefault(require("prettier/plugins/estree"));
 const tiny_invariant_1 = __importDefault(require("tiny-invariant"));
-const mod_js_1 = require("../deps/jsr.io/@std/path/0.224.0/mod.js");
+const mod_js_2 = require("../deps/jsr.io/@std/path/1.0.0/mod.js");
+const Sentry = __importStar(require("@sentry/deno"));
 class RenderContext {
-    constructor({ files, packageDependencies, reporter, prettier, settings }) {
+    constructor({ files, packageDependencies, prettier, settings, renderDependencies, pinnableGenerators }) {
         Object.defineProperty(this, "files", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
-        Object.defineProperty(this, "packageDependencies", {
+        Object.defineProperty(this, "renderDependencies", {
             enumerable: true,
             configurable: true,
             writable: true,
             value: void 0
         });
-        Object.defineProperty(this, "reporter", {
+        Object.defineProperty(this, "packageDependencies", {
             enumerable: true,
             configurable: true,
             writable: true,
@@ -42,14 +67,25 @@ class RenderContext {
             writable: true,
             value: void 0
         });
+        Object.defineProperty(this, "currentDestinationPath", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "pinnableGenerators", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.currentDestinationPath = 'PRE_RENDER';
+        this.renderDependencies = renderDependencies;
         this.files = files;
         this.packageDependencies = packageDependencies;
-        this.reporter = reporter;
         this.prettier = prettier;
         this.settings = settings;
-    }
-    static create(args) {
-        return new RenderContext(args);
+        this.pinnableGenerators = pinnableGenerators;
     }
     toPackageJson() {
         const dependencies = Object.fromEntries(this.packageDependencies.entries());
@@ -57,62 +93,161 @@ class RenderContext {
         return packageJson;
     }
     async render({ packageJson }) {
-        const artifactsMap = this.collate();
-        const formatted = await this.format(artifactsMap);
-        return packageJson
-            ? { ...formatted, 'package.json': this.toPackageJson() }
-            : formatted;
-    }
-    collate() {
-        const fileEntries = Array.from(this.files.entries()).map(([destination, file]) => {
-            const imports = Array.from(file.imports.entries()).map(([module, importItems]) => {
-                return Import_js_1.Import.create(module, Array.from(importItems));
+        const result = await Sentry.startSpan({ name: 'Collate content' }, async () => {
+            return await this.collate();
+        });
+        const renderDependenciesEntries = [
+            ...this.renderDependencies.entries()
+        ].map(([generatorId, dependencyGeneratorKeys]) => {
+            return [generatorId, Array.from(dependencyGeneratorKeys)];
+        });
+        const renderDependencies = Object.fromEntries(renderDependenciesEntries);
+        const pinnable = await Sentry.startSpan({ name: 'Generate pinnable' }, () => {
+            return generatePinnable({
+                pinnableGenerators: this.pinnableGenerators,
+                manifest: result.manifest
             });
-            const fileContents = [
-                imports,
-                Array.from(file.definitions.values()),
-                [] // Without this TS, tries to convert Stringable[] to Import[]
-            ]
-                .filter((section) => Boolean(section?.length))
-                .map(section => section.join('\n'))
-                .join('\n\n');
-            const path = this.settings?.basePath
-                ? (0, mod_js_1.join)(this.settings.basePath, destination.replace(/^@\//, ''))
-                : destination;
-            return [path, fileContents];
         });
-        return Object.fromEntries(fileEntries);
+        return {
+            artifacts: packageJson
+                ? {
+                    ...result.artifacts,
+                    'package.json': this.toPackageJson()
+                }
+                : result.artifacts,
+            manifest: {
+                ...result.manifest,
+                pinnable
+            },
+            renderDependencies
+        };
     }
-    async format(artifactsMap) {
-        if (!this.prettier) {
-            return artifactsMap;
-        }
-        const artifactPromises = Object.values(artifactsMap).map(artifact => {
-            return (0, standalone_1.format)(artifact, {
-                parser: 'typescript',
-                plugins: [estree_1.default, typescript_1.default],
-                ...this.prettier
+    async collate() {
+        const fileEntries = Array.from(this.files.entries());
+        const fileObjects = fileEntries.map(([destination, file]) => {
+            // Set the current destination path to be used by
+            // addGeneratorKey method to apply generator keys
+            // to Correct file
+            this.currentDestinationPath = destination;
+            return renderFile({
+                file,
+                destination,
+                basePath: this.settings?.basePath,
+                prettier: this.prettier
             });
         });
-        const prettifiedArtifacts = await Promise.all(artifactPromises);
-        const prettifiedArtifactEntries = Object.keys(artifactsMap).map((key, index) => {
-            const prettifiedArtifact = prettifiedArtifacts[index];
-            (0, tiny_invariant_1.default)(prettifiedArtifact, 'Prettified artifact is undefined');
-            return [key, prettifiedArtifact];
+        this.currentDestinationPath = 'POST_RENDER';
+        const resolvedFileObjects = [];
+        for (const fileObject of fileObjects) {
+            const formattedContent = await Sentry.startSpan({ name: `Format file: ${fileObject.path}` }, async () => {
+                return await formatContent({
+                    content: fileObject.content,
+                    prettier: this.prettier
+                });
+            });
+            const hash = await toHash(formattedContent);
+            resolvedFileObjects.push({
+                ...fileObject,
+                content: formattedContent,
+                hash
+            });
+        }
+        return resolvedFileObjects.reduce((acc, fileObject) => ({
+            artifacts: {
+                ...acc.artifacts,
+                [fileObject.path]: fileObject.content
+            },
+            manifest: {
+                ...acc.manifest,
+                files: {
+                    ...acc.manifest.files,
+                    [fileObject.path]: {
+                        numberOfLines: fileObject.numberOfLines,
+                        numberOfCharacters: fileObject.numberOfCharacters,
+                        hash: fileObject.hash,
+                        generatorKeys: fileObject.generatorKeys
+                    }
+                }
+            }
+        }), {
+            artifacts: {},
+            manifest: {
+                createdAt: new Date().toISOString(),
+                files: {},
+                pinnable: {}
+            }
         });
-        return Object.fromEntries(prettifiedArtifactEntries);
     }
     getFile(filePath) {
-        const normalisedPath = (0, mod_js_1.normalize)(filePath);
+        const normalisedPath = (0, mod_js_2.normalize)(filePath);
         const currentFile = this.files.get(normalisedPath);
         (0, tiny_invariant_1.default)(currentFile, `File not found during render phase: ${normalisedPath}`);
         return currentFile;
     }
+    addGeneratorKey({ generatorKey }) {
+        const path = this.currentDestinationPath;
+        (0, tiny_invariant_1.default)(!['PRE_RENDER', 'POST_RENDER'].includes(path), `Cannot add generator key during ${path} phase`);
+        const currentFile = this.getFile(path);
+        currentFile.generatorKeys.add(generatorKey);
+    }
     pick({ name, exportPath }) {
         return this.getFile(exportPath).definitions.get(name);
     }
-    report({ level, phase, trail, message }) {
-        this.reporter.report({ level, phase, trail, message });
-    }
 }
 exports.RenderContext = RenderContext;
+const toHash = async (content) => {
+    const messageBuffer = new TextEncoder().encode(content);
+    const hashBuffer = await crypto.subtle.digest('SHA-256', messageBuffer);
+    return (0, mod_js_1.encodeHex)(hashBuffer);
+};
+const renderFile = ({ file, destination, basePath }) => {
+    const imports = Array.from(file.imports.entries()).map(([module, importItems]) => new Import_js_1.Import({ module, importNames: Array.from(importItems) }));
+    const definitions = Array.from(file.definitions.values());
+    const content = [imports, definitions]
+        .filter(section => Boolean(section.length))
+        .map(section => section.join('\n'))
+        .join('\n\n');
+    return {
+        content,
+        path: (0, mod_js_2.join)(basePath ?? 'dist', destination.replace(/^@\//, '')),
+        numberOfLines: content.split('\n').length,
+        numberOfCharacters: content.length,
+        generatorKeys: Array.from(file.generatorKeys).filter(Boolean) // @TODO Fix null keys
+    };
+};
+const formatContent = async ({ content, prettier }) => {
+    if (!prettier) {
+        return content;
+    }
+    return await (0, standalone_1.format)(content, {
+        parser: 'typescript',
+        plugins: [estree_1.default, typescript_1.default],
+        ...prettier
+    });
+};
+const generatePinnable = ({ pinnableGenerators, manifest }) => {
+    const output = {};
+    Object.entries(manifest.files).forEach(([filepath, entry]) => {
+        entry.generatorKeys.forEach(generatorKey => {
+            if (!output[generatorKey]) {
+                output[generatorKey] = [];
+            }
+            output[generatorKey].push(filepath);
+        });
+    });
+    const pinnableEntries = Object.entries(output)
+        .map(([generatorKey, files]) => {
+        if (files.length !== 1) {
+            return null;
+        }
+        const isPinnable = pinnableGenerators.reduce((acc, pinnableGenerator) => {
+            if (generatorKey.startsWith(pinnableGenerator)) {
+                return true;
+            }
+            return acc;
+        }, false);
+        return isPinnable ? [generatorKey, files[0]] : null;
+    })
+        .filter((generatorKey) => generatorKey !== null);
+    return Object.fromEntries(pinnableEntries);
+};

package/script/context/Trail.d.ts

@@ -1,4 +1,3 @@
-import type { Stringable } from '../dsl/Stringable.js';
 import type { OpenAPIV3 } from 'openapi-types';
 type ConstructorArgs = {
     path?: string[];
@@ -8,15 +7,14 @@ type ConstructorArgs = {
     document?: OpenAPIV3.Document;
     subMethodIndex?: number;
 };
-export declare class Trail implements Stringable {
+export declare class Trail {
     path: string[];
     apiPath: string | undefined;
     method: string | undefined;
     schemaRef: string | undefined;
     document: OpenAPIV3.Document | undefined;
     subMethodIndex?: number;
-    private constructor();
-    static create({ path, apiPath, method, schemaRef, document, subMethodIndex }?: ConstructorArgs): Trail;
+    constructor({ path, apiPath, method, schemaRef, document, subMethodIndex }?: ConstructorArgs);
     add(path: string): Trail;
     addApiPath(apiPath: string): Trail;
     addMethod(method: string): Trail;

package/script/context/Trail.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Trail.d.ts","sourceRoot":"","sources":["../../src/context/Trail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C,KAAK,eAAe,GAAG;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,SAAS,CAAC,QAAQ,CAAA;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,qBAAa,KAAM,YAAW,UAAU;IACtC,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,QAAQ,EAAE,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAA;IACxC,cAAc,CAAC,EAAE,MAAM,CAAA;IAEvB,OAAO;IAgBP,MAAM,CAAC,MAAM,CAAC,EACZ,IAAI,EACJ,OAAO,EACP,MAAM,EACN,SAAS,EACT,QAAQ,EACR,cAAc,EACf,GAAE,eAAoB,GAAG,KAAK;IAW/B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK;IAWxB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK;IAWlC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK;IAWhC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK;IAWtC,gBAAgB,IAAI,KAAK;IAWzB,QAAQ,IAAI,MAAM;CASnB"}
+{"version":3,"file":"Trail.d.ts","sourceRoot":"","sources":["../../src/context/Trail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C,KAAK,eAAe,GAAG;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,SAAS,CAAC,QAAQ,CAAA;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,qBAAa,KAAK;IAChB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,OAAO,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;IAC1B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,QAAQ,EAAE,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAA;IACxC,cAAc,CAAC,EAAE,MAAM,CAAA;gBAEX,EACV,IAAS,EACT,OAAO,EACP,MAAM,EACN,SAAS,EACT,QAAQ,EACR,cAAc,EACf,GAAE,eAAoB;IASvB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK;IAWxB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK;IAWlC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK;IAWhC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK;IAWtC,gBAAgB,IAAI,KAAK;IAWzB,QAAQ,IAAI,MAAM;CASnB"}

package/script/context/Trail.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Trail = void 0;
 class Trail {
-    constructor({ path = [], apiPath, method, schemaRef, document, subMethodIndex }) {
+    constructor({ path = [], apiPath, method, schemaRef, document, subMethodIndex } = {}) {
         Object.defineProperty(this, "path", {
             enumerable: true,
             configurable: true,
@@ -46,18 +46,8 @@ class Trail {
         this.document = document;
         this.subMethodIndex = subMethodIndex;
     }
-    static create({ path, apiPath, method, schemaRef, document, subMethodIndex } = {}) {
-        return new Trail({
-            path,
-            apiPath,
-            method,
-            schemaRef,
-            document,
-            subMethodIndex
-        });
-    }
     add(path) {
-        return Trail.create({
+        return new Trail({
             path: this.path.concat(path),
             apiPath: this.apiPath,
             method: this.method,
@@ -67,7 +57,7 @@ class Trail {
         });
     }
     addApiPath(apiPath) {
-        return Trail.create({
+        return new Trail({
             path: this.path.concat(`[${apiPath}]`),
             apiPath,
             method: this.method,
@@ -77,7 +67,7 @@ class Trail {
         });
     }
     addMethod(method) {
-        return Trail.create({
+        return new Trail({
             path: this.path.concat(method),
             apiPath: this.apiPath,
             method,
@@ -87,7 +77,7 @@ class Trail {
         });
     }
     addSchemaRef(schemaRef) {
-        return Trail.create({
+        return new Trail({
             path: this.path.concat(schemaRef),
             apiPath: this.apiPath,
             method: this.method,
@@ -97,7 +87,7 @@ class Trail {
         });
     }
     toSubMethodTrail() {
-        return Trail.create({
+        return new Trail({
             path: this.path.slice(this.subMethodIndex),
             apiPath: this.apiPath,
             method: this.method,

package/script/context/types.d.ts

@@ -1,10 +1,19 @@
 import type { Definition } from '../dsl/Definition.js';
-export type PhaseType = 'parse' | 'group' | 'render';
+import type { GeneratorKey } from '../types/GeneratorKeys.js';
+export type PhaseType = 'parse' | 'generate' | 'render';
 export type FileContents = {
     imports: Map<string, Set<string>>;
     definitions: Map<string, Definition>;
+    generatorKeys: Set<GeneratorKey>;
 };
 export type RenderOptions = {
     packageJson?: boolean;
 };
+export type RenderDependencies = Map<string, Set<GeneratorKey>>;
+export type GetFileOptions = {
+    throwIfNotFound?: boolean;
+};
+export type AddGeneratorKeyArgs = {
+    generatorKey: GeneratorKey;
+};
 //# sourceMappingURL=types.d.ts.map

package/script/context/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/context/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEtD,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAA;AAEpD,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IACjC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;CACrC,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/context/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAE7D,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAA;AAEvD,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;IACjC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;IACpC,aAAa,EAAE,GAAG,CAAC,YAAY,CAAC,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAA;AAE/D,MAAM,MAAM,cAAc,GAAG;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,YAAY,EAAE,YAAY,CAAA;CAC3B,CAAA"}

package/script/deps/jsr.io/@std/encoding/1.0.1/_validate_binary_like.d.ts

@@ -0,0 +1,2 @@
+export declare function validateBinaryLike(source: unknown): Uint8Array;
+//# sourceMappingURL=_validate_binary_like.d.ts.map

package/script/deps/jsr.io/@std/encoding/1.0.1/_validate_binary_like.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_validate_binary_like.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/encoding/1.0.1/_validate_binary_like.ts"],"names":[],"mappings":"AAeA,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,UAAU,CAa9D"}

package/script/deps/jsr.io/@std/encoding/1.0.1/_validate_binary_like.js

@@ -0,0 +1,29 @@
+"use strict";
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateBinaryLike = validateBinaryLike;
+const encoder = new TextEncoder();
+function getTypeName(value) {
+    const type = typeof value;
+    if (type !== "object") {
+        return type;
+    }
+    else if (value === null) {
+        return "null";
+    }
+    else {
+        return value?.constructor?.name ?? "object";
+    }
+}
+function validateBinaryLike(source) {
+    if (typeof source === "string") {
+        return encoder.encode(source);
+    }
+    else if (source instanceof Uint8Array) {
+        return source;
+    }
+    else if (source instanceof ArrayBuffer) {
+        return new Uint8Array(source);
+    }
+    throw new TypeError(`The input must be a Uint8Array, a string, or an ArrayBuffer. Received a value of the type ${getTypeName(source)}.`);
+}

package/script/deps/jsr.io/@std/encoding/1.0.1/ascii85.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Supported ascii85 standards for {@linkcode EncodeAscii85Options} and
+ * {@linkcode DecodeAscii85Options}.
+ */
+export type Ascii85Standard = "Adobe" | "btoa" | "RFC 1924" | "Z85";
+/** Options for {@linkcode encodeAscii85}. */
+export interface EncodeAscii85Options {
+    /**
+     * Character set and delimiter (if supported and used).
+     *
+     * @default {"Adobe"}
+     */
+    standard?: Ascii85Standard;
+    /**
+     * Whether to use a delimiter (if supported).
+     *
+     * @default {false}
+     */
+    delimiter?: boolean;
+}
+/**
+ * Converts data into an ascii85-encoded string.
+ *
+ * @param data The data to encode.
+ * @param options Options for encoding.
+ *
+ * @returns The ascii85-encoded string.
+ *
+ * @example Usage
+ * ```ts
+ * import { encodeAscii85 } from "@std/encoding/ascii85";
+ * import { assertEquals } from "@std/assert";
+ *
+ * assertEquals(encodeAscii85("Hello world!"), "87cURD]j7BEbo80");
+ * ```
+ */
+export declare function encodeAscii85(data: ArrayBuffer | Uint8Array | string, options?: EncodeAscii85Options): string;
+/** Options for {@linkcode decodeAscii85}. */
+export type DecodeAscii85Options = Omit<EncodeAscii85Options, "delimiter">;
+/**
+ * Decodes a ascii85-encoded string.
+ *
+ * @param ascii85 The ascii85-encoded string to decode.
+ * @param options Options for decoding.
+ * @returns The decoded data.
+ *
+ * @example Usage
+ * ```ts
+ * import { decodeAscii85 } from "@std/encoding/ascii85";
+ * import { assertEquals } from "@std/assert";
+ *
+ * assertEquals(
+ *   decodeAscii85("87cURD]j7BEbo80"),
+ *   new TextEncoder().encode("Hello world!"),
+ * );
+ * ```
+ */
+export declare function decodeAscii85(ascii85: string, options?: DecodeAscii85Options): Uint8Array;
+//# sourceMappingURL=ascii85.d.ts.map