@orkestrel/scaffold 0.0.126 → 0.0.127

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -4,7 +4,7 @@
4
4
  "storage": "AGENTS.md",
5
5
  "destination": "AGENTS.md",
6
6
  "executable": false,
7
- "digest": "3d183e5cae674592a63f5ec38deb421fab480d408d2874a3040bacf2e4d20680"
7
+ "digest": "b00de3b210c6a1afc13b870d687d9892e47de877cef27f27eda34e6e68bb524b"
8
8
  },
9
9
  {
10
10
  "storage": "LICENSE",
@@ -16,7 +16,7 @@
16
16
  "storage": "agents/orchestration.md",
17
17
  "destination": ".agents/orchestration.md",
18
18
  "executable": false,
19
- "digest": "8145f2f9f3f50c4a3b9ce82c9725ec275edc45fb579bb63968827bcf4372d08f"
19
+ "digest": "24c84e5e89148d6da9873e1b49b415e6c86a226fefab0752b6ac0329d8814017"
20
20
  },
21
21
  {
22
22
  "storage": "agents/platforms/posix.md",
@@ -580,7 +580,7 @@
580
580
  "storage": "claude/AGENTS.md",
581
581
  "destination": ".claude/AGENTS.md",
582
582
  "executable": false,
583
- "digest": "50ec7a68e73e34faa43ee12b6be72525b2556291753c7211766d3ea0d46687df"
583
+ "digest": "5571dce7ab4cb46693a23a3265ce14b5985a0f0fc9771cd72db83a18474392a7"
584
584
  },
585
585
  {
586
586
  "storage": "claude/agents/analyst.md",
@@ -628,13 +628,13 @@
628
628
  "storage": "claude/agents/orkestrel.md",
629
629
  "destination": ".claude/agents/orkestrel.md",
630
630
  "executable": false,
631
- "digest": "5500ab7df2a61f862ddf9e3cf24c7256f5d2aaf86ee4d9e9afcbe663ba17f235"
631
+ "digest": "1be5cdaf870a89eae3a0521450ef470c6dfb1877bf2b5737df294660b0b4c692"
632
632
  },
633
633
  {
634
634
  "storage": "claude/agents/planner.md",
635
635
  "destination": ".claude/agents/planner.md",
636
636
  "executable": false,
637
- "digest": "4ff794553c157a4fa325edd3822fd9a94764bac9b579f5e66f4a1d1db6a218a1"
637
+ "digest": "948ce228b81f0ebc0b11dcc034cac9d40a89299ba735cd7467bb1b1554b5e777"
638
638
  },
639
639
  {
640
640
  "storage": "claude/agents/researcher.md",
@@ -736,7 +736,7 @@
736
736
  "storage": "claude/rules/workspace.md",
737
737
  "destination": ".claude/rules/workspace.md",
738
738
  "executable": false,
739
- "digest": "8374fb51dade68150f1d1affb0c066682bc1363eb9186322f19f1ac3fc967431"
739
+ "digest": "43d46cd789af54b04b3adc53250c38ea38d1757bae23ff34f321d0b70893e525"
740
740
  },
741
741
  {
742
742
  "storage": "claude/rules/writing.md",
@@ -874,7 +874,7 @@
874
874
  "storage": "codex/agents/planner.toml",
875
875
  "destination": ".codex/agents/planner.toml",
876
876
  "executable": false,
877
- "digest": "a0fa6655aa1a762bc089225b8b72a34e46f4b4be04a59803dd56e7b0bdb1e9fb"
877
+ "digest": "f9e405b6a893514988ff9cbcc3c4addaf606b3f5f6a0e8d53b2bcd4402304bd8"
878
878
  },
879
879
  {
880
880
  "storage": "codex/agents/researcher.toml",
@@ -1018,7 +1018,7 @@
1018
1018
  "storage": "guides/capture.md",
1019
1019
  "destination": "guides/capture.md",
1020
1020
  "executable": false,
1021
- "digest": "3687c8cf8601ec1564f5ad6ae39e519c44eb32f2e5ef01ec40348d4a11ee6f38"
1021
+ "digest": "f19b7ea5ea06958756a20422518ace1078fe87bea4eeb89345b12401a0110d58"
1022
1022
  },
1023
1023
  {
1024
1024
  "storage": "guides/codec.md",
@@ -1048,7 +1048,7 @@
1048
1048
  "storage": "guides/database.md",
1049
1049
  "destination": "guides/database.md",
1050
1050
  "executable": false,
1051
- "digest": "0158058d9cf571e75c26550478666a6f80b994064241b508b56a7980eb3bdbde"
1051
+ "digest": "f7cb2796e7c1d4fe78ab54ebe04b80feb411a07891c04c7168fc1f48cfa0af61"
1052
1052
  },
1053
1053
  {
1054
1054
  "storage": "guides/emitter.md",
@@ -1186,7 +1186,7 @@
1186
1186
  "storage": "guides/relation.md",
1187
1187
  "destination": "guides/relation.md",
1188
1188
  "executable": false,
1189
- "digest": "03f97521e4d6057529bec4ca140ca707cdfe4cd1239dce54d4dbb8da01b63538"
1189
+ "digest": "47380b35b42129f9a0f132744c1e0ad06bf51bfe58aa95e93e7733a8eedeb37a"
1190
1190
  },
1191
1191
  {
1192
1192
  "storage": "guides/router.md",
@@ -1198,7 +1198,7 @@
1198
1198
  "storage": "guides/scaffold.md",
1199
1199
  "destination": "guides/scaffold.md",
1200
1200
  "executable": false,
1201
- "digest": "14085ac48ce713036f7e68f1bce5c684a758e519e7fbb3c467305d5f8a883c9a"
1201
+ "digest": "e594eddd6e2bc9c7138d4a83010d421edad1fb5c602175e5939bab3b7f461729"
1202
1202
  },
1203
1203
  {
1204
1204
  "storage": "guides/sea.md",
@@ -1270,7 +1270,7 @@
1270
1270
  "storage": "guides/toolbox.md",
1271
1271
  "destination": "guides/toolbox.md",
1272
1272
  "executable": false,
1273
- "digest": "07e306b640592d88848e638d1dd6060712ff22ea686a70a503286543368cb256"
1273
+ "digest": "d052fea933416ea959d259db6eba39fdecc37b07e127e2adb3f1f9c648fbcc8e"
1274
1274
  },
1275
1275
  {
1276
1276
  "storage": "guides/websocket.md",
@@ -1336,7 +1336,7 @@
1336
1336
  "storage": "tests/config.test.ts",
1337
1337
  "destination": "tests/config.test.ts",
1338
1338
  "executable": false,
1339
- "digest": "7aed0759a718640fc4fa2f33543b858035bc05273569e2c23839cf7c372fc7f0"
1339
+ "digest": "ebc2324d33011a86561178f6a7adf6816428d333de97ea2f64befaa1638e8357"
1340
1340
  },
1341
1341
  {
1342
1342
  "storage": "tests/policy.test.ts",
@@ -1417,5 +1417,5 @@
1417
1417
  "scripts"
1418
1418
  ],
1419
1419
  "surface": [],
1420
- "digest": "c324fe88780960514ba83afdbe775c5d09755d6c2c0dd9bf987023d78f64162d"
1420
+ "digest": "664d3df4388798e628106f295f165a347149ef14326bcbc035385b5e999091f2"
1421
1421
  }
@@ -379,12 +379,16 @@ describe('selected faces', () => {
379
379
  })
380
380
 
381
381
  it('resolves showcase and journey modes for every occupied application', async () => {
382
- const applications = [
383
- 'browser',
384
- ...collectFrameworks(POLICY_ROOT)
385
- .filter((face) => face.startsWith('app/'))
386
- .map((face) => face.slice(4)),
387
- ]
382
+ const faces = collectFrameworks(POLICY_ROOT)
383
+ .filter((face) => face.startsWith('app/'))
384
+ .map((face) => face.slice(4))
385
+ // The base application is declared by its exact-case entry alone.
386
+ const candidates = ['browser', ...faces]
387
+ const applications = candidates.filter(
388
+ (application) =>
389
+ existsSync(resolve(POLICY_ROOT, 'app', application)) &&
390
+ readdirSync(resolve(POLICY_ROOT, 'app', application)).includes('main.ts'),
391
+ )
388
392
  const manifest = readConfigRecord(
389
393
  JSON.parse(readFileSync(resolve(POLICY_ROOT, 'package.json'), 'utf8')),
390
394
  )
@@ -545,6 +549,20 @@ describe('selected faces', () => {
545
549
  'absent',
546
550
  ]),
547
551
  ).toThrow('not declared')
552
+ // The record names an application exactly when its exact-case entry exists.
553
+ const variant = { name: 'desktop', width: 1280, height: 800 }
554
+ for (const application of applications) {
555
+ expect(
556
+ readConfigRecord(
557
+ readConfigRecord(Reflect.apply(factory, undefined, [variant, [], application])).test,
558
+ ).include,
559
+ ).toStrictEqual([`tests/app/${application}/integration.test.ts`])
560
+ }
561
+ for (const application of candidates.filter((name) => !applications.includes(name))) {
562
+ expect(() => Reflect.apply(factory, undefined, [variant, [], application])).toThrow(
563
+ 'not declared',
564
+ )
565
+ }
548
566
  })
549
567
 
550
568
  it('collects both browser setup proofs and optimizes every selected browser factory', async () => {
@@ -4,7 +4,7 @@ let _orkestrel_template = require("@orkestrel/template");
4
4
  let _orkestrel_emitter = require("@orkestrel/emitter");
5
5
  var package_default = {
6
6
  name: "@orkestrel/scaffold",
7
- version: "0.0.126",
7
+ version: "0.0.127",
8
8
  description: "Scaffold workspaces with commands: new, audit, surface, repair, catalog, and overwrite.",
9
9
  keywords: [
10
10
  "audit",
@@ -112,7 +112,7 @@ var package_default = {
112
112
  "@orkestrel/test": "^0.0.33",
113
113
  "@types/node": "^24.19.2",
114
114
  "@vitest/browser-playwright": "^5.1.0",
115
- "oxfmt": "^0.77.0",
115
+ "oxfmt": "^0.78.0",
116
116
  "oxlint": "^1.93.0",
117
117
  "playwright": "^1.64.1",
118
118
  "typescript": "^7.0.2",
@@ -730,10 +730,36 @@ var BROWSE_DEV_DEPENDENCIES = Object.freeze({ "@orkestrel/browser": package_defa
730
730
  * ```ts
731
731
  * import { CAPTURE_DEV_DEPENDENCIES } from '@orkestrel/scaffold'
732
732
  *
733
- * CAPTURE_DEV_DEPENDENCIES['@orkestrel/capture'] // '^0.0.1'
733
+ * CAPTURE_DEV_DEPENDENCIES['@orkestrel/capture'] // '^0.0.5'
734
734
  * ```
735
735
  */
736
- var CAPTURE_DEV_DEPENDENCIES = Object.freeze({ "@orkestrel/capture": "^0.0.1" });
736
+ var CAPTURE_DEV_DEPENDENCIES = Object.freeze({ "@orkestrel/capture": "^0.0.5" });
737
+ /**
738
+ * Lists the Orkestrel packages that publish a `/browser` entry, frozen.
739
+ *
740
+ * @remarks
741
+ * A browser test project pre-bundles `<package>/browser` for each declared package listed here,
742
+ * so a first import mid-run does not reload the page. Each listed package's vendored guide names
743
+ * its own `/browser` specifier, and the constants test holds the list to the guide mirrors.
744
+ *
745
+ * @example
746
+ * ```ts
747
+ * import { BROWSER_ENTRIES } from '@orkestrel/scaffold'
748
+ *
749
+ * BROWSER_ENTRIES.includes('@orkestrel/router') // true
750
+ * ```
751
+ */
752
+ var BROWSER_ENTRIES = Object.freeze([
753
+ "@orkestrel/browser",
754
+ "@orkestrel/console",
755
+ "@orkestrel/database",
756
+ "@orkestrel/form",
757
+ "@orkestrel/mcp",
758
+ "@orkestrel/router",
759
+ "@orkestrel/table",
760
+ "@orkestrel/test",
761
+ "@orkestrel/workflow"
762
+ ]);
737
763
  /**
738
764
  * Lists the capture package and its fleet runtime dependency closure, frozen.
739
765
  *
@@ -1012,7 +1038,7 @@ function isNamedPlugin(plugin: PluginOption): plugin is { name: string } {
1012
1038
  resolve,
1013
1039
  optimizeDeps,
1014
1040
  publicDir: false,
1015
- test: {
1041
+ {{vuePlugin}} test: {
1016
1042
  name: { label: name, color: 'magenta' },
1017
1043
  root: resolveWorkspacePath('.'),
1018
1044
  isolate: false,
@@ -1108,7 +1134,7 @@ export function srcBrowser(override?: UserConfig): UserConfig {
1108
1134
  resolve,
1109
1135
  optimizeDeps,
1110
1136
  publicDir: false,
1111
- plugins: [outputBoundary('dist/src/browser'), environmentBoundary('src/browser')],
1137
+ plugins: [outputBoundary('dist/src/browser'), environmentBoundary('src/browser'){{vuePlugin}}],
1112
1138
  build: {
1113
1139
  emptyOutDir: true,
1114
1140
  sourcemap: true,
@@ -1249,7 +1275,7 @@ export function srcBin(override?: UserConfig): UserConfig {
1249
1275
  const project: UserConfig = {
1250
1276
  resolve,
1251
1277
  optimizeDeps,
1252
- plugins: [outputBoundary(output), environmentBoundary('app/browser')],
1278
+ plugins: [outputBoundary(output), environmentBoundary('app/browser'){{vuePlugin}}],
1253
1279
  root: resolveWorkspacePath('app/browser'),
1254
1280
  publicDir: false,
1255
1281
  build: {
@@ -5137,6 +5163,7 @@ var isBlueprint = (0, _orkestrel_contract.recordOf)({
5137
5163
  global: _orkestrel_contract.isBoolean,
5138
5164
  showcase: _orkestrel_contract.isBoolean,
5139
5165
  journey: _orkestrel_contract.isBoolean,
5166
+ base: _orkestrel_contract.isBoolean,
5140
5167
  skills: _orkestrel_contract.isBoolean
5141
5168
  }, ["description"]);
5142
5169
  /**
@@ -7018,7 +7045,7 @@ function blueprintToDevDependencies(blueprint) {
7018
7045
  ...BASE_DEV_DEPENDENCIES,
7019
7046
  ...Object.fromEntries(Object.entries(blueprintToToolchainHolds(blueprint)).map(([name, hold]) => [name, hold.range])),
7020
7047
  ...rendered && !BROWSE_UPSTREAM.includes(own) ? BROWSE_DEV_DEPENDENCIES : {},
7021
- ...blueprint.journey && blueprint.app.includes("browser") && !CAPTURE_UPSTREAM.includes(own) ? CAPTURE_DEV_DEPENDENCIES : {},
7048
+ ...blueprint.journey && blueprint.app.includes("browser") && (blueprint.base || blueprintToFaces(blueprint).some((extension) => extension.axes.includes("app"))) && !CAPTURE_UPSTREAM.includes(own) ? CAPTURE_DEV_DEPENDENCIES : {},
7022
7049
  ...sheets ? STYLES_DEV_DEPENDENCIES : {},
7023
7050
  ...blueprint.src.length > 0 || blueprint.bin ? DECLARATION_DEV_DEPENDENCIES : {},
7024
7051
  ...blueprint.src.includes("browser") || blueprint.setup.includes("browser") || sheets ? SOURCE_BROWSER_DEV_DEPENDENCIES : {},
@@ -7208,13 +7235,14 @@ function replaceManifestOverride(manifest, path, range) {
7208
7235
  function blueprintToScripts(blueprint) {
7209
7236
  const source = blueprintToFaces(blueprint).flatMap((extension) => extension.surface === "browser" && extension.axes.includes("src") ? [extension.name] : []);
7210
7237
  const application = blueprintToFaces(blueprint).flatMap((extension) => extension.surface === "browser" && extension.axes.includes("app") ? [extension.name] : []);
7238
+ const base = blueprint.base && blueprint.app.includes("browser");
7211
7239
  const sheets = blueprintToSheets(blueprint);
7212
7240
  const targets = [...sheets, ...blueprint.themes && !blueprint.styles ? ["themes"] : []];
7213
7241
  const checker = application.includes("vue") ? FRAMEWORK_MATRIX.vue.checker : "tsc";
7214
7242
  const publishes = blueprint.src.length > 0 || targets.length > 0;
7215
7243
  const integrates = blueprint.integration;
7216
7244
  const compiles = publishes || blueprint.bin;
7217
- const runtime = blueprint.app.filter((environment) => environment !== "core");
7245
+ const runtime = blueprint.app.filter((environment) => environment !== "core" && (environment !== "browser" || base));
7218
7246
  const vitest = "vitest run --config vite.config.ts --no-cache --reporter=dot";
7219
7247
  const checks = [
7220
7248
  ...blueprint.src,
@@ -7253,7 +7281,7 @@ function blueprintToScripts(blueprint) {
7253
7281
  test: [
7254
7282
  ...compiles ? ["npm run test:src"] : [],
7255
7283
  ...!publishes && blueprint.app.length > 0 ? ["npm run test:app"] : [],
7256
- ...!publishes && blueprint.journey && blueprint.app.includes("browser") ? ["npm run test:journey", ...application.map((name) => `npm run test:journey:${name}`)] : [],
7284
+ ...!publishes && blueprint.journey && (base || application.length > 0) ? [...base ? ["npm run test:journey"] : [], ...application.map((name) => `npm run test:journey:${name}`)] : [],
7257
7285
  "npm run test:policy",
7258
7286
  "npm run test:config",
7259
7287
  ...blueprint.setup.includes("node") || blueprint.global ? ["npm run test:setup"] : [],
@@ -7290,11 +7318,15 @@ function blueprintToScripts(blueprint) {
7290
7318
  "test:config": `${vitest} --project config`,
7291
7319
  ...blueprint.setup.includes("node") || blueprint.global ? { "test:setup": `${vitest} --project setup` } : {},
7292
7320
  ...blueprint.setup.includes("browser") ? { "test:setup:browser": `${vitest} --project setup:browser` } : {},
7293
- ...blueprint.journey && blueprint.app.includes("browser") ? {
7294
- "test:journey": journey,
7295
- journey: "capture journey",
7296
- capture: "capture frames",
7297
- ...Object.fromEntries(application.map((name) => [`test:journey:${name}`, `${journey} --mode ${name}`]))
7321
+ ...blueprint.journey && (base || application.length > 0) ? {
7322
+ ...base ? {
7323
+ "test:journey": journey,
7324
+ journey: "capture journey",
7325
+ capture: "capture frames"
7326
+ } : {},
7327
+ ...Object.fromEntries(application.map((name) => [`test:journey:${name}`, `${journey} --mode ${name}`])),
7328
+ ...Object.fromEntries(application.map((name) => [`journey:${name}`, `capture journey --mode ${name}`])),
7329
+ ...Object.fromEntries(application.map((name) => [`capture:${name}`, `capture frames --mode ${name}`]))
7298
7330
  } : {},
7299
7331
  ...blueprint.skills ? { "test:skills": `${vitest} --project skills` } : {},
7300
7332
  ...blueprint.guides ? { "test:guides": `node --experimental-strip-types ${GUIDES_TEST_PATH}` } : {},
@@ -7324,18 +7356,18 @@ function blueprintToScripts(blueprint) {
7324
7356
  ...Object.fromEntries(targets.map((name) => [`build:src:${name}`, [`vite build --config configs/src/vite.${name}.config.ts`, ...name === "styles" && blueprint.themes ? ["vite build --config configs/src/vite.themes.config.ts"] : []].join(" && ")]))
7325
7357
  } : {},
7326
7358
  ...blueprint.app.length > 0 ? {
7327
- "build:app": runtime.length > 0 ? [...runtime, ...application].map((environment) => `npm run build:app:${environment}`).join(" && ") : "npm run check:app:core",
7359
+ "build:app": runtime.length + application.length > 0 ? [...runtime, ...application].map((environment) => `npm run build:app:${environment}`).join(" && ") : `npm run check:app:${blueprint.app.includes("core") ? "core" : "browser"}`,
7328
7360
  ...Object.fromEntries([...runtime, ...application].map((environment) => [`build:app:${environment}`, `vite build --config configs/app/vite.${environment}.config.ts`]))
7329
7361
  } : {},
7330
- ...blueprint.app.includes("browser") ? {
7362
+ ...base ? {
7331
7363
  dev: "vite --config configs/app/vite.browser.config.ts",
7332
- ...Object.fromEntries(application.map((name) => [`dev:${name}`, `vite --config configs/app/vite.${name}.config.ts`])),
7333
7364
  ...blueprint.showcase ? {
7334
7365
  showcase,
7335
- "build:showcase": buildShowcase,
7336
- ...Object.fromEntries(application.flatMap((name) => [[`showcase:${name}`, `${showcase} --mode ${name}`], [`build:showcase:${name}`, `${buildShowcase} --mode ${name}`]]))
7366
+ "build:showcase": buildShowcase
7337
7367
  } : {}
7338
7368
  } : {},
7369
+ ...Object.fromEntries(application.map((name) => [`dev:${name}`, `vite --config configs/app/vite.${name}.config.ts`])),
7370
+ ...blueprint.showcase ? Object.fromEntries(application.flatMap((name) => [[`showcase:${name}`, `${showcase} --mode ${name}`], [`build:showcase:${name}`, `${buildShowcase} --mode ${name}`]])) : {},
7339
7371
  ...blueprint.app.includes("server") ? {
7340
7372
  serve: "node dist/app/server/main.cjs",
7341
7373
  "serve:build": "npm run build:app:server && npm run serve"
@@ -7344,7 +7376,7 @@ function blueprintToScripts(blueprint) {
7344
7376
  prepack: "npm run build",
7345
7377
  prepublishOnly: [
7346
7378
  "npm run format:check && npm run lint:check && npm run check && npm run build",
7347
- ...blueprint.showcase && blueprint.app.includes("browser") ? ["npm run build:showcase", ...application.map((name) => `npm run build:showcase:${name}`)] : [],
7379
+ ...blueprint.showcase && blueprint.app.includes("browser") ? [...base ? ["npm run build:showcase"] : [], ...application.map((name) => `npm run build:showcase:${name}`)] : [],
7348
7380
  "npm test",
7349
7381
  RELEASE_PROOF_COMMAND,
7350
7382
  ...blueprint.service ? ["npm run test:service"] : []
@@ -7365,7 +7397,8 @@ function blueprintToScripts(blueprint) {
7365
7397
  * rewrites, and one carrying skills adds `test:skills`. Publishing adds the pack and publication lifecycle scripts.
7366
7398
  * Sheet and framework faces add their check and build scripts, application frameworks add dev scripts,
7367
7399
  * and selected showcases and journeys add their mode scripts.
7368
- * A browser application's journey axis also adds `journey` and `capture`. Their generated
7400
+ * A base browser application's journey axis also adds `journey` and `capture`, and each
7401
+ * app-side browser face adds `journey:<name>` and `capture:<name>`. Their generated
7369
7402
  * commands are writable and have no predecessor forms; customized values remain caller-owned.
7370
7403
  * Aggregate test scripts and
7371
7404
  * maintainer-owned gate chains stay outside the region.
@@ -7397,7 +7430,7 @@ function blueprintToWritableScripts(blueprint) {
7397
7430
  const body = Object.entries(scripts).flatMap(([name, command]) => {
7398
7431
  const direct = name.startsWith("test:") && name !== "test:src" && name !== "test:app";
7399
7432
  const sheet = sheets.some((face) => name === `build:src:${face}` || name === `check:src:${face}`);
7400
- const framework = blueprintToFaces(blueprint).some((extension) => extension.surface === "browser" && extension.axes.some((axis) => name === `check:${axis}:${extension.name}` || name === `build:${axis}:${extension.name}` || axis === "app" && name === `dev:${extension.name}`));
7433
+ const framework = blueprintToFaces(blueprint).some((extension) => extension.surface === "browser" && extension.axes.some((axis) => name === `check:${axis}:${extension.name}` || name === `build:${axis}:${extension.name}` || axis === "app" && (name === `dev:${extension.name}` || name === `journey:${extension.name}` || name === `capture:${extension.name}`)));
7401
7434
  const showcase = name === "showcase" || name.startsWith("showcase:") || name === "build:showcase" || name.startsWith("build:showcase:");
7402
7435
  if (!direct && !sheet && !framework && !showcase && !(name === "journey" || name === "capture")) return [];
7403
7436
  return [{
@@ -7544,7 +7577,7 @@ function blueprintToMachinery(blueprint) {
7544
7577
  browser: blueprint.src.includes("browser") || blueprint.app.includes("browser") || blueprint.setup.includes("browser") || blueprintToSheets(blueprint).length > 0 || blueprint.themes || frameworks.length > 0,
7545
7578
  frameworks,
7546
7579
  output: blueprint.src.length > 0 || blueprint.bin || hosted || blueprintToSheets(blueprint).length > 0 || blueprint.themes,
7547
- showcase: blueprint.showcase && blueprint.app.includes("browser")
7580
+ showcase: blueprint.showcase && (blueprint.base && blueprint.app.includes("browser") || blueprintToFaces(blueprint).some((extension) => extension.axes.includes("app")))
7548
7581
  };
7549
7582
  }
7550
7583
  /**
@@ -7664,9 +7697,9 @@ function blueprintToProjects(blueprint) {
7664
7697
  *
7665
7698
  * @remarks
7666
7699
  * A browser-mode run that discovers a runtime package mid-collection reloads the page, so the
7667
- * list names the test package, its browser entry, and every Orkestrel runtime package the
7668
- * blueprint declares or peers with, inline when the line fits the print width and stacked
7669
- * otherwise.
7700
+ * list names the test package, every Orkestrel runtime package the blueprint declares or peers
7701
+ * with, and the `/browser` entry of each one {@link BROWSER_ENTRIES} lists, inline when the
7702
+ * line fits the print width and stacked otherwise.
7670
7703
  *
7671
7704
  * @example
7672
7705
  * ```ts
@@ -7678,17 +7711,20 @@ function blueprintToProjects(blueprint) {
7678
7711
  * ```
7679
7712
  */
7680
7713
  function blueprintToOptimizedDependencies(blueprint) {
7714
+ const packages = [.../* @__PURE__ */ new Set([
7715
+ ...Object.hasOwn(blueprintToDevDependencies(blueprint), "@orkestrel/contract") ? ["@orkestrel/contract"] : [],
7716
+ ...blueprint.dependencies.map((dependency) => dependency.name),
7717
+ ...blueprint.peers.map((peer) => peer.name)
7718
+ ])].filter((name) => name.startsWith("@orkestrel/")).sort();
7681
7719
  const names = [
7682
7720
  "@orkestrel/test",
7683
7721
  "@orkestrel/test/browser",
7684
- ...[.../* @__PURE__ */ new Set([
7685
- ...Object.hasOwn(blueprintToDevDependencies(blueprint), "@orkestrel/contract") ? ["@orkestrel/contract"] : [],
7686
- ...blueprint.dependencies.map((dependency) => dependency.name),
7687
- ...blueprint.peers.map((peer) => peer.name)
7688
- ])].filter((name) => name.startsWith("@orkestrel/")).sort()
7722
+ ...packages,
7723
+ ...packages.filter((name) => BROWSER_ENTRIES.includes(name)).map((name) => `${name}/browser`)
7689
7724
  ];
7690
- const inline = `\tinclude: [${names.map((name) => `'${name}'`).join(", ")}],`;
7691
- return matchesPrintWidth(inline) ? `const optimizeDeps = {\n${inline}\n}\n\n` : `const optimizeDeps = {\n\tinclude: [\n${names.map((name) => `\t\t'${name}',`).join("\n")}\n\t],\n}\n\n`;
7725
+ const includes = [...new Set(names)];
7726
+ const inline = `\tinclude: [${includes.map((name) => `'${name}'`).join(", ")}],`;
7727
+ return matchesPrintWidth(inline) ? `const optimizeDeps = {\n${inline}\n}\n\n` : `const optimizeDeps = {\n\tinclude: [\n${includes.map((name) => `\t\t'${name}',`).join("\n")}\n\t],\n}\n\n`;
7692
7728
  }
7693
7729
  /**
7694
7730
  * Compiles the root Vite and Vitest configuration for a blueprint.
@@ -7713,6 +7749,9 @@ function blueprintToOptimizedDependencies(blueprint) {
7713
7749
  function blueprintToRootVite(blueprint) {
7714
7750
  const machinery = blueprintToMachinery(blueprint);
7715
7751
  const planned = new Set(blueprintToProjects(blueprint));
7752
+ const applicationFaces = blueprintToFaces(blueprint).filter((extension) => extension.axes.includes("app"));
7753
+ const base = blueprint.base && blueprint.app.includes("browser");
7754
+ const journeyed = blueprint.journey && (base || applicationFaces.length > 0);
7716
7755
  const sheets = blueprintToSheets(blueprint);
7717
7756
  const styled = sheets.length > 0 || blueprint.themes;
7718
7757
  const global = blueprint.global ? " globalSetup: ['./tests/setupGlobal.ts'],\n" : "";
@@ -7738,10 +7777,11 @@ function blueprintToRootVite(blueprint) {
7738
7777
  return resolveExternal(id, { peers, refused: [], siblings: [] })
7739
7778
  }
7740
7779
  `] : [],
7741
- ...styled ? [CONFIG_TEMPLATES.factories.sheet] : [],
7780
+ ...styled ? [(0, _orkestrel_template.fillTemplate)(CONFIG_TEMPLATES.factories.sheet, { vuePlugin: machinery.frameworks.includes("vue") ? " plugins: [vue()],\n" : "" })] : [],
7742
7781
  ...planned.has("src:core") ? [CONFIG_TEMPLATES.factories.src.core] : [],
7743
7782
  ...planned.has("src:browser") ? [blueprint.src.includes("core")].map((core) => (0, _orkestrel_template.fillTemplate)(CONFIG_TEMPLATES.factories.src.browser, {
7744
7783
  external,
7784
+ vuePlugin: machinery.frameworks.includes("vue") ? ", vue()" : "",
7745
7785
  output: core ? " output: { paths: { '@src/core': '../core/index.js' } }," : " output: {},",
7746
7786
  exclude: core ? " exclude: ['tests/src/core/**/*.test.ts'],\n" : "",
7747
7787
  global
@@ -7766,11 +7806,12 @@ function blueprintToRootVite(blueprint) {
7766
7806
  ...planned.has("src:bin") ? [CONFIG_TEMPLATES.factories.src.bin] : [],
7767
7807
  ...planned.has("app:core") ? [CONFIG_TEMPLATES.factories.app.core] : [],
7768
7808
  ...planned.has("app:browser") ? [(0, _orkestrel_template.fillTemplate)(CONFIG_TEMPLATES.factories.app.browser, {
7809
+ vuePlugin: machinery.frameworks.includes("vue") ? ", vue()" : "",
7769
7810
  showcaseFactory: machinery.showcase ? CONFIG_TEMPLATES.factories.app.showcase : "",
7770
- journeyFactory: blueprint.journey ? CONFIG_TEMPLATES.factories.app.journey : "",
7771
- journeyExclude: blueprint.journey ? " exclude: ['tests/app/browser/integration.test.ts'],\n" : ""
7811
+ journeyFactory: journeyed ? CONFIG_TEMPLATES.factories.app.journey : "",
7812
+ journeyExclude: blueprint.journey && base ? " exclude: ['tests/app/browser/integration.test.ts'],\n" : ""
7772
7813
  })] : [],
7773
- ...planned.has("app:vue") ? [(0, _orkestrel_template.fillTemplate)(CONFIG_TEMPLATES.factories.app.vue, { journeyExclude: blueprint.journey ? " exclude: ['tests/app/vue/integration.test.ts'],\n" : " exclude: [],\n" })] : [],
7814
+ ...planned.has("app:vue") ? [(0, _orkestrel_template.fillTemplate)(CONFIG_TEMPLATES.factories.app.vue, { journeyExclude: journeyed ? " exclude: ['tests/app/vue/integration.test.ts'],\n" : " exclude: [],\n" })] : [],
7774
7815
  ...planned.has("app:server") ? [CONFIG_TEMPLATES.factories.app.server] : [],
7775
7816
  CONFIG_TEMPLATES.factories.policy,
7776
7817
  CONFIG_TEMPLATES.factories.config,
@@ -7830,11 +7871,11 @@ ${projects.map((project) => `\t\t\t${project},`).join("\n")}
7830
7871
  ].filter((helper) => body.includes(helper));
7831
7872
  const helperImport = `import { ${helpers.join(", ")} } from './configs/helpers.js'\n`;
7832
7873
  return (0, _orkestrel_template.fillTemplate)(CONFIG_TEMPLATES.root.vite, {
7833
- journey: blueprint.journey && blueprint.app.includes("browser") ? "import type { JourneyVariant } from '@orkestrel/test'\n" : "",
7874
+ journey: journeyed ? "import type { JourneyVariant } from '@orkestrel/test'\n" : "",
7834
7875
  imports: imports.length === 0 ? "" : `${imports.join("\n")}\n`,
7835
7876
  helpers: helpers.length === 0 ? "" : matchesPrintWidth(helperImport.trimEnd()) ? helperImport : `import {\n${helpers.map((helper) => `\t${helper},`).join("\n")}\n} from './configs/helpers.js'\n`,
7836
7877
  browsers: machinery.browser ? "import { resolveBrowser, resolvePinnedBrowser } from './configs/browsers.js'\nimport { commands } from './configs/commands.js'\n" : "",
7837
- options: (machinery.browser ? "const browserOptions = resolveBrowser(resolvePinnedBrowser(), process.platform, process.env)\n// Vitest writes a page.screenshot() capture beside its test file unless a directory is named.\nconst screenshots = resolveWorkspacePath('tmp/captures/screenshots')\n\n" + blueprintToOptimizedDependencies(blueprint) : "") + (blueprint.journey && blueprint.app.includes("browser") ? "const capture = process.env.CAPTURE === '1'\n\n" : "") + ((blueprint.journey || blueprint.showcase) && blueprint.app.includes("browser") ? `const applications = {\n\tbrowser: appBrowser,\n${blueprintToFaces(blueprint).filter((extension) => extension.surface === "browser" && extension.axes.includes("app")).map((extension) => `\t${extension.name}: app${extension.name[0]?.toUpperCase()}${extension.name.slice(1)},\n`).join("")}}\n\n` : ""),
7878
+ options: (machinery.browser ? "const browserOptions = resolveBrowser(resolvePinnedBrowser(), process.platform, process.env)\n// Vitest writes a page.screenshot() capture beside its test file unless a directory is named.\nconst screenshots = resolveWorkspacePath('tmp/captures/screenshots')\n\n" + blueprintToOptimizedDependencies(blueprint) : "") + (journeyed ? "const capture = process.env.CAPTURE === '1'\n\n" : "") + ((blueprint.journey || blueprint.showcase) && (base || applicationFaces.length > 0) ? `const applications = {\n${base ? " browser: appBrowser,\n" : ""}${applicationFaces.map((extension) => `\t${extension.name}: app${extension.name[0]?.toUpperCase()}${extension.name.slice(1)},\n`).join("")}}\n\n` : ""),
7838
7879
  factories: body,
7839
7880
  projects: projectRows
7840
7881
  });
@@ -7855,6 +7896,8 @@ ${projects.map((project) => `\t\t\t${project},`).join("\n")}
7855
7896
  * ```
7856
7897
  */
7857
7898
  function blueprintToConfigArtifacts(blueprint) {
7899
+ const applicationFaces = blueprintToFaces(blueprint).filter((extension) => extension.axes.includes("app"));
7900
+ const base = blueprint.base && blueprint.app.includes("browser");
7858
7901
  const roots = [{
7859
7902
  path: "tsconfig.json",
7860
7903
  group: "configs",
@@ -7994,7 +8037,7 @@ ${paths.join("\n")}
7994
8037
  content: axis === "src" ? CONFIG_TEMPLATES.tsconfigs.vue.src : (0, _orkestrel_template.fillTemplate)(CONFIG_TEMPLATES.tsconfigs.vue.app, { include: include.map((entry, index) => `\t\t${JSON.stringify(entry)}${index === include.length - 1 ? "" : ","}`).join("\n") })
7995
8038
  }];
7996
8039
  }));
7997
- const showcase = blueprint.showcase && blueprint.app.includes("browser") ? [{
8040
+ const showcase = blueprint.showcase && (base || applicationFaces.length > 0) ? [{
7998
8041
  path: SHOWCASE_CONFIG_PATH,
7999
8042
  group: "configs",
8000
8043
  ownership: "content",
@@ -8002,7 +8045,7 @@ ${paths.join("\n")}
8002
8045
  environment: "browser",
8003
8046
  content: CONFIG_TEMPLATES.vites.app.showcase
8004
8047
  }] : [];
8005
- const journey = blueprint.journey && blueprint.app.includes("browser") ? [{
8048
+ const journey = blueprint.journey && (base || applicationFaces.length > 0) ? [{
8006
8049
  path: JOURNEY_CONFIG_PATH,
8007
8050
  group: "configs",
8008
8051
  ownership: "birth",
@@ -8081,25 +8124,21 @@ function blueprintToSourceArtifacts(blueprint) {
8081
8124
  environment,
8082
8125
  content: ARTIFACT_TEMPLATES.source.empty
8083
8126
  };
8084
- if (environment === "browser") return [
8085
- entry,
8086
- {
8087
- path: "app/browser/main.ts",
8088
- group: "source",
8089
- ownership: "birth",
8090
- origin: "template",
8091
- environment,
8092
- content: (0, _orkestrel_template.fillTemplate)(ARTIFACT_TEMPLATES.source.main, { heading: `${matchesPrintWidth(`\t.appendChild(document.createElement('h1')).textContent = ${serializeTypeScriptString(blueprint.name)}`) ? " " : "\n "}${serializeTypeScriptString(blueprint.name)}` })
8093
- },
8094
- {
8095
- path: "app/browser/index.html",
8096
- group: "source",
8097
- ownership: "birth",
8098
- origin: "template",
8099
- environment,
8100
- content: ARTIFACT_TEMPLATES.source.browser
8101
- }
8102
- ];
8127
+ if (environment === "browser") return [entry, ...blueprint.base ? [{
8128
+ path: "app/browser/main.ts",
8129
+ group: "source",
8130
+ ownership: "birth",
8131
+ origin: "template",
8132
+ environment,
8133
+ content: (0, _orkestrel_template.fillTemplate)(ARTIFACT_TEMPLATES.source.main, { heading: `${matchesPrintWidth(`\t.appendChild(document.createElement('h1')).textContent = ${serializeTypeScriptString(blueprint.name)}`) ? " " : "\n "}${serializeTypeScriptString(blueprint.name)}` })
8134
+ }, {
8135
+ path: "app/browser/index.html",
8136
+ group: "source",
8137
+ ownership: "birth",
8138
+ origin: "template",
8139
+ environment,
8140
+ content: ARTIFACT_TEMPLATES.source.browser
8141
+ }] : []];
8103
8142
  return environment === "server" ? [entry, {
8104
8143
  path: "app/server/main.ts",
8105
8144
  group: "source",
@@ -8265,7 +8304,8 @@ function blueprintToTestArtifacts(blueprint) {
8265
8304
  origin: "template",
8266
8305
  content: ARTIFACT_TEMPLATES.tests.global.proof
8267
8306
  }] : [];
8268
- const journeys = blueprint.journey && blueprint.app.includes("browser") ? ["browser", ...blueprintToFaces(blueprint).flatMap((extension) => extension.surface === "browser" && extension.axes.includes("app") ? [extension.name] : [])].map((application) => ({
8307
+ const base = blueprint.base && blueprint.app.includes("browser");
8308
+ const journeys = blueprint.journey && (base || blueprintToFaces(blueprint).some((extension) => extension.surface === "browser" && extension.axes.includes("app"))) ? [...base ? ["browser"] : [], ...blueprintToFaces(blueprint).flatMap((extension) => extension.surface === "browser" && extension.axes.includes("app") ? [extension.name] : [])].map((application) => ({
8269
8309
  path: `tests/app/${application}/integration.test.ts`,
8270
8310
  group: "tests",
8271
8311
  ownership: "birth",
@@ -9273,17 +9313,28 @@ function blueprintToQuestions(blueprint) {
9273
9313
  blocking: false,
9274
9314
  candidates: ENVIRONMENTS
9275
9315
  }] : [],
9276
- ...ENVIRONMENTS.flatMap((environment) => [...blueprint.src.filter((declared) => declared === environment).length > 1 ? [{
9277
- field: "src",
9278
- message: `src declares ${environment} more than once.`,
9279
- blocking: true,
9280
- candidates: ENVIRONMENTS
9281
- }] : [], ...blueprint.app.filter((declared) => declared === environment).length > 1 ? [{
9282
- field: "app",
9283
- message: `app declares ${environment} more than once.`,
9284
- blocking: true,
9285
- candidates: ENVIRONMENTS
9286
- }] : []]),
9316
+ ...ENVIRONMENTS.flatMap((environment) => {
9317
+ const selected = blueprint.app.filter((declared) => declared === environment).length;
9318
+ return [
9319
+ ...blueprint.src.filter((declared) => declared === environment).length > 1 ? [{
9320
+ field: "src",
9321
+ message: `src declares ${environment} more than once.`,
9322
+ blocking: true,
9323
+ candidates: ENVIRONMENTS
9324
+ }] : [],
9325
+ ...selected > 1 ? [{
9326
+ field: "app",
9327
+ message: `app declares ${environment} more than once.`,
9328
+ blocking: true,
9329
+ candidates: ENVIRONMENTS
9330
+ }] : [],
9331
+ ...environment === "browser" && selected > 0 && blueprint.base === false && blueprint.extensions.every((extension) => extension.surface !== "browser" || !extension.axes.includes("app")) ? [{
9332
+ field: "base",
9333
+ message: "No base browser entry or app-side browser face is declared, so browser scripts and arrival artifacts are omitted.",
9334
+ blocking: false
9335
+ }] : []
9336
+ ];
9337
+ }),
9287
9338
  ...Iterator.from(blueprint.extensions).map((extension) => {
9288
9339
  const selection = `${extension.surface}:${extension.name}`;
9289
9340
  return {
@@ -9329,9 +9380,9 @@ function blueprintToQuestions(blueprint) {
9329
9380
  message: "showcase projects a browser app, and this workspace declares none, so it emits nothing.",
9330
9381
  blocking: false
9331
9382
  }] : [],
9332
- ...blueprint.journey && !blueprint.app.includes("browser") ? [{
9383
+ ...blueprint.journey && (!blueprint.app.includes("browser") || !blueprint.base && blueprint.extensions.every((extension) => extension.surface !== "browser" || !extension.axes.includes("app"))) ? [{
9333
9384
  field: "journey",
9334
- message: "journey projects a browser app, and this workspace declares none, so it emits nothing.",
9385
+ message: blueprint.app.includes("browser") ? "journey projects a browser application, and this workspace declares neither a base entry nor an app-side browser face, so it emits nothing." : "journey projects a browser app, and this workspace declares none, so it emits nothing.",
9335
9386
  blocking: false
9336
9387
  }] : [],
9337
9388
  ...dependenciesToQuestions(blueprint.dependencies, "dependencies", DEPENDENCY_NAME_PATTERN, ORKESTREL_RANGE_PATTERN),
@@ -9539,6 +9590,7 @@ function createBlueprint(name, input) {
9539
9590
  global: input?.global ?? false,
9540
9591
  showcase: input?.showcase ?? false,
9541
9592
  journey: input?.journey ?? false,
9593
+ base: input?.base ?? input?.app?.includes("browser") ?? false,
9542
9594
  skills: input?.skills ?? false
9543
9595
  }));
9544
9596
  if (blueprint === void 0) throw new ScaffoldError("INVALID", "The filled record is not a blueprint.", { name });
@@ -9855,6 +9907,7 @@ exports.BASE_DEV_DEPENDENCIES = BASE_DEV_DEPENDENCIES;
9855
9907
  exports.BIN_CONFIGS = BIN_CONFIGS;
9856
9908
  exports.BIN_ENTRY_PATH = BIN_ENTRY_PATH;
9857
9909
  exports.BIN_OUTPUT_PATH = BIN_OUTPUT_PATH;
9910
+ exports.BROWSER_ENTRIES = BROWSER_ENTRIES;
9858
9911
  exports.BROWSE_DEV_DEPENDENCIES = BROWSE_DEV_DEPENDENCIES;
9859
9912
  exports.BROWSE_UPSTREAM = BROWSE_UPSTREAM;
9860
9913
  exports.CANON_PATHS = CANON_PATHS;