@parlor/scaffold 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 cychien
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,12 @@
-# Temporary Holding Version
+# @parlor/scaffold
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+What `create-parlor` and `parlor add` share: the project templates, the add-on model, the syntax-tree edit engine, package manager detection, install and git. Installed by `create-parlor` and `@parlor/cli`; you do not depend on it directly.
+
+```ts
+import { ADDON_NAMES, commandsFor } from "@parlor/scaffold";
+
+const pnpm = commandsFor({ name: "pnpm", version: undefined });
+console.log(ADDON_NAMES.map((addon) => pnpm.exec("parlor", ["add", addon])));
+```
+
+Docs: https://cychien.github.io/parlor/reference/cli/

package/dist/add/addon.d.ts

@@ -0,0 +1,101 @@
+import type { Op } from "../edit/ops.js";
+/** Stands for `server.entry` from `parlor.config.ts`, wherever the app keeps it. */
+export declare const SERVER_ENTRY: unique symbol;
+export type ProjectFile = string | typeof SERVER_ENTRY;
+/** Folders under `templates/` in this package. `default` is the full default app. */
+export type TemplateName = "default" | "auth";
+/**
+ * Where the project keeps what add-ons touch, from `parlor.config.ts`. Built by the caller
+ * (`parlor add` loads the config), so this package never loads it.
+ */
+export interface ProjectLayout {
+    readonly rootDir: string;
+    readonly serverEntry: string;
+    readonly schemaDir: string;
+    readonly migrationsDir: string;
+    /** The generated route tree, `src/routeTree.gen.ts` unless `web.routeTree` moves it. */
+    readonly routeTree: string;
+}
+/** Payload files import each other by relative path, so they need the default layout. */
+export interface LayoutRequirement {
+    readonly serverAtRoot?: true;
+    readonly schemaDir?: string;
+    readonly routesDir?: string;
+}
+/**
+ * Every file under `dir` of the template, copied to the same path in the project. A file that
+ * already exists is the developer's and is never overwritten.
+ */
+export interface Payload {
+    readonly template: TemplateName;
+    readonly dir: string;
+}
+export interface FileEdit {
+    readonly file: ProjectFile;
+    readonly ops: readonly Op[];
+}
+/**
+ * Renders `<component />` once in the app's UI. Done when any module under `src/` imports
+ * `component` from `module`, wherever the developer put it, so the manual change for a missing
+ * `into` file satisfies the next run.
+ */
+export interface Mount {
+    readonly component: string;
+    /** Project path of the module that exports `component`. */
+    readonly module: string;
+    readonly into: {
+        readonly file: string;
+        readonly parent: string;
+    };
+}
+/**
+ * A pin another installed package owns: `better-auth` is whatever the project's `@parlor/auth`
+ * declares, read from its manifest in `node_modules` after that package is installed.
+ */
+export interface FromPackage {
+    readonly fromPackage: string;
+    readonly dependency: string;
+}
+export type DependencyVersion = 
+/** Exactly this package's version: every `@parlor/*` package releases with it. */
+"framework"
+/** An explicit range, for a third-party package nothing in the framework pins. */
+ | (string & {}) | FromPackage;
+export interface EnvVar {
+    readonly name: string;
+    readonly example: string;
+    readonly description: string;
+}
+/**
+ * A step a framework tool runs after the files are in place. Each kind declares its outputs
+ * through `done`: the plan uses it to skip finished work, the transaction uses it to validate
+ * the staging copy before anything reaches the project.
+ */
+export type Generation = 
+/** `parlor typegen`; done when the route tree lists every route id in `routes`. */
+{
+    readonly kind: "route-tree";
+    readonly routes: readonly string[];
+}
+/** `parlor db generate --name <name>`; done when the latest snapshot has every table. */
+ | {
+    readonly kind: "migration";
+    readonly name: string;
+    readonly tables: readonly string[];
+};
+export interface Addon {
+    /** One line for `parlor add --help` and the docs. */
+    readonly summary: string;
+    readonly requires: LayoutRequirement;
+    readonly dependencies: Readonly<Record<string, DependencyVersion>>;
+    readonly files: readonly Payload[];
+    readonly edits: readonly FileEdit[];
+    readonly mounts: readonly Mount[];
+    /** Lines added to `.env.example` when missing. */
+    readonly env: readonly EnvVar[];
+    readonly generate: readonly Generation[];
+    /** Printed after a run that changed something. */
+    readonly notes: readonly string[];
+}
+export declare function defineAddon<const A extends Addon>(addon: A): A;
+//# sourceMappingURL=addon.d.ts.map

package/dist/add/addon.d.ts.map

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

package/dist/add/addon.js

@@ -0,0 +1,6 @@
+/** Stands for `server.entry` from `parlor.config.ts`, wherever the app keeps it. */
+export const SERVER_ENTRY = Symbol("server entry");
+export function defineAddon(addon) {
+    return addon;
+}
+//# sourceMappingURL=addon.js.map

package/dist/add/addon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addon.js","sourceRoot":"","sources":["../../src/add/addon.ts"],"names":[],"mappings":"AAEA,oFAAoF;AACpF,MAAM,CAAC,MAAM,YAAY,GAAkB,MAAM,CAAC,cAAc,CAAC,CAAC;AAwGlE,MAAM,UAAU,WAAW,CAAwB,KAAQ;IACzD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/add/plan.d.ts

@@ -0,0 +1,72 @@
+import { type AddonName } from "../addons/index.js";
+import type { TemplateFiles } from "../files.js";
+import { type FromPackage, type Generation, type ProjectLayout } from "./addon.js";
+/** The fields of a `package.json` the engine reads. */
+export interface PackageManifest {
+    readonly name?: string;
+    readonly version?: string;
+    readonly dependencies?: Readonly<Record<string, string>>;
+    readonly devDependencies?: Readonly<Record<string, string>>;
+}
+/** Reads the project as it is on disk; tests pass an in-memory map. */
+export interface ProjectFiles {
+    read(path: string): Promise<string | undefined>;
+    /** Project-relative paths of every file under `dir`, recursively, skipping `node_modules`. */
+    list(dir: string): Promise<readonly string[]>;
+    /** The manifest of `name` as installed in the project's `node_modules`; `undefined` when absent. */
+    manifest(name: string): Promise<PackageManifest | undefined>;
+}
+export interface PlannedWrite {
+    readonly path: string;
+    readonly content: string;
+    readonly change: "create" | "update";
+    /** One short line per op or payload, for the printed plan: "auth: createAuth(database)". */
+    readonly summary: readonly string[];
+}
+/**
+ * A dependency the package manager adds; it owns `package.json` and the lockfile, so neither
+ * is a planned write. `version` stays a `FromPackage` until that package is installed, which is
+ * why install runs in two rounds.
+ */
+export interface PlannedDependency {
+    readonly name: string;
+    readonly version: string | FromPackage;
+    readonly dev: boolean;
+}
+/** What to change by hand, for D4: the file, why the tool would not, and the exact change. */
+export interface ManualChange {
+    readonly file: string;
+    readonly reason: string;
+    readonly change: string;
+}
+export type AddPlan = {
+    readonly kind: "done";
+    readonly addons: readonly AddonName[];
+}
+/** Nothing may be written: the developer makes `manual` by hand and runs the command again. */
+ | {
+    readonly kind: "blocked";
+    readonly addons: readonly AddonName[];
+    readonly manual: readonly ManualChange[];
+} | {
+    readonly kind: "ready";
+    readonly addons: readonly AddonName[];
+    /** Every changed file with its whole new content; nothing is written while planning. */
+    readonly writes: readonly PlannedWrite[];
+    readonly dependencies: readonly PlannedDependency[];
+    readonly generate: readonly Generation[];
+    readonly notes: readonly string[];
+};
+/** `fromPackage`'s own pin of `dependency`, as the project has it installed. */
+export declare function resolveFromPackage(version: FromPackage, project: ProjectFiles): Promise<string | undefined>;
+/**
+ * Pure apart from reads. For every add-on, in order, each step is `done`, an edit, or unsafe;
+ * any unsafe step makes the plan `blocked` with every manual change, not just the first.
+ */
+export declare function planAddons(layout: ProjectLayout, addons: readonly AddonName[], project: ProjectFiles, templates: TemplateFiles): Promise<AddPlan>;
+/**
+ * Whether a generation's declared outputs are in `project`: the route tree lists every route
+ * id; the latest drizzle snapshot (the last entry of `meta/_journal.json`) has every table.
+ */
+export declare function generationDone(layout: ProjectLayout, generation: Generation, project: ProjectFiles): Promise<boolean>;
+//# sourceMappingURL=plan.d.ts.map

package/dist/add/plan.d.ts.map

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

package/dist/add/plan.js

@@ -0,0 +1,237 @@
+import { dirname, relative } from "node:path";
+import { ADDONS } from "../addons/index.js";
+import { editSource, evaluateOp, manualCode, opSummary, } from "../edit/ops.js";
+import { parseSource } from "../edit/source.js";
+import { importedName } from "../edit/syntax.js";
+import { FRAMEWORK_VERSION } from "../version.js";
+import { SERVER_ENTRY, } from "./addon.js";
+/** `fromPackage`'s own pin of `dependency`, as the project has it installed. */
+export async function resolveFromPackage(version, project) {
+    const manifest = await project.manifest(version.fromPackage);
+    return (manifest?.dependencies?.[version.dependency] ??
+        manifest?.devDependencies?.[version.dependency]);
+}
+const relativeImport = (from, module) => {
+    const path = relative(dirname(from), module).replace(/\.tsx?$/, ".js");
+    return path.startsWith(".") ? path : `./${path}`;
+};
+const isModule = (path) => /\.(?:ts|tsx)$/.test(path) && !path.endsWith(".d.ts");
+/**
+ * Pure apart from reads. For every add-on, in order, each step is `done`, an edit, or unsafe;
+ * any unsafe step makes the plan `blocked` with every manual change, not just the first.
+ */
+export async function planAddons(layout, addons, project, templates) {
+    const drafts = new Map();
+    const manual = [];
+    const dependencies = [];
+    const generate = [];
+    const notes = [];
+    const read = async (path) => drafts.get(path)?.content ?? (await project.read(path));
+    const write = async (path, content, summary) => {
+        const draft = drafts.get(path);
+        if (draft) {
+            draft.content = content;
+            draft.summary.push(...summary);
+            return;
+        }
+        const exists = (await project.read(path)) !== undefined;
+        drafts.set(path, {
+            content,
+            change: exists ? "update" : "create",
+            summary: [...summary],
+        });
+    };
+    const manifest = JSON.parse((await project.read("package.json")) ?? "{}");
+    const fingerprint = () => JSON.stringify([
+        [...drafts].map(([path, draft]) => [path, draft.content]),
+        dependencies,
+        generate,
+    ]);
+    const listed = (name) => Boolean(manifest.dependencies?.[name] ?? manifest.devDependencies?.[name]);
+    for (const name of addons) {
+        const addon = ADDONS[name];
+        const before = fingerprint();
+        const requirement = unmetRequirement(name, addon, layout);
+        if (requirement) {
+            manual.push(requirement);
+            continue;
+        }
+        for (const payload of addon.files) {
+            for (const path of await templates.list(payload.template, payload.dir)) {
+                if ((await read(path)) === undefined) {
+                    await write(path, await templates.read(payload.template, path), []);
+                }
+            }
+        }
+        const edits = new Map();
+        const addEdit = (file, ops) => edits.set(file, [...(edits.get(file) ?? []), ...ops]);
+        for (const fileEdit of addon.edits) {
+            addEdit(fileEdit.file === SERVER_ENTRY ? layout.serverEntry : fileEdit.file, fileEdit.ops);
+        }
+        for (const mount of addon.mounts) {
+            if (await mounted(mount, project, drafts))
+                continue;
+            addEdit(mount.into.file, [
+                {
+                    kind: "import",
+                    names: [mount.component],
+                    from: relativeImport(mount.into.file, mount.module),
+                },
+                { kind: "jsx-child", component: mount.into.parent, element: mount.component },
+            ]);
+        }
+        for (const [file, ops] of edits) {
+            const text = await read(file);
+            if (text === undefined) {
+                manual.push({
+                    file,
+                    reason: `${file} is missing.`,
+                    change: ops.map((op) => manualCode(op)).join("\n\n"),
+                });
+                continue;
+            }
+            const source = parseSource(file, text);
+            const outcome = editSource(source, ops);
+            if (outcome.status === "done")
+                continue;
+            if (outcome.status === "unsafe") {
+                manual.push(manualFor(file, ops, outcome.unsafe));
+                continue;
+            }
+            const summary = ops
+                .filter((op) => evaluateOp(source, op).status === "edit")
+                .map((op) => opSummary(source, op))
+                .filter((line) => line !== undefined);
+            await write(file, outcome.text, summary);
+        }
+        if (addon.env.length > 0) {
+            const current = (await read(ENV_EXAMPLE)) ?? "";
+            const missing = addon.env.filter((variable) => !new RegExp(`^${variable.name}=`, "m").test(current));
+            if (missing.length > 0) {
+                const lines = missing.map((variable) => `# ${variable.description}\n${variable.name}=${variable.example}\n`);
+                const separator = current === "" || current.endsWith("\n\n")
+                    ? ""
+                    : current.endsWith("\n")
+                        ? "\n"
+                        : "\n\n";
+                await write(ENV_EXAMPLE, `${current}${separator}${lines.join("\n")}`, missing.map((variable) => variable.name));
+            }
+        }
+        for (const [dependency, version] of Object.entries(addon.dependencies)) {
+            if (dependencies.some((planned) => planned.name === dependency))
+                continue;
+            if (listed(dependency))
+                continue;
+            dependencies.push({
+                name: dependency,
+                version: await resolveVersion(version, project),
+                dev: false,
+            });
+        }
+        for (const generation of addon.generate) {
+            if (!(await generationDone(layout, generation, project)))
+                generate.push(generation);
+        }
+        if (fingerprint() !== before)
+            notes.push(...addon.notes);
+    }
+    if (manual.length > 0)
+        return { kind: "blocked", addons, manual };
+    if (drafts.size === 0 && dependencies.length === 0 && generate.length === 0) {
+        return { kind: "done", addons };
+    }
+    return {
+        kind: "ready",
+        addons,
+        writes: [...drafts].map(([path, draft]) => ({ path, ...draft })),
+        dependencies,
+        generate,
+        notes,
+    };
+}
+const ENV_EXAMPLE = ".env.example";
+function unmetRequirement(name, addon, layout) {
+    const { requires } = addon;
+    if (requires.serverAtRoot && layout.serverEntry.includes("/")) {
+        return {
+            file: layout.serverEntry,
+            reason: `${name} needs the server entry at the project root, and it is ${layout.serverEntry}.`,
+            change: `Move ${layout.serverEntry} to server.ts and set server.entry to "server.ts" in parlor.config.ts.`,
+        };
+    }
+    if (requires.schemaDir && layout.schemaDir !== requires.schemaDir) {
+        return {
+            file: "parlor.config.ts",
+            reason: `${name} needs the schema in ${requires.schemaDir}/, and it is in ${layout.schemaDir}.`,
+            change: `Set database.schema to "${requires.schemaDir}" in parlor.config.ts and move the tables there.`,
+        };
+    }
+    const routes = `${dirname(layout.routeTree)}/routes`;
+    if (requires.routesDir && routes !== requires.routesDir) {
+        return {
+            file: "parlor.config.ts",
+            reason: `${name} needs the routes in ${requires.routesDir}/, and they are in ${routes}/.`,
+            change: `Keep web.routeTree at its default so the routes live in ${requires.routesDir}/.`,
+        };
+    }
+    return undefined;
+}
+async function mounted(mount, project, drafts) {
+    const paths = new Set([
+        ...(await project.list("src")),
+        ...[...drafts.keys()].filter((path) => path.startsWith("src/")),
+    ]);
+    for (const path of paths) {
+        if (!isModule(path) || path === mount.module)
+            continue;
+        const text = drafts.get(path)?.content ?? (await project.read(path));
+        if (text === undefined || !text.includes(mount.component))
+            continue;
+        const source = parseSource(path, text);
+        if (importedName(source, mount.component, relativeImport(path, mount.module)))
+            return true;
+    }
+    return false;
+}
+function manualFor(file, ops, failed) {
+    const imports = ops.filter((op) => op.kind === "import").map((op) => manualCode(op));
+    const changes = failed
+        .filter((entry) => entry.op.kind !== "import")
+        .map((entry) => manualCode(entry.op));
+    return {
+        file,
+        reason: [...new Set(failed.map((entry) => entry.reason))].join(" "),
+        change: [...(imports.length > 0 ? [imports.join("\n")] : []), ...changes].join("\n\n"),
+    };
+}
+async function resolveVersion(version, project) {
+    if (version === "framework")
+        return FRAMEWORK_VERSION;
+    if (typeof version === "string")
+        return version;
+    return (await resolveFromPackage(version, project)) ?? version;
+}
+/**
+ * Whether a generation's declared outputs are in `project`: the route tree lists every route
+ * id; the latest drizzle snapshot (the last entry of `meta/_journal.json`) has every table.
+ */
+export async function generationDone(layout, generation, project) {
+    if (generation.kind === "route-tree") {
+        const tree = await project.read(layout.routeTree);
+        return (tree !== undefined &&
+            generation.routes.every((route) => tree.includes(`"${route}"`)));
+    }
+    const journal = await project.read(`${layout.migrationsDir}/meta/_journal.json`);
+    if (journal === undefined)
+        return false;
+    const entries = JSON.parse(journal).entries ?? [];
+    const last = entries.at(-1);
+    if (!last)
+        return false;
+    const snapshot = await project.read(`${layout.migrationsDir}/meta/${String(last.idx).padStart(4, "0")}_snapshot.json`);
+    if (snapshot === undefined)
+        return false;
+    const tables = Object.values(JSON.parse(snapshot).tables ?? {}).map((table) => table.name);
+    return generation.tables.every((table) => tables.includes(table));
+}
+//# sourceMappingURL=plan.js.map

package/dist/add/plan.js.map

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

package/dist/add/run.d.ts

@@ -0,0 +1,92 @@
+import type { AddonName } from "../addons/index.js";
+import { type PackageManager } from "../package-manager.js";
+import type { ProjectLayout } from "./addon.js";
+import { type AddPlan, type ManualChange } from "./plan.js";
+/**
+ * The framework tools a run needs after files are staged. `parlor add` passes the same code
+ * `parlor typegen` and `parlor db generate` run, so this package stays free of the toolchain.
+ * Each takes the directory to run in, because the transaction runs them against the staging
+ * copy, never against the project.
+ */
+export interface AddTools {
+    routeTree(rootDir: string): Promise<void>;
+    migration(rootDir: string, name: string): Promise<void>;
+}
+export interface AddRequest {
+    readonly layout: ProjectLayout;
+    readonly addons: readonly AddonName[];
+    readonly packageManager: PackageManager;
+    readonly tools: AddTools;
+    /** `dry-run` plans and reports without writing or installing. */
+    readonly mode: "apply" | "dry-run";
+    /** `false` (`--no-install`) writes files only and reports the install and generate commands. */
+    readonly install: boolean;
+    /** `false` (`--no-git-check`) skips the refusal on uncommitted changes. */
+    readonly gitCheck: boolean;
+    readonly log: (line: string) => void;
+}
+type ReadyPlan = Extract<AddPlan, {
+    kind: "ready";
+}>;
+export type AddResult = {
+    readonly kind: "done";
+    readonly addons: readonly AddonName[];
+} | {
+    readonly kind: "blocked";
+    readonly addons: readonly AddonName[];
+    readonly manual: readonly ManualChange[];
+} | {
+    readonly kind: "planned";
+    readonly plan: ReadyPlan;
+}
+/** The project has uncommitted changes and `gitCheck` is on: nothing was touched. */
+ | {
+    readonly kind: "dirty";
+    readonly addons: readonly AddonName[];
+    readonly files: readonly string[];
+}
+/** `pending` lists commands skipped by `--no-install`, to run before the next `parlor dev`. */
+ | {
+    readonly kind: "applied";
+    readonly plan: ReadyPlan;
+    /** Files the generators wrote, beyond the plan's own writes. */
+    readonly generated: readonly string[];
+    readonly pending: readonly string[];
+}
+/**
+ * Nothing reached the project: a failed install restored `package.json` and the lockfile; a
+ * failed or unvalidated generation discarded the staging copy and restored them too. Only
+ * `node_modules` may hold more than before, which is a cache, not state.
+ */
+ | {
+    readonly kind: "failed";
+    readonly addons: readonly AddonName[];
+    readonly stage: "install" | "generate";
+    readonly message: string;
+};
+/**
+ * The one entry point behind `parlor add`. A transaction in stages, so a failure never leaves
+ * an app that cannot boot and a crash is finished by the next run (every step it already did
+ * is `done`):
+ *   1. plan (no writes); `blocked`, `done` and `dry-run` return here
+ *   2. git: `uncommittedChanges(rootDir)` non-empty and `gitCheck` -> `dirty`
+ *   3. install: snapshot `package.json` and the lockfile; round one adds every dependency whose
+ *      version is known (`<pm> add`), round two resolves each `FromPackage` from the manifest
+ *      round one installed and adds those; any failure restores the snapshot -> `failed`
+ *   4. stage: `stageProject` copies the tree (minus node_modules, .git, .parlor) into
+ *      `.parlor/add/<run id>/` and lays the planned writes over it
+ *   5. generate: each pending generation's tool runs in the staging dir; `generationDone`
+ *      against the staging copy must then hold, else the copy is discarded -> `failed`
+ *   6. commit: every staged file whose bytes differ from the project is written through a temp
+ *      file and a rename; the staging dir is removed
+ * `install: false` skips 3 and 5; `pending` then names the install commands and a second
+ * `parlor add` to generate.
+ */
+export declare function addAddons(request: AddRequest): Promise<AddResult>;
+/** The terminal text for a result and the exit code: 1 for `blocked`, `dirty` and `failed`, else 0. */
+export declare function formatAddResult(result: AddResult, manager: PackageManager): {
+    readonly text: string;
+    readonly exitCode: 0 | 1;
+};
+export {};
+//# sourceMappingURL=run.d.ts.map

package/dist/add/run.d.ts.map

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