@byline/cli 3.21.0 → 4.1.0

package/dist/lib/planned-writes.d.ts

@@ -0,0 +1,8 @@
+import type { FileWrite } from '../types.js';
+export interface ApplyWritesResult {
+    written: string[];
+    conflicts: string[];
+}
+/** Apply exactly the writes shown in a plan, unless a target changed after planning. */
+export declare function applyPlannedWrites(writes: readonly FileWrite[]): ApplyWritesResult;
+//# sourceMappingURL=planned-writes.d.ts.map

package/dist/lib/planned-writes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planned-writes.d.ts","sourceRoot":"","sources":["../../src/lib/planned-writes.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAE5C,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,wFAAwF;AACxF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,GAAG,iBAAiB,CAoGlF"}

package/dist/lib/planned-writes.js

@@ -0,0 +1,177 @@
+import { existsSync, lstatSync, mkdirSync, mkdtempSync, readFileSync, rmdirSync, rmSync, writeFileSync, } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, isAbsolute, join, relative, resolve, sep } from 'node:path';
+/** Apply exactly the writes shown in a plan, unless a target changed after planning. */
+export function applyPlannedWrites(writes) {
+    const conflicts = [];
+    const normalizedPaths = writes.map((write) => resolve(write.path));
+    for (let index = 0; index < normalizedPaths.length; index++) {
+        const path = normalizedPaths[index];
+        if (!path)
+            continue;
+        for (let otherIndex = index + 1; otherIndex < normalizedPaths.length; otherIndex++) {
+            const other = normalizedPaths[otherIndex];
+            if (!other)
+                continue;
+            if (path === other || isDescendant(path, other) || isDescendant(other, path)) {
+                conflicts.push(path, other);
+            }
+        }
+    }
+    for (const write of writes) {
+        const invalidParent = firstInvalidParent(write.path);
+        if (invalidParent) {
+            conflicts.push(invalidParent);
+            continue;
+        }
+        const target = lstatIfPresent(write.path);
+        const exists = target !== undefined;
+        if (target && !target.isFile()) {
+            conflicts.push(write.path);
+            continue;
+        }
+        const current = exists ? readFileSync(write.path, 'utf8') : undefined;
+        if (write.mode === 'delete' && !exists) {
+            conflicts.push(write.path);
+            continue;
+        }
+        if (write.mode === 'create' && exists) {
+            conflicts.push(write.path);
+            continue;
+        }
+        if (write.before !== undefined && current !== write.before) {
+            conflicts.push(write.path);
+        }
+    }
+    // Never partially apply a stale plan: validate every snapshot first.
+    if (conflicts.length > 0)
+        return { written: [], conflicts: [...new Set(conflicts)] };
+    const stageRoot = mkdtempSync(join(tmpdir(), 'byline-planned-writes-'));
+    const staged = new Map();
+    try {
+        for (const [index, write] of writes.entries()) {
+            if (write.mode === 'delete')
+                continue;
+            const path = join(stageRoot, String(index));
+            writeFileSync(path, write.contents, 'utf8');
+            staged.set(write, path);
+        }
+    }
+    catch {
+        rmSync(stageRoot, { recursive: true, force: true });
+        return { written: [], conflicts: writes.map((write) => write.path) };
+    }
+    const written = [];
+    const applied = [];
+    const createdDirectories = new Set();
+    let failedPath;
+    try {
+        for (const write of writes) {
+            failedPath = write.path;
+            const invalidParent = firstInvalidParent(write.path);
+            if (invalidParent)
+                throw new Error(`invalid parent ${invalidParent}`);
+            const target = lstatIfPresent(write.path);
+            if (target && !target.isFile())
+                throw new Error(`non-file target ${write.path}`);
+            if (write.mode === 'create' && target)
+                throw new Error(`existing target ${write.path}`);
+            if (write.mode === 'delete' && !target)
+                throw new Error(`missing target ${write.path}`);
+            const before = target ? readFileSync(write.path, 'utf8') : undefined;
+            if (write.before !== undefined && before !== write.before) {
+                throw new Error(`stale target ${write.path}`);
+            }
+            applied.push({ path: write.path, before });
+            if (write.mode === 'delete') {
+                rmSync(write.path);
+                written.push(write.path);
+                continue;
+            }
+            createParentDirectories(write.path, createdDirectories);
+            const stagePath = staged.get(write);
+            if (!stagePath)
+                throw new Error(`missing staged contents for ${write.path}`);
+            const contents = readFileSync(stagePath, 'utf8');
+            if (write.mode === 'create')
+                writeFileSync(write.path, contents, { encoding: 'utf8', flag: 'wx' });
+            else
+                writeFileSync(write.path, contents, 'utf8');
+            written.push(write.path);
+        }
+    }
+    catch {
+        rollbackAppliedWrites(applied);
+        removeCreatedDirectories(createdDirectories);
+        return { written: [], conflicts: failedPath ? [failedPath] : writes.map((write) => write.path) };
+    }
+    finally {
+        rmSync(stageRoot, { recursive: true, force: true });
+    }
+    return { written, conflicts };
+}
+function lstatIfPresent(path) {
+    try {
+        return lstatSync(path);
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === 'ENOENT' || code === 'ENOTDIR')
+            return undefined;
+        throw error;
+    }
+}
+function isDescendant(parent, candidate) {
+    const rel = relative(parent, candidate);
+    return rel !== '' && rel !== '..' && !rel.startsWith(`..${sep}`) && !isAbsolute(rel);
+}
+function firstInvalidParent(path) {
+    let parent = dirname(resolve(path));
+    while (true) {
+        const target = lstatIfPresent(parent);
+        if (target)
+            return target.isDirectory() ? undefined : parent;
+        const next = dirname(parent);
+        if (next === parent)
+            return parent;
+        parent = next;
+    }
+}
+function createParentDirectories(path, created) {
+    const missing = [];
+    let parent = dirname(resolve(path));
+    while (!existsSync(parent)) {
+        missing.push(parent);
+        parent = dirname(parent);
+    }
+    for (const directory of missing.reverse()) {
+        mkdirSync(directory);
+        created.add(directory);
+    }
+}
+function rollbackAppliedWrites(applied) {
+    for (const entry of [...applied].reverse()) {
+        try {
+            if (entry.before === undefined)
+                rmSync(entry.path, { force: true });
+            else {
+                mkdirSync(dirname(entry.path), { recursive: true });
+                writeFileSync(entry.path, entry.before, 'utf8');
+            }
+        }
+        catch {
+            // Continue restoring independent paths after a rollback failure.
+        }
+    }
+}
+function removeCreatedDirectories(directories) {
+    for (const directory of [...directories].sort((left, right) => right.length - left.length)) {
+        try {
+            rmdirSync(directory);
+        }
+        catch {
+            // Keep non-empty directories, including any that another process used.
+        }
+    }
+}
+//# sourceMappingURL=planned-writes.js.map

package/dist/lib/planned-writes.js.map

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

package/dist/lib/planned-writes.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=planned-writes.test.d.ts.map

package/dist/lib/planned-writes.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planned-writes.test.d.ts","sourceRoot":"","sources":["../../src/lib/planned-writes.test.ts"],"names":[],"mappings":""}

package/dist/lib/planned-writes.test.js

@@ -0,0 +1,113 @@
+import { existsSync, lstatSync, mkdirSync, readFileSync, rmSync, symlinkSync, writeFileSync, } from 'node:fs';
+import { join } from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+import { createTestContext } from '../test-helpers.js';
+import { applyPlannedWrites } from './planned-writes.js';
+const contexts = [];
+afterEach(() => {
+    for (const ctx of contexts.splice(0))
+        rmSync(ctx.cwd, { recursive: true, force: true });
+});
+describe('planned writes', () => {
+    it('applies no writes when an intermediate parent is a file', () => {
+        const ctx = createTestContext();
+        contexts.push(ctx);
+        const blocker = ctx.resolve('generated/blocked');
+        mkdirSync(ctx.resolve('generated'), { recursive: true });
+        writeFileSync(blocker, 'user-owned');
+        const first = ctx.resolve('generated/first.ts');
+        const result = applyPlannedWrites([
+            { path: first, contents: 'first', mode: 'create' },
+            { path: join(blocker, 'second.ts'), contents: 'second', mode: 'create' },
+        ]);
+        expect(result.written).toEqual([]);
+        expect(result.conflicts).toContain(blocker);
+        expect(existsSync(first)).toBe(false);
+        expect(readFileSync(blocker, 'utf8')).toBe('user-owned');
+    });
+    it('rejects colliding planned file and descendant paths before writing', () => {
+        const ctx = createTestContext();
+        contexts.push(ctx);
+        const parent = ctx.resolve('generated/route');
+        const result = applyPlannedWrites([
+            { path: parent, contents: 'file', mode: 'create' },
+            { path: join(parent, 'child.ts'), contents: 'child', mode: 'create' },
+        ]);
+        expect(result.written).toEqual([]);
+        expect(existsSync(parent)).toBe(false);
+    });
+    it('does not follow an intermediate symlink outside the planned tree', () => {
+        const ctx = createTestContext();
+        contexts.push(ctx);
+        const outside = ctx.resolve('outside');
+        const linked = ctx.resolve('generated/link');
+        mkdirSync(outside);
+        mkdirSync(ctx.resolve('generated'));
+        symlinkSync(outside, linked);
+        const result = applyPlannedWrites([
+            { path: join(linked, 'escaped.ts'), contents: 'escaped', mode: 'create' },
+        ]);
+        expect(result.written).toEqual([]);
+        expect(result.conflicts).toContain(linked);
+        expect(existsSync(join(outside, 'escaped.ts'))).toBe(false);
+    });
+    it('rejects a dangling symlink at a final target before applying any writes', () => {
+        const ctx = createTestContext();
+        contexts.push(ctx);
+        const outside = ctx.resolve('outside');
+        const target = ctx.resolve('generated/linked.ts');
+        const escaped = join(outside, 'escaped.ts');
+        mkdirSync(outside);
+        mkdirSync(ctx.resolve('generated'));
+        symlinkSync(escaped, target);
+        const first = ctx.resolve('generated/first.ts');
+        const result = applyPlannedWrites([
+            { path: first, contents: 'first', mode: 'create' },
+            { path: target, contents: 'escaped', mode: 'create' },
+        ]);
+        expect(result.written).toEqual([]);
+        expect(result.conflicts).toContain(target);
+        expect(existsSync(first)).toBe(false);
+        expect(existsSync(escaped)).toBe(false);
+        expect(lstatSync(target).isSymbolicLink()).toBe(true);
+    });
+    it('rolls back applied patches and creates when a target changes after preflight', () => {
+        const ctx = createTestContext();
+        contexts.push(ctx);
+        const patched = ctx.resolve('generated/existing.ts');
+        const createdDirectory = ctx.resolve('generated/nested');
+        const created = join(createdDirectory, 'created.ts');
+        const stale = ctx.resolve('generated/stale.ts');
+        mkdirSync(ctx.resolve('generated'));
+        writeFileSync(patched, 'original');
+        writeFileSync(stale, 'expected');
+        let observedPriorWrites = false;
+        const staleWrite = {
+            // Change this target only once the apply loop has made both earlier writes visible.
+            get path() {
+                if (!observedPriorWrites &&
+                    readFileSync(patched, 'utf8') === 'patched' &&
+                    existsSync(created)) {
+                    observedPriorWrites = true;
+                    writeFileSync(stale, 'changed-after-preflight');
+                }
+                return stale;
+            },
+            before: 'expected',
+            contents: 'replacement',
+            mode: 'patch',
+        };
+        const result = applyPlannedWrites([
+            { path: patched, before: 'original', contents: 'patched', mode: 'patch' },
+            { path: created, contents: 'created', mode: 'create' },
+            staleWrite,
+        ]);
+        expect(result).toEqual({ written: [], conflicts: [stale] });
+        expect(observedPriorWrites).toBe(true);
+        expect(readFileSync(patched, 'utf8')).toBe('original');
+        expect(existsSync(created)).toBe(false);
+        expect(existsSync(createdDirectory)).toBe(false);
+        expect(readFileSync(stale, 'utf8')).toBe('changed-after-preflight');
+    });
+});
+//# sourceMappingURL=planned-writes.test.js.map

package/dist/lib/planned-writes.test.js.map

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

package/dist/lib/release-policy.d.ts

@@ -0,0 +1,12 @@
+export interface BylineReleasePolicy {
+    dependencyRange: string;
+    supportedRange: string;
+    displayFloor: string;
+}
+/** Derive every CLI package-compatibility value from one release version. */
+export declare function deriveBylineReleasePolicy(cliVersion: string): BylineReleasePolicy;
+/** Version of the installed CLI package; Changesets updates this at release time. */
+export declare const CLI_PACKAGE_VERSION: string;
+/** Active compatibility policy for this exact CLI artifact. */
+export declare const BYLINE_RELEASE_POLICY: BylineReleasePolicy;
+//# sourceMappingURL=release-policy.d.ts.map

package/dist/lib/release-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-policy.d.ts","sourceRoot":"","sources":["../../src/lib/release-policy.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,MAAM,CAAA;IACvB,cAAc,EAAE,MAAM,CAAA;IACtB,YAAY,EAAE,MAAM,CAAA;CACrB;AAED,6EAA6E;AAC7E,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,GAAG,mBAAmB,CAWjF;AAID,qFAAqF;AACrF,eAAO,MAAM,mBAAmB,QAAiE,CAAA;AAEjG,+DAA+D;AAC/D,eAAO,MAAM,qBAAqB,qBAAiD,CAAA"}

package/dist/lib/release-policy.js

@@ -0,0 +1,20 @@
+import { createRequire } from 'node:module';
+import { parse } from 'semver';
+/** Derive every CLI package-compatibility value from one release version. */
+export function deriveBylineReleasePolicy(cliVersion) {
+    const parsed = parse(cliVersion);
+    if (!parsed) {
+        throw new Error(`Invalid @byline/cli package version: ${cliVersion}`);
+    }
+    return {
+        dependencyRange: `^${parsed.version}`,
+        supportedRange: `>=${parsed.version} <${parsed.major + 1}.0.0-0`,
+        displayFloor: `${parsed.major}.${parsed.minor}.x+`,
+    };
+}
+const require = createRequire(import.meta.url);
+/** Version of the installed CLI package; Changesets updates this at release time. */
+export const CLI_PACKAGE_VERSION = require('../../package.json').version;
+/** Active compatibility policy for this exact CLI artifact. */
+export const BYLINE_RELEASE_POLICY = deriveBylineReleasePolicy(CLI_PACKAGE_VERSION);
+//# sourceMappingURL=release-policy.js.map

package/dist/lib/release-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-policy.js","sourceRoot":"","sources":["../../src/lib/release-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAQ9B,6EAA6E;AAC7E,MAAM,UAAU,yBAAyB,CAAC,UAAkB;IAC1D,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC,CAAA;IAChC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,wCAAwC,UAAU,EAAE,CAAC,CAAA;IACvE,CAAC;IAED,OAAO;QACL,eAAe,EAAE,IAAI,MAAM,CAAC,OAAO,EAAE;QACrC,cAAc,EAAE,KAAK,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,KAAK,GAAG,CAAC,QAAQ;QAChE,YAAY,EAAE,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,KAAK;KACnD,CAAA;AACH,CAAC;AAED,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAA;AAE9C,qFAAqF;AACrF,MAAM,CAAC,MAAM,mBAAmB,GAAI,OAAO,CAAC,oBAAoB,CAAyB,CAAC,OAAO,CAAA;AAEjG,+DAA+D;AAC/D,MAAM,CAAC,MAAM,qBAAqB,GAAG,yBAAyB,CAAC,mBAAmB,CAAC,CAAA"}

package/dist/lib/release-policy.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=release-policy.test.d.ts.map

package/dist/lib/release-policy.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-policy.test.d.ts","sourceRoot":"","sources":["../../src/lib/release-policy.test.ts"],"names":[],"mappings":""}

package/dist/lib/release-policy.test.js

@@ -0,0 +1,36 @@
+import { describe, expect, it } from 'vitest';
+import { deriveBylineReleasePolicy } from './release-policy.js';
+describe('deriveBylineReleasePolicy', () => {
+    it.each([
+        [
+            '3.21.0',
+            {
+                dependencyRange: '^3.21.0',
+                supportedRange: '>=3.21.0 <4.0.0-0',
+                displayFloor: '3.21.x+',
+            },
+        ],
+        [
+            '4.0.0',
+            {
+                dependencyRange: '^4.0.0',
+                supportedRange: '>=4.0.0 <5.0.0-0',
+                displayFloor: '4.0.x+',
+            },
+        ],
+        [
+            '5.2.1',
+            {
+                dependencyRange: '^5.2.1',
+                supportedRange: '>=5.2.1 <6.0.0-0',
+                displayFloor: '5.2.x+',
+            },
+        ],
+    ])('derives the lockstep policy for %s', (version, expected) => {
+        expect(deriveBylineReleasePolicy(version)).toEqual(expected);
+    });
+    it('rejects an invalid package version', () => {
+        expect(() => deriveBylineReleasePolicy('next')).toThrow('Invalid @byline/cli package version');
+    });
+});
+//# sourceMappingURL=release-policy.test.js.map

package/dist/lib/release-policy.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-policy.test.js","sourceRoot":"","sources":["../../src/lib/release-policy.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE7C,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AAE/D,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,IAAI,CAAC;QACN;YACE,QAAQ;YACR;gBACE,eAAe,EAAE,SAAS;gBAC1B,cAAc,EAAE,mBAAmB;gBACnC,YAAY,EAAE,SAAS;aACxB;SACF;QACD;YACE,OAAO;YACP;gBACE,eAAe,EAAE,QAAQ;gBACzB,cAAc,EAAE,kBAAkB;gBAClC,YAAY,EAAE,QAAQ;aACvB;SACF;QACD;YACE,OAAO;YACP;gBACE,eAAe,EAAE,QAAQ;gBACzB,cAAc,EAAE,kBAAkB;gBAClC,YAAY,EAAE,QAAQ;aACvB;SACF;KACF,CAAC,CAAC,oCAAoC,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE;QAC7D,MAAM,CAAC,yBAAyB,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC9D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,GAAG,EAAE,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,qCAAqC,CAAC,CAAA;IAChG,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/lib/route-config.d.ts

@@ -0,0 +1,40 @@
+import { type StaticResult } from './static-config.js';
+import type { Context } from '../context.js';
+export declare const DEFAULT_ADMIN_PATH = "/admin";
+export declare const DEFAULT_SIGN_IN_PATH = "/sign-in";
+export declare const PREVIOUS_RELEASE_ROUTES_SOURCE = "/**\n * This Source Code is subject to the terms of the Mozilla Public\n * License, v. 2.0. If a copy of the MPL was not distributed with this\n * file, You can obtain one at http://mozilla.org/MPL/2.0/.\n *\n * Copyright (c) Infonomic Company Limited\n */\n\n/**\n * URL segments for admin and (future) public API routes. Defaults of\n * `/admin` and `/api` are applied automatically by `resolveRoutes()` \u2014\n * keys only need to be set here when overriding either default.\n */\n\nimport type { RoutesConfig } from '@byline/core'\n\nexport const routes: Partial<RoutesConfig> = {\n  admin: '/admin',\n  api: '/api',\n}\n\n/**\n * Fallback used by both server and admin entry points when no\n * `VITE_SERVER_URL` env var is set. Each entry resolves the env var\n * itself (Vite's `import.meta.env` on the client, Node's `process.env`\n * on the server) and falls back to this literal.\n */\nexport const DEFAULT_SERVER_URL = 'http://localhost:5173/'\n";
+export interface ValidatedRoutePaths {
+    adminPath: string;
+    adminSegments: string[];
+    apiPath: string;
+    apiSegments: string[];
+    signInPath: string;
+    signInSegments: string[];
+}
+export interface GeneratedRoutesSource {
+    adminPath: string;
+    apiPath: string;
+    signInPath: string;
+}
+export interface StaticRouteConfig {
+    admin: string;
+    api: string;
+    signIn: string;
+}
+type ValidationResult = {
+    ok: true;
+    value: ValidatedRoutePaths;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function validateRoutePaths(ctx: Context, adminInput?: string, signInInput?: string, apiInput?: string): ValidationResult;
+/** Recognize only generated routes.ts sources with route literals as the sole variation. */
+export declare function recognizeGeneratedRoutesSource(source: string, canonical: string): GeneratedRoutesSource | null;
+export declare function readStaticRoutesSource(source: string): StaticResult<StaticRouteConfig>;
+export declare function routesSourceAligned(source: string, ctx: Context, expected: ValidatedRoutePaths): boolean;
+export declare function renderGeneratedRoutesSource(canonical: string, adminPath: string, apiPath: string, signInPath: string): string;
+export declare function validateCanonicalRoutesSource(source: string): StaticResult<StaticRouteConfig>;
+export declare function canonicalRoutesTemplatePath(ctx: Context): string;
+export {};
+//# sourceMappingURL=route-config.d.ts.map

package/dist/lib/route-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-config.d.ts","sourceRoot":"","sources":["../../src/lib/route-config.ts"],"names":[],"mappings":"AAGA,OAAO,EAIL,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAA;AAE3B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAE5C,eAAO,MAAM,kBAAkB,WAAW,CAAA;AAC1C,eAAO,MAAM,oBAAoB,aAAa,CAAA;AAK9C,eAAO,MAAM,8BAA8B,i8BA4B1C,CAAA;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,EAAE,CAAA;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,EAAE,MAAM,EAAE,CAAA;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;CACf;AAED,KAAK,gBAAgB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,mBAAmB,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAE/F,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,OAAO,EACZ,UAAU,SAAqB,EAC/B,WAAW,SAAuB,EAClC,QAAQ,CAAC,EAAE,MAAM,GAChB,gBAAgB,CAmGlB;AAED,4FAA4F;AAC5F,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,qBAAqB,GAAG,IAAI,CA6B9B;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC,iBAAiB,CAAC,CAgBtF;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,mBAAmB,GAC5B,OAAO,CAeT;AAED,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR;AAED,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAAC,iBAAiB,CAAC,CAyB7F;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAGhE"}