@encore-os/eos-spec 0.3.1

package/dist/commands/conformance.js

@@ -0,0 +1,124 @@
+import { emit, getGlobalOptions } from '../lib/output.js';
+import { buildPipeline } from '../lib/pipeline-map.js';
+import { BUILDER_PIPELINE_SCHEMA, ENCORE1_PIPELINE_SCHEMA } from '../lib/pipeline-config.js';
+import { validateSchema } from '../lib/pipeline-schema.js';
+import { DEFAULT_PREDICATES } from '../lib/predicate-registry.js';
+import { deriveSignalsFromText, isPrimarySpecPath } from '../lib/spec-pure.js';
+function synthSpec(signalsText) {
+    return {
+        id: 'XX-1',
+        core: 'pf',
+        path: 'specs/pf/specs/XX-1.md',
+        hasPlan: false,
+        hasTasks: false,
+        hasContext: false,
+        archived: false,
+        signals: deriveSignalsFromText('pf', signalsText),
+    };
+}
+/** A navigator fixture: real signal derivation from `body` + the caller's file
+ *  flags, the way the loader builds a SpecFile (mirrors navigator-golden.test.ts). */
+function navSpec(core, body, flags = {}) {
+    return {
+        id: 'XX-1',
+        core,
+        path: `specs/${core}/specs/XX-1.md`,
+        hasPlan: flags.hasPlan ?? false,
+        hasTasks: flags.hasTasks ?? false,
+        hasContext: false,
+        archived: false,
+        signals: deriveSignalsFromText(core, body, { researchFileExists: flags.research ?? false }),
+    };
+}
+export function runConformanceChecks() {
+    const checks = [];
+    const guard = (name, fn) => {
+        try {
+            checks.push({ name, ok: true, detail: fn() });
+        }
+        catch (e) {
+            checks.push({ name, ok: false, detail: e instanceof Error ? e.message : String(e) });
+        }
+    };
+    for (const [layout, schema] of [
+        ['encore1', ENCORE1_PIPELINE_SCHEMA],
+        ['builder', BUILDER_PIPELINE_SCHEMA],
+    ]) {
+        guard(`schema:${layout}`, () => {
+            validateSchema(schema, DEFAULT_PREDICATES);
+            return `${schema.stages.length} stages, ${schema.statusOrder.length} statuses — valid against the predicate registry`;
+        });
+        guard(`pipeline:${layout}`, () => {
+            const { computeStage } = buildPipeline(schema, DEFAULT_PREDICATES);
+            const stub = computeStage(synthSpec('---\nid: XX-1\ncore: pf\n---\n# x\n'));
+            const validated = computeStage(synthSpec('---\nid: XX-1\ncore: pf\n---\n<!-- validated: 2026-01-01 -->\n'));
+            if (stub !== 'stub')
+                throw new Error(`empty spec should be 'stub', got '${stub}'`);
+            if (validated !== 'validated')
+                throw new Error(`validated spec should be 'validated', got '${validated}'`);
+            return `computeStage: empty→stub, validated→validated`;
+        });
+    }
+    guard('pure:signals', () => {
+        const s = deriveSignalsFromText('hr', '---\nid: HR-1\ncore: hr\nacceptance_criteria:\n  - id: AC-1\n    status: verified\n---\n');
+        if (!s.isRegulated)
+            throw new Error('hr should be regulated');
+        if (!s.hasVerifiedAcceptanceCriteria)
+            throw new Error('all-verified AC should satisfy the terminal gate');
+        return 'deriveSignalsFromText: regulated + terminal-AC gate';
+    });
+    guard('pure:paths', () => {
+        if (!isPrimarySpecPath('specs/pf/specs/PF-1-x.md'))
+            throw new Error('primary spec path not recognized');
+        if (isPrimarySpecPath('specs/pf/plans/PF-1-PLAN.md'))
+            throw new Error('artifact path wrongly recognized as a spec');
+        return 'isPrimarySpecPath: spec ✓ / artifact ✗';
+    });
+    // The navigator decision-accuracy floor (epic #300 — promoted from the
+    // navigator-golden CI suite so the runnable conformance pack carries it too).
+    guard('navigator:stages', () => {
+        const { computeStage } = buildPipeline(ENCORE1_PIPELINE_SCHEMA, DEFAULT_PREDICATES);
+        const V = '<!-- validated: 2026-01-01 -->';
+        const R = '<!-- spec-reviewed: 2026-01-01 -->';
+        const fm = (core, extra = '') => `---\nid: XX-1\ncore: ${core}\n${extra}---\n`;
+        const rich = (core) => fm(core, 'acceptance_criteria:\n  - id: AC-1\n    status: verified\n');
+        const cases = [
+            ['stub', navSpec('fw', fm('fw'))],
+            ['validated', navSpec('fw', `${fm('fw')}${V}\n`)],
+            ['reviewed', navSpec('fw', `${fm('fw')}${V}\n${R}\n`)],
+            ['planned', navSpec('fw', `${fm('fw')}${V}\n${R}\n`, { hasPlan: true })],
+            ['tasks_generated', navSpec('fw', `${rich('fw')}${V}\n${R}\n`, { hasPlan: true, hasTasks: true })],
+            // regulated honest-cap: an hr spec marked reviewed but with NO research appendix
+            // cannot honestly pass regulatory_grounded, so it caps at validated.
+            ['validated', navSpec('hr', `${fm('hr')}${V}\n${R}\n`)],
+        ];
+        for (const [expected, spec] of cases) {
+            const got = computeStage(spec);
+            if (got !== expected)
+                throw new Error(`navigator stage (core ${spec.core}): expected ${expected}, got ${got}`);
+        }
+        return `${cases.length} stage decisions correct (stub→tasks_generated + regulated honest-cap)`;
+    });
+    return checks;
+}
+export function registerConformance(program) {
+    program
+        .command('conformance')
+        .description('Run the engine conformance pack in-process (pipeline-schema validity for both layouts, stage materialization, typed-AC + /pure helper behavior). Exits non-zero on any failure. Used by the npm-pack install smoke against a clean tarball install.')
+        .action((_options, cmd) => {
+        const global = getGlobalOptions(cmd);
+        const checks = runConformanceChecks();
+        const failed = checks.filter((c) => !c.ok);
+        const text = [
+            `eos-spec conformance — ${checks.length - failed.length}/${checks.length} checks passed`,
+            ...checks.map((c) => `  ${c.ok ? '✅' : '❌'} ${c.name.padEnd(18)} ${c.detail}`),
+        ].join('\n');
+        emit(global, {
+            ok: failed.length === 0,
+            data: { passed: checks.length - failed.length, total: checks.length, checks },
+            text,
+            ...(failed.length > 0 ? { exitCode: 1 } : {}),
+        });
+    });
+}
+//# sourceMappingURL=conformance.js.map

package/dist/commands/conformance.js.map

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

package/dist/commands/create.d.ts

@@ -0,0 +1,6 @@
+import type { Command } from 'commander';
+export declare function registerCreate(program: Command): void;
+export declare function specSubdirForId(id: string, specsPath: string): string;
+export declare function applyHeader(template: string, id: string, title?: string): string;
+export declare function nextFreeId(repoRoot: string, core: string, kind: 'base' | 'ux'): string;
+export declare function humanizeName(slug: string): string;

package/dist/commands/create.js

@@ -0,0 +1,277 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { loadConfig, resolveTemplatePath } from '../lib/config.js';
+import { logEvent, RUN_ID } from '../lib/events.js';
+import { ErrorCode, emit, emitContinuing, getGlobalOptions } from '../lib/output.js';
+import { searchSpecs } from '../lib/precedent-search.js';
+import { getRepoRoot, isKnownCore } from '../lib/repo.js';
+import { findSpecsById } from '../lib/specs.js';
+import { withEventLog } from '../lib/with-event-log.js';
+export function registerCreate(program) {
+    program
+        .command('create [id] [title...]')
+        .description('Scaffold a new spec (and optional plan/tasks) from templates. Will not overwrite existing files.')
+        .option('--core <code>', 'Core for auto-ID allocation (used with --name)')
+        .option('--name <slug>', 'Slug for the new spec (used with --core)')
+        .option('--type <kind>', 'Spec type; "wizard" allocates {CORE}-UX-NN and routes to ux/')
+        .option('--lite', 'Use SPEC_TEMPLATE_LITE.md instead of SPEC_TEMPLATE.md', false)
+        .option('--enhancement', 'Use SPEC_TEMPLATE_LITE.md (enhancement/single mode)', false)
+        .option('--with-plan', 'Also scaffold PLAN_TEMPLATE.md → {ID}-PLAN.md', false)
+        .option('--with-tasks', 'Also scaffold TASKS_TEMPLATE.md → {ID}-TASKS.md', false)
+        .option('--force', 'Override the id-collision HALT (active or archived id); overrides are logged to telemetry', false)
+        .action((idArg, titleParts, options, cmd) => withEventLog('create', async () => {
+        const global = getGlobalOptions(cmd);
+        const repoRoot = getRepoRoot(global.repoRoot);
+        let id = idArg;
+        let title = titleParts.join(' ').trim();
+        if (!id) {
+            if (!options.core || !options.name) {
+                emit(global, {
+                    ok: false,
+                    error: {
+                        code: ErrorCode.INVALID_ARGUMENT,
+                        message: 'create: provide an <id>, or both --core and --name to auto-allocate.',
+                    },
+                    data: {},
+                    text: 'create: provide an <id>, or both --core and --name to auto-allocate.',
+                });
+                return;
+            }
+            const kind = options.type === 'wizard' ? 'ux' : 'base';
+            id = nextFreeId(repoRoot, String(options.core).toLowerCase(), kind);
+            if (!title)
+                title = humanizeName(String(options.name));
+        }
+        const upper = id.toUpperCase();
+        const core = upper.split('-')[0]?.toLowerCase();
+        if (!core || !isKnownCore(core, repoRoot)) {
+            emit(global, {
+                ok: false,
+                error: {
+                    code: ErrorCode.INVALID_ARGUMENT,
+                    message: `create: invalid spec id "${id}" — expected format CORE-NN (e.g. PF-37)`,
+                },
+                data: { id },
+                text: `create: invalid spec id "${id}" — expected format CORE-NN (e.g. PF-37)`,
+            });
+        }
+        // Tier-1 id-collision gate (design §4.3): HALT when this id already exists
+        // actively or in archive/. The lookup itself fails open (design §7) so a
+        // corrupt corpus can never make create unusable.
+        let collisions = [];
+        try {
+            collisions = findSpecsById(repoRoot, upper, { includeArchived: true });
+        }
+        catch (err) {
+            // fail open — log the error for observability but never block create
+            logEvent({
+                ts: new Date().toISOString(),
+                command: 'create',
+                runId: RUN_ID,
+                ms: 0,
+                ok: false,
+                specId: upper,
+                core,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+        const activeCollisions = collisions.filter((s) => !s.archived);
+        const archivedCollisions = collisions.filter((s) => s.archived);
+        if (!options.force && activeCollisions.length > 0) {
+            logEvent({
+                ts: new Date().toISOString(),
+                command: 'create',
+                runId: RUN_ID,
+                ms: 0,
+                ok: false,
+                specId: upper,
+                core,
+                gate: 'create-id-collision',
+                verdict: 'block',
+                overridden: false,
+            });
+            emit(global, {
+                ok: false,
+                data: { id: upper, collisions: activeCollisions.map((s) => relPath(repoRoot, s.path)) },
+                text: [
+                    `create: HALT — spec id ${upper} already exists:`,
+                    ...activeCollisions.map((s) => `  - ${relPath(repoRoot, s.path)}`),
+                    `Extend the existing spec or allocate a fresh id (eos-spec create --core ${core} --name <slug>).`,
+                    'Pass --force to scaffold anyway (the override is logged).',
+                ].join('\n'),
+            });
+        }
+        if (!options.force && archivedCollisions.length > 0) {
+            logEvent({
+                ts: new Date().toISOString(),
+                command: 'create',
+                runId: RUN_ID,
+                ms: 0,
+                ok: false,
+                specId: upper,
+                core,
+                gate: 'create-id-collision',
+                verdict: 'block',
+                overridden: false,
+            });
+            emit(global, {
+                ok: false,
+                data: { id: upper, archivedCollisions: archivedCollisions.map((s) => relPath(repoRoot, s.path)) },
+                text: [
+                    `create: HALT — ${upper} is a retired id; it exists in archive:`,
+                    ...archivedCollisions.map((s) => `  - ${relPath(repoRoot, s.path)}`),
+                    'Read the archived spec for precedent before reviving this id (never reuse a retired ID — rules/governance.md).',
+                    'Pass --force to scaffold anyway (the override is logged).',
+                ].join('\n'),
+            });
+        }
+        if (options.force && collisions.length > 0) {
+            logEvent({
+                ts: new Date().toISOString(),
+                command: 'create',
+                runId: RUN_ID,
+                ms: 0,
+                ok: true,
+                specId: upper,
+                core,
+                gate: 'create-id-collision',
+                verdict: 'block',
+                overridden: true,
+            });
+        }
+        const created = [];
+        const skipped = [];
+        const config = loadConfig(repoRoot, global.config);
+        const specsDir = join(repoRoot, 'specs', core, specSubdirForId(upper, config.paths.specs));
+        const plansDir = join(repoRoot, 'specs', core, config.paths.plans);
+        const tasksDir = join(repoRoot, 'specs', core, config.paths.tasks);
+        mkdirSync(specsDir, { recursive: true });
+        if (options.withPlan)
+            mkdirSync(plansDir, { recursive: true });
+        if (options.withTasks)
+            mkdirSync(tasksDir, { recursive: true });
+        const tmplKey = options.enhancement ? 'enhancement_single' : options.lite ? 'lite_spec' : 'full_spec';
+        const tmplPath = resolveTemplatePath(config, tmplKey);
+        const tmplName = tmplPath
+            ? tmplPath.split('/').pop()
+            : options.enhancement
+                ? 'SPEC_TEMPLATE_LITE.md'
+                : options.lite
+                    ? 'SPEC_TEMPLATE_LITE.md'
+                    : 'SPEC_TEMPLATE.md';
+        const specSource = readTemplate(repoRoot, tmplName);
+        const slug = slugify(options.name ? String(options.name) : title || upper);
+        // Tier-2 precedent auto-run (design §4.3): surface related existing specs on
+        // every create. Warn-only — printed, telemetered, never blocking — and
+        // fail-open so a broken search can never block scaffolding (design §7).
+        try {
+            const topic = title || upper;
+            const hits = searchSpecs(topic, { core, repoRoot, limit: 5 }).slice(0, 5);
+            if (hits.length > 0) {
+                emitContinuing(global, `create: related existing specs for "${topic}" (top ${hits.length}):`);
+                for (const hit of hits) {
+                    emitContinuing(global, `  - ${hit.id}${hit.title ? ` ${hit.title}` : ''} (${hit.file})`);
+                }
+                logEvent({
+                    ts: new Date().toISOString(),
+                    command: 'create',
+                    runId: RUN_ID,
+                    ms: 0,
+                    ok: true,
+                    specId: upper,
+                    core,
+                    gate: 'create-precedent',
+                    verdict: 'warn',
+                });
+            }
+        }
+        catch {
+            // fail open — precedent search must never block create
+        }
+        const specTarget = join(specsDir, `${upper}-${slug}.md`);
+        writeIfMissing(specTarget, applyHeader(specSource, upper, title || upper), created, skipped);
+        if (options.withPlan) {
+            const planTmpl = resolveTemplatePath(config, 'plan');
+            const planName = planTmpl ? planTmpl.split('/').pop() : 'PLAN_TEMPLATE.md';
+            const planSource = readTemplate(repoRoot, planName);
+            writeIfMissing(join(plansDir, `${upper}-PLAN.md`), applyHeader(planSource, upper, title || upper), created, skipped);
+        }
+        if (options.withTasks) {
+            const tasksTmpl = resolveTemplatePath(config, 'tasks');
+            const tasksName = tasksTmpl ? tasksTmpl.split('/').pop() : 'TASKS_TEMPLATE.md';
+            const tasksSource = readTemplate(repoRoot, tasksName);
+            writeIfMissing(join(tasksDir, `${upper}-TASKS.md`), applyHeader(tasksSource, upper, title || upper), created, skipped);
+        }
+        emit(global, {
+            ok: created.length > 0,
+            data: { id: upper, title, created, skipped },
+            text: created.length === 0
+                ? `create: nothing created (already exists)\n  skipped: ${skipped.join(', ')}`
+                : `create: ${upper} scaffolded\n  created: ${created.map((c) => relPath(repoRoot, c)).join(', ')}${skipped.length ? `\n  skipped: ${skipped.map((c) => relPath(repoRoot, c)).join(', ')}` : ''}`,
+        });
+    })(options, cmd));
+}
+function readTemplate(repoRoot, name) {
+    const path = join(repoRoot, 'specs', '_templates', name);
+    if (!existsSync(path)) {
+        throw new Error(`Template not found: specs/_templates/${name}`);
+    }
+    return readFileSync(path, 'utf8');
+}
+export function specSubdirForId(id, specsPath) {
+    return /-UX-/i.test(id) ? 'ux' : specsPath;
+}
+export function applyHeader(template, id, title = '') {
+    const core = id.split('-')[0]?.toLowerCase() ?? '';
+    return template
+        .replace(/\{\{ID\}\}/g, id)
+        .replace(/\{\{CORE\}\}/g, core)
+        .replace(/\{\{TITLE\}\}/g, title)
+        .replace(/\{\{DATE\}\}/g, new Date().toISOString().slice(0, 10));
+}
+function writeIfMissing(target, content, created, skipped) {
+    if (existsSync(target)) {
+        skipped.push(target);
+        return;
+    }
+    writeFileSync(target, content, 'utf8');
+    created.push(target);
+}
+function slugify(s) {
+    return s
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '')
+        .slice(0, 60);
+}
+function relPath(repoRoot, p) {
+    return p.startsWith(repoRoot) ? p.slice(repoRoot.length + 1) : p;
+}
+export function nextFreeId(repoRoot, core, kind) {
+    const upper = core.toUpperCase();
+    // Archived specs hold their ids forever — never reuse a retired ID (rules/governance.md).
+    const dirs = [
+        join(repoRoot, 'specs', core, kind === 'ux' ? 'ux' : 'specs'),
+        join(repoRoot, 'specs', core, 'archive'),
+    ];
+    const re = kind === 'ux' ? new RegExp(`^${upper}-UX-(\\d+)`, 'i') : new RegExp(`^${upper}-(\\d+)(?!\\d)`, 'i');
+    let max = 0;
+    for (const dir of dirs) {
+        if (!existsSync(dir))
+            continue;
+        for (const f of readdirSync(dir)) {
+            const m = f.match(re);
+            if (m)
+                max = Math.max(max, parseInt(m[1], 10));
+        }
+    }
+    const n = String(max + 1).padStart(2, '0');
+    return kind === 'ux' ? `${upper}-UX-${n}` : `${upper}-${n}`;
+}
+export function humanizeName(slug) {
+    return slug
+        .replace(/[-_]+/g, ' ')
+        .replace(/\b\w/g, (c) => c.toUpperCase())
+        .trim();
+}
+//# sourceMappingURL=create.js.map

package/dist/commands/create.js.map

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

package/dist/commands/deferred.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from 'commander';
+export declare function registerDeferred(program: Command): void;

package/dist/commands/deferred.js

@@ -0,0 +1,85 @@
+import { runScript } from '../lib/exec.js';
+import { ErrorCode, emit, emitContinuing, getGlobalOptions } from '../lib/output.js';
+import { getRepoRoot } from '../lib/repo.js';
+import { findSpec } from '../lib/specs.js';
+export function registerDeferred(program) {
+    program
+        .command('deferred')
+        .description('Manage the deferred specs dashboard: sync from spec files or promote a deferred item.')
+        .option('--sync', 'Regenerate DEFERRED_DASHBOARD.md from spec deferred markers', false)
+        .option('--promote', 'Promote a deferred item to active (requires --spec)', false)
+        .option('--spec <id>', 'Spec ID to promote (used with --promote)')
+        .option('--list', 'List all deferred items', false)
+        .action(async (options, cmd) => {
+        const global = getGlobalOptions(cmd);
+        const repoRoot = getRepoRoot(global.repoRoot);
+        if (options.sync) {
+            emitContinuing(global, 'deferred: syncing DEFERRED_DASHBOARD.md ...');
+            const result = runScript(['npx', 'tsx', 'scripts/specs/sync-deferred-dashboard.ts'], repoRoot);
+            emit(global, {
+                ok: result.exitCode === 0,
+                data: { exitCode: result.exitCode, stdout: result.stdout, stderr: result.stderr },
+                text: result.exitCode === 0
+                    ? `deferred: sync complete\n${result.stdout.trim()}`
+                    : `deferred: sync failed (exit ${result.exitCode})\n${result.stderr || result.stdout}`,
+                exitCode: result.exitCode === 0 ? 0 : 1,
+            });
+        }
+        if (options.promote) {
+            if (!options.spec) {
+                emit(global, {
+                    ok: false,
+                    error: { code: ErrorCode.SCOPE_REQUIRED, message: 'deferred: --promote requires --spec <id>' },
+                    data: { reason: '--promote requires --spec' },
+                    text: 'deferred: --promote requires --spec <id>',
+                });
+            }
+            const spec = findSpec(repoRoot, options.spec);
+            if (!spec) {
+                emit(global, {
+                    ok: false,
+                    error: { code: ErrorCode.SPEC_NOT_FOUND, message: `deferred: spec ${options.spec} not found` },
+                    data: { specId: options.spec },
+                    text: `deferred: spec ${options.spec} not found`,
+                });
+            }
+            const nextSteps = [
+                `1. Run: eos-spec create ${spec.id} --enhancement --with-tasks`,
+                `2. Fill out the enhancement spec from the deferred item description`,
+                `3. Mark the deferred row resolved in specs/DEFERRED_DASHBOARD.md`,
+                `4. Run: eos-spec next --spec ${spec.id}`,
+            ];
+            emit(global, {
+                ok: true,
+                data: {
+                    specId: spec.id,
+                    core: spec.core,
+                    title: spec.title,
+                    status: spec.status,
+                    nextSteps,
+                },
+                text: `deferred: promote ${spec.id} (${spec.title ?? 'untitled'})\n\nNext steps:\n${nextSteps.join('\n')}`,
+            });
+        }
+        if (options.list) {
+            const result = runScript(['npx', 'tsx', 'scripts/specs/sync-deferred-dashboard.ts', '--dry-run'], repoRoot);
+            emit(global, {
+                ok: true,
+                data: { stdout: result.stdout },
+                text: result.stdout.trim() || 'deferred: no deferred items found',
+            });
+        }
+        if (!options.sync && !options.promote && !options.list) {
+            emit(global, {
+                ok: false,
+                error: {
+                    code: ErrorCode.INVALID_ARGUMENT,
+                    message: 'deferred: specify --sync, --promote --spec <id>, or --list',
+                },
+                data: null,
+                text: 'deferred: specify --sync, --promote --spec <id>, or --list',
+            });
+        }
+    });
+}
+//# sourceMappingURL=deferred.js.map

package/dist/commands/deferred.js.map

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

package/dist/commands/delta.d.ts

@@ -0,0 +1,17 @@
+import type { Command } from 'commander';
+type DeltaRow = {
+    section: string;
+    adds: string;
+    changes: string;
+    removes: string;
+};
+type ParsedDelta = {
+    type: string | null;
+    rows: DeltaRow[];
+    backwardCompatibility: string | null;
+    consumersAffected: string | null;
+};
+export declare function registerDelta(program: Command): void;
+export declare function parseDeltaSection(content: string): ParsedDelta | null;
+export declare function validateDelta(delta: ParsedDelta, allowedTypes: string[]): string[];
+export {};