create-we8 0.1.0

package/dist/files.js

@@ -0,0 +1,373 @@
+/**
+ * Every file the scaffolder writes, as pure functions of the answers. Keeping
+ * the contents here rather than inside the directory walk means the generated
+ * project can be asserted on in tests without a filesystem.
+ *
+ * The generated worker is deliberately tiny. The app IS the CMS worker: three
+ * imports, one registration, one default export. Everything a site changes is
+ * configuration, which is why `wrangler.jsonc` is the file with the comments
+ * in it and `src/index.ts` is the file with almost nothing.
+ */
+import { generateWranglerConfig } from '@we8/cloudflare';
+import { WE8_VERSION_RANGE } from './options.js';
+/** The CMS version a fresh project reports from `/v1/health`. */
+export const CMS_VERSION = '0.1.0';
+/**
+ * Registry ranges normally; `file:` paths into a checkout under
+ * `--from-workspace`, which is how this repo proves the scaffolder works
+ * before anything is published. npm links a `file:` directory rather than
+ * copying it, so a rebuild in the checkout is picked up straight away.
+ */
+export function dependencySpecs(options, workspaceRoot) {
+    if (!options.fromWorkspace || !workspaceRoot) {
+        return {
+            cms: WE8_VERSION_RANGE,
+            cloudflare: WE8_VERSION_RANGE,
+            astro: WE8_VERSION_RANGE,
+            client: WE8_VERSION_RANGE,
+            admin: WE8_VERSION_RANGE,
+        };
+    }
+    return {
+        cms: `file:${workspaceRoot}/packages/cms`,
+        cloudflare: `file:${workspaceRoot}/packages/cloudflare`,
+        astro: `file:${workspaceRoot}/packages/astro`,
+        client: `file:${workspaceRoot}/packages/client`,
+        admin: `file:${workspaceRoot}/packages/admin`,
+    };
+}
+/** The project manifest. */
+export function projectPackageJson(options, deps) {
+    const scripts = {
+        dev: 'wrangler dev',
+        deploy: 'wrangler deploy',
+        'db:migrate': 'we8-cloudflare migrate',
+        'db:migrate:remote': 'we8-cloudflare migrate --remote',
+        // Local only, always. The pack's seed command has no remote mode.
+        'db:seed': 'we8-cloudflare seed',
+        doctor: 'we8-cloudflare doctor',
+        'doctor:remote': 'we8-cloudflare doctor --remote',
+        // Copies the built portal into public/ so the worker serves it at /.
+        'admin:bundle': 'node node_modules/@we8/cms/scripts/bundle-admin.mjs --source node_modules/@we8/admin-app/dist --target public',
+        typecheck: 'tsc --noEmit',
+    };
+    if (options.template === 'astro') {
+        scripts['site:dev'] = 'npm run dev --workspace site';
+        scripts['site:build'] = 'npm run build --workspace site';
+    }
+    const manifest = {
+        name: options.projectName,
+        version: '0.1.0',
+        private: true,
+        type: 'module',
+        description: `The we8 CMS backing ${options.siteUrl}.`,
+        ...(options.template === 'astro' ? { workspaces: ['site'] } : {}),
+        scripts,
+        dependencies: {
+            '@we8/admin-app': deps.admin,
+            '@we8/cloudflare': deps.cloudflare,
+            '@we8/cms': deps.cms,
+        },
+        devDependencies: {
+            '@cloudflare/workers-types': '^5.20260705.1',
+            typescript: '^5.7.3',
+            wrangler: '^4.107.0',
+        },
+        engines: { node: options.template === 'astro' ? '>=22.12.0' : '>=20' },
+    };
+    return `${JSON.stringify(manifest, null, 2)}\n`;
+}
+/** The worker. */
+export function workerEntry(options) {
+    return `/**
+ * ${options.projectName}: the we8 CMS worker for ${options.siteUrl}.
+ *
+ * The app IS the CMS worker. @we8/cms brings the routes, the modules, the
+ * embedded auth, and the retention cron; @we8/cloudflare brings the sender
+ * that turns form notifications and password resets into real mail. Everything
+ * else about this site lives in wrangler.jsonc and in the admin API.
+ *
+ * The sender registers itself as a no-op unless this worker is configured for
+ * it (EMAIL_MODE, the EMAIL binding, EMAIL_FROM), so the line below is safe to
+ * leave in place whether or not the site sends mail.
+ *
+ * To add your own routes, import { app } from '@we8/cms', mount them on it,
+ * and export an object of your own instead of re-exporting the default.
+ */
+
+import cms, { registerEmailSender } from '@we8/cms';
+import { cloudflareEmailSender } from '@we8/cloudflare';
+
+registerEmailSender(cloudflareEmailSender);
+
+export default cms;
+`;
+}
+/** The local secrets template. */
+export function devVarsExample() {
+    return `# Copy this to .dev.vars (gitignored) before running \`npm run dev\`.
+
+# The secret Better Auth signs sessions with. REQUIRED: with no value set, the
+# admin API refuses every request rather than validating a session it could not
+# have signed. Generate one with:
+#   openssl rand -hex 32
+BETTER_AUTH_SECRET=
+
+# Optional. Only enforced for forms that switch Turnstile on; unset means
+# Turnstile verification is skipped rather than failed.
+# TURNSTILE_SECRET=
+`;
+}
+/** The project's gitignore. `.dev.vars` is the line that matters. */
+export function gitignore(options) {
+    const lines = [
+        'node_modules/',
+        'dist/',
+        '',
+        '# Wrangler state, including the local D1 database.',
+        '.wrangler/',
+        '',
+        '# Your secrets. Never commit this.',
+        '.dev.vars',
+        '',
+        '# The bundled admin portal; npm run admin:bundle fills it.',
+        'public/*',
+        '!public/.gitkeep',
+        '',
+        '.DS_Store',
+    ];
+    if (options.template === 'astro') {
+        lines.push('', "# The site's generated types and its local configuration.", 'site/.astro/', 'site/.env');
+    }
+    return `${lines.join('\n')}\n`;
+}
+/** The project's tsconfig: enough to typecheck the worker and nothing more. */
+export function tsconfig() {
+    return `${JSON.stringify({
+        compilerOptions: {
+            target: 'ES2022',
+            lib: ['ES2022'],
+            module: 'ESNext',
+            moduleResolution: 'Bundler',
+            moduleDetection: 'force',
+            types: ['@cloudflare/workers-types'],
+            strict: true,
+            noEmit: true,
+            skipLibCheck: true,
+            isolatedModules: true,
+            verbatimModuleSyntax: true,
+        },
+        include: ['src'],
+    }, null, 2)}\n`;
+}
+/** The project's wrangler config, from the pack's generator. */
+export function wranglerConfig(options) {
+    const emailMode = options.email;
+    return generateWranglerConfig({
+        workerName: options.projectName,
+        databaseName: options.databaseName,
+        databaseId: options.databaseId,
+        bucketName: options.bucketName,
+        siteUrl: options.siteUrl,
+        cmsVersion: CMS_VERSION,
+        emailMode,
+        emailFrom: options.emailFrom,
+    });
+}
+/**
+ * The README: the whole path from here to a deployed CMS, as commands that can
+ * be pasted in order. This is the file a stranger reads first and the only
+ * place the ordering constraints (database before migrate, secret before
+ * sign-up) are written down in one list.
+ */
+export function readme(options) {
+    const { projectName, databaseName, bucketName, template } = options;
+    const hasId = Boolean(options.databaseId);
+    const lines = [];
+    const p = (line = '') => {
+        lines.push(line);
+    };
+    p(`# ${projectName}`);
+    p();
+    p(`A we8 CMS on Cloudflare Workers: content, forms, analytics, media, SEO, and`);
+    p('AEO behind a single-site `/v1` API, with an embedded admin login.');
+    if (template === 'astro') {
+        p('The Astro starter site is in `site/` and builds from fixtures until you');
+        p('point it at this CMS.');
+    }
+    p();
+    p('## From here to a live CMS');
+    p();
+    p('Each step depends on the one before it.');
+    p();
+    p('**1. Install.**');
+    p();
+    p('```');
+    p('npm install');
+    p('```');
+    p();
+    p('**2. Sign in to Cloudflare.**');
+    p();
+    p('```');
+    p('npx wrangler login');
+    p('```');
+    p();
+    if (hasId) {
+        p('**3. Create the bucket.** The database already exists and its id is in');
+        p('`wrangler.jsonc`.');
+        p();
+        p('```');
+        p(`npx wrangler r2 bucket create ${bucketName}`);
+        p('```');
+    }
+    else {
+        p('**3. Create the database and the bucket.**');
+        p();
+        p('```');
+        p(`npx wrangler d1 create ${databaseName}`);
+        p(`npx wrangler r2 bucket create ${bucketName}`);
+        p('```');
+        p();
+        p('`d1 create` prints a uuid. Paste it into `wrangler.jsonc`, replacing');
+        p('`REPLACE_WITH_YOUR_D1_DATABASE_ID`.');
+    }
+    p();
+    p('**4. Set the session secret.** The admin API refuses every request without');
+    p('it, so this is not optional.');
+    p();
+    p('```');
+    p('openssl rand -hex 32              # copy the value');
+    p('cp .dev.vars.example .dev.vars    # paste it into BETTER_AUTH_SECRET');
+    p('npx wrangler secret put BETTER_AUTH_SECRET   # paste it again, for the deployment');
+    p('```');
+    p();
+    p('**5. Create the schema.**');
+    p();
+    p('```');
+    p('npm run db:migrate           # the local database');
+    p('npm run db:migrate:remote    # the deployed one');
+    p('```');
+    p();
+    p('**6. Check the wiring.**');
+    p();
+    p('```');
+    p('npm run doctor');
+    p('```');
+    p();
+    p('It names anything still missing and prints the command that fixes it.');
+    p();
+    p('**7. Bundle the admin portal.** The worker serves the portal itself; this');
+    p('copies the built app into `public/`. Skip it to run API-only.');
+    p();
+    p('```');
+    p('npm run admin:bundle');
+    p('```');
+    p();
+    p('**8. Run it locally.**');
+    p();
+    p('```');
+    p('npm run dev');
+    p('```');
+    p();
+    p('Then, in another terminal:');
+    p();
+    p('```');
+    p('curl http://localhost:8787/v1/health');
+    p('```');
+    p();
+    p('**9. Deploy.**');
+    p();
+    p('```');
+    p('npm run deploy');
+    p('```');
+    p();
+    p('Before you deploy for real, set `vars.SITE_URL` in `wrangler.jsonc` to your');
+    p('public origin. The sitemap, `llms.txt`, and the JSON-LD are all built from');
+    p('it, and `npm run doctor:remote` fails a deployment that still says');
+    p('`localhost`.');
+    p();
+    p('**10. Claim the site.** Open `/` in the browser: with the portal bundled,');
+    p('the first visit offers to create the owner account. The first account');
+    p('becomes the owner, and public sign-up closes behind it (API-only installs');
+    p('sign up once at `/api/auth/sign-up/email` instead). Every account after');
+    p('that is created by the owner, in the portal under Setup.');
+    p();
+    p('## Local development data');
+    p();
+    p('```');
+    p('npm run db:seed');
+    p('```');
+    p();
+    p('Loads a working site: settings, an author, a published post, a draft, a');
+    p('contact form, and two API keys. It contains plaintext API keys, so it is');
+    p('local-only by construction: the command has no remote mode and refuses one.');
+    p();
+    if (template === 'astro') {
+        p('## The site');
+        p();
+        p('```');
+        p('npm run site:dev      # the Astro starter on its own port');
+        p('npm run site:build');
+        p('```');
+        p();
+        p('It builds from the fixtures in `site/src/lib/fixtures.ts` until you point');
+        p('it at this CMS. To do that, copy `site/.env.example` to `site/.env` and');
+        p('set:');
+        p();
+        p('```');
+        p('WE8_API_URL=http://localhost:8787');
+        p('WE8_PUBLISHABLE_KEY=pk_...   # from npm run db:seed, or the admin API');
+        p('```');
+        p();
+    }
+    p('## What is bound to what');
+    p();
+    p('| Name | Kind | Required | What it is |');
+    p('| --- | --- | --- | --- |');
+    p('| `DB` | D1 | yes | The site\'s database |');
+    p('| `MEDIA` | R2 | yes | The site\'s media bucket |');
+    p('| `SITE_URL` | var | yes | The site\'s public origin |');
+    p('| `CMS_VERSION` | var | yes | Reported by `/v1/health` |');
+    p('| `BETTER_AUTH_SECRET` | secret | yes | Signs sessions |');
+    p('| `AUTH_URL` | var | no | Where auth builds its URLs; defaults to `SITE_URL` |');
+    p('| `TURNSTILE_SECRET` | secret | no | Only for forms that enable Turnstile |');
+    p('| `EMAIL_MODE` | var | no | `console` logs mail, `cloudflare` sends it, unset drops it |');
+    p('| `EMAIL_FROM` | var | no | The from-address, with `EMAIL_MODE=cloudflare` |');
+    p('| `EMAIL` | send_email | no | The Cloudflare Email Service binding |');
+    p();
+    p('## Sending mail');
+    p();
+    p('Mail is off until it is configured, and a site with no mail configured is a');
+    p('working site: a form submission is stored and returns success whether or');
+    p('not a notification went anywhere. To turn it on:');
+    p();
+    p('1. Onboard the sending domain in the Cloudflare dashboard, under Compute,');
+    p('   Email Service, Email Sending.');
+    p('2. In `wrangler.jsonc`, uncomment the `send_email` binding and set');
+    p('   `vars.EMAIL_MODE` to `"cloudflare"` and `vars.EMAIL_FROM` to an address');
+    p('   on that domain.');
+    p('3. `npm run doctor` confirms it.');
+    p();
+    p('## More');
+    p();
+    p('- `GET /v1/openapi.json` is this API, live and self-describing.');
+    p('- The we8 package documentation: https://github.com/reveriext/we8-package');
+    p();
+    return lines.join('\n');
+}
+/** Everything except the copied template, which is a directory walk rather than a string. */
+export function generatedFiles(options, deps) {
+    return [
+        { path: 'package.json', contents: projectPackageJson(options, deps) },
+        { path: 'wrangler.jsonc', contents: wranglerConfig(options) },
+        { path: 'src/index.ts', contents: workerEntry(options) },
+        { path: 'tsconfig.json', contents: tsconfig() },
+        { path: '.dev.vars.example', contents: devVarsExample() },
+        // Keeps the asset directory present so wrangler finds it before the first
+        // admin:bundle run; the worker serves API-only while it is empty.
+        { path: 'public/.gitkeep', contents: '' },
+        { path: '.gitignore', contents: gitignore(options) },
+        { path: 'README.md', contents: readme(options) },
+    ];
+}
+//# sourceMappingURL=files.js.map

package/dist/files.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `create-we8`: the scaffolder behind `npm create we8`. It assembles a project
+ * that IS the CMS worker plus configuration, and optionally the Astro starter
+ * under `site/`.
+ *
+ * The module surface is here so the scaffolder can be driven from a script as
+ * well as a terminal; `src/cli.ts` is a thin wrapper over it.
+ */
+export { USAGE, WE8_VERSION_RANGE, defaultsFor, directoryName, parseArgs, resolveOptions, toResourceName, type EmailChoice, type ParsedInvocation, type ScaffoldOptions, type TemplateChoice, } from './options.js';
+export { CMS_VERSION, dependencySpecs, devVarsExample, generatedFiles, gitignore, projectPackageJson, readme, tsconfig, workerEntry, wranglerConfig, type DependencySpecs, type GeneratedFile, } from './files.js';
+export { BUNDLED_TEMPLATE_DIR, resolveTemplateDir, resolveWorkspaceRoot, rewriteTemplateManifest, scaffoldProject, type ScaffoldResult, } from './scaffold.js';
+export { promptForAnswers, terminalAsker, type Asker } from './prompts.js';
+/** The published name of this package. */
+export declare const packageName = "create-we8";
+/** The package version line this workspace targets. */
+export declare const packageRelease = "0.1";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,KAAK,EACL,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,SAAS,EACT,cAAc,EACd,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,WAAW,EACX,eAAe,EACf,cAAc,EACd,cAAc,EACd,SAAS,EACT,kBAAkB,EAClB,MAAM,EACN,QAAQ,EACR,WAAW,EACX,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,aAAa,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACvB,eAAe,EACf,KAAK,cAAc,GACpB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,KAAK,KAAK,EAAE,MAAM,cAAc,CAAC;AAE3E,0CAA0C;AAC1C,eAAO,MAAM,WAAW,eAAe,CAAC;AAExC,uDAAuD;AACvD,eAAO,MAAM,cAAc,QAAQ,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * `create-we8`: the scaffolder behind `npm create we8`. It assembles a project
+ * that IS the CMS worker plus configuration, and optionally the Astro starter
+ * under `site/`.
+ *
+ * The module surface is here so the scaffolder can be driven from a script as
+ * well as a terminal; `src/cli.ts` is a thin wrapper over it.
+ */
+export { USAGE, WE8_VERSION_RANGE, defaultsFor, directoryName, parseArgs, resolveOptions, toResourceName, } from './options.js';
+export { CMS_VERSION, dependencySpecs, devVarsExample, generatedFiles, gitignore, projectPackageJson, readme, tsconfig, workerEntry, wranglerConfig, } from './files.js';
+export { BUNDLED_TEMPLATE_DIR, resolveTemplateDir, resolveWorkspaceRoot, rewriteTemplateManifest, scaffoldProject, } from './scaffold.js';
+export { promptForAnswers, terminalAsker } from './prompts.js';
+/** The published name of this package. */
+export const packageName = 'create-we8';
+/** The package version line this workspace targets. */
+export const packageRelease = '0.1';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,KAAK,EACL,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,SAAS,EACT,cAAc,EACd,cAAc,GAKf,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,WAAW,EACX,eAAe,EACf,cAAc,EACd,cAAc,EACd,SAAS,EACT,kBAAkB,EAClB,MAAM,EACN,QAAQ,EACR,WAAW,EACX,cAAc,GAGf,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACvB,eAAe,GAEhB,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAc,MAAM,cAAc,CAAC;AAE3E,0CAA0C;AAC1C,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CAAC;AAExC,uDAAuD;AACvD,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC"}

package/dist/options.d.ts

@@ -0,0 +1,78 @@
+/**
+ * What the scaffolder is being asked for: argument parsing, defaults, and the
+ * validation both the interactive and the non-interactive paths share.
+ *
+ * Nothing here touches the filesystem, so the whole decision layer is testable
+ * on its own, and the prompts become a way of filling in the same structure
+ * rather than a second implementation of it.
+ */
+/** Whether the project also gets the Astro starter under `site/`. */
+export type TemplateChoice = 'astro' | 'none';
+/** How the project sends mail. Mirrors the pack's own modes. */
+export type EmailChoice = 'off' | 'console' | 'cloudflare';
+/** The version line the generated project depends on. */
+export declare const WE8_VERSION_RANGE = "^0.1.0";
+/** Everything the scaffolder needs to write a project. */
+export interface ScaffoldOptions {
+    /** Where the project goes, relative to the working directory or absolute. */
+    directory: string;
+    /** The project, Worker, and package name. */
+    projectName: string;
+    template: TemplateChoice;
+    databaseName: string;
+    bucketName: string;
+    /** A real D1 id when the user already made the database. */
+    databaseId?: string | undefined;
+    siteUrl: string;
+    email: EmailChoice;
+    emailFrom?: string | undefined;
+    /** Write into a directory that already has files in it. */
+    force: boolean;
+    /**
+     * Link the packages from a local checkout instead of the registry. Internal:
+     * this is how the repo tests the scaffolder before anything is published.
+     */
+    fromWorkspace: boolean;
+    /** The checkout to link from, when fromWorkspace is set. */
+    workspaceRoot?: string | undefined;
+    /** Run `npm install` in the new project. */
+    install: boolean;
+    /** Initialise a git repository. */
+    git: boolean;
+}
+/** A parse result: either something to do, or something to print. */
+export interface ParsedInvocation {
+    mode: 'scaffold' | 'help' | 'version';
+    /** Answers given on the command line. Anything absent is prompted for or defaulted. */
+    answers: Partial<ScaffoldOptions>;
+    /** True when the user asked for no questions. */
+    yes: boolean;
+    error?: string;
+}
+export declare const USAGE = "create-we8 - scaffold a we8 CMS project on Cloudflare\n\nUsage:\n  npm create we8 [directory] [options]\n\nOptions:\n  --name <name>           Project, Worker, and package name. Defaults to the\n                          directory name.\n  --template <choice>     astro (the starter site under site/) or none for a\n                          headless-only backend. Default: astro\n  --headless              Shorthand for --template none\n  --site-url <url>        The site's public origin. Default:\n                          http://localhost:8787, which is what local dev wants.\n  --d1-name <name>        D1 database name. Default: <name>\n  --d1-id <uuid>          The id from `wrangler d1 create`, if it already\n                          exists. Left as a placeholder otherwise.\n  --r2-name <name>        R2 bucket name. Default: <name>-media\n  --email <mode>          off, console, or cloudflare. Default: off\n  --email-from <address>  Required with --email cloudflare\n  --force                 Write into a directory that is not empty\n  --no-install            Do not run npm install\n  --no-git                Do not run git init\n  -y, --yes               Take the defaults and ask nothing\n  -h, --help              This\n  -v, --version           The scaffolder version\n\nAfter it finishes, the README in the new project has the exact next commands.\n";
+/** Turns anything a person types into a name Cloudflare accepts, or an empty string. */
+export declare function toResourceName(input: string): string;
+/** The last segment of a path, as a starting point for the project name. */
+export declare function directoryName(directory: string): string;
+/**
+ * Reads argv (without node and the script). A positional argument is the
+ * directory; an unknown flag is an error, because a silently ignored
+ * `--templat` would scaffold the wrong project shape without saying so.
+ */
+export declare function parseArgs(argv: readonly string[]): ParsedInvocation;
+/** The defaults a name implies, so prompts and flags agree on what they mean. */
+export declare function defaultsFor(projectName: string): {
+    databaseName: string;
+    bucketName: string;
+    siteUrl: string;
+};
+/**
+ * Fills a partial set of answers out into a complete one, or says what is
+ * missing. This is the non-interactive path in full: with `--yes` and a
+ * directory, nothing else is required.
+ */
+export declare function resolveOptions(answers: Partial<ScaffoldOptions>, cwd?: string): {
+    options?: ScaffoldOptions;
+    error?: string;
+};
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,qEAAqE;AACrE,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,CAAC;AAE9C,gEAAgE;AAChE,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,SAAS,GAAG,YAAY,CAAC;AAE3D,yDAAyD;AACzD,eAAO,MAAM,iBAAiB,WAAW,CAAC;AAE1C,0DAA0D;AAC1D,MAAM,WAAW,eAAe;IAC9B,6EAA6E;IAC7E,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,cAAc,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,WAAW,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,2DAA2D;IAC3D,KAAK,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,aAAa,EAAE,OAAO,CAAC;IACvB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,4CAA4C;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,mCAAmC;IACnC,GAAG,EAAE,OAAO,CAAC;CACd;AAED,qEAAqE;AACrE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;IACtC,uFAAuF;IACvF,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,CAAC;IAClC,iDAAiD;IACjD,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,KAAK,61CA2BjB,CAAC;AAEF,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAQpD;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGvD;AAOD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,gBAAgB,CA+FnE;AAED,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG;IAChD,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,CASA;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,EACjC,GAAG,GAAE,MAAsB,GAC1B;IACD,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAgEA"}