@endora-commerce/cli 0.100.0

package/dist/new-storefront/reference.js

@@ -0,0 +1,430 @@
+/**
+ * The reference storefront, and every declaration in it that names something
+ * above its own directory.
+ *
+ * **Nothing here is a list.** `specs/071-modular-packaging/roadmap.md` § *F7*
+ * derived the transformation once, on 2026-09-02, and recorded it as *"four
+ * `@endora-commerce/*` `workspace:` ranges and three monorepo-relative
+ * configuration references"*. Re-derived against the tree on 2026-09-03 that is
+ * already wrong in four ways — `@endora-commerce/api-client` has been dropped
+ * from the storefront's manifest, the vitest configuration is `.mts` rather than
+ * `.ts`, `app/globals.css` has grown a Tailwind `@source` glob into the
+ * repository's package tree, and one test file imports a repository script. A
+ * tool carrying the list would have copied three of those four out of the
+ * repository unchanged and said nothing.
+ *
+ * So the population is computed on every run, from three sources that are each
+ * an independent author of part of the answer:
+ *
+ *   * **`git ls-files`** for which files the reference storefront *is*. Build
+ *     output, `node_modules` and a stray `.next` are excluded by construction
+ *     rather than by an ignore list this file would have to keep current.
+ *   * **the storefront's own `package.json`** for the `workspace:` ranges, in
+ *     every dependency field rather than only `dependencies`.
+ *   * **the copied text itself** for every relative reference that resolves
+ *     outside the storefront directory, in the three shapes a Next application
+ *     writes one: an ES module specifier, a JSON `extends`, and a CSS `@source`
+ *     glob.
+ *
+ * A reference the transformation cannot make standalone is a **refusal**, never
+ * a file copied out unchanged: that is the one property that keeps this command
+ * from going stale the way the roadmap's own sentence did.
+ */
+import { spawnSync } from 'node:child_process';
+import { builtinModules } from 'node:module';
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { dirname, join, relative, resolve, sep } from 'node:path';
+import { addressVariablesFor, scopeToMembers, } from '@endora-commerce/contracts';
+import { loadTreeDeclaration } from '../inputs/declaration.js';
+import { isNextApplication } from '../lib/workspace-packages.js';
+/** Raised when the reference storefront cannot be read. Exit 2. */
+export class StorefrontHostError extends Error {
+}
+/** Raised when the author asked for something this command refuses. Exit 1. */
+export class StorefrontInputError extends Error {
+}
+/** The dependency fields a manifest can declare a `workspace:` range in. */
+export const DEPENDENCY_FIELDS = [
+    'dependencies',
+    'devDependencies',
+    'peerDependencies',
+    'optionalDependencies',
+];
+/** The nearest ancestor of `start` holding a `pnpm-workspace.yaml`, or `null`. */
+export function findRepoRoot(start) {
+    let current = resolve(start);
+    for (;;) {
+        if (existsSync(join(current, 'pnpm-workspace.yaml')))
+            return current;
+        const parent = dirname(current);
+        if (parent === current)
+            return null;
+        current = parent;
+    }
+}
+/**
+ * The reference storefront's files, from git.
+ *
+ * Git is the independent author here: the alternative is a walk plus an
+ * exclusion list, and an exclusion list is a second answer to "what is this
+ * application" that goes stale against `.gitignore` in silence. A checkout with
+ * no git, or a storefront directory git does not track, is exit 2 — never a
+ * partial copy.
+ */
+export function trackedFiles(repoRoot, storefrontDir) {
+    const result = spawnSync('git', ['ls-files', '-z', '--', storefrontDir], {
+        cwd: repoRoot,
+        encoding: 'utf8',
+        maxBuffer: 64 * 1024 * 1024,
+    });
+    if (result.error !== undefined || result.status !== 0) {
+        throw new StorefrontHostError(`\`git ls-files\` could not enumerate ${storefrontDir}: ` +
+            `${result.error?.message ?? result.stderr}. The copy population is git's answer to ` +
+            `"what is this application", so a run that cannot ask it copies nothing rather than ` +
+            `walking the directory and guessing which artefacts are build output.`);
+    }
+    const files = result.stdout
+        .split('\0')
+        .filter((line) => line.length > 0)
+        .map((line) => relative(storefrontDir, join(repoRoot, line)));
+    if (files.length === 0) {
+        throw new StorefrontHostError(`git tracks no file under ${storefrontDir}. There is no reference storefront to copy.`);
+    }
+    return files;
+}
+/**
+ * Locate the reference storefront.
+ *
+ * It is found by the **one workspace member that is a Next application**, not by
+ * a directory called `storefront`: the member's manifest declares `next` and a
+ * `build` script that runs it, and `pnpm-workspace.yaml` says which directories
+ * are members. A repository that renames the directory is followed; one that
+ * grows a second Next application is exit 2 rather than a run over whichever
+ * sorted first.
+ */
+export function resolveReference(cwd) {
+    const repoRoot = findRepoRoot(cwd);
+    if (repoRoot === null) {
+        throw new StorefrontHostError(`no pnpm-workspace.yaml above ${cwd}. \`endora new storefront\` copies the reference ` +
+            `storefront out of a checkout of the platform repository, so it has to be run inside ` +
+            `one. There is nothing for it to copy anywhere else.`);
+    }
+    const candidates = nextApplications(repoRoot);
+    if (candidates.length === 0) {
+        throw new StorefrontHostError(`${repoRoot} declares no workspace member that is a Next application, so this checkout ` +
+            `holds no reference storefront. A member qualifies by declaring \`next\` as a ` +
+            `dependency and a \`build\` script that runs it.`);
+    }
+    if (candidates.length > 1) {
+        throw new StorefrontHostError(`${repoRoot} holds more than one Next application ` +
+            `(${candidates.map((dir) => relative(repoRoot, dir)).join(', ')}). This command will ` +
+            `not choose between them, because a run over whichever sorted first is a run whose ` +
+            `subject nobody chose.`);
+    }
+    const dir = candidates[0];
+    const manifest = readManifest(join(dir, 'package.json'));
+    return { repoRoot, dir, files: trackedFiles(repoRoot, dir), manifest };
+}
+function readManifest(path) {
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch (error) {
+        throw new StorefrontHostError(`${path} could not be read as JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/** Workspace member directories, from the `packages:` globs as written. */
+export function memberDirectories(repoRoot) {
+    const text = readFileSync(join(repoRoot, 'pnpm-workspace.yaml'), 'utf8');
+    const globs = [];
+    let inPackages = false;
+    for (const raw of text.split('\n')) {
+        const line = raw.replace(/#.*$/, '').trimEnd();
+        if (/^packages:\s*$/.test(line)) {
+            inPackages = true;
+            continue;
+        }
+        if (!inPackages)
+            continue;
+        const entry = /^\s+-\s+['"]?([^'"\s]+)['"]?\s*$/.exec(line);
+        if (entry === null) {
+            if (line.trim().length > 0 && !line.startsWith(' '))
+                inPackages = false;
+            continue;
+        }
+        globs.push(entry[1]);
+    }
+    const found = [];
+    for (const glob of globs) {
+        if (glob.startsWith('!'))
+            continue;
+        if (!glob.endsWith('/*')) {
+            found.push(join(repoRoot, glob));
+            continue;
+        }
+        found.push(...expand(join(repoRoot, glob.slice(0, -2))));
+    }
+    return found;
+}
+function expand(parent) {
+    if (!existsSync(parent))
+        return [];
+    return readdirSync(parent, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => join(parent, entry.name));
+}
+function nextApplications(repoRoot) {
+    const found = [];
+    for (const dir of memberDirectories(repoRoot)) {
+        const manifestPath = join(dir, 'package.json');
+        if (!existsSync(manifestPath))
+            continue;
+        let manifest;
+        try {
+            manifest = JSON.parse(readFileSync(manifestPath, 'utf8'));
+        }
+        catch {
+            continue;
+        }
+        // The predicate lives in `lib/workspace-packages.ts` because
+        // `check-release-intent.ts` asks the same question of the same population
+        // — which member is the reference storefront — and two copies of it are two
+        // answers waiting to disagree (feature 104, FR-001).
+        if (isNextApplication(manifest))
+            found.push(dir);
+    }
+    return [...found].sort();
+}
+/** Every `workspace:` range the reference storefront declares, in field order. */
+export function workspaceRanges(manifest) {
+    const found = [];
+    for (const field of DEPENDENCY_FIELDS) {
+        const block = manifest[field];
+        if (typeof block !== 'object' || block === null)
+            continue;
+        for (const [name, declared] of Object.entries(block)) {
+            if (typeof declared !== 'string' || !declared.startsWith('workspace:'))
+                continue;
+            found.push({ field, name, declared });
+        }
+    }
+    return found;
+}
+/** Files whose text this analysis reads for outward references. */
+const TEXTUAL = /\.(ts|tsx|mts|cts|js|jsx|mjs|cjs|json|css)$/;
+/**
+ * Every relative declaration in the reference storefront that resolves outside
+ * it, in the three shapes an application writes one.
+ *
+ * The specifier's own leading `.` is what makes it a candidate: a bare specifier
+ * names a package and is resolved by the installer, not by this copy. A glob is
+ * resolved up to its first wildcard segment, because that prefix is the part
+ * that has to exist.
+ */
+export function outwardReferences(reference) {
+    const found = [];
+    for (const file of reference.files) {
+        if (!TEXTUAL.test(file))
+            continue;
+        const absolute = join(reference.dir, file);
+        if (!existsSync(absolute))
+            continue;
+        const text = readFileSync(absolute, 'utf8');
+        for (const raw of referencesIn(text)) {
+            if (!raw.specifier.startsWith('.'))
+                continue;
+            const target = resolve(dirname(absolute), globPrefix(raw.specifier));
+            if (target === reference.dir || target.startsWith(reference.dir + sep))
+                continue;
+            found.push({ file, kind: raw.kind, specifier: raw.specifier, target });
+        }
+    }
+    return found.sort((a, b) => a.file.localeCompare(b.file) || a.specifier.localeCompare(b.specifier));
+}
+/** The path prefix of a glob: everything up to the first wildcard segment. */
+export function globPrefix(specifier) {
+    const segments = specifier.split('/');
+    const wildcard = segments.findIndex((segment) => /[*?[{]/.test(segment));
+    return wildcard === -1 ? specifier : segments.slice(0, wildcard).join('/');
+}
+const MODULE_SPECIFIER = /(?:^|[\s;{(=])(?:import|export)\s[^'"()]*?from\s*['"]([^'"]+)['"]|(?:^|[^\w.])(?:import|require)\(\s*['"]([^'"]+)['"]\s*\)|(?:^|[\s;{(])import\s*['"]([^'"]+)['"]/g;
+const JSON_EXTENDS = /"extends"\s*:\s*"([^"]+)"/g;
+const CSS_SOURCE = /@source\s+(?:not\s+)?['"]([^'"]+)['"]/g;
+function referencesIn(text) {
+    const found = [];
+    for (const match of text.matchAll(MODULE_SPECIFIER)) {
+        const specifier = match[1] ?? match[2] ?? match[3];
+        if (specifier !== undefined)
+            found.push({ kind: 'module-specifier', specifier });
+    }
+    for (const match of text.matchAll(JSON_EXTENDS)) {
+        found.push({ kind: 'json-extends', specifier: match[1] });
+    }
+    for (const match of text.matchAll(CSS_SOURCE)) {
+        found.push({ kind: 'css-source', specifier: match[1] });
+    }
+    return found;
+}
+/**
+ * Every package a module's **static import and re-export statements** name,
+ * reduced to the package: `vitest/config` is `vitest`, `@scope/pkg/sub` is
+ * `@scope/pkg`. Relative specifiers and Node's own modules are not packages an
+ * installer resolves, so they are not here.
+ *
+ * Anchored at the start of a line, deliberately narrower than
+ * {@link outwardReferences}' pattern: that one looks for a path anywhere a
+ * declaration could write one, and over a configuration file it also matches
+ * the word "import" inside a rule's message string. Here a false match is a
+ * refusal of a correct scaffold, and the statements a configuration file
+ * loads its packages with are the static ones this reads.
+ */
+export function importedPackages(text) {
+    const found = new Set();
+    for (const match of text.matchAll(STATIC_IMPORT)) {
+        const specifier = match[1];
+        if (specifier.startsWith('.') || specifier.startsWith('/'))
+            continue;
+        if (specifier.startsWith('node:') || builtinModules.includes(specifier.split('/')[0]))
+            continue;
+        const parts = specifier.split('/');
+        found.add(specifier.startsWith('@') ? parts.slice(0, 2).join('/') : parts[0]);
+    }
+    return [...found].sort();
+}
+const STATIC_IMPORT = /^[ \t]*(?:import|export)\s+(?:[^'";]*?\sfrom\s*)?['"]([^'"]+)['"]/gm;
+/** Every package name a manifest declares, in any dependency field. */
+export function declaredPackages(manifest) {
+    const names = new Set();
+    for (const field of DEPENDENCY_FIELDS) {
+        const block = manifest[field];
+        if (typeof block !== 'object' || block === null)
+            continue;
+        for (const name of Object.keys(block))
+            names.add(name);
+    }
+    return names;
+}
+/** The file a storefront declares its environment in, and the copy carries verbatim. */
+export const ENV_EXAMPLE_FILE = '.env.example';
+/** The binding a storefront's declaration is exported under. */
+export const STOREFRONT_DECLARATION_EXPORT = 'STOREFRONT_ENVIRONMENT_INPUTS';
+/**
+ * Every declaration the file makes, in file order — the copy's own worked
+ * example of its environment.
+ *
+ * One parser, because there are two questions asked of this file and they must
+ * not come to disagree about what it says: *which of these names a backend*
+ * (below) and *what value does this file give for a name* — the second being how
+ * the acceptance criterion configures the instance it boots without carrying a
+ * list of variables of its own. A key repeated in the file keeps its last
+ * assignment, which is what every reader of a `.env` does.
+ *
+ * A blank value is **not** a declaration. `NEXT_PUBLIC_SITE_URL=` and no line at
+ * all are the same state for whoever has to supply it, and reading the first as
+ * an answer would let a consumer pass an empty string to a command whose whole
+ * subject is that nothing is invented — `inputs/env-file.ts` makes the same call
+ * for the same reason, one directory over.
+ */
+export function envExampleDeclarations(envExampleText) {
+    const declared = new Map();
+    for (const line of envExampleText.split('\n')) {
+        const match = /^\s*(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)$/.exec(line);
+        if (match === null)
+            continue;
+        const value = match[2].trim().replace(/^(['"])(.*)\1$/, '$2');
+        if (value.length === 0) {
+            declared.delete(match[1]);
+            continue;
+        }
+        declared.set(match[1], value);
+    }
+    return declared;
+}
+/** The same answer, read off a storefront directory. */
+export function envExampleDeclarationsOf(storefrontDir) {
+    const path = join(storefrontDir, ENV_EXAMPLE_FILE);
+    if (!existsSync(path))
+        return new Map();
+    return envExampleDeclarations(readFileSync(path, 'utf8'));
+}
+/**
+ * The variables a storefront sets to name a member of its instance.
+ *
+ * **Derived from the storefront's own declaration, never written down here.**
+ * A sentence carrying the two backend names would be a copy of a fact the
+ * storefront already states, going stale the first time one is renamed (D-100),
+ * and the guidance this replaces is what that costs: it named
+ * `PUBLIC_API_BASE_URL`, which no file in the copy has ever read, so an operator
+ * who followed it got a storefront quietly talking to the fallback its fetchers
+ * compile in.
+ *
+ * **The predicate is `addressOf`, and it used to be the shape of the value.**
+ * This function read `.env.example` and answered *a declaration whose value is
+ * an absolute `http(s)` URL*, on the reasoning that a backend address is one and
+ * none of the file's other keys was. The second half stopped being true the
+ * moment the file gained the storefront's own public address: `.env.example`
+ * would then have swept `NEXT_PUBLIC_SITE_URL` in with the backend's, and
+ * `nextSteps` would have told a client — in a file they own outright and nobody
+ * revisits — that it "names the backend this storefront talks to". A confident
+ * wrong sentence is worse than the silence it replaces, and the criterion would
+ * have pointed the shop's canonical origin at its API host at the same time.
+ *
+ * So the question is asked of the declaration, which says what each value **is**
+ * rather than what it looks like. The scoping stays `.env.example`'s job for
+ * *values* (`envExampleDeclarations`, above); this is about meaning.
+ *
+ * Nothing is invented when the declaration names no address: the answer is empty
+ * and each caller says so in its own words.
+ */
+export function addressVariables(declared, member) {
+    return addressVariablesFor(declared, member);
+}
+/**
+ * The same answer, read off a storefront directory.
+ *
+ * It loads that directory's own `environment-inputs.mjs` — the copy's, when the
+ * caller is holding a copy — through the one loader every other reader uses, so
+ * a declaration that will not parse is a refusal here as it is everywhere else.
+ * A storefront with no declaration at all is `DeclarationLoadError` and not an
+ * empty answer: that was `.env.example`'s rule, and it was right for a file that
+ * is a worked example. This one is the tree's statement of what it reads, and
+ * "absent" is not "reads nothing" (`loadTreeDeclaration`'s own header).
+ */
+export async function backendAddressVariablesOf(storefrontDir) {
+    const declared = await loadTreeDeclaration(storefrontDir, STOREFRONT_DECLARATION_EXPORT);
+    return addressVariables(declared, 'backend');
+}
+/** The variables naming the storefront's own public address, off a directory. */
+export async function storefrontAddressVariablesOf(storefrontDir) {
+    const declared = await loadTreeDeclaration(storefrontDir, STOREFRONT_DECLARATION_EXPORT);
+    return addressVariables(declared, 'storefront');
+}
+/**
+ * Every variable this storefront's own process reads, off a directory.
+ *
+ * The two functions above answer *which of these names a member* — a subset
+ * chosen by `addressOf`. This one is the whole population, scoped to the one
+ * member that runs here, and it exists because a caller that **spawns** a
+ * storefront's toolchain has to know which names in its own environment belong
+ * to the instance rather than to itself.
+ *
+ * That is not a curiosity. Next loads a `.env` and does **not** override a
+ * variable the process already carries, so any of these names present in a
+ * parent's environment silently displaces the value written into the copy's own
+ * `.env` — and a harness that passed its environment on wholesale would be
+ * measuring its own configuration while reporting on the command's. `NODE_ENV`
+ * is the case that made this real: this storefront's declaration says in as many
+ * words that its toolchain sets it and that *"setting it by hand is how a
+ * production build ends up serving development output"*, and a CI job that set
+ * it for the **backend** it booted put it on every process in the job, including
+ * a `next build` in a scaffolded instance outside the checkout.
+ *
+ * Scoped with `scopeToMembers` rather than by name, for `storefrontDeclaredInputs`'
+ * reason: a declaration may carry an input another member reads, and the question
+ * here is what *this* process reads.
+ */
+export async function declaredVariablesOf(storefrontDir) {
+    const declared = await loadTreeDeclaration(storefrontDir, STOREFRONT_DECLARATION_EXPORT);
+    return scopeToMembers(declared, ['storefront']).map((input) => input.name);
+}
+//# sourceMappingURL=reference.js.map

package/dist/new-storefront/reference.js.map

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

package/dist/new-storefront/rewrite.d.ts

@@ -0,0 +1,171 @@
+import { DEPENDENCY_FIELDS, StorefrontInputError, type OutwardReference, type StorefrontReference } from './reference.js';
+/** An outward reference no rule below classifies. */
+export declare class UnclassifiedReferenceError extends StorefrontInputError {
+}
+/** A vendored configuration imports a package the scaffold's manifest does not declare. */
+export declare class UndeclaredImportError extends StorefrontInputError {
+}
+/** A file the scaffold writes: either copied bytes or rewritten text. */
+export interface PlannedFile {
+    /** Where it lands, scaffold-relative, with `/` separators. */
+    readonly path: string;
+    /** The source it is copied from, absolute, or `null` for authored text. */
+    readonly source: string | null;
+    /** The text to write, or `null` to copy `source` byte for byte. */
+    readonly content: string | null;
+    /** What this run did to it, for the report and for `--dry-run`. */
+    readonly note: string | null;
+}
+/** One `workspace:` range and what it became. */
+export interface RangeRewrite {
+    readonly field: string;
+    readonly name: string;
+    readonly from: string;
+    readonly to: string;
+}
+/** A file the copy leaves behind, with the reason. */
+export interface OmittedFile {
+    readonly path: string;
+    readonly reason: string;
+}
+export interface StorefrontPlan {
+    readonly files: readonly PlannedFile[];
+    readonly ranges: readonly RangeRewrite[];
+    /** Every outward reference this run rewrote, with what it became. */
+    readonly rewrites: readonly (OutwardReference & {
+        readonly to: string;
+    })[];
+    readonly omitted: readonly OmittedFile[];
+    /** The registry the copy installs from, or `null` for the public one. */
+    readonly registry: string | null;
+}
+/** What the caller asked for beyond the copy itself. */
+export interface PlanOptions {
+    /**
+     * The endpoint the scaffolded storefront installs `@endora-commerce/*` from.
+     *
+     * Absent is the destination and the default: no `.npmrc` at all, which is what
+     * an open-source consumer holds (`registry-and-scope.md` R3.4).
+     */
+    readonly registry?: string | undefined;
+}
+/**
+ * `workspace:<protocol>` as pnpm itself publishes it.
+ *
+ * The version comes from the named package's own manifest, so a repository that
+ * has started versioning its packages produces real ranges with no change here.
+ */
+export declare function publishedRange(declared: string, version: string): string;
+/** The version a workspace member declares, or `null` when it is not a member. */
+export declare function memberVersion(memberDirs: readonly string[], name: string): {
+    version: string;
+    dir: string;
+} | null;
+/** The single npm scope the workspace's `@`-scoped members publish under. */
+export declare function workspaceScope(memberDirs: readonly string[]): string | null;
+/**
+ * The `packageManager` the scaffolded manifest declares.
+ *
+ * **It is a fact about the client's migration cost, not a formality**
+ * (`specs/104-package-publication/` FR-023). Measured in that feature's
+ * `research.md` §4: a pnpm lockfile records integrity and no registry, an npm
+ * lockfile records a `resolved` URL per package — so a client moving between
+ * registries edits one `.npmrc` line or regenerates their whole lockfile, and
+ * which of the two applies is decided by a field nobody had written down.
+ *
+ * The value is the checkout's own: the reference storefront's if it declares
+ * one, otherwise the repository root's, because that is the manager this
+ * repository builds and tests the reference storefront with. A checkout that
+ * declares neither is a refusal — this command invents no version, for
+ * {@link rewriteManifest}'s reason one field over: a `packageManager` corepack
+ * rejects is worse than the absent field it replaced.
+ */
+export declare function packageManagerFor(reference: StorefrontReference): string;
+/** Rule 1 — the manifest, with every `workspace:` range published. */
+export declare function rewriteManifest(reference: StorefrontReference, memberDirs: readonly string[]): {
+    text: string;
+    ranges: readonly RangeRewrite[];
+};
+/** What rule 2 does to one vendored configuration file. */
+interface VendorPlan {
+    /** Where the vendored copy lands, scaffold-relative. */
+    readonly path: string;
+    /** Its text, already made standalone. */
+    readonly content: string;
+    /** What the referring file's specifier becomes. */
+    readonly specifier: string;
+    readonly note: string;
+}
+/**
+ * Rule 2 — vendor a configuration file the storefront extends, and cut the
+ * declarations that cannot come with it.
+ *
+ * The cut is derived, not listed: each of the vendored file's *own* relative
+ * references is resolved, and one whose target is outside the set being vendored
+ * is removed together with the declaration that uses it. A JSON `paths` entry
+ * and an ES import are the two shapes that occur; anything else is refused, so
+ * a base configuration that grows a third shape stops this command rather than
+ * being copied out half-rewritten.
+ */
+export declare function vendorConfiguration(reference: OutwardReference, storefrontDir: string, taken?: ReadonlySet<string>): VendorPlan;
+/**
+ * Drop every `compilerOptions.paths` entry whose target leaves the scaffold.
+ *
+ * `paths` is the one declaration in a shared `tsconfig` that is repository
+ * geometry rather than compiler policy: its targets are directories under
+ * `packages/`, which a standalone storefront replaces with installed packages.
+ * Left in place they are dead configuration pointing at nothing; TypeScript
+ * falls back to node resolution and the scaffold's author is left reading a
+ * block that describes a tree they do not have.
+ */
+export declare function cutForeignJsonPaths(text: string, configDir: string, storefrontDir: string): {
+    text: string;
+    dropped: readonly string[];
+};
+/**
+ * Drop an ES import whose target leaves the scaffold, and the statements that
+ * use what it bound.
+ *
+ * Deliberately narrow: it removes the import line and any *expression statement*
+ * that is a bare call of a removed binding, which is the shape a configuration
+ * file's side-effecting guard takes. A removed binding used anywhere else is a
+ * refusal — rewriting an expression is not something this command does, and
+ * emitting a configuration with a dangling identifier would be worse than
+ * stopping.
+ */
+export declare function cutForeignImports(text: string, fileDir: string, storefrontDir: string): {
+    text: string;
+    dropped: readonly string[];
+};
+/**
+ * Rule 3 — a glob naming the workspace's package tree, retargeted at where a
+ * standalone application finds those packages.
+ *
+ * `null` when the glob names something else, so the caller refuses it rather
+ * than this function guessing.
+ */
+export declare function retargetPackageGlob(reference: OutwardReference, repoRoot: string, memberDirs: readonly string[], referringFileDir: string, scaffoldDir: string): string | null;
+/**
+ * The directories the application's **test** configuration collects from.
+ *
+ * This is the population rule 4 may omit a file from, and it is derived from the
+ * test runner's own `include` globs rather than from a path convention —
+ * `test/` is this storefront's name for it and the next one's may not be.
+ *
+ * **It fails closed on purpose.** An application with no readable test
+ * configuration has no test population, so every outward reference rule 4 reaches
+ * is a refusal. The other way round — treating "I could not tell" as "not
+ * application code" — is how a file that genuinely reaches into the platform
+ * repository gets dropped out of a client's storefront in silence, which is the
+ * defect this command exists to refuse one layer up.
+ */
+export declare function testRoots(reference: StorefrontReference): readonly string[];
+/**
+ * The whole plan: every file the scaffold writes, and what each rewrite did.
+ *
+ * @param scaffoldDir where the copy will live, used only to express a retargeted
+ *   glob relative to the file that writes it.
+ */
+export declare function planStorefront(reference: StorefrontReference, memberDirs: readonly string[], scaffoldDir: string, options?: PlanOptions): StorefrontPlan;
+export { DEPENDENCY_FIELDS };
+//# sourceMappingURL=rewrite.d.ts.map

package/dist/new-storefront/rewrite.d.ts.map

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