@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.
- package/dist/bin/main.js +5 -2
- package/dist/bin/main.js.map +1 -1
- package/dist/host/AGENTS.md +1 -1
- package/dist/host/agents/orchestration.md +3 -3
- package/dist/host/claude/AGENTS.md +2 -2
- package/dist/host/claude/agents/orkestrel.md +14 -14
- package/dist/host/claude/agents/planner.md +2 -2
- package/dist/host/claude/rules/workspace.md +7 -6
- package/dist/host/codex/agents/planner.toml +2 -2
- package/dist/host/guides/capture.md +123 -123
- package/dist/host/guides/database.md +18 -7
- package/dist/host/guides/relation.md +71 -31
- package/dist/host/guides/scaffold.md +67 -49
- package/dist/host/guides/toolbox.md +8 -1
- package/dist/host/manifest.json +14 -14
- package/dist/host/tests/config.test.ts +24 -6
- package/dist/src/core/index.cjs +128 -75
- package/dist/src/core/index.cjs.map +1 -1
- package/dist/src/core/index.d.cts +27 -6
- package/dist/src/core/index.d.ts +27 -6
- package/dist/src/core/index.js +128 -76
- package/dist/src/core/index.js.map +1 -1
- package/package.json +2 -2
package/dist/host/manifest.json
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
"storage": "AGENTS.md",
|
|
5
5
|
"destination": "AGENTS.md",
|
|
6
6
|
"executable": false,
|
|
7
|
-
"digest": "
|
|
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": "
|
|
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": "
|
|
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": "
|
|
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": "
|
|
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": "
|
|
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": "
|
|
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": "
|
|
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": "
|
|
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": "
|
|
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": "
|
|
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": "
|
|
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": "
|
|
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": "
|
|
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
|
|
383
|
-
'
|
|
384
|
-
|
|
385
|
-
|
|
386
|
-
|
|
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 () => {
|
package/dist/src/core/index.cjs
CHANGED
|
@@ -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.
|
|
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.
|
|
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.
|
|
733
|
+
* CAPTURE_DEV_DEPENDENCIES['@orkestrel/capture'] // '^0.0.5'
|
|
734
734
|
* ```
|
|
735
735
|
*/
|
|
736
|
-
var CAPTURE_DEV_DEPENDENCIES = Object.freeze({ "@orkestrel/capture": "^0.0.
|
|
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 &&
|
|
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 &&
|
|
7294
|
-
|
|
7295
|
-
|
|
7296
|
-
|
|
7297
|
-
|
|
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(" && ") :
|
|
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
|
-
...
|
|
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
|
|
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,
|
|
7668
|
-
*
|
|
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
|
-
...
|
|
7685
|
-
|
|
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
|
|
7691
|
-
|
|
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:
|
|
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:
|
|
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:
|
|
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) : "") + (
|
|
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 &&
|
|
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 &&
|
|
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
|
-
|
|
8086
|
-
|
|
8087
|
-
|
|
8088
|
-
|
|
8089
|
-
|
|
8090
|
-
|
|
8091
|
-
|
|
8092
|
-
|
|
8093
|
-
|
|
8094
|
-
|
|
8095
|
-
|
|
8096
|
-
|
|
8097
|
-
|
|
8098
|
-
|
|
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
|
|
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) =>
|
|
9277
|
-
|
|
9278
|
-
|
|
9279
|
-
|
|
9280
|
-
|
|
9281
|
-
|
|
9282
|
-
|
|
9283
|
-
|
|
9284
|
-
|
|
9285
|
-
|
|
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;
|