@wolfstar/http-framework 3.4.0-next-20260903210435 → 3.4.0

package/dist/esm/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","names":["isFile"],"sources":["../../src/lib/config/errors.ts","../../src/lib/config/load.ts","../../src/lib/config/resolve.ts","../../src/lib/config/index.ts","../../src/config.ts"],"sourcesContent":["export interface ConfigErrorOptions {\n\t/** A stable, machine readable code, e.g. `INVALID_TYPE`. */\n\tcode: string;\n\t/** A short, actionable suggestion. */\n\thint?: string;\n\t/** The dotted path of the offending option, e.g. `dev.debounce`. */\n\tpath?: string;\n\t/** The configuration file the error originates from. */\n\tfile?: string | null;\n\tcause?: unknown;\n}\n\n/**\n * A `stars.config.*` error: an invalid option, or a file that failed to load or parse.\n *\n * This is a plain data error (no exit code or terminal formatting) so it stays meaningful outside a CLI, e.g. for a\n * dashboard or test that calls {@link loadStarsConfig} directly. `@wolfstar/cli` maps it to exit code `2` and renders\n * `message`, `path`, `file` and `hint` for the terminal.\n */\nexport class ConfigError extends Error {\n\tpublic readonly code: string;\n\tpublic readonly hint: string | null;\n\tpublic readonly path: string | null;\n\tpublic readonly file: string | null;\n\n\tpublic constructor(message: string, options: ConfigErrorOptions) {\n\t\tsuper(message, options.cause === undefined ? undefined : { cause: options.cause });\n\t\tthis.name = 'ConfigError';\n\t\tthis.code = options.code;\n\t\tthis.hint = options.hint ?? null;\n\t\tthis.path = options.path ?? null;\n\t\tthis.file = options.file ?? null;\n\t}\n}\n","import { existsSync, statSync } from 'node:fs';\nimport { basename, dirname, join, resolve } from 'node:path';\nimport type { StarsConfig } from '../../config.js';\nimport { ConfigError } from './errors.js';\n\nexport const CONFIG_EXTENSIONS = ['ts', 'mts', 'cts', 'js', 'mjs', 'cjs'] as const;\nexport const CONFIG_FILE_NAMES = CONFIG_EXTENSIONS.map((extension) => `stars.config.${extension}`);\n\nexport interface LoadConfigFileOptions {\n\t/** The directory to discover the configuration file from. */\n\tcwd: string;\n\t/** An explicit configuration file (`--config`), resolved from `cwd`. */\n\tconfigFile?: string | null;\n}\n\nexport interface LoadedConfigFile {\n\t/** The absolute path of the loaded file, `null` when running on defaults. */\n\tconfigFile: string | null;\n\tconfig: StarsConfig;\n}\n\n/**\n * Finds the first `stars.config.*` file in `cwd`, in {@link CONFIG_FILE_NAMES} order.\n */\nexport function discoverConfigFile(cwd: string): string | null {\n\tfor (const name of CONFIG_FILE_NAMES) {\n\t\tconst candidate = join(cwd, name);\n\t\tif (isFile(candidate)) return candidate;\n\t}\n\n\treturn null;\n}\n\n/**\n * Loads the raw configuration object. The loader (`c12`) is imported lazily so\n * commands that never touch the configuration stay fast.\n */\nexport async function loadConfigFile(options: LoadConfigFileOptions): Promise<LoadedConfigFile> {\n\tconst cwd = resolve(options.cwd);\n\tlet file: string | null;\n\n\tif (options.configFile) {\n\t\tfile = resolve(cwd, options.configFile);\n\t\tif (!isFile(file)) {\n\t\t\tthrow new ConfigError(`Configuration file not found: ${file}`, {\n\t\t\t\tcode: 'CONFIG_NOT_FOUND',\n\t\t\t\thint: `Pass an existing file to --config, or create one of ${CONFIG_FILE_NAMES.join(', ')} in ${cwd}.`\n\t\t\t});\n\t\t}\n\t} else {\n\t\tfile = discoverConfigFile(cwd);\n\t\tif (!file) return { configFile: null, config: {} };\n\t}\n\n\tconst { loadConfig } = await import('c12');\n\n\tlet loaded: unknown;\n\ttry {\n\t\tconst result = await loadConfig<StarsConfig>({\n\t\t\tname: 'stars',\n\t\t\tcwd: dirname(file),\n\t\t\tconfigFile: basename(file),\n\t\t\trcFile: false,\n\t\t\tglobalRc: false,\n\t\t\tdotenv: false,\n\t\t\tpackageJson: false,\n\t\t\tdefaults: {}\n\t\t});\n\t\t// c12 merges every layer with the defaults, which turns non-object exports into `{}`: inspect the raw layer.\n\t\tconst layer = result.layers?.find(\n\t\t\t(candidate) => candidate.configFile && resolve(candidate.cwd ?? dirname(file), candidate.configFile) === file\n\t\t);\n\t\tloaded = layer ? layer.config : result.config;\n\t} catch (error) {\n\t\tconst message = error instanceof Error ? error.message : String(error);\n\t\tthrow new ConfigError(`Failed to load the configuration: ${message}`, {\n\t\t\tcode: 'CONFIG_LOAD_FAILED',\n\t\t\tfile,\n\t\t\thint: 'The file must be valid TypeScript/JavaScript and export the configuration as its default export.',\n\t\t\tcause: error\n\t\t});\n\t}\n\n\tif (loaded === null || typeof loaded !== 'object' || Array.isArray(loaded)) {\n\t\tthrow new ConfigError('The configuration file must export an object as its default export.', {\n\t\t\tcode: 'CONFIG_NOT_OBJECT',\n\t\t\tfile,\n\t\t\thint: \"Use `export default defineConfig({ ... })` from '@wolfstar/http-framework/config'.\"\n\t\t});\n\t}\n\n\treturn { configFile: file, config: loaded as StarsConfig };\n}\n\nfunction isFile(path: string): boolean {\n\ttry {\n\t\treturn existsSync(path) && statSync(path).isFile();\n\t} catch {\n\t\treturn false;\n\t}\n}\n","import { existsSync, readFileSync, statSync } from 'node:fs';\nimport { basename, dirname, extname, isAbsolute, join, relative, resolve } from 'node:path';\nimport type { StarsBuildTool, StarsConfig, StarsDevConfig, StarsExperimentalConfig, StarsTypechecker } from '../../config.js';\nimport { ConfigError } from './errors.js';\n\nexport interface PackageJsonLike {\n\tname?: string;\n\tversion?: string;\n\tmain?: string;\n\ttype?: string;\n\tscripts?: Record<string, string>;\n\tdependencies?: Record<string, string>;\n\tdevDependencies?: Record<string, string>;\n}\n\nexport interface ResolvedBuildConfig {\n\treadonly tool: StarsBuildTool;\n\t/** Absolute output directory. */\n\treadonly outDir: string;\n\t/** Absolute `tsconfig.json` used by `tsc`, `null` for the other tools. */\n\treadonly tsconfig: string | null;\n\t/** Absolute path of the file `node` runs, i.e. the built entry (or the entry itself when `tool` is `none`). */\n\treadonly output: string;\n}\n\nexport interface ResolvedTypecheckConfig {\n\treadonly enabled: boolean;\n\t/** Absolute `tsconfig.json` the type checker runs against, `null` when it could not be found. */\n\treadonly tsconfig: string | null;\n\t/** The type checker to run, with `'auto'` already resolved. */\n\treadonly checker: StarsTypechecker;\n}\n\nexport type ResolvedTunnelConfig =\n\t| { readonly mode: 'off' }\n\t/** A `cloudflared` quick tunnel, whose hostname is only known once it is up. */\n\t| { readonly mode: 'quick'; readonly path: string; readonly updateEndpoint: boolean }\n\t/** An https URL the user already serves. */\n\t| { readonly mode: 'url'; readonly url: string; readonly path: string; readonly updateEndpoint: boolean };\n\nexport interface ResolvedDevConfig {\n\treadonly watch: readonly string[];\n\treadonly ignore: readonly string[];\n\treadonly debounce: number;\n\treadonly env: Readonly<Record<string, string>>;\n\treadonly nodeArgs: readonly string[];\n\treadonly args: readonly string[];\n\treadonly url: string | null;\n\treadonly health: string | null;\n\treadonly killTimeout: number;\n\treadonly typecheck: ResolvedTypecheckConfig;\n\treadonly tunnel: ResolvedTunnelConfig;\n\t/** Absolute path of the file the dev session's logs are mirrored into, `null` when disabled. */\n\treadonly logFile: string | null;\n}\n\nexport interface ResolvedNitroConfig {\n\treadonly preset: string;\n}\n\nexport interface ResolvedExperimentalConfig {\n\treadonly enableVite: boolean;\n\treadonly enableExternalVite: boolean;\n\treadonly enableNitro: boolean;\n\treadonly nitro: ResolvedNitroConfig;\n}\n\nexport interface ResolvedImportsConfig {\n\treadonly enabled: boolean;\n\t/** Directory glob patterns, relative to the project root (the way `unimport` scans them). */\n\treadonly dirs: readonly string[];\n\treadonly presets: readonly string[];\n\treadonly exclude: readonly string[];\n\t/** Absolute path of the generated declaration file. */\n\treadonly dts: string;\n}\n\nexport interface ResolvedI18nCodegenConfig {\n\treadonly locales: string;\n\treadonly output: string;\n}\n\nexport interface ResolvedCodegenConfig {\n\treadonly i18n: ResolvedI18nCodegenConfig | null;\n}\n\nexport interface ResolvedStarsConfig {\n\t/** Absolute path of the configuration file, `null` when running on defaults. */\n\treadonly configFile: string | null;\n\t/** The directory the CLI was invoked from. */\n\treadonly cwd: string;\n\t/** Absolute project root. */\n\treadonly root: string;\n\treadonly packageJson: PackageJsonLike | null;\n\t/** Absolute source entry. */\n\treadonly entry: string;\n\treadonly build: ResolvedBuildConfig;\n\treadonly dev: ResolvedDevConfig;\n\treadonly codegen: ResolvedCodegenConfig;\n\treadonly imports: ResolvedImportsConfig;\n\treadonly experimental: ResolvedExperimentalConfig;\n\t/** Raw options merged into `vite.config.*`. */\n\treadonly vite: Readonly<Record<string, unknown>>;\n\t/** Raw options merged into `tsdown.config.*`. */\n\treadonly tsdown: Readonly<Record<string, unknown>>;\n}\n\nexport interface ResolveConfigOptions {\n\tcwd: string;\n\tconfigFile: string | null;\n\tconfig: StarsConfig;\n\tenv?: NodeJS.ProcessEnv;\n}\n\nexport const DEFAULT_ENTRIES = ['src/main.ts', 'src/main.js', 'src/index.ts', 'src/index.js'] as const;\nexport const DEFAULT_IGNORE = ['**/node_modules/**', '**/dist/**', '**/.git/**'] as const;\nexport const DEFAULT_DEBOUNCE = 150;\nexport const DEFAULT_KILL_TIMEOUT = 5000;\nexport const DEFAULT_NODE_ARGS = ['--enable-source-maps'] as const;\nexport const DEFAULT_DEV_PORT = 3000;\nexport const DEFAULT_I18N_LOCALES = 'src/locales/en-US';\nexport const DEFAULT_I18N_OUTPUT = 'src/@types/i18next.d.ts';\nexport const DEFAULT_IMPORTS_DIRS = ['src/lib/**', 'src/utils/**'] as const;\nexport const DEFAULT_IMPORTS_PRESETS = ['@wolfstar/http-framework', '@wolfstar/env-utilities'] as const;\nexport const DEFAULT_IMPORTS_DTS = '.stars/imports.d.ts';\nexport const DEFAULT_DEV_LOG_FILE = '.stars/dev.log';\nexport const DEFAULT_TUNNEL_PATH = '/';\n\nconst BUILD_TOOLS = new Set<string>(['tsdown', 'tsc', 'none', 'vite', 'auto']);\nconst TYPECHECKERS = new Set<string>(['tsc', 'golar', 'tsz', 'auto']);\nconst VITE_CONFIG_FILES = ['vite.config.ts', 'vite.config.mts', 'vite.config.cts', 'vite.config.js', 'vite.config.mjs', 'vite.config.cjs'];\nconst TSDOWN_CONFIG_FILES = [\n\t'tsdown.config.ts',\n\t'tsdown.config.mts',\n\t'tsdown.config.cts',\n\t'tsdown.config.js',\n\t'tsdown.config.mjs',\n\t'tsdown.config.cjs',\n\t'tsdown.config.json'\n];\nconst TYPESCRIPT_EXTENSIONS = new Set(['.ts', '.mts', '.cts']);\n\n/**\n * Applies defaults, validates every option and resolves all paths to absolute ones.\n *\n * @throws {ConfigError} with an actionable `hint` on the first invalid option.\n */\nexport function resolveStarsConfig(options: ResolveConfigOptions): ResolvedStarsConfig {\n\tconst cwd = resolve(options.cwd);\n\tconst env = options.env ?? process.env;\n\tconst file = options.configFile;\n\tconst config = options.config;\n\tconst validator = new Validator(file);\n\n\tvalidator.knownKeys(config, '', ['root', 'entry', 'build', 'dev', 'codegen', 'imports', 'experimental', 'vite', 'tsdown']);\n\tconst baseDirectory = file ? dirname(file) : cwd;\n\n\tconst root = resolve(baseDirectory, validator.string(config.root, 'root') ?? '.');\n\tif (!isDirectory(root)) {\n\t\tthrow validator.error(\n\t\t\t`The project root does not exist: ${root}`,\n\t\t\t'root',\n\t\t\t'ROOT_NOT_FOUND',\n\t\t\t'Point `root` to an existing directory, relative to the configuration file.'\n\t\t);\n\t}\n\n\tconst packageJson = readPackageJson(root);\n\tconst experimental = resolveExperimental(config.experimental ?? {}, validator);\n\tconst entry = resolveEntry(root, validator.string(config.entry, 'entry'), validator);\n\tconst build = resolveBuild(root, entry, packageJson, config.build ?? {}, experimental, validator);\n\tconst dev = resolveDev(root, entry, packageJson, config.dev ?? {}, env, validator);\n\tconst codegen = resolveCodegen(root, config.codegen ?? {}, validator);\n\tconst imports = resolveImports(root, build.tool, config.imports, validator);\n\tconst vite = validator.plainObject(config.vite, 'vite') ?? {};\n\tconst tsdown = validator.plainObject(config.tsdown, 'tsdown') ?? {};\n\n\treturn { configFile: file, cwd, root, packageJson, entry, build, dev, codegen, imports, experimental, vite, tsdown };\n}\n\n/**\n * Presents an absolute path relative to `root` when possible, for display purposes.\n */\nexport function displayPath(root: string, path: string): string {\n\tconst rel = relative(root, path);\n\tif (!rel) return '.';\n\treturn rel.startsWith('..') || isAbsolute(rel) ? path : rel;\n}\n\nfunction resolveEntry(root: string, configured: string | undefined, validator: Validator): string {\n\tif (configured !== undefined) {\n\t\tconst entry = resolve(root, configured);\n\t\tif (!isFile(entry)) {\n\t\t\tthrow validator.error(\n\t\t\t\t`The entry file does not exist: ${entry}`,\n\t\t\t\t'entry',\n\t\t\t\t'ENTRY_NOT_FOUND',\n\t\t\t\t'Point `entry` to the file that starts the bot, relative to the project root.'\n\t\t\t);\n\t\t}\n\t\treturn entry;\n\t}\n\n\tfor (const candidate of DEFAULT_ENTRIES) {\n\t\tconst entry = join(root, candidate);\n\t\tif (isFile(entry)) return entry;\n\t}\n\n\tthrow validator.error(\n\t\t`Could not find the entry file in ${root}`,\n\t\t'entry',\n\t\t'ENTRY_NOT_FOUND',\n\t\t`Set \\`entry\\` in the configuration, or create one of ${DEFAULT_ENTRIES.join(', ')}.`\n\t);\n}\n\nfunction resolveBuild(\n\troot: string,\n\tentry: string,\n\tpackageJson: PackageJsonLike | null,\n\tconfig: NonNullable<StarsConfig['build']>,\n\texperimental: ResolvedExperimentalConfig,\n\tvalidator: Validator\n): ResolvedBuildConfig {\n\tvalidator.knownKeys(config, 'build', ['tool', 'outDir', 'tsconfig']);\n\n\tconst requested = validator.string(config.tool, 'build.tool') ?? 'auto';\n\tif (!BUILD_TOOLS.has(requested)) {\n\t\tthrow validator.error(\n\t\t\t`Unknown build tool \"${requested}\"`,\n\t\t\t'build.tool',\n\t\t\t'INVALID_BUILD_TOOL',\n\t\t\t\"Use one of 'tsdown', 'tsc', 'vite', 'none' or 'auto'.\"\n\t\t);\n\t}\n\n\tif (requested === 'vite' && !experimental.enableVite) {\n\t\tthrow validator.error(\n\t\t\t\"The 'vite' build tool is experimental\",\n\t\t\t'build.tool',\n\t\t\t'EXPERIMENT_REQUIRED',\n\t\t\t'Set `experimental.enableVite` to true to use it.'\n\t\t);\n\t}\n\n\tconst isTypeScriptEntry = TYPESCRIPT_EXTENSIONS.has(extname(entry));\n\tconst tool: StarsBuildTool =\n\t\trequested === 'auto' ? detectBuildTool(root, packageJson, isTypeScriptEntry, experimental) : (requested as StarsBuildTool);\n\n\tif (tool === 'none' && isTypeScriptEntry) {\n\t\tthrow validator.error(\n\t\t\t`The entry ${displayPath(root, entry)} is TypeScript but the build tool is 'none'`,\n\t\t\t'build.tool',\n\t\t\t'BUILD_TOOL_REQUIRED',\n\t\t\t\"Set `build.tool` to 'tsdown' or 'tsc', or point `entry` to a JavaScript file.\"\n\t\t);\n\t}\n\n\t// Nitro owns its own output layout; anything else keeps the plain `dist` convention.\n\tconst defaultOutDir = experimental.enableNitro ? '.output' : 'dist';\n\tconst outDir = resolve(root, validator.string(config.outDir, 'build.outDir') ?? defaultOutDir);\n\n\tlet tsconfig: string | null = null;\n\tconst configuredTsconfig = validator.string(config.tsconfig, 'build.tsconfig');\n\tif (configuredTsconfig !== undefined) {\n\t\ttsconfig = resolve(root, configuredTsconfig);\n\t\tif (!isFile(tsconfig)) {\n\t\t\tthrow validator.error(\n\t\t\t\t`The tsconfig file does not exist: ${tsconfig}`,\n\t\t\t\t'build.tsconfig',\n\t\t\t\t'TSCONFIG_NOT_FOUND',\n\t\t\t\t'Point `build.tsconfig` to an existing tsconfig.json, relative to the project root.'\n\t\t\t);\n\t\t}\n\t} else if (tool === 'tsc') {\n\t\ttsconfig = [join(root, 'src', 'tsconfig.json'), join(root, 'tsconfig.json')].find((candidate) => isFile(candidate)) ?? null;\n\t\tif (!tsconfig) {\n\t\t\tthrow validator.error(\n\t\t\t\t`Could not find a tsconfig.json in ${root}`,\n\t\t\t\t'build.tsconfig',\n\t\t\t\t'TSCONFIG_NOT_FOUND',\n\t\t\t\t'Create src/tsconfig.json or tsconfig.json, or set `build.tsconfig`.'\n\t\t\t);\n\t\t}\n\t}\n\n\t// Nitro always writes its server entry to `<outDir>/server/index.mjs`, regardless of the project's own entry\n\t// file name or `package.json#main` — it is Nitro's output, not a build of the project's own entry file.\n\tconst output = experimental.enableNitro\n\t\t? join(outDir, 'server', 'index.mjs')\n\t\t: tool === 'none'\n\t\t\t? entry\n\t\t\t: resolveBuildOutput(root, entry, outDir, packageJson);\n\treturn { tool, outDir, tsconfig, output };\n}\n\nfunction detectBuildTool(\n\troot: string,\n\tpackageJson: PackageJsonLike | null,\n\tisTypeScriptEntry: boolean,\n\texperimental: ResolvedExperimentalConfig\n): StarsBuildTool {\n\t// Vite only wins the detection once the project opted into it; without the flag a `vite.config.*` is somebody\n\t// else's (a dashboard, a docs site) and must not take the bot's build over.\n\tif (experimental.enableVite) {\n\t\tconst hasVite = VITE_CONFIG_FILES.some((name) => isFile(join(root, name))) || hasDependency(packageJson, 'vite');\n\t\tif (hasVite) return 'vite';\n\t}\n\n\tconst hasTsdown = TSDOWN_CONFIG_FILES.some((name) => isFile(join(root, name))) || hasDependency(packageJson, 'tsdown');\n\tif (hasTsdown) return 'tsdown';\n\tif (isTypeScriptEntry) return 'tsc';\n\treturn 'none';\n}\n\n/**\n * Resolves the `experimental` block. Every flag is a boolean defaulting to `false`, the way Nuxt's own experimental\n * flags are declared, and the ones that build on each other are checked here rather than surfacing later as a\n * confusing runtime failure.\n */\nfunction resolveExperimental(config: StarsExperimentalConfig, validator: Validator): ResolvedExperimentalConfig {\n\tif (config === null || typeof config !== 'object' || Array.isArray(config)) {\n\t\tthrow validator.error(\n\t\t\t'`experimental` must be an object',\n\t\t\t'experimental',\n\t\t\t'INVALID_TYPE',\n\t\t\t'Use `{ enableVite, enableExternalVite, enableNitro, nitro }`.'\n\t\t);\n\t}\n\n\tvalidator.knownKeys(config, 'experimental', ['enableVite', 'enableExternalVite', 'enableNitro', 'nitro']);\n\tconst enableVite = validator.boolean(config.enableVite, 'experimental.enableVite') ?? false;\n\tconst enableExternalVite = validator.boolean(config.enableExternalVite, 'experimental.enableExternalVite') ?? false;\n\tconst enableNitro = validator.boolean(config.enableNitro, 'experimental.enableNitro') ?? false;\n\n\tif (enableExternalVite && !enableVite) {\n\t\tthrow validator.error(\n\t\t\t'`experimental.enableExternalVite` needs `experimental.enableVite`',\n\t\t\t'experimental.enableExternalVite',\n\t\t\t'EXPERIMENT_REQUIRED',\n\t\t\t'Set `experimental.enableVite` to true as well, or drop `enableExternalVite`.'\n\t\t);\n\t}\n\n\tif (enableNitro && !enableVite) {\n\t\tthrow validator.error(\n\t\t\t'`experimental.enableNitro` needs `experimental.enableVite`',\n\t\t\t'experimental.enableNitro',\n\t\t\t'EXPERIMENT_REQUIRED',\n\t\t\t'Set `experimental.enableVite` to true as well, or drop `enableNitro`.'\n\t\t);\n\t}\n\n\tconst rawNitro = 'nitro' in config ? config.nitro : undefined;\n\tif (rawNitro !== undefined && !enableNitro) {\n\t\tthrow validator.error(\n\t\t\t'`experimental.nitro` needs `experimental.enableNitro`',\n\t\t\t'experimental.nitro',\n\t\t\t'EXPERIMENT_REQUIRED',\n\t\t\t'Set `experimental.enableNitro` to true as well, or drop `nitro`.'\n\t\t);\n\t}\n\tif (rawNitro !== undefined && (rawNitro === null || typeof rawNitro !== 'object' || Array.isArray(rawNitro))) {\n\t\tthrow validator.error('`experimental.nitro` must be an object', 'experimental.nitro', 'INVALID_TYPE', 'Use `{ preset }`.');\n\t}\n\tif (rawNitro) validator.knownKeys(rawNitro, 'experimental.nitro', ['preset']);\n\tconst preset = validator.string(rawNitro?.preset, 'experimental.nitro.preset') ?? 'node-server';\n\n\treturn { enableVite, enableExternalVite, enableNitro, nitro: { preset } };\n}\n\nfunction resolveBuildOutput(root: string, entry: string, outDir: string, packageJson: PackageJsonLike | null): string {\n\tif (packageJson?.main) return resolve(root, packageJson.main);\n\n\tconst extension = extname(entry);\n\tconst outputExtension = extension === '.mts' ? '.mjs' : extension === '.cts' ? '.cjs' : '.js';\n\treturn join(outDir, `${basename(entry, extension)}${outputExtension}`);\n}\n\nconst ENV_FILES = ['.env.local', '.env'] as const;\nconst ENV_PORT_KEYS = ['HTTP_PORT', 'PORT'] as const;\n\n/**\n * Reads the project's `.env.local`/`.env` into a plain object, the way `stars dev` and `stars commands` need it:\n * these files are only loaded into `process.env` by the bot itself once it starts (see `@wolfstar/env-utilities`),\n * so by the time the CLI runs they are not there yet. This is a minimal line reader, not a full dotenv\n * implementation — quoting is stripped, but expansion (`dotenv-expand`) is not. Earlier files win, matching\n * dotenv's own precedence.\n */\nexport function readProjectEnvFiles(root: string): Record<string, string> {\n\tconst result: Record<string, string> = {};\n\n\tfor (const file of ENV_FILES) {\n\t\tconst path = join(root, file);\n\t\tif (!isFile(path)) continue;\n\n\t\tlet contents: string;\n\t\ttry {\n\t\t\tcontents = readFileSync(path, 'utf-8');\n\t\t} catch {\n\t\t\tcontinue;\n\t\t}\n\n\t\tfor (const line of contents.split(/\\r?\\n/)) {\n\t\t\tconst match = /^\\s*(?:export\\s+)?([A-Za-z_][A-Za-z0-9_]*)\\s*=\\s*(.*)$/.exec(line);\n\t\t\tif (!match) continue;\n\n\t\t\tconst key = match[1]!;\n\t\t\tif (key in result) continue;\n\t\t\tresult[key] = match[2]!.trim().replace(/^['\"]|['\"]$/g, '');\n\t\t}\n\t}\n\n\treturn result;\n}\n\nfunction readDevPortFromEnvFile(root: string): string | null {\n\tconst values = readProjectEnvFiles(root);\n\tfor (const key of ENV_PORT_KEYS) {\n\t\tif (values[key]) return values[key];\n\t}\n\n\treturn null;\n}\n\nfunction resolveDev(\n\troot: string,\n\tentry: string,\n\tpackageJson: PackageJsonLike | null,\n\tconfig: NonNullable<StarsConfig['dev']>,\n\tenv: NodeJS.ProcessEnv,\n\tvalidator: Validator\n): ResolvedDevConfig {\n\tvalidator.knownKeys(config, 'dev', [\n\t\t'watch',\n\t\t'ignore',\n\t\t'debounce',\n\t\t'env',\n\t\t'nodeArgs',\n\t\t'args',\n\t\t'url',\n\t\t'health',\n\t\t'killTimeout',\n\t\t'typecheck',\n\t\t'tunnel',\n\t\t'logFile'\n\t]);\n\n\tconst watch = (validator.stringArray(config.watch, 'dev.watch') ?? [displayPath(root, dirname(entry))]).map((path) => resolve(root, path));\n\tconst ignore = validator.stringArray(config.ignore, 'dev.ignore') ?? [...DEFAULT_IGNORE];\n\tconst debounce = validator.nonNegativeNumber(config.debounce, 'dev.debounce') ?? DEFAULT_DEBOUNCE;\n\tconst devEnv = validator.stringRecord(config.env, 'dev.env') ?? {};\n\tconst nodeArgs = validator.stringArray(config.nodeArgs, 'dev.nodeArgs') ?? [...DEFAULT_NODE_ARGS];\n\tconst args = validator.stringArray(config.args, 'dev.args') ?? [];\n\tconst killTimeout = validator.nonNegativeNumber(config.killTimeout, 'dev.killTimeout') ?? DEFAULT_KILL_TIMEOUT;\n\tconst health = validator.string(config.health, 'dev.health') ?? null;\n\n\tlet url = validator.string(config.url, 'dev.url') ?? null;\n\tif (url !== null) {\n\t\ttry {\n\t\t\tnew URL(url);\n\t\t} catch {\n\t\t\tthrow validator.error(`Invalid URL \"${url}\"`, 'dev.url', 'INVALID_URL', 'Use an absolute URL such as http://localhost:3000.');\n\t\t}\n\t} else {\n\t\t// Mirrors Vite's and Nuxt's own dev servers: a URL is shown without any configuration. The exact host\n\t\t// (`localhost` vs `127.0.0.1`) is resolved at runtime by `stars dev`, once it knows which one is actually reachable.\n\t\tconst port = devEnv.HTTP_PORT ?? env.HTTP_PORT ?? readDevPortFromEnvFile(root) ?? String(DEFAULT_DEV_PORT);\n\t\turl = /^\\d+$/.test(port) ? `http://localhost:${port}` : `http://localhost:${DEFAULT_DEV_PORT}`;\n\t}\n\n\tconst typecheck = resolveTypecheck(root, packageJson, config.typecheck, validator);\n\tconst tunnel = resolveTunnel(config.tunnel, validator);\n\tconst logFile = config.logFile === false ? null : resolve(root, validator.string(config.logFile, 'dev.logFile') ?? DEFAULT_DEV_LOG_FILE);\n\n\treturn { watch, ignore, debounce, env: devEnv, nodeArgs, args, url, health, killTimeout, typecheck, tunnel, logFile };\n}\n\n/**\n * Resolves `dev.typecheck`. The tsconfig is looked up the same way the `tsc` build tool looks up its own, so a\n * project building with `tsdown` still gets `tsc --watch --noEmit` on the right project file.\n */\nfunction resolveTypecheck(\n\troot: string,\n\tpackageJson: PackageJsonLike | null,\n\tconfig: StarsDevConfig['typecheck'],\n\tvalidator: Validator\n): ResolvedTypecheckConfig {\n\tif (config === undefined || config === false) return { enabled: false, tsconfig: null, checker: detectTypechecker(packageJson) };\n\n\tlet configured: string | undefined;\n\tlet requestedChecker = 'auto';\n\tif (config !== true) {\n\t\tif (config === null || typeof config !== 'object' || Array.isArray(config)) {\n\t\t\tthrow validator.error(\n\t\t\t\t'`dev.typecheck` must be a boolean or an object',\n\t\t\t\t'dev.typecheck',\n\t\t\t\t'INVALID_TYPE',\n\t\t\t\t'Use `true` to type-check with the project tsconfig, `{ tsconfig }` to pick one, or `false` to disable it.'\n\t\t\t);\n\t\t}\n\n\t\tvalidator.knownKeys(config, 'dev.typecheck', ['tsconfig', 'checker']);\n\t\tconfigured = validator.string(config.tsconfig, 'dev.typecheck.tsconfig');\n\t\trequestedChecker = validator.string(config.checker, 'dev.typecheck.checker') ?? 'auto';\n\t\tif (!TYPECHECKERS.has(requestedChecker)) {\n\t\t\tthrow validator.error(\n\t\t\t\t`Unknown type checker \"${requestedChecker}\"`,\n\t\t\t\t'dev.typecheck.checker',\n\t\t\t\t'INVALID_TYPECHECKER',\n\t\t\t\t\"Use one of 'tsc', 'golar', 'tsz' or 'auto'.\"\n\t\t\t);\n\t\t}\n\t}\n\n\tconst checker: StarsTypechecker = requestedChecker === 'auto' ? detectTypechecker(packageJson) : (requestedChecker as StarsTypechecker);\n\n\tif (configured !== undefined) {\n\t\tconst tsconfig = resolve(root, configured);\n\t\tif (!isFile(tsconfig)) {\n\t\t\tthrow validator.error(\n\t\t\t\t`The tsconfig file does not exist: ${tsconfig}`,\n\t\t\t\t'dev.typecheck.tsconfig',\n\t\t\t\t'TSCONFIG_NOT_FOUND',\n\t\t\t\t'Point `dev.typecheck.tsconfig` to an existing tsconfig.json, relative to the project root.'\n\t\t\t);\n\t\t}\n\t\treturn { enabled: true, tsconfig, checker };\n\t}\n\n\tconst found = [join(root, 'src', 'tsconfig.json'), join(root, 'tsconfig.json')].find((candidate) => isFile(candidate)) ?? null;\n\tif (!found) {\n\t\tthrow validator.error(\n\t\t\t`Could not find a tsconfig.json in ${root}`,\n\t\t\t'dev.typecheck',\n\t\t\t'TSCONFIG_NOT_FOUND',\n\t\t\t'Create src/tsconfig.json or tsconfig.json, or set `dev.typecheck.tsconfig`.'\n\t\t);\n\t}\n\n\treturn { enabled: true, tsconfig: found, checker };\n}\n\n/**\n * Picks the type checker when `dev.typecheck.checker` is `auto`: `golar` when the project already depends on it\n * (it wraps TypeScript and is what this repository's own `typecheck` scripts run), `tsc` otherwise. `tsz` is never\n * picked automatically — it is an early, tsc-compatible alternative a project opts into.\n */\nfunction detectTypechecker(packageJson: PackageJsonLike | null): StarsTypechecker {\n\treturn hasDependency(packageJson, 'golar') ? 'golar' : 'tsc';\n}\n\n/**\n * Resolves `dev.tunnel`: `true` (or `{}`) opens a `cloudflared` quick tunnel, a string (or `{ url }`) is an https\n * URL the user already serves and the CLI only checks.\n */\nfunction resolveTunnel(config: StarsDevConfig['tunnel'], validator: Validator): ResolvedTunnelConfig {\n\tif (config === undefined || config === false) return { mode: 'off' };\n\n\tlet url: string | undefined;\n\tlet updateEndpoint = false;\n\tlet path = DEFAULT_TUNNEL_PATH;\n\n\tif (typeof config === 'string') {\n\t\turl = config;\n\t} else if (config !== true) {\n\t\tif (config === null || typeof config !== 'object' || Array.isArray(config)) {\n\t\t\tthrow validator.error(\n\t\t\t\t'`dev.tunnel` must be a boolean, an https URL or an object',\n\t\t\t\t'dev.tunnel',\n\t\t\t\t'INVALID_TYPE',\n\t\t\t\t'Use `true` for a cloudflared quick tunnel, an https URL you already serve, or `false` to disable it.'\n\t\t\t);\n\t\t}\n\n\t\tvalidator.knownKeys(config, 'dev.tunnel', ['url', 'updateEndpoint', 'path']);\n\t\turl = validator.string(config.url, 'dev.tunnel.url');\n\t\tupdateEndpoint = validator.boolean(config.updateEndpoint, 'dev.tunnel.updateEndpoint') ?? false;\n\t\tpath = validator.string(config.path, 'dev.tunnel.path') ?? DEFAULT_TUNNEL_PATH;\n\t}\n\n\tif (url === undefined) return { mode: 'quick', path, updateEndpoint };\n\n\t// Discord only accepts an https interactions endpoint.\n\tlet parsed: URL;\n\ttry {\n\t\tparsed = new URL(url);\n\t} catch {\n\t\tthrow validator.error(`Invalid URL \"${url}\"`, 'dev.tunnel', 'INVALID_URL', 'Use an absolute https URL such as https://bot.example.com.');\n\t}\n\n\tif (parsed.protocol !== 'https:') {\n\t\tthrow validator.error(\n\t\t\t`The tunnel URL must be https, received \"${url}\"`,\n\t\t\t'dev.tunnel',\n\t\t\t'INVALID_URL',\n\t\t\t'Discord only accepts an https interactions endpoint.'\n\t\t);\n\t}\n\n\treturn { mode: 'url', url, path, updateEndpoint };\n}\n\nfunction resolveCodegen(root: string, config: NonNullable<StarsConfig['codegen']>, validator: Validator): ResolvedCodegenConfig {\n\tvalidator.knownKeys(config, 'codegen', ['i18n']);\n\n\tif (config.i18n === false) return { i18n: null };\n\n\tif (config.i18n === undefined) {\n\t\tconst locales = join(root, DEFAULT_I18N_LOCALES);\n\t\treturn { i18n: isDirectory(locales) ? { locales, output: join(root, DEFAULT_I18N_OUTPUT) } : null };\n\t}\n\n\tif (config.i18n === null || typeof config.i18n !== 'object') {\n\t\tthrow validator.error(\n\t\t\t'`codegen.i18n` must be an object or `false`',\n\t\t\t'codegen.i18n',\n\t\t\t'INVALID_TYPE',\n\t\t\t'Use `{ locales, output }` to configure it or `false` to disable it.'\n\t\t);\n\t}\n\n\tvalidator.knownKeys(config.i18n, 'codegen.i18n', ['locales', 'output']);\n\tconst locales = resolve(root, validator.string(config.i18n.locales, 'codegen.i18n.locales') ?? DEFAULT_I18N_LOCALES);\n\tif (!isDirectory(locales)) {\n\t\tthrow validator.error(\n\t\t\t`The locales directory does not exist: ${locales}`,\n\t\t\t'codegen.i18n.locales',\n\t\t\t'LOCALES_NOT_FOUND',\n\t\t\t'Point `codegen.i18n.locales` to the base locale directory, relative to the project root.'\n\t\t);\n\t}\n\n\tconst output = resolve(root, validator.string(config.i18n.output, 'codegen.i18n.output') ?? DEFAULT_I18N_OUTPUT);\n\treturn { i18n: { locales, output } };\n}\n\n/**\n * The transform that injects auto imports (`@wolfstar/http-framework/auto-imports`) only runs through `tsdown`'s\n * rolldown pipeline, the same way Nuxt's own auto imports only run through its Vite/webpack build: `tsc` and `none`\n * have no transform step to hook into. `tsdown` is picked as `build.tool` first (see {@link detectBuildTool}) for the\n * same reason — it is the only tool this feature, and this build config in general, treats as the default choice.\n */\nfunction resolveImports(root: string, buildTool: StarsBuildTool, config: StarsConfig['imports'], validator: Validator): ResolvedImportsConfig {\n\tconst defaultDirs = DEFAULT_IMPORTS_DIRS.map((dir) => resolve(root, dir));\n\tconst defaultPresets = [...DEFAULT_IMPORTS_PRESETS];\n\tconst defaultDts = resolve(root, DEFAULT_IMPORTS_DTS);\n\n\tif (config === false) {\n\t\treturn { enabled: false, dirs: defaultDirs, presets: defaultPresets, exclude: [], dts: defaultDts };\n\t}\n\n\tconst forcedOn = config === true;\n\tconst options = forcedOn || config === undefined ? {} : config;\n\tif (typeof options !== 'object' || options === null || Array.isArray(options)) {\n\t\tthrow validator.error(\n\t\t\t'`imports` must be an object, `true` or `false`',\n\t\t\t'imports',\n\t\t\t'INVALID_TYPE',\n\t\t\t'Use `{ dirs, presets, exclude, dts }`, `true` to enable with defaults, or `false` to disable.'\n\t\t);\n\t}\n\n\tvalidator.knownKeys(options, 'imports', ['enabled', 'dirs', 'presets', 'exclude', 'dts']);\n\n\tconst requestedOn = forcedOn || validator.boolean(options.enabled, 'imports.enabled');\n\tif (requestedOn && buildTool !== 'tsdown') {\n\t\tthrow validator.error(\n\t\t\t'`imports` requires the `tsdown` build tool',\n\t\t\t'imports.enabled',\n\t\t\t'IMPORTS_REQUIRE_TSDOWN',\n\t\t\t\"Set `build.tool` to 'tsdown', or remove `imports`/set it to `false`.\"\n\t\t);\n\t}\n\n\tconst dirs = (validator.stringArray(options.dirs, 'imports.dirs') ?? [...DEFAULT_IMPORTS_DIRS]).map((dir) => resolve(root, dir));\n\tconst presets = validator.stringArray(options.presets, 'imports.presets') ?? defaultPresets;\n\tconst exclude = validator.stringArray(options.exclude, 'imports.exclude') ?? [];\n\tconst dts = resolve(root, validator.string(options.dts, 'imports.dts') ?? DEFAULT_IMPORTS_DTS);\n\n\treturn { enabled: requestedOn ?? buildTool === 'tsdown', dirs, presets, exclude, dts };\n}\n\nclass Validator {\n\tpublic constructor(private readonly file: string | null) {}\n\n\tpublic error(message: string, path: string, code: string, hint: string): ConfigError {\n\t\treturn new ConfigError(message, { code, path, hint, file: this.file });\n\t}\n\n\tpublic knownKeys(value: object, path: string, keys: readonly string[]): void {\n\t\tfor (const key of Object.keys(value)) {\n\t\t\tif (keys.includes(key)) continue;\n\t\t\tconst fullPath = path ? `${path}.${key}` : key;\n\t\t\tthrow this.error(\n\t\t\t\t`Unknown option \\`${fullPath}\\``,\n\t\t\t\tfullPath,\n\t\t\t\t'UNKNOWN_OPTION',\n\t\t\t\t`Known options${path ? ` of \\`${path}\\`` : ''}: ${keys.join(', ')}.`\n\t\t\t);\n\t\t}\n\t}\n\n\tpublic string(value: unknown, path: string): string | undefined {\n\t\tif (value === undefined) return undefined;\n\t\tif (typeof value !== 'string' || value.length === 0) throw this.typeError(path, 'a non-empty string', value);\n\t\treturn value;\n\t}\n\n\tpublic boolean(value: unknown, path: string): boolean | undefined {\n\t\tif (value === undefined) return undefined;\n\t\tif (typeof value !== 'boolean') throw this.typeError(path, 'a boolean', value);\n\t\treturn value;\n\t}\n\n\t/** A plain object passed through as-is (e.g. raw `vite`/`tsdown` config merged into the project's own). */\n\tpublic plainObject(value: unknown, path: string): Record<string, unknown> | undefined {\n\t\tif (value === undefined) return undefined;\n\t\tif (value === null || typeof value !== 'object' || Array.isArray(value)) throw this.typeError(path, 'an object', value);\n\t\treturn value as Record<string, unknown>;\n\t}\n\n\tpublic stringArray(value: unknown, path: string): string[] | undefined {\n\t\tif (value === undefined) return undefined;\n\t\tif (!Array.isArray(value) || !value.every((item) => typeof item === 'string')) throw this.typeError(path, 'an array of strings', value);\n\t\treturn value;\n\t}\n\n\tpublic nonNegativeNumber(value: unknown, path: string): number | undefined {\n\t\tif (value === undefined) return undefined;\n\t\tif (typeof value !== 'number' || !Number.isFinite(value) || value < 0) throw this.typeError(path, 'a non-negative number', value);\n\t\treturn value;\n\t}\n\n\tpublic stringRecord(value: unknown, path: string): Record<string, string> | undefined {\n\t\tif (value === undefined) return undefined;\n\t\tif (value === null || typeof value !== 'object' || Array.isArray(value) || !Object.values(value).every((item) => typeof item === 'string')) {\n\t\t\tthrow this.typeError(path, 'an object of string values', value);\n\t\t}\n\t\treturn value as Record<string, string>;\n\t}\n\n\tprivate typeError(path: string, expected: string, value: unknown): ConfigError {\n\t\treturn this.error(\n\t\t\t`\\`${path}\\` must be ${expected}, received ${describe(value)}`,\n\t\t\tpath,\n\t\t\t'INVALID_TYPE',\n\t\t\t`Set \\`${path}\\` to ${expected} or remove it to use the default.`\n\t\t);\n\t}\n}\n\nfunction describe(value: unknown): string {\n\tif (value === null) return 'null';\n\tif (Array.isArray(value)) return 'an array';\n\tif (typeof value === 'string') return `\"${value}\"`;\n\treturn typeof value === 'object' ? 'an object' : `${typeof value} ${String(value)}`;\n}\n\nfunction hasDependency(packageJson: PackageJsonLike | null, name: string): boolean {\n\treturn Boolean(packageJson?.dependencies?.[name] ?? packageJson?.devDependencies?.[name]);\n}\n\nfunction readPackageJson(root: string): PackageJsonLike | null {\n\tconst file = join(root, 'package.json');\n\tif (!isFile(file)) return null;\n\n\ttry {\n\t\tconst parsed: unknown = JSON.parse(readFileSync(file, 'utf-8'));\n\t\treturn parsed !== null && typeof parsed === 'object' ? (parsed as PackageJsonLike) : null;\n\t} catch (error) {\n\t\tthrow new ConfigError(`Failed to parse ${file}: ${error instanceof Error ? error.message : String(error)}`, {\n\t\t\tcode: 'PACKAGE_JSON_INVALID',\n\t\t\thint: 'Fix the JSON syntax of the package.json file.',\n\t\t\tcause: error\n\t\t});\n\t}\n}\n\nfunction isFile(path: string): boolean {\n\ttry {\n\t\treturn existsSync(path) && statSync(path).isFile();\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nfunction isDirectory(path: string): boolean {\n\ttry {\n\t\treturn existsSync(path) && statSync(path).isDirectory();\n\t} catch {\n\t\treturn false;\n\t}\n}\n","import { loadConfigFile } from './load.js';\nimport { resolveStarsConfig, type ResolvedStarsConfig } from './resolve.js';\n\nexport interface LoadStarsConfigOptions {\n\t/**\n\t * The directory to discover `stars.config.*` from.\n\t * @default process.cwd()\n\t */\n\tcwd?: string;\n\t/** An explicit configuration file, resolved from `cwd`. */\n\tconfigFile?: string | null;\n\t/**\n\t * Environment used for defaults such as `HTTP_PORT`.\n\t * @default process.env\n\t */\n\tenv?: NodeJS.ProcessEnv;\n}\n\n/**\n * Loads, validates and resolves a project's `stars.config.*`.\n *\n * @throws {ConfigError} when the configuration file cannot be loaded or contains an invalid option.\n */\nexport async function loadStarsConfig(options: LoadStarsConfigOptions = {}): Promise<ResolvedStarsConfig> {\n\tconst cwd = options.cwd ?? process.cwd();\n\tconst loaded = await loadConfigFile({ cwd, configFile: options.configFile });\n\treturn resolveStarsConfig({ cwd, configFile: loaded.configFile, config: loaded.config, env: options.env });\n}\n\nexport { CONFIG_EXTENSIONS, CONFIG_FILE_NAMES, discoverConfigFile, loadConfigFile } from './load.js';\nexport type { LoadConfigFileOptions, LoadedConfigFile } from './load.js';\nexport { ConfigError } from './errors.js';\nexport type { ConfigErrorOptions } from './errors.js';\nexport { displayPath, readProjectEnvFiles, resolveStarsConfig } from './resolve.js';\nexport type {\n\tPackageJsonLike,\n\tResolveConfigOptions,\n\tResolvedBuildConfig,\n\tResolvedCodegenConfig,\n\tResolvedDevConfig,\n\tResolvedExperimentalConfig,\n\tResolvedNitroConfig,\n\tResolvedI18nCodegenConfig,\n\tResolvedImportsConfig,\n\tResolvedStarsConfig,\n\tResolvedTunnelConfig,\n\tResolvedTypecheckConfig\n} from './resolve.js';\n","/**\n * Public, side-effect free configuration surface of `@wolfstar/cli`.\n *\n * This module is intentionally tiny: importing it from a `stars.config.ts`\n * file must never start the bot nor pull the heavy runtime of the CLI.\n *\n * @module @wolfstar/http-framework/config\n */\n\n/**\n * The build tool used to turn the project sources into runnable JavaScript.\n *\n * - `tsdown`: run the project's own `tsdown` (configuration file included) programmatically.\n * - `tsc`: run the project's `tsc -b` on the configured `tsconfig`.\n * - `vite`: run the project's own `vite` (configuration file included), requires `experimental.enableVite`.\n * - `none`: the entry is runnable as-is (JavaScript projects), no build step.\n * - `auto`: detect from the project (default).\n */\nexport type StarsBuildTool = 'tsdown' | 'tsc' | 'none' | 'vite';\n\nexport interface StarsBuildConfig {\n\t/**\n\t * The build tool to use.\n\t * @default 'auto'\n\t */\n\ttool?: StarsBuildTool | 'auto';\n\t/**\n\t * The directory, relative to {@link StarsConfig.root}, the build writes into.\n\t * @default 'dist', or '.output' when `experimental.enableNitro` is on (Nitro's own convention)\n\t */\n\toutDir?: string;\n\t/**\n\t * The `tsconfig.json` used by the `tsc` build tool, relative to {@link StarsConfig.root}.\n\t * @default 'src/tsconfig.json' when it exists, 'tsconfig.json' otherwise\n\t */\n\ttsconfig?: string;\n}\n\n/**\n * Raw options merged into the project's own `vite.config.*`, the way `vite: {}` in a Nuxt config is merged into\n * Nuxt's own Vite config. Kept as `unknown` here (the CLI, not the framework, depends on `vite`'s types) and passed\n * to Vite's `mergeConfig` as-is.\n */\nexport type StarsViteConfig = Record<string, unknown>;\n\n/**\n * Raw options merged into the project's own `tsdown.config.*`.\n */\nexport type StarsTsdownConfig = Record<string, unknown>;\n\n/**\n * The type checker `stars dev` runs next to the bot.\n *\n * - `tsc`: the project's own TypeScript, in watch mode.\n * - `golar`: the project's `golar`, forwarding to TypeScript (`golar tsc`), in watch mode.\n * - `tsz`: the project's `tsz` (or `try-tsz`). It has no watch mode, so it is re-run after every build instead.\n * - `auto`: `golar` when the project depends on it, `tsc` otherwise (default).\n */\nexport type StarsTypechecker = 'tsc' | 'golar' | 'tsz';\n\nexport interface StarsTypecheckConfig {\n\t/**\n\t * The `tsconfig.json` the type checker runs against, relative to {@link StarsConfig.root}.\n\t * @default the build tool's tsconfig, 'src/tsconfig.json' or 'tsconfig.json'\n\t */\n\ttsconfig?: string;\n\t/**\n\t * Which type checker to run.\n\t * @default 'auto'\n\t */\n\tchecker?: StarsTypechecker | 'auto';\n}\n\nexport interface StarsTunnelConfig {\n\t/**\n\t * An https URL you already serve; when unset a `cloudflared` quick tunnel is opened instead.\n\t */\n\turl?: string;\n\t/**\n\t * Writes the tunnel's URL to the Discord application's `interactions_endpoint_url` when it changes.\n\t *\n\t * This edits a live Discord application, so it is opt-in: it needs `DISCORD_TOKEN` and `DISCORD_APPLICATION_ID`\n\t * (or `APPLICATION_ID`) in the environment or the project's `.env`.\n\t * @default false\n\t */\n\tupdateEndpoint?: boolean;\n\t/**\n\t * The path the interactions endpoint is served on, appended to the tunnel URL.\n\t * @default '/'\n\t */\n\tpath?: string;\n}\n\nexport interface StarsDevConfig {\n\t/**\n\t * Extra paths to watch, relative to {@link StarsConfig.root}. Only used when\n\t * the build tool is `none`; `tsdown` and `tsc` watch through their own build.\n\t * @default [dirname(entry)]\n\t */\n\twatch?: string[];\n\t/**\n\t * Glob patterns or paths to ignore while watching, relative to {@link StarsConfig.root}.\n\t * @default ['**\\/node_modules/**', '**\\/dist/**', '**\\/.git/**']\n\t */\n\tignore?: string[];\n\t/**\n\t * Milliseconds to wait after a change before restarting the bot.\n\t * @default 150\n\t */\n\tdebounce?: number;\n\t/**\n\t * Environment variables added to the bot process.\n\t */\n\tenv?: Record<string, string>;\n\t/**\n\t * Arguments passed to `node` before the entry file.\n\t * @default ['--enable-source-maps']\n\t */\n\tnodeArgs?: string[];\n\t/**\n\t * Arguments passed to the bot after the entry file.\n\t * @default []\n\t */\n\targs?: string[];\n\t/**\n\t * The URL the bot listens on, shown in the dev UI's status line and used for {@link StarsDevConfig.health}.\n\t *\n\t * Resolved automatically, the way Vite's and Nuxt's dev servers do, from (in order) `dev.env.HTTP_PORT`, the\n\t * process's `HTTP_PORT`, the project's `.env.local`/`.env` (`HTTP_PORT` or `PORT`), or `3000`. `stars dev` also\n\t * resolves whether `localhost` should be shown as `127.0.0.1` instead, the same DNS-order check Vite does, so the\n\t * printed URL is always the one that is actually reachable.\n\t * @default `http://localhost:3000` (or whichever port is found)\n\t */\n\turl?: string;\n\t/**\n\t * A path, relative to {@link StarsDevConfig.url}, polled to report the bot's health in the dev UI.\n\t * When unset the dev UI only reports process state.\n\t */\n\thealth?: string;\n\t/**\n\t * Milliseconds to wait for the bot to exit after `SIGTERM` before killing it.\n\t * @default 5000\n\t */\n\tkillTimeout?: number;\n\t/**\n\t * Runs a type checker next to the bot and reports type errors on the dev UI's `tsc` channel, without blocking\n\t * builds or restarts. `true` uses the project's own tsconfig and type checker, an object picks either\n\t * ({@link StarsTypecheckConfig.checker}).\n\t * @default false\n\t */\n\ttypecheck?: boolean | StarsTypecheckConfig;\n\t/**\n\t * Exposes the bot's HTTP interactions endpoint publicly while `stars dev` runs, so Discord can reach it.\n\t *\n\t * `true` opens a `cloudflared` quick tunnel (its hostname changes on every run), a string is an https URL you\n\t * already serve yourself (named tunnel, reverse proxy, …) that the CLI only checks for reachability.\n\t * @default false\n\t */\n\ttunnel?: boolean | string | StarsTunnelConfig;\n\t/**\n\t * The file `stars dev` mirrors its logs into, relative to {@link StarsConfig.root}, so a session can be read back\n\t * after the terminal UI is gone. `false` disables it.\n\t * @default '.stars/dev.log'\n\t */\n\tlogFile?: string | false;\n}\n\nexport interface StarsI18nCodegenConfig {\n\t/**\n\t * The base locale directory, relative to {@link StarsConfig.root}.\n\t * @default 'src/locales/en-US'\n\t */\n\tlocales?: string;\n\t/**\n\t * The generated declaration file, relative to {@link StarsConfig.root}.\n\t * @default 'src/@types/i18next.d.ts'\n\t */\n\toutput?: string;\n}\n\nexport interface StarsCodegenConfig {\n\t/**\n\t * i18next type generation through `@wolfstar/i18next-type-generator`.\n\t * `false` disables it, an object enables it, unset auto-detects from the presence of the locales directory.\n\t */\n\ti18n?: StarsI18nCodegenConfig | false;\n}\n\nexport interface StarsImportsConfig {\n\t/**\n\t * Whether auto imports are enabled. Requires the `tsdown` build tool: the imports are injected at build time by\n\t * the `autoImports()` plugin from `@wolfstar/http-framework/auto-imports`, which the other tools cannot run.\n\t * @default true when the build tool is 'tsdown', false otherwise\n\t */\n\tenabled?: boolean;\n\t/**\n\t * Directories, relative to {@link StarsConfig.root}, whose exported values are auto-importable. Entries are glob\n\t * path patterns: `'src/lib'` scans only the files directly inside it, `'src/lib/**'` scans recursively.\n\t * @default ['src/lib/**', 'src/utils/**']\n\t */\n\tdirs?: string[];\n\t/**\n\t * Packages whose exports are auto-importable. Packages that are not installed are skipped.\n\t * @default ['@wolfstar/http-framework', '@wolfstar/env-utilities']\n\t */\n\tpresets?: string[];\n\t/**\n\t * Export names excluded from auto imports, e.g. to avoid clashes with project-local names.\n\t * @default []\n\t */\n\texclude?: string[];\n\t/**\n\t * The generated declaration file that types the auto imports, relative to {@link StarsConfig.root}.\n\t * Include it in the project's tsconfig and add its directory to .gitignore.\n\t * @default '.stars/imports.d.ts'\n\t */\n\tdts?: string;\n}\n\n/**\n * The [Nitro preset](https://nitro.build/deploy) `stars build` targets, only reachable once\n * {@link StarsExperimentalConfig.enableNitro} (itself gated on {@link StarsExperimentalConfig.enableVite}) is `true`\n * — see {@link StarsExperimentalConfig}.\n */\nexport interface StarsNitroConfig {\n\t/**\n\t * `'node-server'` (the default, runs locally with plain `node`), `'cloudflare-module'`, `'aws-lambda'`,\n\t * `'vercel'`, `'netlify'`, `'bun'`, `'deno-deploy'`, and more — see Nitro's own preset list.\n\t * @default 'node-server'\n\t */\n\tpreset?: string;\n}\n\n/**\n * Opt-in flags for work that is still landing, in the shape Nuxt's own `experimental` block has: every flag is a\n * boolean, defaults to `false`, and is documented with what it changes and what it still needs. A flag stays here\n * until the behaviour it guards is the default (or is dropped), so enabling one is a statement that breakage is\n * acceptable in exchange for the feature.\n *\n * `enableExternalVite`, `enableNitro` and `nitro` build on `enableVite` (and `nitro` on `enableNitro` too): the type\n * only accepts them once their prerequisite is `true`, so turning one on without the other is a type error here\n * instead of a `ConfigError` at load time.\n */\nexport type StarsExperimentalConfig =\n\t| { enableVite?: false; enableExternalVite?: false; enableNitro?: false }\n\t| {\n\t\t\t/**\n\t\t\t * Uses Vite as the project's build tool, in place of `tsdown`. `build.tool` may then be set to `'vite'`\n\t\t\t * (and `'auto'` detects a `vite.config.*`); the bot keeps calling `client.listen()` and running as a\n\t\t\t * plain `node:http` process, restarted on every change — this only swaps the bundler.\n\t\t\t */\n\t\t\tenableVite: true;\n\t\t\t/**\n\t\t\t * Runs the bot through Vite itself, the way `nuxt dev` runs on Vite's own dev server: instead of\n\t\t\t * building then restarting a child `node` process on every change, `stars dev` loads the entry through\n\t\t\t * Vite's SSR module graph and serves it — through `@wolfstar/http-framework/fetch`'s\n\t\t\t * `createFetchHandler` — from one long-lived process, invalidating and re-evaluating just the entry's\n\t\t\t * module graph on a change instead of restarting.\n\t\t\t *\n\t\t\t * With this on, the entry's default export must be the `Client` instance (already `load()`ed, not\n\t\t\t * `listen()`ed) rather than a script that calls `client.listen()` itself — `stars dev` owns the socket.\n\t\t\t * @default false\n\t\t\t */\n\t\t\tenableExternalVite?: boolean;\n\t\t\tenableNitro?: false;\n\t  }\n\t| {\n\t\t\tenableVite: true;\n\t\t\tenableExternalVite?: boolean;\n\t\t\t/**\n\t\t\t * Builds the bot through [Nitro](https://nitro.build) instead of a `node:http` server, so `stars build`\n\t\t\t * produces a server deployable to any of Nitro's presets (`node-server` locally, `cloudflare-module`,\n\t\t\t * `aws-lambda`, `vercel`, `netlify`, `bun`, `deno-deploy`, and more) from the same\n\t\t\t * `@wolfstar/http-framework/fetch` handler `enableExternalVite` already runs in dev — no per-platform\n\t\t\t * adapter to maintain.\n\t\t\t *\n\t\t\t * Output goes to `.output/` (Nitro's own convention) instead of `build.outDir`. The entry's default\n\t\t\t * export must be the `Client` instance, the same as `enableExternalVite`.\n\t\t\t */\n\t\t\tenableNitro: true;\n\t\t\t/** Nitro-specific options, reachable only with `enableNitro: true`. */\n\t\t\tnitro?: StarsNitroConfig;\n\t  };\n\nexport interface StarsConfig {\n\t/**\n\t * The project root. Relative paths are resolved from the configuration file.\n\t * @default dirname(configFile)\n\t */\n\troot?: string;\n\t/**\n\t * The source entry point of the bot, relative to {@link StarsConfig.root}.\n\t * @default the first of 'src/main.ts', 'src/main.js', 'src/index.ts', 'src/index.js' that exists\n\t */\n\tentry?: string;\n\tbuild?: StarsBuildConfig;\n\tdev?: StarsDevConfig;\n\tcodegen?: StarsCodegenConfig;\n\t/**\n\t * Nuxt-style auto imports of the framework's exports and the project's own modules.\n\t * `false` disables them, `true` forces them on (requires the `tsdown` build tool).\n\t */\n\timports?: StarsImportsConfig | boolean;\n\t/** Opt-in flags for behaviour that is still landing. */\n\texperimental?: StarsExperimentalConfig;\n\t/**\n\t * Raw options merged into `vite.config.*`, the way `vite: {}` in a Nuxt config is merged into Nuxt's own Vite\n\t * config. Only used with `build.tool: 'vite'` (see `experimental.enableVite`).\n\t */\n\tvite?: StarsViteConfig;\n\t/**\n\t * Raw options merged into `tsdown.config.*`. Only used with `build.tool: 'tsdown'`.\n\t */\n\ttsdown?: StarsTsdownConfig;\n}\n\n/**\n * Typed helper for `stars.config.{ts,mts,cts,js,mjs,cjs}` files.\n *\n * @example\n * ```ts\n * import { defineConfig } from '@wolfstar/http-framework/config';\n *\n * export default defineConfig({\n * \tentry: 'src/main.ts',\n * \tbuild: { tool: 'tsdown' }\n * });\n * ```\n */\nexport function defineConfig(config: StarsConfig): StarsConfig {\n\treturn config;\n}\n\nexport * from './lib/config/index.js';\n"],"mappings":"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"}

package/dist/esm/defineProperty-BFrI-_1n.js

@@ -0,0 +1,43 @@
+//#region \0@oxc-project+runtime@0.144.0/helpers/esm/typeof.js
+function _typeof(o) {
+	"@babel/helpers - typeof";
+	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o) {
+		return typeof o;
+	} : function(o) {
+		return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o;
+	}, _typeof(o);
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.144.0/helpers/esm/toPrimitive.js
+function toPrimitive(t, r) {
+	if ("object" != _typeof(t) || !t) return t;
+	var e = t[Symbol.toPrimitive];
+	if (void 0 !== e) {
+		var i = e.call(t, r || "default");
+		if ("object" != _typeof(i)) return i;
+		throw new TypeError("@@toPrimitive must return a primitive value.");
+	}
+	return ("string" === r ? String : Number)(t);
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.144.0/helpers/esm/toPropertyKey.js
+function toPropertyKey(t) {
+	var i = toPrimitive(t, "string");
+	return "symbol" == _typeof(i) ? i : i + "";
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.144.0/helpers/esm/defineProperty.js
+function _defineProperty(e, r, t) {
+	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
+		value: t,
+		enumerable: !0,
+		configurable: !0,
+		writable: !0
+	}) : e[r] = t, e;
+}
+
+//#endregion
+export { _defineProperty as t };

package/dist/esm/fetch.d.ts

@@ -0,0 +1,27 @@
+import { t as Client } from "./Client-Mni9tJr6.js";
+//#region src/fetch.d.ts
+interface FetchHandlerOptions {
+  /**
+   * The bot's Discord public key, used to verify interaction signatures.
+   * @default process.env.DISCORD_PUBLIC_KEY
+   */
+  discordPublicKey?: string;
+  /**
+   * The path interactions are posted to.
+   * @default process.env.HTTP_POST_PATH ?? '/'
+   */
+  postPath?: string;
+}
+type FetchHandler = (request: Request) => Promise<Response>;
+/**
+ * Wraps `Client`'s own dispatch — signature verification, routing, replies, the exact same code `listen()` runs —
+ * behind a Fetch handler, by bridging a `Request` to the `IncomingMessage`/`ServerResponse` shape it expects.
+ *
+ * This changes nothing about the framework's internals: `handleRawHttpMessage` is `protected`, not private, and is
+ * called here exactly as `Client#listen()` calls it on every request. `Client` never has to know which transport
+ * (`node:http`, Vite, Nitro, a Worker) produced the request.
+ */
+declare function createFetchHandler(client: Client, options?: FetchHandlerOptions): Promise<FetchHandler>;
+//#endregion
+export { FetchHandler, FetchHandlerOptions, createFetchHandler };
+//# sourceMappingURL=fetch.d.ts.map

package/dist/esm/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","names":[],"sources":["../../src/fetch.ts"],"mappings":";;UAaiB;;;;;EAKhB;;;;;EAKA;;KAGW,gBAAgB,SAAS,YAAY,QAAQ;;;;;;;;;iBAYnC,mBAAmB,QAAQ,QAAQ,UAAS,sBAA2B,QAAQ"}

package/dist/esm/fetch.js

@@ -0,0 +1,76 @@
+import { t as _defineProperty } from "./defineProperty-BFrI-_1n.js";
+import { i as _classPrivateFieldGet2, o as _classPrivateFieldInitSpec, r as _classPrivateFieldSet2, t as makeKey } from "./security-BBKStXe6.js";
+import { EventEmitter } from "node:events";
+import { Readable } from "node:stream";
+
+//#region src/fetch.ts
+/**
+* Wraps `Client`'s own dispatch — signature verification, routing, replies, the exact same code `listen()` runs —
+* behind a Fetch handler, by bridging a `Request` to the `IncomingMessage`/`ServerResponse` shape it expects.
+*
+* This changes nothing about the framework's internals: `handleRawHttpMessage` is `protected`, not private, and is
+* called here exactly as `Client#listen()` calls it on every request. `Client` never has to know which transport
+* (`node:http`, Vite, Nitro, a Worker) produced the request.
+*/
+async function createFetchHandler(client, options = {}) {
+	const discordPublicKey = options.discordPublicKey ?? process.env.DISCORD_PUBLIC_KEY;
+	if (!discordPublicKey) throw new Error("The discordPublicKey cannot be empty");
+	const key = await makeKey(discordPublicKey);
+	const path = options.postPath ?? process.env.HTTP_POST_PATH ?? "/";
+	const dispatch = client.handleRawHttpMessage.bind(client);
+	return async (request) => {
+		const incoming = toIncomingMessage(request);
+		const outgoing = new FetchServerResponse();
+		await dispatch(incoming, outgoing, path, key);
+		return outgoing.toResponse();
+	};
+}
+function toIncomingMessage(request) {
+	const headers = {};
+	request.headers.forEach((value, name) => {
+		headers[name] = value;
+	});
+	const body = request.body ? Readable.fromWeb(request.body) : Readable.from([]);
+	return Object.assign(body, {
+		url: new URL(request.url).pathname,
+		method: request.method,
+		headers
+	});
+}
+var _headers = /* @__PURE__ */ new WeakMap();
+var _body = /* @__PURE__ */ new WeakMap();
+/**
+* The minimum of `http.ServerResponse` `Client`'s dispatch touches: `setHeader`, `statusCode`, `end`,
+* `writableEnded`, and a `'close'` event once the response is done (`BaseInteraction`'s `_sendReply` awaits it
+* before resolving, so a caller here has to fire it too, or every reply would hang forever).
+*/
+var FetchServerResponse = class extends EventEmitter {
+	constructor(..._args) {
+		super(..._args);
+		_defineProperty(this, "statusCode", 200);
+		_defineProperty(this, "writableEnded", false);
+		_defineProperty(this, "closed", false);
+		_classPrivateFieldInitSpec(this, _headers, new Headers());
+		_classPrivateFieldInitSpec(this, _body, void 0);
+	}
+	setHeader(name, value) {
+		_classPrivateFieldGet2(_headers, this).set(name, value);
+	}
+	end(chunk) {
+		_classPrivateFieldSet2(_body, this, chunk);
+		this.writableEnded = true;
+		this.closed = true;
+		queueMicrotask(() => this.emit("close"));
+		return this;
+	}
+	toResponse() {
+		return new Response(_classPrivateFieldGet2(_body, this) ?? null, {
+			status: this.statusCode,
+			headers: _classPrivateFieldGet2(_headers, this)
+		});
+	}
+};
+
+//#endregion
+export { createFetchHandler };
+//# sourceMappingURL=fetch.js.map

package/dist/esm/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","names":[],"sources":["../../src/fetch.ts"],"sourcesContent":["/**\n * Fetch (Web `Request`/`Response`) entry point for `@wolfstar/http-framework`, so a bot can be served by anything\n * that speaks Fetch — Vite's dev middleware, Nitro, Cloudflare Workers, `Bun.serve`, `Deno.serve` — instead of only\n * `Client#listen()`'s own `node:http` server.\n *\n * @module @wolfstar/http-framework/fetch\n */\nimport type { IncomingHttpHeaders, IncomingMessage, ServerResponse } from 'node:http';\nimport { EventEmitter } from 'node:events';\nimport { Readable } from 'node:stream';\nimport type { Client } from './lib/Client.js';\nimport { makeKey, type Key } from './lib/utils/security.js';\n\nexport interface FetchHandlerOptions {\n\t/**\n\t * The bot's Discord public key, used to verify interaction signatures.\n\t * @default process.env.DISCORD_PUBLIC_KEY\n\t */\n\tdiscordPublicKey?: string;\n\t/**\n\t * The path interactions are posted to.\n\t * @default process.env.HTTP_POST_PATH ?? '/'\n\t */\n\tpostPath?: string;\n}\n\nexport type FetchHandler = (request: Request) => Promise<Response>;\n\ntype Dispatch = (request: IncomingMessage, response: ServerResponse, path: string, key: Key) => Promise<ServerResponse>;\n\n/**\n * Wraps `Client`'s own dispatch — signature verification, routing, replies, the exact same code `listen()` runs —\n * behind a Fetch handler, by bridging a `Request` to the `IncomingMessage`/`ServerResponse` shape it expects.\n *\n * This changes nothing about the framework's internals: `handleRawHttpMessage` is `protected`, not private, and is\n * called here exactly as `Client#listen()` calls it on every request. `Client` never has to know which transport\n * (`node:http`, Vite, Nitro, a Worker) produced the request.\n */\nexport async function createFetchHandler(client: Client, options: FetchHandlerOptions = {}): Promise<FetchHandler> {\n\tconst discordPublicKey = options.discordPublicKey ?? process.env.DISCORD_PUBLIC_KEY;\n\tif (!discordPublicKey) throw new Error('The discordPublicKey cannot be empty');\n\n\tconst key = await makeKey(discordPublicKey);\n\tconst path = options.postPath ?? process.env.HTTP_POST_PATH ?? '/';\n\tconst dispatch = (client as unknown as { handleRawHttpMessage: Dispatch }).handleRawHttpMessage.bind(client);\n\n\treturn async (request: Request): Promise<Response> => {\n\t\tconst incoming = toIncomingMessage(request);\n\t\tconst outgoing = new FetchServerResponse();\n\t\tawait dispatch(incoming, outgoing as unknown as ServerResponse, path, key);\n\t\treturn outgoing.toResponse();\n\t};\n}\n\nfunction toIncomingMessage(request: Request): IncomingMessage {\n\tconst headers: IncomingHttpHeaders = {};\n\trequest.headers.forEach((value, name) => {\n\t\theaders[name] = value;\n\t});\n\n\tconst body = request.body ? Readable.fromWeb(request.body as never) : Readable.from([]);\n\treturn Object.assign(body, { url: new URL(request.url).pathname, method: request.method, headers }) as unknown as IncomingMessage;\n}\n\n/**\n * The minimum of `http.ServerResponse` `Client`'s dispatch touches: `setHeader`, `statusCode`, `end`,\n * `writableEnded`, and a `'close'` event once the response is done (`BaseInteraction`'s `_sendReply` awaits it\n * before resolving, so a caller here has to fire it too, or every reply would hang forever).\n */\nclass FetchServerResponse extends EventEmitter {\n\tpublic statusCode = 200;\n\tpublic writableEnded = false;\n\tpublic closed = false;\n\treadonly #headers = new Headers();\n\t#body: string | undefined;\n\n\tpublic setHeader(name: string, value: string): void {\n\t\tthis.#headers.set(name, value);\n\t}\n\n\tpublic end(chunk?: string): this {\n\t\tthis.#body = chunk;\n\t\tthis.writableEnded = true;\n\t\tthis.closed = true;\n\t\tqueueMicrotask(() => this.emit('close'));\n\t\treturn this;\n\t}\n\n\tpublic toResponse(): Response {\n\t\treturn new Response(this.#body ?? null, { status: this.statusCode, headers: this.#headers });\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;AAsCA,eAAsB,mBAAmB,QAAgB,UAA+B,CAAC,GAA0B;CAClH,MAAM,mBAAmB,QAAQ,oBAAoB,QAAQ,IAAI;CACjE,IAAI,CAAC,kBAAkB,MAAM,IAAI,MAAM,sCAAsC;CAE7E,MAAM,MAAM,MAAM,QAAQ,gBAAgB;CAC1C,MAAM,OAAO,QAAQ,YAAY,QAAQ,IAAI,kBAAkB;CAC/D,MAAM,WAAY,OAAyD,qBAAqB,KAAK,MAAM;CAE3G,OAAO,OAAO,YAAwC;EACrD,MAAM,WAAW,kBAAkB,OAAO;EAC1C,MAAM,WAAW,IAAI,oBAAoB;EACzC,MAAM,SAAS,UAAU,UAAuC,MAAM,GAAG;EACzE,OAAO,SAAS,WAAW;CAC5B;AACD;AAEA,SAAS,kBAAkB,SAAmC;CAC7D,MAAM,UAA+B,CAAC;CACtC,QAAQ,QAAQ,SAAS,OAAO,SAAS;EACxC,QAAQ,QAAQ;CACjB,CAAC;CAED,MAAM,OAAO,QAAQ,OAAO,SAAS,QAAQ,QAAQ,IAAa,IAAI,SAAS,KAAK,CAAC,CAAC;CACtF,OAAO,OAAO,OAAO,MAAM;EAAE,KAAK,IAAI,IAAI,QAAQ,GAAG,CAAC,CAAC;EAAU,QAAQ,QAAQ;EAAQ;CAAQ,CAAC;AACnG;;;;;;;;AAOA,IAAM,sBAAN,cAAkC,aAAa;;;wBACvC,cAAa;wBACb,iBAAgB;wBAChB,UAAS;6CACI,IAAI,QAAQ;;;CAGhC,AAAO,UAAU,MAAc,OAAqB;EACnD,uCAAc,IAAI,MAAM,KAAK;CAC9B;CAEA,AAAO,IAAI,OAAsB;EAChC,oCAAa;EACb,KAAK,gBAAgB;EACrB,KAAK,SAAS;EACd,qBAAqB,KAAK,KAAK,OAAO,CAAC;EACvC,OAAO;CACR;CAEA,AAAO,aAAuB;EAC7B,OAAO,IAAI,uCAAS,SAAc,MAAM;GAAE,QAAQ,KAAK;GAAY,0CAAS;EAAc,CAAC;CAC5F;AACD"}