@skmtc/core 0.0.491 → 0.0.492

package/script/context/RenderContext.d.ts

@@ -0,0 +1,38 @@
+import type { PrettierConfigType } from '../types/prettierConfig.js';
+import type { AddGeneratorKeyArgs, RenderResult } from './types.js';
+import type { Definition } from '../dsl/Definition.js';
+import type { PickArgs } from './GenerateContext.js';
+import type { ResultType } from '../types/Results.js';
+import type { StackTrail } from './StackTrail.js';
+import type * as log from '../deps/jsr.io/@std/log/0.224.8/mod.js';
+import type { File } from '../dsl/File.js';
+type ConstructorArgs = {
+    files: Map<string, File>;
+    previews: Record<string, Record<string, string>>;
+    prettier?: PrettierConfigType;
+    basePath: string | undefined;
+    pinnableGenerators: string[];
+    stackTrail: StackTrail;
+    logger: log.Logger;
+    captureCurrentResult: (result: ResultType) => void;
+};
+export declare class RenderContext {
+    #private;
+    files: Map<string, File>;
+    previews: Record<string, Record<string, string>>;
+    private prettier?;
+    basePath: string | undefined;
+    currentDestinationPath: string | 'PRE_RENDER' | 'POST_RENDER';
+    pinnableGenerators: string[];
+    logger: log.Logger;
+    captureCurrentResult: (result: ResultType) => void;
+    constructor({ files, previews, prettier, basePath, pinnableGenerators, logger, stackTrail, captureCurrentResult }: ConstructorArgs);
+    render(): Omit<RenderResult, 'results'>;
+    private collate;
+    trace<T>(token: string | string[], fn: () => T): T;
+    getFile(filePath: string): File;
+    addGeneratorKey({ generatorKey }: AddGeneratorKeyArgs): void;
+    pick({ name, exportPath }: PickArgs): Definition | undefined;
+}
+export {};
+//# sourceMappingURL=RenderContext.d.ts.map

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

@@ -0,0 +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,mBAAmB,EAAqB,YAAY,EAAE,MAAM,YAAY,CAAA;AAEtF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAGpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAGrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,KAAK,GAAG,MAAM,wCAAwC,CAAA;AAClE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAE1C,KAAK,eAAe,GAAG;IACrB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAChD,QAAQ,CAAC,EAAE,kBAAkB,CAAA;IAC7B,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,kBAAkB,EAAE,MAAM,EAAE,CAAA;IAC5B,UAAU,EAAE,UAAU,CAAA;IACtB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAA;IAClB,oBAAoB,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAA;CACnD,CAAA;AAYD,qBAAa,aAAa;;IACxB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;IACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAChD,OAAO,CAAC,QAAQ,CAAC,CAAoB;IACrC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,sBAAsB,EAAE,MAAM,GAAG,YAAY,GAAG,aAAa,CAAA;IAC7D,kBAAkB,EAAE,MAAM,EAAE,CAAA;IAC5B,MAAM,EAAE,GAAG,CAAC,MAAM,CAAA;IAElB,oBAAoB,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAA;gBACtC,EACV,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,kBAAkB,EAClB,MAAM,EACN,UAAU,EACV,oBAAoB,EACrB,EAAE,eAAe;IAclB,MAAM,IAAI,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC;IAwBvC,OAAO,CAAC,OAAO;IAoDf,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAIlD,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAU/B,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

@@ -0,0 +1,227 @@
+"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 __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+var _RenderContext_stackTrail;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RenderContext = void 0;
+const Sentry = __importStar(require("@sentry/deno"));
+const tiny_invariant_1 = __importDefault(require("tiny-invariant"));
+const mod_js_1 = require("../deps/jsr.io/@std/path/1.0.6/mod.js");
+const toResolvedArtifactPath_js_1 = require("../helpers/toResolvedArtifactPath.js");
+const tracer_js_1 = require("../helpers/tracer.js");
+class RenderContext {
+    constructor({ files, previews, prettier, basePath, pinnableGenerators, logger, stackTrail, captureCurrentResult }) {
+        Object.defineProperty(this, "files", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "previews", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "prettier", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "basePath", {
+            enumerable: true,
+            configurable: true,
+            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
+        });
+        Object.defineProperty(this, "logger", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        _RenderContext_stackTrail.set(this, void 0);
+        Object.defineProperty(this, "captureCurrentResult", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.currentDestinationPath = 'PRE_RENDER';
+        this.files = files;
+        this.previews = previews;
+        this.prettier = prettier;
+        this.basePath = basePath;
+        this.pinnableGenerators = pinnableGenerators;
+        this.logger = logger;
+        __classPrivateFieldSet(this, _RenderContext_stackTrail, stackTrail, "f");
+        this.captureCurrentResult = captureCurrentResult;
+        console.log('PREVIEW 2', previews);
+    }
+    render() {
+        return Sentry.startSpan({ name: 'Render artifacts' }, () => {
+            const result = Sentry.startSpan({ name: 'Collate content' }, () => {
+                return this.collate();
+            });
+            const pinnable = Sentry.startSpan({ name: 'Generate pinnable' }, () => {
+                return generatePinnable({
+                    pinnableGenerators: this.pinnableGenerators,
+                    files: result.files
+                });
+            });
+            const rendered = {
+                artifacts: result.artifacts,
+                files: result.files,
+                previews: this.previews,
+                pinnable
+            };
+            return rendered;
+        });
+    }
+    collate() {
+        const fileEntries = Array.from(this.files.entries());
+        const fileObjects = fileEntries
+            .map(([destinationPath, file]) => {
+            return this.trace(destinationPath, () => {
+                // Set the current destination path to be used by
+                // addGeneratorKey method to apply generator keys
+                // to Correct file
+                // @TODO: Could this be combined with the tracer call above?
+                this.currentDestinationPath = destinationPath;
+                const renderedFile = renderFile({
+                    content: file.toString(),
+                    generatorKeys: Array.from(file.generatorKeys).filter(Boolean),
+                    destinationPath,
+                    basePath: this.basePath,
+                    prettier: this.prettier
+                });
+                this.captureCurrentResult('success');
+                return renderedFile;
+            });
+        })
+            .filter(fileObject => fileObject !== undefined);
+        this.currentDestinationPath = 'POST_RENDER';
+        return fileObjects.reduce((acc, { content, path, ...fileMeta }) => ({
+            ...acc,
+            artifacts: {
+                ...acc.artifacts,
+                [path]: content
+            },
+            files: {
+                ...acc.files,
+                [path]: {
+                    ...fileMeta
+                }
+            }
+        }), {
+            artifacts: {},
+            files: {},
+            pinnable: {}
+        });
+    }
+    trace(token, fn) {
+        return (0, tracer_js_1.tracer)(__classPrivateFieldGet(this, _RenderContext_stackTrail, "f"), token, fn);
+    }
+    getFile(filePath) {
+        const normalisedPath = (0, mod_js_1.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);
+    }
+}
+exports.RenderContext = RenderContext;
+_RenderContext_stackTrail = new WeakMap();
+const renderFile = ({ content, generatorKeys, destinationPath, basePath }) => {
+    return {
+        content,
+        path: (0, toResolvedArtifactPath_js_1.toResolvedArtifactPath)({ basePath, destinationPath }),
+        destinationPath,
+        numberOfLines: content.split('\n').length,
+        numberOfCharacters: content.length,
+        generatorKeys,
+        hash: 'PLACEHOLDER'
+    };
+};
+const generatePinnable = ({ pinnableGenerators, files }) => {
+    const output = {};
+    Object.values(files).forEach(entry => {
+        entry.generatorKeys.forEach(generatorKey => {
+            if (!output[generatorKey]) {
+                output[generatorKey] = [];
+            }
+            output[generatorKey].push(entry.destinationPath);
+        });
+    });
+    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/ResultsHandler.d.ts

@@ -0,0 +1,19 @@
+import { type LevelName } from '../deps/jsr.io/@std/log/0.224.8/levels.js';
+import type { LogRecord } from '../deps/jsr.io/@std/log/0.224.8/logger.js';
+import { BaseHandler } from '../deps/jsr.io/@std/log/0.224.8/base_handler.js';
+import type { BaseHandlerOptions } from '../deps/jsr.io/@std/log/0.224.8/base_handler.js';
+import type { CoreContext } from './CoreContext.js';
+export interface ResultsHandlerOptions extends BaseHandlerOptions {
+    context: CoreContext;
+}
+export declare class ResultsHandler extends BaseHandler {
+    #private;
+    context: CoreContext;
+    constructor(levelName: LevelName, options: ResultsHandlerOptions);
+    setup(): void;
+    handle(logRecord: LogRecord): void;
+    log(levelName: string): void;
+    flush(): void;
+    destroy(): void;
+}
+//# sourceMappingURL=ResultsHandler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ResultsHandler.d.ts","sourceRoot":"","sources":["../../src/context/ResultsHandler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,2CAA2C,CAAA;AACrF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2CAA2C,CAAA;AAC1E,OAAO,EAAE,WAAW,EAAE,MAAM,iDAAiD,CAAA;AAC7E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iDAAiD,CAAA;AACzF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAGnD,MAAM,WAAW,qBAAsB,SAAQ,kBAAkB;IAC/D,OAAO,EAAE,WAAW,CAAA;CACrB;AAED,qBAAa,cAAe,SAAQ,WAAW;;IAC7C,OAAO,EAAE,WAAW,CAAA;gBAMR,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,qBAAqB;IAMvD,KAAK;IAML,MAAM,CAAC,SAAS,EAAE,SAAS;IASpC,GAAG,CAAC,SAAS,EAAE,MAAM;IAWrB,KAAK;IAMI,OAAO;CAKjB"}

package/script/context/ResultsHandler.js

@@ -0,0 +1,56 @@
+"use strict";
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _ResultsHandler_instances, _ResultsHandler_unloadCallback, _ResultsHandler_resetBuffer;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResultsHandler = void 0;
+const levels_js_1 = require("../deps/jsr.io/@std/log/0.224.8/levels.js");
+const base_handler_js_1 = require("../deps/jsr.io/@std/log/0.224.8/base_handler.js");
+const ts_pattern_1 = require("ts-pattern");
+class ResultsHandler extends base_handler_js_1.BaseHandler {
+    constructor(levelName, options) {
+        super(levelName, options);
+        _ResultsHandler_instances.add(this);
+        Object.defineProperty(this, "context", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        _ResultsHandler_unloadCallback.set(this, (() => {
+            this.destroy();
+        }).bind(this));
+        this.context = options.context;
+    }
+    setup() {
+        __classPrivateFieldGet(this, _ResultsHandler_instances, "m", _ResultsHandler_resetBuffer).call(this);
+        addEventListener('unload', __classPrivateFieldGet(this, _ResultsHandler_unloadCallback, "f"));
+    }
+    handle(logRecord) {
+        super.handle(logRecord);
+        // Immediately flush if log level is higher than ERROR
+        if (logRecord.level > levels_js_1.LogLevels.ERROR) {
+            this.flush();
+        }
+    }
+    log(levelName) {
+        this.context.captureCurrentResult((0, ts_pattern_1.match)(levelName)
+            .with('WARN', () => 'warning')
+            .with('ERROR', () => 'error')
+            .otherwise(() => {
+            throw new Error(`Unexpected log level name: ${levelName}`);
+        }));
+    }
+    flush() {
+        __classPrivateFieldGet(this, _ResultsHandler_instances, "m", _ResultsHandler_resetBuffer).call(this);
+    }
+    destroy() {
+        this.flush();
+        removeEventListener('unload', __classPrivateFieldGet(this, _ResultsHandler_unloadCallback, "f"));
+    }
+}
+exports.ResultsHandler = ResultsHandler;
+_ResultsHandler_unloadCallback = new WeakMap(), _ResultsHandler_instances = new WeakSet(), _ResultsHandler_resetBuffer = function _ResultsHandler_resetBuffer() { };

package/script/context/StackTrail.d.ts

@@ -0,0 +1,14 @@
+export declare class StackTrail {
+    #private;
+    constructor(stack?: (string | number)[]);
+    clone(): StackTrail;
+    slice(start: number, end?: number): StackTrail;
+    get stackTrail(): (string | number)[];
+    append(frame: string | string[]): StackTrail;
+    getParentOf(frame: string): string | undefined;
+    remove(frame: string | string[]): StackTrail;
+    static join(...stacks: (StackTrail | string)[]): string;
+    static parse(value: string): StackTrail;
+    toString(): string;
+}
+//# sourceMappingURL=StackTrail.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StackTrail.d.ts","sourceRoot":"","sources":["../../src/context/StackTrail.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAU;;gBAGT,KAAK,GAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAO;IAI3C,KAAK;IAIL,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM;IAIjC,IAAI,UAAU,wBAEb;IAED,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,UAAU;IAgB5C,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAW9C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,UAAU;IAsB5C,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC,UAAU,GAAG,MAAM,CAAC,EAAE,GAAG,MAAM;IAIvD,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;IAYvC,QAAQ;CAOT"}

package/script/context/StackTrail.js

@@ -0,0 +1,85 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _StackTrail_stack;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StackTrail = void 0;
+class StackTrail {
+    constructor(stack = []) {
+        _StackTrail_stack.set(this, void 0);
+        __classPrivateFieldSet(this, _StackTrail_stack, stack, "f");
+    }
+    clone() {
+        return new StackTrail([...__classPrivateFieldGet(this, _StackTrail_stack, "f")]);
+    }
+    slice(start, end) {
+        return new StackTrail(__classPrivateFieldGet(this, _StackTrail_stack, "f").slice(start, end));
+    }
+    get stackTrail() {
+        return __classPrivateFieldGet(this, _StackTrail_stack, "f");
+    }
+    append(frame) {
+        if (typeof frame === 'string') {
+            __classPrivateFieldGet(this, _StackTrail_stack, "f").push(frame);
+            return this;
+        }
+        if (Array.isArray(frame)) {
+            frame.forEach(p => this.append(p));
+            return this;
+        }
+        throw new Error(`Unexpected stack frame: ${frame}`);
+    }
+    getParentOf(frame) {
+        const lastItemIndex = this.stackTrail.length - 1;
+        if (this.stackTrail?.[lastItemIndex] === frame &&
+            this.stackTrail?.[lastItemIndex - 1] === 'properties') {
+            const parentName = this.stackTrail?.[lastItemIndex - 2];
+            return typeof parentName === 'string' ? parentName : undefined;
+        }
+    }
+    remove(frame) {
+        if (typeof frame === 'string') {
+            const lastItem = __classPrivateFieldGet(this, _StackTrail_stack, "f")[__classPrivateFieldGet(this, _StackTrail_stack, "f").length - 1];
+            if (lastItem !== frame) {
+                throw new Error(`Expected to remove frame '${frame}' but found '${lastItem}'`);
+            }
+            __classPrivateFieldGet(this, _StackTrail_stack, "f").pop();
+            return this;
+        }
+        if (Array.isArray(frame)) {
+            frame.toReversed().forEach(p => this.remove(p));
+            return this;
+        }
+        throw new Error(`Unexpected stack frame: ${frame}`);
+    }
+    static join(...stacks) {
+        return stacks.map(stack => stack.toString()).join(':');
+    }
+    static parse(value) {
+        const stack = value.split(':').map(item => {
+            if (!item) {
+                throw new Error(`Empty stack trail token in: ${value}`);
+            }
+            return item.replaceAll('%3A', ':');
+        });
+        return new StackTrail(stack);
+    }
+    toString() {
+        return __classPrivateFieldGet(this, _StackTrail_stack, "f")
+            .map(item => {
+            return typeof item === 'string' ? item.replaceAll(':', '%3A') : item;
+        })
+            .join(':');
+    }
+}
+exports.StackTrail = StackTrail;
+_StackTrail_stack = new WeakMap();

package/script/context/types.d.ts

@@ -0,0 +1,23 @@
+import type { GeneratorKey } from '../types/GeneratorKeys.js';
+import type { ManifestEntry } from '../types/Manifest.js';
+import type { ResultType } from '../types/Results.js';
+export type PhaseType = 'parse' | 'generate' | 'render';
+export type GetFileOptions = {
+    throwIfNotFound?: boolean;
+};
+export type AddGeneratorKeyArgs = {
+    generatorKey: GeneratorKey;
+};
+export type FilesRenderResult = {
+    artifacts: Record<string, string>;
+    files: Record<string, ManifestEntry>;
+    pinnable: Partial<Record<GeneratorKey, string>>;
+};
+export type RenderResult = {
+    artifacts: Record<string, string>;
+    files: Record<string, ManifestEntry>;
+    previews: Record<string, Record<string, string>>;
+    pinnable: Partial<Record<GeneratorKey, string>>;
+    results: Record<string, ResultType>;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/context/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAA;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAErD,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAA;AAEvD,MAAM,MAAM,cAAc,GAAG;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,YAAY,EAAE,YAAY,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IACpC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAA;CAChD,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IACpC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAChD,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAA;IAC/C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;CACpC,CAAA"}

package/script/context/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });