rtistree 0.5.0

package/dist/program.d.ts

@@ -0,0 +1,85 @@
+import { z } from 'zod';
+import type { Project } from './project.js';
+export declare const PROGRAM_VERSION = "rtistree-studio/1";
+export declare const programSchema: z.ZodObject<{
+    source: z.ZodOptional<z.ZodString>;
+    code: z.ZodOptional<z.ZodString>;
+    asset_id: z.ZodString;
+    target: z.ZodOptional<z.ZodString>;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    seed: z.ZodDefault<z.ZodNumber>;
+    parameters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodJSONSchema>>;
+    inputs: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+    timeout_ms: z.ZodDefault<z.ZodNumber>;
+    expected_hash: z.ZodOptional<z.ZodString>;
+    reason: z.ZodString;
+}, z.core.$strict>;
+export type RasterProgram = z.infer<typeof programSchema>;
+export interface ProgramRecipe {
+    version: typeof PROGRAM_VERSION;
+    source: string;
+    source_hash: string;
+    parameters: Record<string, unknown>;
+    width: number;
+    height: number;
+    seed: number;
+    timeout_ms: number;
+    inputs: Record<string, {
+        source: string;
+        hash: string;
+    }>;
+    output_hash: string;
+    runtime: {
+        node: string;
+        skia: string;
+        techniques?: string;
+    };
+}
+export declare function executeRasterProgram(source: string, options: Pick<RasterProgram, 'width' | 'height' | 'seed' | 'parameters' | 'timeout_ms'>, inputs?: Record<string, Buffer>): Promise<Buffer>;
+/** Explicit execution only. Rendering/importing a scene never evaluates its recipes. */
+export declare function runProgram(project: Project, raw: unknown): Promise<{
+    asset_id: string;
+    asset: {
+        source: string;
+        hash: string;
+        recipe: {
+            source: string;
+            hash: string;
+        };
+    };
+    recipe_hash: string;
+    output_hash: string;
+    sequence: number;
+    scene_hash: string;
+}>;
+/** Bake immutable artifacts without changing a scene, for atomic multi-node builds. */
+export declare function bakeProgram(root: string, spec: RasterProgram, assets: import('./schema.js').Scene['assets']): Promise<{
+    asset: {
+        source: string;
+        hash: string;
+        recipe: {
+            source: string;
+            hash: string;
+        };
+    };
+    recipe_hash: string;
+    output_hash: string;
+}>;
+export declare function replayRecipe(root: string, reference: {
+    source: string;
+    hash: string;
+}): Promise<{
+    identical: boolean;
+    expected_hash: string;
+    output_hash: string;
+    png: Buffer<ArrayBufferLike>;
+}>;
+/** Copy a frozen recipe and its local input snapshots without executing code. */
+export declare function copyRecipe(root: string, reference: {
+    source: string;
+    hash: string;
+}, destination: string): Promise<{
+    source: string;
+    hash: string;
+}>;

package/dist/program.js

@@ -0,0 +1,246 @@
+import { TECHNIQUE_VERSION } from './techniques.js';
+import { Worker } from 'node:worker_threads';
+import { readFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { z } from 'zod';
+import sharp from 'sharp';
+import { canonical, localAssetPath, sha256 } from './assets.js';
+import { writeArtifact } from './artifacts.js';
+import { sceneHash } from './assets.js';
+import { flattenLayers } from './schema.js';
+export const PROGRAM_VERSION = 'rtistree-studio/1';
+const name = z.string().regex(/^[a-zA-Z][a-zA-Z0-9_-]{0,79}$/);
+export const programSchema = z
+    .strictObject({
+    source: z.string().min(1).optional(),
+    code: z
+        .string()
+        .min(1)
+        .max(256 * 1024)
+        .optional(),
+    asset_id: name,
+    target: name.optional(),
+    width: z.number().int().min(1).max(8192),
+    height: z.number().int().min(1).max(8192),
+    seed: z.number().int().min(0).max(0xffffffff).default(0),
+    parameters: z.record(z.string(), z.json()).default({}),
+    inputs: z.record(name, name).default({}),
+    timeout_ms: z.number().int().min(50).max(30000).default(10000),
+    expected_hash: z.string().optional(),
+    reason: z.string().min(1).max(4000),
+})
+    .superRefine((value, ctx) => {
+    if (Boolean(value.source) === Boolean(value.code))
+        ctx.addIssue({
+            code: 'custom',
+            message: 'Specify exactly one of source (project-local file) or code (inline JavaScript)',
+        });
+});
+export async function executeRasterProgram(source, options, inputs = {}) {
+    options = programSchema.parse({
+        width: options.width,
+        height: options.height,
+        seed: options.seed,
+        parameters: options.parameters,
+        timeout_ms: options.timeout_ms,
+        source: 'inline',
+        asset_id: 'output',
+        reason: 'Execute',
+    });
+    if (Buffer.byteLength(source) > 256 * 1024 ||
+        Buffer.byteLength(canonical(options.parameters)) > 64 * 1024)
+        throw new Error('Program source/parameters exceed 256 KiB / 64 KiB');
+    if (options.width * options.height > 16 * 1024 * 1024)
+        throw new Error('Program output exceeds 16 megapixels');
+    let pixels = options.width * options.height;
+    if (Object.keys(inputs).length > 16)
+        throw new Error('A program accepts at most 16 input images');
+    for (const input of Object.values(inputs)) {
+        const m = await sharp(input, { limitInputPixels: 32 * 1024 * 1024 }).metadata();
+        pixels += m.width * m.height;
+    }
+    if (pixels > 32 * 1024 * 1024)
+        throw new Error('Program inputs/output exceed 32 megapixels');
+    const ts = import.meta.url.endsWith('.ts'), url = new URL(ts ? './program-worker.ts' : './program-worker.js', import.meta.url).href;
+    const bootstrap = ts
+        ? `import('tsx/esm/api').then(({tsImport}) => tsImport(${JSON.stringify(url)}, ${JSON.stringify(import.meta.url)}))`
+        : `import(${JSON.stringify(url)})`;
+    const png = await new Promise((resolve, reject) => {
+        const worker = new Worker(bootstrap, {
+            eval: true,
+            workerData: { ...options, source, inputs },
+            resourceLimits: { maxOldGenerationSizeMb: 256 },
+        });
+        const timer = setTimeout(() => {
+            void worker.terminate();
+            reject(new Error('Raster program exceeded its wall-clock limit'));
+        }, options.timeout_ms + 2000);
+        const finish = () => {
+            clearTimeout(timer);
+            void worker.terminate();
+        };
+        worker.once('message', (message) => {
+            finish();
+            if (message.error)
+                reject(new Error(message.error));
+            else
+                resolve(Buffer.from(message.png));
+        });
+        worker.once('error', (error) => {
+            finish();
+            reject(error);
+        });
+        worker.once('exit', (code) => {
+            clearTimeout(timer);
+            reject(new Error(`Raster worker exited before producing an image (${code})`));
+        });
+    });
+    const metadata = await sharp(png, { limitInputPixels: 16 * 1024 * 1024 }).metadata();
+    if (metadata.format !== 'png' ||
+        metadata.width !== options.width ||
+        metadata.height !== options.height)
+        throw new Error('Program output must encode a PNG with the declared dimensions');
+    return png;
+}
+/** Explicit execution only. Rendering/importing a scene never evaluates its recipes. */
+export async function runProgram(project, raw) {
+    const spec = programSchema.parse(raw), scene = await project.scene(), before = sceneHash(scene);
+    if (spec.expected_hash && before !== spec.expected_hash)
+        throw new Error('Stale scene hash');
+    const { asset, recipe_hash: hash, output_hash, } = await bakeProgram(project.root, spec, scene.assets);
+    const commands = [{ type: 'registerAsset', id: spec.asset_id, asset }];
+    if (spec.target) {
+        const target = flattenLayers(scene.layers).find((l) => l.id === spec.target);
+        commands.push(target
+            ? { type: 'setSource', target: spec.target, source: spec.asset_id }
+            : {
+                type: 'addLayer',
+                layer: {
+                    id: spec.target,
+                    type: 'raster',
+                    source: spec.asset_id,
+                    bounds: [0, 0, spec.width, spec.height],
+                },
+            });
+    }
+    const entry = await project.apply({ commands, reason: spec.reason, expected_hash: before });
+    return {
+        asset_id: spec.asset_id,
+        asset,
+        recipe_hash: hash,
+        output_hash,
+        sequence: entry.sequence,
+        scene_hash: entry.after_hash,
+    };
+}
+/** Bake immutable artifacts without changing a scene, for atomic multi-node builds. */
+export async function bakeProgram(root, spec, assets) {
+    const source = spec.code ?? (await readFile(await localAssetPath(root, spec.source), 'utf8'));
+    const inputs = Object.create(null);
+    let inputPixels = spec.width * spec.height;
+    if (inputPixels > 16 * 1024 * 1024)
+        throw new Error('Program output exceeds 16 megapixels');
+    if (Buffer.byteLength(source) > 256 * 1024 ||
+        Buffer.byteLength(canonical(spec.parameters)) > 64 * 1024)
+        throw new Error('Program source/parameters exceed 256 KiB / 64 KiB');
+    if (Object.keys(spec.inputs).length > 16)
+        throw new Error('A program accepts at most 16 input images');
+    for (const [key, id] of Object.entries(spec.inputs)) {
+        const asset = assets[id];
+        if (!asset)
+            throw new Error(`Unknown program input asset ${id}`);
+        const bytes = await readFile(await localAssetPath(root, asset.source));
+        if (bytes.length > 64 * 1024 * 1024)
+            throw new Error('Program input exceeds 64 MiB');
+        if (asset.hash && sha256(bytes) !== asset.hash)
+            throw new Error('Program input hash mismatch');
+        const metadata = await sharp(bytes, { limitInputPixels: 32 * 1024 * 1024 }).metadata();
+        inputPixels += metadata.width * metadata.height;
+        if (inputPixels > 32 * 1024 * 1024)
+            throw new Error('Program inputs/output exceed 32 megapixels');
+        inputs[key] = await sharp(bytes, { limitInputPixels: 32 * 1024 * 1024 })
+            .toColourspace('srgb')
+            .png()
+            .toBuffer();
+    }
+    const png = await executeRasterProgram(source, spec, inputs);
+    const recipe = {
+        version: PROGRAM_VERSION,
+        source,
+        source_hash: sha256(source),
+        parameters: spec.parameters,
+        width: spec.width,
+        height: spec.height,
+        seed: spec.seed,
+        timeout_ms: spec.timeout_ms,
+        inputs: Object.fromEntries(Object.entries(inputs).map(([key, bytes]) => [
+            key,
+            { source: `inputs/${sha256(bytes).slice(7)}.png`, hash: sha256(bytes) },
+        ])),
+        output_hash: sha256(png),
+        runtime: { node: process.version, skia: '1.0.8', techniques: TECHNIQUE_VERSION },
+    };
+    const manifest = canonical(recipe), hash = sha256(manifest), directory = join('recipes', hash.slice(7));
+    for (const [key, bytes] of Object.entries(inputs))
+        await writeArtifact(join(root, directory, recipe.inputs[key].source), bytes);
+    await writeArtifact(join(root, directory, 'recipe.json'), manifest);
+    const sourcePath = join(directory, 'output.png');
+    await writeArtifact(join(root, sourcePath), png);
+    const asset = {
+        source: sourcePath,
+        hash: sha256(png),
+        recipe: { source: join(directory, 'recipe.json'), hash },
+    };
+    return { asset, recipe_hash: hash, output_hash: recipe.output_hash };
+}
+export async function replayRecipe(root, reference) {
+    const file = await localAssetPath(root, reference.source), raw = await readFile(file, 'utf8');
+    if (sha256(raw) !== reference.hash)
+        throw new Error('Recipe hash mismatch');
+    const recipe = JSON.parse(raw);
+    if (recipe.version !== PROGRAM_VERSION || sha256(recipe.source) !== recipe.source_hash)
+        throw new Error('Unsupported or changed program recipe');
+    if (recipe.runtime.techniques && recipe.runtime.techniques !== TECHNIQUE_VERSION)
+        throw new Error('Recipe requires a different technique version');
+    const spec = programSchema.parse({
+        width: recipe.width,
+        height: recipe.height,
+        seed: recipe.seed,
+        parameters: recipe.parameters,
+        timeout_ms: recipe.timeout_ms,
+        source: 'recipe',
+        asset_id: 'replay',
+        reason: 'Replay',
+    });
+    const inputs = Object.create(null);
+    for (const [name, input] of Object.entries(recipe.inputs)) {
+        const bytes = await readFile(await localAssetPath(dirname(file), input.source));
+        if (sha256(bytes) !== input.hash)
+            throw new Error('Recipe input hash mismatch');
+        inputs[name] = bytes;
+    }
+    const png = await executeRasterProgram(recipe.source, spec, inputs);
+    return {
+        identical: sha256(png) === recipe.output_hash,
+        expected_hash: recipe.output_hash,
+        output_hash: sha256(png),
+        png,
+    };
+}
+/** Copy a frozen recipe and its local input snapshots without executing code. */
+export async function copyRecipe(root, reference, destination) {
+    const path = await localAssetPath(root, reference.source), bytes = await readFile(path);
+    if (sha256(bytes) !== reference.hash)
+        throw new Error('Recipe hash mismatch');
+    const recipe = JSON.parse(bytes.toString());
+    const directory = join('recipes', reference.hash.slice(7));
+    for (const input of Object.values(recipe.inputs)) {
+        const contents = await readFile(await localAssetPath(dirname(path), input.source));
+        if (sha256(contents) !== input.hash)
+            throw new Error('Recipe input hash mismatch');
+        await writeArtifact(join(destination, directory, input.source), contents);
+    }
+    await writeArtifact(join(destination, directory, 'recipe.json'), bytes);
+    return { source: join(directory, 'recipe.json'), hash: reference.hash };
+}
+//# sourceMappingURL=program.js.map

package/dist/program.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.js","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"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"}

package/dist/project-config.d.ts

@@ -0,0 +1,91 @@
+import { z } from 'zod';
+export declare const projectConfigSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    scene: z.ZodDefault<z.ZodString>;
+    output_dir: z.ZodDefault<z.ZodString>;
+    presets: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        format: z.ZodDefault<z.ZodEnum<{
+            jpeg: "jpeg";
+            pdf: "pdf";
+            png: "png";
+            svg: "svg";
+            tiff: "tiff";
+        }>>;
+        colour_space: z.ZodDefault<z.ZodEnum<{
+            cmyk: "cmyk";
+            srgb: "srgb";
+        }>>;
+        profile: z.ZodOptional<z.ZodString>;
+        profile_hash: z.ZodOptional<z.ZodString>;
+        intent: z.ZodDefault<z.ZodLiteral<"perceptual">>;
+        quality: z.ZodDefault<z.ZodNumber>;
+        chroma_subsampling: z.ZodDefault<z.ZodEnum<{
+            "4:2:0": "4:2:0";
+            "4:4:4": "4:4:4";
+        }>>;
+        background: z.ZodDefault<z.ZodString>;
+        crop_marks: z.ZodDefault<z.ZodBoolean>;
+        minimum_ppi: z.ZodDefault<z.ZodNumber>;
+        max_ink: z.ZodDefault<z.ZodNumber>;
+        black: z.ZodDefault<z.ZodEnum<{
+            "k-only": "k-only";
+            profile: "profile";
+        }>>;
+        mode: z.ZodDefault<z.ZodEnum<{
+            hybrid: "hybrid";
+            raster: "raster";
+        }>>;
+        ppi: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type ProjectConfig = z.infer<typeof projectConfigSchema>;
+export declare function projectPath(root: string, value: string): string;
+export declare function resolveProject(input: string): Promise<{
+    file: string;
+    config?: undefined;
+    configFile?: undefined;
+} | {
+    file: string;
+    config: {
+        version: 1;
+        scene: string;
+        output_dir: string;
+        presets: Record<string, {
+            format: "jpeg" | "pdf" | "png" | "svg" | "tiff";
+            colour_space: "cmyk" | "srgb";
+            profile?: string | undefined;
+            profile_hash?: string | undefined;
+            intent: "perceptual";
+            quality: number;
+            chroma_subsampling: "4:2:0" | "4:4:4";
+            background: string;
+            crop_marks: boolean;
+            minimum_ppi: number;
+            max_ink: number;
+            black: "k-only" | "profile";
+            mode: "hybrid" | "raster";
+            ppi?: number | undefined;
+        }>;
+    };
+    configFile: string;
+}>;
+export declare function createProject(directory: string, options?: {
+    size?: string;
+    orientation?: string;
+    ppi?: number;
+    bleed?: string;
+    outputDir?: string;
+}): Promise<{
+    project: string;
+    manifest: string;
+    scene: string;
+    output: string;
+    document: {
+        width: number;
+        height: number;
+        unit: "in" | "mm" | "pt";
+        ppi: number;
+        bleed: number;
+        safe_margin: number;
+    };
+}>;

package/dist/project-config.js

@@ -0,0 +1,187 @@
+import { z } from 'zod';
+import { mkdir, readFile, realpath, stat, writeFile } from 'node:fs/promises';
+import { dirname, isAbsolute, relative, resolve, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parse, stringify } from 'yaml';
+import { exportPresetSchema, documentSchema, documentGeometry, lengthMm, } from './document.js';
+import { localAssetPath } from './assets.js';
+export const projectConfigSchema = z.strictObject({
+    version: z.literal(1),
+    scene: z.string().default('scene.yaml'),
+    output_dir: z.string().default('output'),
+    presets: z.record(z.string(), exportPresetSchema).default({}),
+});
+export function projectPath(root, value) {
+    const path = resolve(root, value), rel = relative(root, path);
+    if (isAbsolute(value) || rel === '..' || rel.startsWith(`..${sep}`))
+        throw new Error('Project paths must stay inside the project directory');
+    return path;
+}
+export async function resolveProject(input) {
+    let path = await realpath(resolve(input));
+    if ((await stat(path)).isDirectory())
+        path = resolve(path, 'rtistree.yaml');
+    if (!path.endsWith('/rtistree.yaml')) {
+        try {
+            const manifest = resolve(dirname(path), 'rtistree.yaml'), config = projectConfigSchema.parse(parse(await readFile(manifest, 'utf8')));
+            if ((await localAssetPath(dirname(path), config.scene)) === path)
+                return resolveProject(manifest);
+        }
+        catch (e) {
+            if (e.code !== 'ENOENT')
+                throw e;
+        }
+        return { file: path };
+    }
+    const config = projectConfigSchema.parse(parse(await readFile(path, 'utf8'))), root = dirname(path);
+    let output = projectPath(root, config.output_dir);
+    while (true) {
+        try {
+            const actual = await realpath(output);
+            projectPath(root, relative(root, actual));
+            break;
+        }
+        catch (e) {
+            if (e.code !== 'ENOENT')
+                throw e;
+            const parent = dirname(output);
+            if (parent === output)
+                throw e;
+            output = parent;
+        }
+    }
+    const file = await localAssetPath(root, config.scene);
+    if (dirname(file) !== root)
+        throw new Error('The scene entry point must be in the project root');
+    return { file, config, configFile: path };
+}
+export async function createProject(directory, options = {}) {
+    const sizes = {
+        A3: [297, 420],
+        A4: [210, 297],
+        A5: [148, 210],
+        Letter: [215.9, 279.4],
+    };
+    let size = sizes[options.size ?? 'A4'];
+    if (!size) {
+        const pair = (options.size ?? '').split('x');
+        if (pair.length !== 2)
+            throw new Error('Use A3, A4, A5, Letter, or WIDTHxHEIGHT in mm');
+        size = pair.map(lengthMm);
+    }
+    if (options.orientation && !['portrait', 'landscape'].includes(options.orientation))
+        throw new Error('Unknown orientation');
+    if (options.orientation === 'portrait')
+        size = [Math.min(...size), Math.max(...size)];
+    if (options.orientation === 'landscape')
+        size = [Math.max(...size), Math.min(...size)];
+    const document = documentSchema.parse({
+        width: size[0],
+        height: size[1],
+        ppi: options.ppi ?? 300,
+        bleed: lengthMm(options.bleed ?? '3mm'),
+        safe_margin: 5,
+    });
+    documentGeometry(document);
+    const root = resolve(directory), output = options.outputDir ?? 'output';
+    const outputRelative = relative(root, projectPath(root, output));
+    if (!outputRelative ||
+        [
+            'assets',
+            'layers',
+            'fonts',
+            'profiles',
+            'history',
+            'schemas',
+            'programs',
+            'recipes',
+            'raster',
+            'studio',
+        ].includes(outputRelative.split(sep)[0]))
+        throw new Error('Choose a dedicated output directory');
+    // Exclusive mkdir fails before any write if the destination already exists.
+    await mkdir(dirname(root), { recursive: true });
+    await mkdir(root);
+    for (const dir of [
+        'assets',
+        'fonts',
+        'profiles',
+        'layers',
+        'history',
+        'schemas',
+        'programs',
+        'recipes',
+        'studio',
+        output,
+    ])
+        await mkdir(projectPath(root, dir), { recursive: true });
+    const config = projectConfigSchema.parse({
+        version: 1,
+        scene: 'scene.yaml',
+        output_dir: output,
+        presets: {
+            screen: { format: 'png', ppi: 96 },
+            print: { format: 'pdf', colour_space: 'cmyk', minimum_ppi: 150 },
+        },
+    });
+    const canvas = {
+        width: Math.round(document.width * 4),
+        height: Math.round(document.height * 4),
+        background: '#f3efe6',
+    };
+    const files = {
+        'rtistree.yaml': '# yaml-language-server: $schema=./schemas/project.schema.json\n' + stringify(config),
+        'scene.yaml': '# yaml-language-server: $schema=./schemas/authoring.schema.json\n' +
+            stringify({
+                version: 1,
+                canvas,
+                document,
+                include: ['layers/background.yaml', 'layers/content.yaml'],
+            }),
+        'layers/background.yaml': stringify({
+            layers: [
+                { id: 'background', type: 'procedural', generator: { type: 'solid', colour: '#f3efe6' } },
+            ],
+        }),
+        'layers/content.yaml': stringify({
+            layers: [
+                {
+                    id: 'title',
+                    type: 'text',
+                    bounds: [
+                        canvas.width * 0.1,
+                        canvas.height * 0.15,
+                        canvas.width * 0.8,
+                        canvas.height * 0.5,
+                    ],
+                    content: 'A new canvas.',
+                    style: { font: 'display', size: Math.min(64, canvas.width / 10), colour: '#243d38' },
+                },
+            ],
+        }),
+        '.gitignore': `${output}/\nhistory/*.lock\n`,
+        'README.md': '# Your Rtistree project\n\nEdit scene.yaml and layers/. Assets, fonts and ICC profiles stay local. Read graphics studio-help for the foundation-first art-direction protocol. Author 2D painting code in programs/; use graphics pipeline . pipeline.json and graphics production . request.json for staged art. Cache and candidate records live in studio/.\n\nRun graphics render . --preset screen, graphics export . --format pdf --preset screen, or graphics preflight . --preset print.\n\nBefore CMYK print export, copy your printer/paper ICC profile to profiles/ and set presets.print.profile plus profile_hash in rtistree.yaml. Print preflight rejects a missing profile. Existing scene-file commands remain available.\n',
+    };
+    for (const name of [
+        'project',
+        'authoring',
+        'fragment',
+        'program',
+        'pipeline',
+        'construction',
+        'production',
+        'raster-read',
+        'raster-write',
+    ])
+        files[`schemas/${name}.schema.json`] = await readFile(resolve(dirname(fileURLToPath(import.meta.url)), '..', 'schemas', `${name}.schema.json`), 'utf8');
+    for (const [name, content] of Object.entries(files))
+        await writeFile(resolve(root, name), content, { flag: 'wx' });
+    return {
+        project: root,
+        manifest: resolve(root, 'rtistree.yaml'),
+        scene: resolve(root, 'scene.yaml'),
+        output: resolve(root, output),
+        document,
+    };
+}
+//# sourceMappingURL=project-config.js.map

package/dist/project-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-config.js","sourceRoot":"","sources":["../src/project-config.ts"],"names":[],"mappings":"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"}