@orkestrel/scaffold 0.0.133 → 0.0.135
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/agents/skills/orkestrel-dispatch/scripts/bench.js +61 -96
- package/dist/agents/skills/orkestrel-dispatch/scripts/brief.js +48 -76
- package/dist/agents/skills/orkestrel-dispatch/scripts/chain.js +27 -66
- package/dist/agents/skills/orkestrel-dispatch/scripts/cite.js +31 -64
- package/dist/agents/skills/orkestrel-dispatch/scripts/launch.js +43 -57
- package/dist/agents/skills/orkestrel-dispatch/scripts/login.js +43 -86
- package/dist/agents/skills/orkestrel-dispatch/scripts/patch.js +68 -104
- package/dist/agents/skills/orkestrel-dispatch/scripts/result.js +35 -69
- package/dist/agents/skills/orkestrel-dispatch/scripts/sweep.js +47 -84
- package/dist/agents/skills/orkestrel-falsify/scripts/mutate.js +134 -116
- package/dist/agents/skills/orkestrel-harden/scripts/discovery.js +38 -90
- package/dist/agents/skills/orkestrel-harden/scripts/interleave.js +39 -103
- package/dist/agents/skills/orkestrel-harden/scripts/measure.js +40 -89
- package/dist/agents/skills/orkestrel-harden/scripts/titles.js +41 -87
- package/dist/agents/skills/orkestrel-parallel/scripts/cases.js +43 -88
- package/dist/agents/skills/orkestrel-parallel/scripts/lane.js +1568 -213
- package/dist/agents/skills/orkestrel-publish/scripts/compare.js +40 -60
- package/dist/agents/skills/orkestrel-publish/scripts/pins.js +47 -81
- package/dist/agents/skills/orkestrel-publish/scripts/steps.js +66 -104
- package/dist/agents/skills/orkestrel-publish/scripts/swap.js +74 -88
- package/dist/agents/skills/orkestrel-publish/scripts/wave.js +387 -109
- package/dist/agents/skills/orkestrel-publish/scripts/window.js +55 -96
- package/dist/agents/skills/orkestrel-scout/scripts/map.js +54 -101
- package/dist/bin/main.js +275 -33
- package/dist/bin/main.js.map +1 -1
- package/dist/host/AGENTS.md +1 -1
- package/dist/host/agents/skills/orkestrel-dispatch/scripts/bench.ts +81 -97
- package/dist/host/agents/skills/orkestrel-dispatch/scripts/brief.ts +64 -72
- package/dist/host/agents/skills/orkestrel-dispatch/scripts/chain.ts +41 -63
- package/dist/host/agents/skills/orkestrel-dispatch/scripts/cite.ts +56 -79
- package/dist/host/agents/skills/orkestrel-dispatch/scripts/launch.ts +61 -74
- package/dist/host/agents/skills/orkestrel-dispatch/scripts/login.ts +59 -89
- package/dist/host/agents/skills/orkestrel-dispatch/scripts/patch.ts +87 -106
- package/dist/host/agents/skills/orkestrel-dispatch/scripts/result.ts +57 -76
- package/dist/host/agents/skills/orkestrel-dispatch/scripts/sweep.ts +73 -88
- package/dist/host/agents/skills/orkestrel-falsify/SKILL.md +2 -2
- package/dist/host/agents/skills/orkestrel-falsify/scripts/mutate.ts +167 -119
- package/dist/host/agents/skills/orkestrel-harden/references/methods.md +1 -1
- package/dist/host/agents/skills/orkestrel-harden/scripts/discovery.ts +58 -75
- package/dist/host/agents/skills/orkestrel-harden/scripts/interleave.ts +55 -99
- package/dist/host/agents/skills/orkestrel-harden/scripts/measure.ts +59 -90
- package/dist/host/agents/skills/orkestrel-harden/scripts/titles.ts +60 -80
- package/dist/host/agents/skills/orkestrel-parallel/SKILL.md +4 -4
- package/dist/host/agents/skills/orkestrel-parallel/scripts/cases.ts +71 -108
- package/dist/host/agents/skills/orkestrel-parallel/scripts/lane.ts +1990 -274
- package/dist/host/agents/skills/orkestrel-publish/references/release.md +1 -0
- package/dist/host/agents/skills/orkestrel-publish/references/wave.md +28 -7
- package/dist/host/agents/skills/orkestrel-publish/scripts/compare.ts +58 -79
- package/dist/host/agents/skills/orkestrel-publish/scripts/pins.ts +66 -87
- package/dist/host/agents/skills/orkestrel-publish/scripts/steps.ts +84 -102
- package/dist/host/agents/skills/orkestrel-publish/scripts/swap.ts +92 -99
- package/dist/host/agents/skills/orkestrel-publish/scripts/wave.ts +483 -127
- package/dist/host/agents/skills/orkestrel-publish/scripts/window.ts +82 -120
- package/dist/host/agents/skills/orkestrel-scout/SKILL.md +3 -3
- package/dist/host/agents/skills/orkestrel-scout/scripts/map.ts +85 -112
- package/dist/host/claude/agents/orkestrel.md +16 -16
- package/dist/host/claude/rules/architecture.md +1 -1
- package/dist/host/claude/rules/documentation.md +1 -1
- package/dist/host/claude/rules/patterns.md +7 -4
- package/dist/host/claude/rules/styles.md +1 -1
- package/dist/host/claude/rules/tests.md +3 -3
- package/dist/host/claude/rules/workspace.md +50 -37
- package/dist/host/configs/helpers.ts +117 -71
- package/dist/host/dotfiles/oxlintrc.json +6 -0
- package/dist/host/guides/agent.md +989 -395
- package/dist/host/guides/database.md +357 -342
- package/dist/host/guides/form.md +79 -4
- package/dist/host/guides/middleware.md +5 -5
- package/dist/host/guides/ollama.md +41 -42
- package/dist/host/guides/scaffold.md +170 -70
- package/dist/host/guides/study.md +12 -12
- package/dist/host/guides/table.md +20 -6
- package/dist/host/guides/test.md +166 -52
- package/dist/host/guides/toolbox.md +127 -81
- package/dist/host/guides/workspace.md +21 -14
- package/dist/host/manifest.json +54 -54
- package/dist/host/tests/config.test.ts +251 -7
- package/dist/host/tests/policy.test.ts +14 -21
- package/dist/host/tests/setupPolicy.ts +43 -36
- package/dist/src/core/index.cjs +533 -139
- package/dist/src/core/index.cjs.map +1 -1
- package/dist/src/core/index.d.cts +223 -16
- package/dist/src/core/index.d.ts +223 -16
- package/dist/src/core/index.js +524 -139
- package/dist/src/core/index.js.map +1 -1
- package/dist/src/server/index.cjs +23 -14
- package/dist/src/server/index.cjs.map +1 -1
- package/dist/src/server/index.d.cts +3 -2
- package/dist/src/server/index.d.ts +3 -2
- package/dist/src/server/index.js +24 -15
- package/dist/src/server/index.js.map +1 -1
- package/package.json +2 -2
|
@@ -103,7 +103,8 @@ Exported from `@orkestrel/scaffold`, and reachable from
|
|
|
103
103
|
| `HydratedArtifact` | interface | `{ origin, ownership, source?, hex, content? }` | Represents a vendored file whose exact bytes have been read, so its content can be compared. |
|
|
104
104
|
| `ManifestDependencySet` | interface | `{ runtime, development, peer }` | Describes the runtime, development, and peer sections read from an existing package manifest. |
|
|
105
105
|
| `ManifestEdit` | interface | `{ start, end, text }` | Represents one in-place replacement of manifest text. |
|
|
106
|
-
| `
|
|
106
|
+
| `ManifestEntrySet` | interface | `{ bin, files, exports }` | Describes the `bin`, `files`, and `exports` entries a manifest carries. |
|
|
107
|
+
| `ManifestRegionSet` | interface | `{ pins, scripts, additions?, overrides?, entries? }` | Describes the manifest regions a writing operation may change. |
|
|
107
108
|
| `ManifestScript` | interface | `{ name, command, accepted }` | Represents one manifest script a region-writing operation may replace. |
|
|
108
109
|
| `ManifestToken` | interface | `{ text, index, depth, value }` | Represents one string or object brace found in manifest text. |
|
|
109
110
|
| `Override` | interface | `{ path, content }` | Represents one artifact override. |
|
|
@@ -133,7 +134,6 @@ Exported from `@orkestrel/scaffold`, and reachable from
|
|
|
133
134
|
| Name | Kind | Signature | Summary |
|
|
134
135
|
| --------------------------------- | ----- | ------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
135
136
|
| `APP_BROWSER_DEV_DEPENDENCIES` | const | `Readonly<Record<string, string>>` | Lists the development dependencies a private browser application adds. |
|
|
136
|
-
| `APP_DEV_DEPENDENCIES` | const | `Readonly<Record<string, string>>` | Names the development dependency every private `app` environment adds. |
|
|
137
137
|
| `APP_MATRIX` | const | `Readonly<Record<Environment, AppDefinition>>` | Holds the configuration and runtime-entry settings each private `app` environment contributes, frozen. |
|
|
138
138
|
| `APP_SERVER_DEV_DEPENDENCIES` | const | `Readonly<Record<string, string>>` | Lists the development dependencies a private server application adds. |
|
|
139
139
|
| `ARTIFACT_GROUPS` | const | `readonly ArtifactGroup[]` | Lists the `ArtifactGroup` values in plan order, frozen. |
|
|
@@ -142,7 +142,8 @@ Exported from `@orkestrel/scaffold`, and reachable from
|
|
|
142
142
|
| `BARREL_CONFIGS` | const | `readonly string[]` | Lists the configuration file a workspace with studies and a server application adds, frozen. |
|
|
143
143
|
| `BASE_DEV_DEPENDENCIES` | const | `Readonly<Record<string, string>>` | Holds the baseline tooling versions, before framework holds apply. |
|
|
144
144
|
| `BIN_CONFIGS` | const | `readonly string[]` | Lists the configuration files a workspace that ships its own executable adds, frozen. |
|
|
145
|
-
| `BIN_ENTRY_PATH` | const | `"src/bin/main.ts"` | Names the executable entry
|
|
145
|
+
| `BIN_ENTRY_PATH` | const | `"src/bin/main.ts"` | Names the executable entry, the `main` module of `src/bin`. |
|
|
146
|
+
| `BIN_MODULE_PATTERN` | const | `RegExp` | Matches the stem of a `src/bin` module: lowercase letters and digits, letter first, no hyphen. |
|
|
146
147
|
| `BIN_OUTPUT_PATH` | const | `"dist/bin/main.js"` | Names the built executable a bin workspace's manifest command runs. |
|
|
147
148
|
| `BROWSE_DEV_DEPENDENCIES` | const | `Readonly<Record<string, string>>` | Names the development dependency a browser or styles surface adds. |
|
|
148
149
|
| `BROWSE_UPSTREAM` | const | `readonly string[]` | Lists the packages `@orkestrel/browser` depends on at runtime, directly or transitively, frozen. |
|
|
@@ -153,6 +154,7 @@ Exported from `@orkestrel/scaffold`, and reachable from
|
|
|
153
154
|
| `CATALOG_AGENT_PATH` | const | `".claude/agents/orkestrel.md"` | Names the agent file whose marker-bounded package table the catalog verb alone owns. |
|
|
154
155
|
| `CATALOG_END_MARKER` | const | `"<!-- /orkestrel:catalog -->"` | Names the marker closing the package table inside `CATALOG_AGENT_PATH`. |
|
|
155
156
|
| `CATALOG_START_MARKER` | const | `"<!-- orkestrel:catalog -->"` | Names the marker opening the package table inside `CATALOG_AGENT_PATH`. |
|
|
157
|
+
| `CENTRAL_FILE_NAMES` | const | `readonly string[]` | Lists the stems of the centralized files the architecture kind table names, which no `src/bin` module takes, frozen. |
|
|
156
158
|
| `CONFIG_TEMPLATES` | const | `ConfigTemplateSet` | Holds formatter-stable template text for every configuration artifact. |
|
|
157
159
|
| `CONFORMANCE_TEST_PATH` | const | `"tests/conformance.test.ts"` | Names the official-tooling drift proof whose presence makes a workspace `conformance`. |
|
|
158
160
|
| `CONTROL_CHARACTER_PATTERN` | const | `RegExp` | Matches the Unicode controls, formatting controls, and line and paragraph separators rejected in text. |
|
|
@@ -178,6 +180,7 @@ Exported from `@orkestrel/scaffold`, and reachable from
|
|
|
178
180
|
| `INTEGRATION_TEST_PATH` | const | `"tests/integration.test.ts"` | Names the cross-environment composition proof whose presence makes a workspace `integration`. |
|
|
179
181
|
| `INVALID_PATH_CHARACTER_PATTERN` | const | `RegExp` | Matches the visible characters a target-relative path and a Markdown path cell both forbid. |
|
|
180
182
|
| `JOURNEY_CONFIG_PATH` | const | `"configs/app/vite.journey.config.ts"` | Names the Vite wrapper whose presence makes a workspace `journey`. |
|
|
183
|
+
| `MANIFEST_KEY_ORDER` | const | `readonly string[]` | Lists the top-level manifest keys in the order a compiled manifest emits them. |
|
|
181
184
|
| `MANIFEST_PATH` | const | `"package.json"` | Names the manifest path every compiler plan emits with birth ownership. |
|
|
182
185
|
| `MAX_ARTIFACT_BYTES` | const | `5242880` | Caps the bytes accepted for one artifact. |
|
|
183
186
|
| `MAX_ARTIFACT_HEX_LENGTH` | const | `number` | Caps the length of the hexadecimal string carrying one artifact's bytes. |
|
|
@@ -232,36 +235,38 @@ Exported from `@orkestrel/scaffold`, and reachable from
|
|
|
232
235
|
|
|
233
236
|
#### Guards
|
|
234
237
|
|
|
235
|
-
| Name | Kind | Signature
|
|
236
|
-
| -------------------- | -------- |
|
|
237
|
-
| `isArtifact` | const | `Guard<Artifact>`
|
|
238
|
-
| `isArtifactFinding` | const | `Guard<ArtifactFinding>`
|
|
239
|
-
| `isArtifactGroup` | const | `Guard<ArtifactGroup>`
|
|
240
|
-
| `isArtifactGroups` | const | `Guard<readonly ArtifactGroup[]>`
|
|
241
|
-
| `isAudit` | const | `Guard<Audit>`
|
|
242
|
-
| `isBlueprint` | const | `Guard<Blueprint>`
|
|
243
|
-
| `
|
|
244
|
-
| `
|
|
245
|
-
| `
|
|
246
|
-
| `
|
|
247
|
-
| `
|
|
248
|
-
| `
|
|
249
|
-
| `
|
|
250
|
-
| `
|
|
251
|
-
| `
|
|
252
|
-
| `
|
|
253
|
-
| `
|
|
254
|
-
| `
|
|
255
|
-
| `
|
|
256
|
-
| `
|
|
257
|
-
| `
|
|
258
|
-
| `
|
|
259
|
-
| `
|
|
260
|
-
| `
|
|
261
|
-
| `
|
|
262
|
-
| `
|
|
263
|
-
| `
|
|
264
|
-
| `
|
|
238
|
+
| Name | Kind | Signature | Summary |
|
|
239
|
+
| -------------------- | -------- | ---------------------------------------------------------------- | --------------------------------------------------------------------------------- |
|
|
240
|
+
| `isArtifact` | const | `Guard<Artifact>` | Narrows a value to an `Artifact`. |
|
|
241
|
+
| `isArtifactFinding` | const | `Guard<ArtifactFinding>` | Narrows a value to an `ArtifactFinding`. |
|
|
242
|
+
| `isArtifactGroup` | const | `Guard<ArtifactGroup>` | Narrows a value to one `ArtifactGroup` a plan selects over. |
|
|
243
|
+
| `isArtifactGroups` | const | `Guard<readonly ArtifactGroup[]>` | Narrows a value to a bounded group selection. |
|
|
244
|
+
| `isAudit` | const | `Guard<Audit>` | Narrows a value to an `Audit`. |
|
|
245
|
+
| `isBlueprint` | const | `Guard<Blueprint>` | Narrows a value to a `Blueprint`. |
|
|
246
|
+
| `isBinModule` | function | `(value: unknown) => value is string` | Narrows a value to the stem of a `src/bin` module. |
|
|
247
|
+
| `isBrowserExtension` | const | `Guard<BrowserExtension>` | Narrows a value to a supported browser framework with distinct occupied axes. |
|
|
248
|
+
| `isCatalogEntry` | const | `Guard<CatalogEntry>` | Narrows a value to a `CatalogEntry`. |
|
|
249
|
+
| `isCollection` | function | `(value: unknown) => value is readonly unknown[]` | Narrows a value to an array within the limit one public collection accepts. |
|
|
250
|
+
| `isCompilerHooks` | const | `Guard<EmitterHooks<CompilerEventMap>>` | Narrows a value to the compiler's initial listener record. |
|
|
251
|
+
| `isCompilerOptions` | const | `Guard<CompilerOptions>` | Narrows a value to `CompilerOptions`. |
|
|
252
|
+
| `isContent` | const | `Guard<string>` | Narrows a value to text this package will accept as one artifact's content. |
|
|
253
|
+
| `isDependency` | const | `Guard<Dependency>` | Narrows a value to a `Dependency`. |
|
|
254
|
+
| `isDependencyName` | const | `Guard<string>` | Narrows a value to the scoped package name a runtime dependency carries. |
|
|
255
|
+
| `isEnvironment` | const | `Guard<Environment>` | Narrows a value to one `Environment` a workspace may select. |
|
|
256
|
+
| `isExtension` | const | `Guard<Extension>` | Narrows a value to an extension of a supported surface. |
|
|
257
|
+
| `isHexContent` | const | `Guard<string>` | Narrows a value to exact lowercase hexadecimal bytes within one artifact's limit. |
|
|
258
|
+
| `isManifestScript` | const | `Guard<ManifestScript>` | Narrows a value to a `ManifestScript`. |
|
|
259
|
+
| `isMirror` | const | `Guard<Mirror>` | Narrows a value to a `Mirror`. |
|
|
260
|
+
| `isOverride` | const | `Guard<Override>` | Narrows a value to an `Override`. |
|
|
261
|
+
| `isPath` | function | `(value: unknown) => value is string` | Narrows a value to a logical target-relative path. |
|
|
262
|
+
| `isPlan` | const | `Guard<Plan>` | Narrows a value to a `Plan`. |
|
|
263
|
+
| `isQuestion` | const | `Guard<Question>` | Narrows a value to a `Question`. |
|
|
264
|
+
| `isScaffoldError` | function | `(value: unknown) => value is ScaffoldError` | Narrows a caught value to a `ScaffoldError`. |
|
|
265
|
+
| `isSheetName` | function | `(value: unknown) => value is string` | Narrows a value to a non-reserved sheet face name. |
|
|
266
|
+
| `isSnapshot` | function | `(value: unknown) => value is Snapshot` | Narrows a value to a `Snapshot`. |
|
|
267
|
+
| `isStylesExtension` | const | `Guard<StylesExtension>` | Narrows a value to a named non-reserved stylesheet face. |
|
|
268
|
+
| `isSubpathMap` | function | `(value: unknown) => value is Readonly<Record<string, unknown>>` | Narrows a manifest `exports` value to a map of subpaths. |
|
|
269
|
+
| `isSurface` | const | `Guard<Surface>` | Narrows a value to a surface an extension can extend. |
|
|
265
270
|
|
|
266
271
|
#### Parsers
|
|
267
272
|
|
|
@@ -296,14 +301,17 @@ Exported from `@orkestrel/scaffold`, and reachable from
|
|
|
296
301
|
| `isRetainedPath` | function | `(path: string) => boolean` | Checks whether another surface owns a target's present bytes at a path. |
|
|
297
302
|
| `iterateAnswers` | function | `<TValue, TAnswer>(source: Iterable<TValue>, answer: (value: TValue) => TAnswer \| undefined) => Generator<TAnswer \| undefined, void, undefined>` | Yields the answer to each value of a source and ends after the first refused answer. |
|
|
298
303
|
| `manifestToDependencies` | function | `(manifest: string) => ManifestDependencySet` | Projects a package manifest's text to the `@orkestrel/*` packages each dependency section declares. |
|
|
304
|
+
| `manifestToEntries` | function | `(manifest: string, planned: ManifestEntrySet) => ManifestEntrySet` | Projects a package manifest's text to the planned `bin`, `files`, and `exports` entries it lacks. |
|
|
299
305
|
| `manifestToName` | function | `(manifest: string) => string \| undefined` | Projects a package manifest's text to its own name. |
|
|
300
306
|
| `matchesArtifactDriftReachability` | function | `(ownership: Ownership, finding: ArtifactFinding) => boolean` | Tests whether `inferArtifactDrift` could have produced a finding for an ownership. |
|
|
301
307
|
| `matchesBarrel` | function | `(blueprint: Blueprint) => boolean` | Tests whether a workspace plans the application server barrel build. |
|
|
302
308
|
| `matchesEngines` | function | `(engines: string) => boolean` | Tests whether a declared engines floor is at or above the supported minimum. |
|
|
303
309
|
| `matchesOrchestrationPath` | function | `(path: string) => boolean` | Tests whether a path instructs or wires an agent rather than the toolchain. |
|
|
310
|
+
| `matchesPackedPath` | function | `(declared: string, planned: string) => boolean` | Checks whether a declared `files` entry packs a planned one. |
|
|
304
311
|
| `matchesPrintWidth` | function | `(line: string) => boolean` | Tests whether one emitted line fits the vendored formatter width. |
|
|
305
312
|
| `matchesRange` | function | `(range: string, latest: string) => boolean` | Tests whether a declared range already admits a published version. |
|
|
306
313
|
| `nameToGuide` | function | `(name: string) => string` | Derives the guide mirror path a package name answers for. |
|
|
314
|
+
| `normalizePackagePath` | function | `(path: string) => string` | Returns the canonical form of a path a manifest names inside its package. |
|
|
307
315
|
| `parseOwnedJSONValue` | function | `(value: unknown) => JSONValue \| undefined` | Snapshots an untrusted value into exact JSON data the caller owns. |
|
|
308
316
|
| `planToSummary` | function | `(plan: Plan) => PlanSummary` | Projects a plan into its tally by artifact origin. |
|
|
309
317
|
| `renderSkillPointer` | function | `(canonical: string, name: string) => string \| undefined` | Renders the `SKILL.md` pointer a target carries in place of a canonical skill. |
|
|
@@ -333,7 +341,8 @@ Exported from `@orkestrel/scaffold`, and reachable from
|
|
|
333
341
|
| `blueprintToDevDependencies` | function | `(blueprint: Blueprint) => Readonly<Record<string, string>>` | Projects a blueprint into the development dependencies its manifest declares. |
|
|
334
342
|
| `blueprintToToolchainHolds` | function | `(blueprint: Blueprint) => Readonly<Record<string, ToolchainHold>>` | Projects a blueprint into the toolchain holds its browser frameworks require. |
|
|
335
343
|
| `blueprintToDocumentArtifacts` | function | `(blueprint: Blueprint) => readonly ContentArtifact[]` | Compiles the generated workspace's root documentation. |
|
|
336
|
-
| `
|
|
344
|
+
| `blueprintToEntries` | function | `(blueprint: Blueprint) => ManifestEntrySet` | Projects a blueprint into the `bin`, `files`, and `exports` entries its manifest carries. |
|
|
345
|
+
| `blueprintToExports` | function | `(blueprint: Blueprint) => Readonly<Record<string, unknown>>` | Projects published environments, sheets, and `src/bin` modules into the manifest export map. |
|
|
337
346
|
| `blueprintToFaces` | function | `(blueprint: Blueprint) => readonly BrowserExtension[]` | Projects a blueprint into browser extensions restricted to occupied browser axes. |
|
|
338
347
|
| `blueprintToGuideArtifacts` | function | `(blueprint: Blueprint) => readonly ContentArtifact[]` | Compiles the generated workspace's guide index. |
|
|
339
348
|
| `blueprintToHostArtifacts` | function | `(blueprint: Blueprint) => readonly Artifact[]` | Compiles the vendored host artifacts a workspace plans. |
|
|
@@ -353,6 +362,7 @@ Exported from `@orkestrel/scaffold`, and reachable from
|
|
|
353
362
|
| `blueprintToWritableScripts` | function | `(blueprint: Blueprint) => readonly ManifestScript[]` | Projects a blueprint into the manifest scripts a region write may replace. |
|
|
354
363
|
| `dependenciesToQuestions` | function | `(dependencies: readonly Dependency[], field: string, name: RegExp, range: RegExp) => readonly Question[]` | Measures one declared package list against the name and range syntax it accepts. |
|
|
355
364
|
| `insertManifestDependencies` | function | `(manifest: string, additions: DependencyPinSet) => string \| undefined` | Inserts dependencies a package manifest does not declare into the section each one names. |
|
|
365
|
+
| `insertManifestEntries` | function | `(manifest: string, planned: ManifestEntrySet) => string \| undefined` | Inserts the planned `bin`, `files`, and `exports` entries a package manifest lacks. |
|
|
356
366
|
| `insertManifestSection` | function | `(manifest: string, section: 'dependencies' \| 'devDependencies', dependencies: readonly Dependency[], present: boolean) => string \| undefined` | Inserts dependencies into one section of package manifest text. |
|
|
357
367
|
| `overridesToQuestions` | function | `(overrides: readonly Override[], artifacts: readonly Artifact[]) => readonly Question[]` | Measures a blueprint's overrides against the artifacts drafted for it. |
|
|
358
368
|
| `pathToCondition` | function | `(path: string, formats: readonly BuildFormat[]) => Readonly<Record<string, unknown>>` | Builds one `exports` condition block for a built environment. |
|
|
@@ -697,9 +707,49 @@ files on `main`, the scaffold repository's `host.json` file, and changed vendore
|
|
|
697
707
|
`ORKESTREL_SCAFFOLD_REPOSITORY` replaces the repository base. These settings change which host
|
|
698
708
|
answers a read and grant no verb write authority that it did not already have.
|
|
699
709
|
|
|
700
|
-
`new --bin` creates the executable entry, its test, and its scoped Vite and TypeScript wrappers.
|
|
701
|
-
|
|
702
|
-
`
|
|
710
|
+
`new --bin` creates the executable entry, its test, and its scoped Vite and TypeScript wrappers.
|
|
711
|
+
|
|
712
|
+
A `src/bin` module takes no creation option. Write it as a direct child `src/bin/<name>.ts` whose
|
|
713
|
+
name `BIN_MODULE_PATTERN` admits and `CENTRAL_FILE_NAMES` does not name, as an import from a library
|
|
714
|
+
environment through its `@src/*` alias followed by `export default` of the imported value, because
|
|
715
|
+
a host tool such as Vitest's `--reporter=<specifier>` loads the module's default export. The reading
|
|
716
|
+
verbs list every direct `.ts` file whose name opens with a lowercase letter and names no
|
|
717
|
+
centralized file in `bin`, and the gate refuses one `isBinModule` rejects, such as `my-tool`.
|
|
718
|
+
`main` stays the executable. Each module other than
|
|
719
|
+
`main` builds through `srcBin` and `configs/src/vite.bin.config.ts` to the ES-only
|
|
720
|
+
`dist/bin/<name>.js` with its rolled-up `dist/bin/<name>.d.ts`, and the manifest exports it as
|
|
721
|
+
`./<name>`. Only `main.js` carries the `#!/usr/bin/env node` banner, and only `main` plans the `bin`
|
|
722
|
+
command. Every module shares `check:src:bin`, `build:src:bin`, `test:src:bin`, and the `src:bin`
|
|
723
|
+
project over `tests/src/bin`. The build keeps every `@src/*` specifier external and rewrites it
|
|
724
|
+
through `output.paths` to the built `../src/<environment>/index.js`, and `rewriteSourceSpecifier`
|
|
725
|
+
writes the same path into each declaration. The vendored `.oxlintrc.json` admits a default export
|
|
726
|
+
in `src/bin/*.ts` and refuses a relative import of `src/core` or `src/server` from `src/bin`, which
|
|
727
|
+
would bundle a second copy of the environment. The distribution proof reads `dist/bin` as its own
|
|
728
|
+
face and reports a library source copied into it. The gate refuses a module whose `./<name>`
|
|
729
|
+
subpath another planned subpath takes, such as `src/bin/server.ts` beside `src/server`, and names
|
|
730
|
+
both. A consumer loads a module by its subpath, as `--reporter=@orkestrel/test/reporter` loads the
|
|
731
|
+
`reporter` module of `@orkestrel/test`.
|
|
732
|
+
|
|
733
|
+
When an existing workspace adds a `src/bin` module, `overwrite` writes every row its manifest
|
|
734
|
+
lacks: `exports["./<name>"]`, `dist/bin` in `files`, `check:src:bin`, `build:src:bin`, and
|
|
735
|
+
`test:src:bin`. It extends `test:src`, `check:src`, and `build:src` where each still holds a value
|
|
736
|
+
an earlier plan generated. `repair` writes the scripts and none of the entries. Before the write,
|
|
737
|
+
`audit` reports the missing entries in its `entries` question and the missing scripts in its
|
|
738
|
+
`scripts` question. Where the package owns `check:src` or `build:src`, the `scripts` question asks
|
|
739
|
+
you to invoke `npm run check:src:bin` from the `check:src` chain and `npm run build:src:bin` from
|
|
740
|
+
the `build:src` chain. Where the manifest declares no `check:src` or `build:src`, the question names
|
|
741
|
+
the script to add and the `check` or `build` chain that invokes it. Where the package owns
|
|
742
|
+
`test:src`, the `projects` question asks you to add `--project src:bin` to it, and `overwrite`
|
|
743
|
+
refuses the `configs` group with that same step named until a chain from `test` reaches the
|
|
744
|
+
project. `src/bin/main.ts` adds the `bin` command to the same rows. An executable reaches `dist/src` only through
|
|
745
|
+
the `@src/*` specifiers its build rewrites, one per library environment, so `dist/src` is packed
|
|
746
|
+
only where a library environment or a sheet builds into it, and an executable beside neither packs
|
|
747
|
+
`dist/bin` and no `dist/src`. An added library environment follows the
|
|
748
|
+
same rule: `overwrite` writes its subpath, `check:src:<environment>`, `build:src:<environment>`,
|
|
749
|
+
and `test:src:<environment>`, and extends the generated aggregates.
|
|
750
|
+
|
|
751
|
+
The `new --app browser` command selects the journey axis, creates its birth-owned wrapper,
|
|
752
|
+
defines `appJourney` in the root configuration, and excludes the browser integration suite from
|
|
703
753
|
`app:browser`. Its manifest declares `test:journey`. A `private: true` workspace invokes it after
|
|
704
754
|
`npm run test:app` in `test`; a publishing workspace runs application and journey suites on demand,
|
|
705
755
|
outside release gates and chains. It also declares `journey: capture journey` and `capture: capture frames` for explicit
|
|
@@ -771,7 +821,8 @@ environment's export a distinct name. The record never holds a conflict, so a co
|
|
|
771
821
|
run that reads its owner as a candidate.
|
|
772
822
|
|
|
773
823
|
A candidate refuses, naming its path, when its manifest is unreadable, when it has neither its guide
|
|
774
|
-
nor `src
|
|
824
|
+
nor `src/` (an app-only workspace, which publishes no surface and relies on its `test:policy`
|
|
825
|
+
`surface` rule), when its guide exists but is not UTF-8 text within the artifact bound, or when a
|
|
775
826
|
TypeScript source under `src/` cannot be read. Only `.ts` files under `src/` are read, so a binary
|
|
776
827
|
asset there is ignored. A barrel holding a statement other than `export * from './module.js'`
|
|
777
828
|
refuses with the statement named, because the reflection follows nothing else and an incomplete
|
|
@@ -877,7 +928,7 @@ and the declared `@orkestrel/*` packages come from `package.json`. The environme
|
|
|
877
928
|
the directories the target actually ships, because a directory is the fact and a declaration beside
|
|
878
929
|
it could disagree. The styles surface, its themes target, the showcase, and every extension are
|
|
879
930
|
read from the markers Surfaces and extensions lists. The remaining facts come from exact-case
|
|
880
|
-
files: `src/bin
|
|
931
|
+
files: each direct `src/bin` module adds its name to `bin`, each root `tests/setup*.test.ts` match selects `setup`,
|
|
881
932
|
`tests/guides.test.ts` selects `guides`, `tests/integration.test.ts` selects `integration`,
|
|
882
933
|
`tests/conformance.test.ts` selects `conformance`, `tests/tree.test.ts` selects `tree`,
|
|
883
934
|
`tests/setupService.ts` selects `service`,
|
|
@@ -990,6 +1041,8 @@ Scaffold writes one part of the manifest rather than advising on it: the writabl
|
|
|
990
1041
|
`repair` and `overwrite` write every direct `test:<project>` script the blueprint computes,
|
|
991
1042
|
`test:probe`, and `test:bench`. A publishing workspace also receives `test:distribution`, `prepack`,
|
|
992
1043
|
and `prepublishOnly`. Each sheet face adds its `check:src:<face>` and `build:src:<face>` scripts.
|
|
1044
|
+
Each library environment adds its `check:src:<environment>` and `build:src:<environment>` scripts.
|
|
1045
|
+
The `src/bin` modules add `check:src:bin` and `build:src:bin`.
|
|
993
1046
|
Each occupied framework face adds `check:<axis>:vue` and `build:<axis>:vue`; the application face also adds `dev:vue`.
|
|
994
1047
|
Selected showcase pages add `showcase`, `showcase:<framework>`, `build:showcase`, and `build:showcase:<framework>`; application journeys add `test:journey:<framework>`.
|
|
995
1048
|
A workspace that plans the application server barrel adds `build:app:barrel`, which has no
|
|
@@ -1001,18 +1054,26 @@ predecessor of the chain that builds themes after it. A publishing `test` chain
|
|
|
1001
1054
|
it matches byte for byte the planned chain with the generated `test:app`, `test:journey`, and framework
|
|
1002
1055
|
journey invocations inserted after `test:src`, where that blueprint emitted them before.
|
|
1003
1056
|
`repair` and `overwrite` remove those helper invocations from that exact predecessor.
|
|
1004
|
-
When the `test` or `build:app` chain is a generated
|
|
1005
|
-
|
|
1006
|
-
|
|
1007
|
-
|
|
1008
|
-
|
|
1009
|
-
|
|
1057
|
+
When the `test`, `test:src`, `check:src`, `build:src`, or `build:app` chain is a generated
|
|
1058
|
+
predecessor, which runs fewer steps or names fewer `--project` values than the planned chain and
|
|
1059
|
+
runs only planned steps and projects in the planned order, that chain joins the region and `repair`
|
|
1060
|
+
and `overwrite` write the planned chain in its place. That write lands only when every step the
|
|
1061
|
+
planned chain adds runs a Vitest command or a script the manifest declares or the region writes. An
|
|
1062
|
+
absent aggregate is never written, and `test:app` sits outside the region. Only a private
|
|
1063
|
+
workspace's planned chain invokes `test:app`. A chain whose planned form adds an
|
|
1010
1064
|
aggregate the manifest lacks stays with the package, and the `projects` question keeps its remedy.
|
|
1011
1065
|
`audit` reports this `test` chain write only through the `projects` question, so a planned step that
|
|
1012
1066
|
registers no Vitest project, such as `npm run test:guides`, lands on the next `repair` without an
|
|
1013
|
-
earlier advisory. `audit` reports no `build:app` chain write, so
|
|
1014
|
-
`
|
|
1015
|
-
`
|
|
1067
|
+
earlier advisory. `audit` reports no `build:app` chain write, so `repair` rewrites a predecessor
|
|
1068
|
+
`build:app` with no earlier advisory after `build:app:barrel` is declared, and before then only the
|
|
1069
|
+
`scripts` question's report of a missing `build:app:barrel` script precedes that write. A
|
|
1070
|
+
package-owned `build:app` chain that omits the barrel step stays with the package, and the `scripts`
|
|
1071
|
+
question reports that no chain from `build` reaches `build:app:barrel`. A package-owned `check:src`
|
|
1072
|
+
or `build:src` chain that omits an entry's step stays with the package, and the `scripts` question
|
|
1073
|
+
reports each of `check:src:bin` and `build:src:bin`
|
|
1074
|
+
that no chain from `check` or `build` reaches. A package-owned `test:src` that omits an entry's
|
|
1075
|
+
project raises the `projects` question, which names `test:src` and the missing `--project` value.
|
|
1076
|
+
A chain the region lists running any other step or order stays maintainer-owned, as do the
|
|
1016
1077
|
`check`, `build`, `dev`, `serve`, `format`, `lint`, `clean`, and `copy` gate chains. A
|
|
1017
1078
|
declared value is overwritten only when it is already the value being written or is a recognized
|
|
1018
1079
|
generated predecessor. The overwrite happens in place,
|
|
@@ -1038,6 +1099,38 @@ reconcile the declared ranges and write the script region on every run, whatever
|
|
|
1038
1099
|
names. A run scoped to `manifest` for a script write takes the reconciled `@orkestrel/*`
|
|
1039
1100
|
ranges with it, and a run that excludes `manifest` still takes the ranges and the scripts.
|
|
1040
1101
|
|
|
1102
|
+
`overwrite` also inserts each planned `bin` command, `files` path, and `exports` subpath the
|
|
1103
|
+
manifest lacks, whatever `--groups` selects, and `repair` inserts none. The entries land in the
|
|
1104
|
+
offline half beside the dependency declarations, so a catalog step that cannot complete keeps them.
|
|
1105
|
+
An inserted entry lands before the first declared entry the plan orders after it and copies the
|
|
1106
|
+
section's indentation; an absent section is created before the first declared key the born
|
|
1107
|
+
manifest orders after it. A declared entry keeps its value whatever the plan holds, and each
|
|
1108
|
+
section reads a planned entry as declared by its own rule:
|
|
1109
|
+
|
|
1110
|
+
- A planned command is declared when `bin` names it, or when any declared command runs the planned
|
|
1111
|
+
file, so a package that publishes its executable under another name, such as `browse`, keeps
|
|
1112
|
+
that name. A string `bin` declares the planned command when it names the planned file. Both
|
|
1113
|
+
forms read a path as npm does: a backslash is a separator and a run of separators is one, so
|
|
1114
|
+
`dist\bin\main.js` and `dist//bin/main.js` name `dist/bin/main.js`.
|
|
1115
|
+
- A planned `files` path is declared when a declared path equals it or names a directory above it,
|
|
1116
|
+
compared by path segments, so `dist` packs `dist/app` and `dist-old` does not. A declared path
|
|
1117
|
+
ending in `/**` or `/*` names the directory before it, so `dist/**` packs `dist/app`. No other
|
|
1118
|
+
glob is read: `dist/*.js` declares no planned path it does not equal. A negated path is declared
|
|
1119
|
+
only by an equal entry.
|
|
1120
|
+
- A planned subpath is declared when the `exports` map names it. A string `exports`, a fallback
|
|
1121
|
+
array, or an object whose keys are conditions such as `import` and `require` publishes the root
|
|
1122
|
+
export alone, so it declares `.` and takes no other subpath: Node refuses an object that mixes
|
|
1123
|
+
conditions with subpaths.
|
|
1124
|
+
|
|
1125
|
+
A `bin` value that is not an object, an `exports` value that is not a map of subpaths, or a
|
|
1126
|
+
`files` value that is not an array of strings takes no entry. `audit` reports every missing entry
|
|
1127
|
+
in its non-blocking `entries` question, which names each entry with its JSON value and each section
|
|
1128
|
+
whose shape refuses it, with the shape that admits the entry. The human report of `overwrite`
|
|
1129
|
+
prints one `Inserted <entry> in package.json.` line per entry it wrote. When a workspace plans an
|
|
1130
|
+
executable and declares `"sideEffects": false`, `audit` adds a non-blocking `sideEffects` note
|
|
1131
|
+
that a bundler may drop the imports the executable runs only for their side effects, and names
|
|
1132
|
+
the value a born manifest carries. No verb changes the declared value.
|
|
1133
|
+
|
|
1041
1134
|
Before resolving overwrite's version ranges, the declaration step lifts each planned foreign tool
|
|
1042
1135
|
whose `devDependencies` major is earlier than the canon's to the blueprint's planned range,
|
|
1043
1136
|
including selected framework holds. An equal or later declared major stays, as does a disjunction
|
|
@@ -1228,7 +1321,7 @@ import { createBlueprint } from '@orkestrel/scaffold'
|
|
|
1228
1321
|
const blueprint = createBlueprint('router', {
|
|
1229
1322
|
src: ['core', 'server'],
|
|
1230
1323
|
dependencies: [{ name: '@orkestrel/emitter', range: '^0.0.5' }],
|
|
1231
|
-
bin:
|
|
1324
|
+
bin: ['main'],
|
|
1232
1325
|
})
|
|
1233
1326
|
|
|
1234
1327
|
blueprint.version // '0.0.1'
|
|
@@ -1273,8 +1366,8 @@ because the shape is chosen once and read afterwards: `new` refuses the advisory
|
|
|
1273
1366
|
`repair` need the plan to describe and restore a target that already has that shape. A library
|
|
1274
1367
|
caller creating a workspace holds the same refusal, and the Compile section states it.
|
|
1275
1368
|
|
|
1276
|
-
`bin`, `setup`, `guides`, `integration`, `conformance`, `tree`, `service`, `vendors`,
|
|
1277
|
-
`global`, `styles`, `themes`, `showcase`, `journey`, `base`, and `skills` are structural facts, and `extensions` lists the
|
|
1369
|
+
`bin`, `setup`, `guides`, `integration`, `conformance`, `tree`, `service`, `vendors`,
|
|
1370
|
+
`studies`, `global`, `styles`, `themes`, `showcase`, `journey`, `base`, and `skills` are structural facts, and `extensions` lists the
|
|
1278
1371
|
extension faces. Reading verbs set each fact and list each extension only when the workspace
|
|
1279
1372
|
physically ships the directory or exact-case file that defines it, never because of the workspace's
|
|
1280
1373
|
name and never because a sibling fact is set.
|
|
@@ -1448,8 +1541,8 @@ workspace carries:
|
|
|
1448
1541
|
`BrowserExtension.axes` lists the axes a browser extension physically occupies, so a target holding
|
|
1449
1542
|
`app/vue` and no `src/vue` carries `axes: ['app']`. `FRAMEWORKS` holds `vue` alone. A
|
|
1450
1543
|
`StylesExtension` name passes `isSheetName`: it matches `NAME_PATTERN` and is none of the
|
|
1451
|
-
`RESERVED_SHEET_NAMES` values, which are `core`, `browser`, `server`, `bin`, `styles`,
|
|
1452
|
-
`vue`.
|
|
1544
|
+
`RESERVED_SHEET_NAMES` values, which are `core`, `browser`, `server`, `bin`, `styles`,
|
|
1545
|
+
`themes`, and `vue`.
|
|
1453
1546
|
|
|
1454
1547
|
`parseExtension` reads one `surface:name` entry, and `isSurface` decides whether its surface is
|
|
1455
1548
|
one the generator plans, so `styles:print` parses and `themes:print` does not. Browser text carries
|
|
@@ -1600,8 +1693,8 @@ The `vue` extension gives each axis it occupies a face of its own:
|
|
|
1600
1693
|
`check` script typechecks the whole tree through `vue-tsc` in place of `tsc`.
|
|
1601
1694
|
|
|
1602
1695
|
The vendored `.oxlintrc.json` holds each face to the import direction `AGENTS.md` § Project model fixes, and
|
|
1603
|
-
refuses, from `src/browser`, `src/server`, `src/vue`, and `src/bin`, a relative path to
|
|
1604
|
-
`src/browser` from `src/vue`, or to `src/server` from `src/bin` with a message naming the alias, because a face's
|
|
1696
|
+
refuses, from `src/browser`, `src/server`, `src/vue`, and `src/bin`, a relative path to
|
|
1697
|
+
`src/core`, to `src/browser` from `src/vue`, or to `src/server` from `src/bin` with a message naming the alias, because a face's
|
|
1605
1698
|
build bundles what a relative path reaches. The vendored
|
|
1606
1699
|
`tests/config.test.ts` drives those directions through Oxlint.
|
|
1607
1700
|
|
|
@@ -1700,14 +1793,14 @@ A workspace that selects `studies` and the `server` application also builds the
|
|
|
1700
1793
|
`build:app:barrel` script exist only under that condition, and `build:app` runs the script after
|
|
1701
1794
|
`build:app:server`. `serve:build` runs `build` before `serve`, so the barrel, which the server
|
|
1702
1795
|
build's emptied `dist/app/server` would otherwise lose, and every browser face the server serves are
|
|
1703
|
-
rebuilt. The build emits the single file `dist/app/server/index.js` with `@app/*` and
|
|
1704
|
-
|
|
1705
|
-
|
|
1706
|
-
|
|
1707
|
-
staged root, compares the `main.cjs` digest across the barrel step, builds the barrel
|
|
1708
|
-
`index.js` digest, imports the file in Node, and holds each claim under a control.
|
|
1709
|
-
`tests/config.test.ts` repeats the externals, digest, and `main.cjs` readings in each
|
|
1710
|
-
plans the barrel.
|
|
1796
|
+
rebuilt. The build emits the single file `dist/app/server/index.js` with `@app/*` and `@src/*`
|
|
1797
|
+
specifiers and relative imports inlined, and `node:` and every installed package specifier left
|
|
1798
|
+
external. It sets `emptyOutDir` to `false`, so `main.cjs` stays byte-identical. A workspace without
|
|
1799
|
+
both conditions plans none of the three. Scaffold's `tests/src/core/templates.test.ts` builds both
|
|
1800
|
+
entries in a staged root, compares the `main.cjs` digest across the barrel step, builds the barrel
|
|
1801
|
+
twice for one `index.js` digest, imports the file in Node, and holds each claim under a control.
|
|
1802
|
+
The vendored `tests/config.test.ts` repeats the externals, digest, and `main.cjs` readings in each
|
|
1803
|
+
target that plans the barrel.
|
|
1711
1804
|
|
|
1712
1805
|
### The migration guard
|
|
1713
1806
|
|
|
@@ -2007,8 +2100,10 @@ declaration, a binding that is not an identifier, a barrel statement outside the
|
|
|
2007
2100
|
A missing guide root, an empty catalog, a catalog row with no hosted guide, and a hosted guide
|
|
2008
2101
|
carrying no `Surface` section report one the same way, so a reading the sweep could not complete
|
|
2009
2102
|
never reports clean. A collision reads
|
|
2010
|
-
`surface name belongs to one package: NAME (OWNER)
|
|
2011
|
-
|
|
2103
|
+
`surface name belongs to one package: NAME (OWNER)`, then the correction: delete the local declaration
|
|
2104
|
+
and `import { NAME } from "@orkestrel/OWNER"` (or the owner's environment entry that exports it)
|
|
2105
|
+
where the contracts match, and rename only where the local contract differs. It carries the
|
|
2106
|
+
declaring path and line, sorted by path, line, and message. Which package keeps a claimed name is the answer
|
|
2012
2107
|
`.claude/rules/names.md` § Fleet name ownership gives; the rule carries no allowlist and no
|
|
2013
2108
|
suppression.
|
|
2014
2109
|
|
|
@@ -2029,6 +2124,7 @@ set is reachable through a published specifier.
|
|
|
2029
2124
|
| `POLICY_SURFACE_HOST` | const | Names the installed host root containing the fleet's reference guides. |
|
|
2030
2125
|
| `createPolicySurfaceFixture` | function | Creates a scratch target with a complete installed guide population. |
|
|
2031
2126
|
| `createPolicySurfaceGuide` | function | Creates a guide whose surface claims the supplied fixture names. |
|
|
2127
|
+
| `describeSurfaceCollision` | function | Describes the refusal for a name that two packages claim, with the owner's import. |
|
|
2032
2128
|
| `inspectPolicySurface` | function | Inspects source and target-owned setup names against the hosted fleet guides. |
|
|
2033
2129
|
| `readPolicyDeclarations` | function | Locates parsed exports at their physical declaration lines. |
|
|
2034
2130
|
| `readPolicySurface` | function | Reads reachable source declarations and refuses unread barrel statements or targets. |
|
|
@@ -2599,10 +2695,10 @@ Nothing is fixed except the manifest.
|
|
|
2599
2695
|
`--ignore-scripts` to `npm pack` so a suite never re-runs the build it already gates.
|
|
2600
2696
|
- One template artifact per configuration file the selection needs: the root `tsconfig.json` and
|
|
2601
2697
|
`vite.config.ts`, plus a Vite config and a scoped TypeScript config per selected environment and
|
|
2602
|
-
for `bin` when it
|
|
2698
|
+
for `bin` when it lists a module. The root `tsconfig.json` maps the `@src` and `@app` aliases the selection
|
|
2603
2699
|
reaches, and beside them the workspace's own published specifiers — `@orkestrel/<name>` and one
|
|
2604
|
-
`@orkestrel/<name>/<environment>` entry per subpath the `exports` map publishes —
|
|
2605
|
-
source entry. Without them the workspace's own name resolves through that `exports` map to
|
|
2700
|
+
`@orkestrel/<name>/<environment>` entry per environment subpath the `exports` map publishes —
|
|
2701
|
+
each to its source entry. A `src/bin` module's subpath and each sheet subpath map no entry. Without them the workspace's own name resolves through that `exports` map to
|
|
2606
2702
|
`dist/`, and `npm run check` would wait on `npm run build`. Every subpath is written before the
|
|
2607
2703
|
bare specifier, because `vite.config.ts` derives its `alias` record from these entries in order and
|
|
2608
2704
|
a bare specifier also matches its own subpaths. An `app` environment publishes nothing and maps no
|
|
@@ -2739,8 +2835,12 @@ workspace installs, so a publishing workspace declares `@microsoft/api-extractor
|
|
|
2739
2835
|
compiler API of its own. The browser and server faces pass `rewriteCoreSpecifier`: the compiler
|
|
2740
2836
|
emits the `@src/core` specifier unrewritten and the extractor keeps it external, so the rewrite
|
|
2741
2837
|
replaces it with the workspace's own published name and a consumer of the packed face reaches core
|
|
2742
|
-
through the root export the tarball declares. The seeded `bin` config
|
|
2743
|
-
executable ships no
|
|
2838
|
+
through the root export the tarball declares. The seeded `bin` config rolls up each module its
|
|
2839
|
+
`entries` list names, every `src/bin` module but `main`, because an executable ships no
|
|
2840
|
+
declarations. It passes `rewriteSourceSpecifier`, which replaces each `@src/<environment>` with
|
|
2841
|
+
`../src/<environment>/index.js`, so `dist/bin/<name>.d.ts` reads the environment's declarations at
|
|
2842
|
+
the path `dist/bin/<name>.js` imports. Each roll-up takes its entry's name, so a face ships
|
|
2843
|
+
`index.d.ts` and a `reporter` module ships `reporter.d.ts`.
|
|
2744
2844
|
|
|
2745
2845
|
`planToSummary` reports the tally rather than a number written down here:
|
|
2746
2846
|
|