@orkestrel/scaffold 0.0.134 → 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-parallel/scripts/lane.js +610 -79
- package/dist/agents/skills/orkestrel-publish/scripts/wave.js +307 -16
- package/dist/bin/main.js +253 -35
- package/dist/bin/main.js.map +1 -1
- package/dist/host/AGENTS.md +1 -1
- package/dist/host/agents/skills/orkestrel-parallel/SKILL.md +1 -1
- package/dist/host/agents/skills/orkestrel-parallel/scripts/lane.ts +782 -115
- package/dist/host/agents/skills/orkestrel-publish/references/release.md +1 -0
- package/dist/host/agents/skills/orkestrel-publish/references/wave.md +22 -5
- package/dist/host/agents/skills/orkestrel-publish/scripts/wave.ts +379 -27
- package/dist/host/claude/agents/orkestrel.md +14 -14
- package/dist/host/claude/rules/architecture.md +1 -1
- package/dist/host/claude/rules/patterns.md +2 -0
- package/dist/host/claude/rules/workspace.md +64 -63
- package/dist/host/configs/helpers.ts +88 -67
- package/dist/host/dotfiles/oxlintrc.json +1 -57
- package/dist/host/guides/agent.md +989 -395
- package/dist/host/guides/database.md +357 -342
- package/dist/host/guides/middleware.md +5 -5
- package/dist/host/guides/ollama.md +41 -42
- package/dist/host/guides/scaffold.md +177 -105
- package/dist/host/guides/study.md +12 -12
- package/dist/host/guides/test.md +158 -46
- package/dist/host/guides/toolbox.md +127 -81
- package/dist/host/guides/workspace.md +21 -14
- package/dist/host/manifest.json +23 -23
- package/dist/host/tests/config.test.ts +166 -112
- package/dist/src/core/index.cjs +491 -195
- package/dist/src/core/index.cjs.map +1 -1
- package/dist/src/core/index.d.cts +217 -24
- package/dist/src/core/index.d.ts +217 -24
- package/dist/src/core/index.js +482 -193
- package/dist/src/core/index.js.map +1 -1
- package/dist/src/server/index.cjs +18 -8
- package/dist/src/server/index.cjs.map +1 -1
- package/dist/src/server/index.d.cts +4 -3
- package/dist/src/server/index.d.ts +4 -3
- package/dist/src/server/index.js +19 -9
- package/dist/src/server/index.js.map +1 -1
- package/package.json +2 -2
|
@@ -245,7 +245,6 @@ export declare interface ArtifactTemplateSet {
|
|
|
245
245
|
};
|
|
246
246
|
readonly entry: string;
|
|
247
247
|
readonly bin: string;
|
|
248
|
-
readonly reporter: string;
|
|
249
248
|
readonly distribution: {
|
|
250
249
|
readonly module: string;
|
|
251
250
|
readonly proof: string;
|
|
@@ -361,9 +360,12 @@ export declare const BASE_DEV_DEPENDENCIES: Readonly<Record<string, string>>;
|
|
|
361
360
|
/** Lists the configuration files a workspace that ships its own executable adds, frozen. */
|
|
362
361
|
export declare const BIN_CONFIGS: readonly string[];
|
|
363
362
|
|
|
364
|
-
/** Names the executable entry
|
|
363
|
+
/** Names the executable entry, the `main` module of `src/bin`. */
|
|
365
364
|
export declare const BIN_ENTRY_PATH = "src/bin/main.ts";
|
|
366
365
|
|
|
366
|
+
/** Matches the stem of a `src/bin` module: lowercase letters and digits, letter first, no hyphen. */
|
|
367
|
+
export declare const BIN_MODULE_PATTERN: RegExp;
|
|
368
|
+
|
|
367
369
|
/** Names the built executable a bin workspace's manifest command runs. */
|
|
368
370
|
export declare const BIN_OUTPUT_PATH = "dist/bin/main.js";
|
|
369
371
|
|
|
@@ -377,7 +379,7 @@ export declare const BIN_OUTPUT_PATH = "dist/bin/main.js";
|
|
|
377
379
|
* are runtime `@orkestrel/*` packages. A peer in the `@orkestrel` scope is a
|
|
378
380
|
* fleet pin; every other peer is a floor. `extras` are package-specific
|
|
379
381
|
* development dependencies and may carry any valid npm name.
|
|
380
|
-
* `bin`, `
|
|
382
|
+
* `bin`, `setup`, `guides`, `integration`, `conformance`, `tree`, `service`,
|
|
381
383
|
* `vendors`, `studies`, `global`, `showcase`, `journey`, `base`, `styles`, `themes`, and `skills` are structural facts: each is
|
|
382
384
|
* set only when the workspace physically ships the directory or exact-case file
|
|
383
385
|
* that defines it, never because of the workspace's name and never because a
|
|
@@ -387,6 +389,11 @@ export declare const BIN_OUTPUT_PATH = "dist/bin/main.js";
|
|
|
387
389
|
* `setup` lists the runtimes required by root setup proofs: `node` for generic
|
|
388
390
|
* and server proofs, and `browser` for `tests/setupBrowser.test.ts` and `tests/setupStyles.test.ts`.
|
|
389
391
|
* `journey` selects the birth-owned variant wrapper for a browser application.
|
|
392
|
+
* `bin` lists the stems of the direct `.ts` files of `src/bin`, sorted: each stem that opens with
|
|
393
|
+
* a lowercase letter and that {@link CENTRAL_FILE_NAMES} does not name. The gate refuses a stem
|
|
394
|
+
* {@link isBinModule} rejects. `main` is the
|
|
395
|
+
* executable the manifest's `bin` field runs, and every other module publishes the ES-only
|
|
396
|
+
* `./<name>` subpath with its declaration, for a host tool that loads the module by specifier.
|
|
390
397
|
* `skills` registers the `skills` Vitest project over the mirrored proofs of the skill
|
|
391
398
|
* scripts a workspace ships under each `.agents/skills/<skill>/scripts/` directory, and adds their
|
|
392
399
|
* scoped typecheck.
|
|
@@ -426,9 +433,7 @@ export declare interface Blueprint {
|
|
|
426
433
|
readonly version: string;
|
|
427
434
|
readonly engines: string;
|
|
428
435
|
readonly overrides: readonly Override[];
|
|
429
|
-
readonly bin:
|
|
430
|
-
/** Selects the exact-case `src/reporter/main.ts` entry of the published Vitest reporter. */
|
|
431
|
-
readonly reporter: boolean;
|
|
436
|
+
readonly bin: readonly string[];
|
|
432
437
|
readonly setup: readonly SetupRuntime[];
|
|
433
438
|
readonly guides: boolean;
|
|
434
439
|
readonly integration: boolean;
|
|
@@ -549,10 +554,34 @@ export declare function blueprintToDevDependencies(blueprint: Blueprint): Readon
|
|
|
549
554
|
export declare function blueprintToDocumentArtifacts(blueprint: Blueprint): readonly ContentArtifact[];
|
|
550
555
|
|
|
551
556
|
/**
|
|
552
|
-
* Projects
|
|
557
|
+
* Projects a blueprint into the `bin`, `files`, and `exports` entries its manifest carries.
|
|
558
|
+
*
|
|
559
|
+
* @param blueprint - The workspace specification.
|
|
560
|
+
* @returns The planned commands, packed paths, and subpaths, each in the order the manifest emits.
|
|
561
|
+
*
|
|
562
|
+
* @remarks
|
|
563
|
+
* A workspace without an executable plans no command, and one publishing nothing plans no
|
|
564
|
+
* subpath, because its manifest carries no `exports` map. `dist/src` is packed only where a
|
|
565
|
+
* library environment or a sheet builds into it: an executable reaches `dist/src` only through
|
|
566
|
+
* the `@src/*` specifiers its build rewrites, one per library environment, so an executable
|
|
567
|
+
* beside no library environment bundles what it imports and packs `dist/bin` alone. A workspace
|
|
568
|
+
* publishing nothing packs `dist/app` when it builds an application.
|
|
569
|
+
*
|
|
570
|
+
* @example
|
|
571
|
+
* ```ts
|
|
572
|
+
* import { blueprintToEntries, createBlueprint } from '@orkestrel/scaffold'
|
|
573
|
+
*
|
|
574
|
+
* blueprintToEntries(createBlueprint('router', { src: ['core'], bin: ['main'] })).files
|
|
575
|
+
* // ['dist/src', 'dist/bin', 'README.md']
|
|
576
|
+
* ```
|
|
577
|
+
*/
|
|
578
|
+
export declare function blueprintToEntries(blueprint: Blueprint): ManifestEntrySet;
|
|
579
|
+
|
|
580
|
+
/**
|
|
581
|
+
* Projects published environments, sheets, and `src/bin` modules into the manifest export map.
|
|
553
582
|
* @param blueprint - The workspace specification.
|
|
554
|
-
* @returns JavaScript conditions, CSS and SCSS subpaths, and the ES-only
|
|
555
|
-
* without an invented JavaScript root.
|
|
583
|
+
* @returns JavaScript conditions, CSS and SCSS subpaths, and the ES-only `./<name>` subpath of
|
|
584
|
+
* each `src/bin` module other than `main`, without an invented JavaScript root.
|
|
556
585
|
* @example
|
|
557
586
|
* ```ts
|
|
558
587
|
* import { blueprintToExports, createBlueprint } from '@orkestrel/scaffold'
|
|
@@ -1027,7 +1056,8 @@ export declare function blueprintToToolchainHolds(blueprint: Blueprint): Readonl
|
|
|
1027
1056
|
* benchmark workbench scripts. A workspace carrying guides adds `test:guides`,
|
|
1028
1057
|
* whose package-owned entry runs the guides project and handles explicit parity
|
|
1029
1058
|
* rewrites, and one carrying skills adds `test:skills`. Publishing adds the pack and publication
|
|
1030
|
-
* lifecycle scripts.
|
|
1059
|
+
* lifecycle scripts. Library environments, sheet faces, framework faces, and `src/bin` modules
|
|
1060
|
+
* add their check and build scripts, application
|
|
1031
1061
|
* frameworks add dev scripts, and selected showcases and journeys add their mode scripts.
|
|
1032
1062
|
* A base browser application's journey axis also adds `journey` and `capture`, and each
|
|
1033
1063
|
* app-side browser face adds `journey:<name>` and `capture:<name>`. Their generated
|
|
@@ -1056,7 +1086,7 @@ export declare function blueprintToToolchainHolds(blueprint: Blueprint): Readonl
|
|
|
1056
1086
|
*
|
|
1057
1087
|
* const blueprint = createBlueprint('router', { src: ['core'] })
|
|
1058
1088
|
*
|
|
1059
|
-
* blueprintToWritableScripts(blueprint)[0]?.name // '
|
|
1089
|
+
* blueprintToWritableScripts(blueprint)[0]?.name // 'check:src:core'
|
|
1060
1090
|
* ```
|
|
1061
1091
|
*/
|
|
1062
1092
|
export declare function blueprintToWritableScripts(blueprint: Blueprint): readonly ManifestScript[];
|
|
@@ -1310,6 +1340,9 @@ export declare type CatalogEntry = {
|
|
|
1310
1340
|
*/
|
|
1311
1341
|
export declare function catalogToLayers(entries: readonly CatalogEntry[]): ReadonlyArray<readonly string[]>;
|
|
1312
1342
|
|
|
1343
|
+
/** Lists the stems of the centralized files the architecture kind table names, which no `src/bin` module takes, frozen. */
|
|
1344
|
+
export declare const CENTRAL_FILE_NAMES: readonly string[];
|
|
1345
|
+
|
|
1313
1346
|
/**
|
|
1314
1347
|
* Collects the near names and equal contracts other owners claim beside each name a candidate adds.
|
|
1315
1348
|
*
|
|
@@ -1738,7 +1771,6 @@ export declare class Compiler implements CompilerInterface {
|
|
|
1738
1771
|
readonly browser: string;
|
|
1739
1772
|
readonly server: string;
|
|
1740
1773
|
readonly bin: string;
|
|
1741
|
-
readonly reporter: string;
|
|
1742
1774
|
};
|
|
1743
1775
|
readonly app: {
|
|
1744
1776
|
readonly core: string;
|
|
@@ -1783,7 +1815,6 @@ export declare class Compiler implements CompilerInterface {
|
|
|
1783
1815
|
readonly server: string;
|
|
1784
1816
|
};
|
|
1785
1817
|
readonly bin: string;
|
|
1786
|
-
readonly reporter: string;
|
|
1787
1818
|
readonly skills: string;
|
|
1788
1819
|
};
|
|
1789
1820
|
readonly vites: {
|
|
@@ -1795,7 +1826,6 @@ export declare class Compiler implements CompilerInterface {
|
|
|
1795
1826
|
readonly server: string;
|
|
1796
1827
|
};
|
|
1797
1828
|
readonly bin: string;
|
|
1798
|
-
readonly reporter: string;
|
|
1799
1829
|
readonly app: {
|
|
1800
1830
|
readonly vue: string;
|
|
1801
1831
|
readonly browser: string;
|
|
@@ -1883,7 +1913,7 @@ export declare class Compiler implements CompilerInterface {
|
|
|
1883
1913
|
* const blueprint = createBlueprint('router', {
|
|
1884
1914
|
* src: ['core', 'server'],
|
|
1885
1915
|
* dependencies: [{ name: '@orkestrel/emitter', range: '^0.0.5' }],
|
|
1886
|
-
* bin:
|
|
1916
|
+
* bin: ['main'],
|
|
1887
1917
|
* })
|
|
1888
1918
|
*
|
|
1889
1919
|
* blueprint.version // '0.0.1'
|
|
@@ -2333,6 +2363,38 @@ export declare class Compiler implements CompilerInterface {
|
|
|
2333
2363
|
*/
|
|
2334
2364
|
export declare function insertManifestDependencies(manifest: string, additions: DependencyPinSet): string | undefined;
|
|
2335
2365
|
|
|
2366
|
+
/**
|
|
2367
|
+
* Inserts the planned `bin`, `files`, and `exports` entries a package manifest lacks.
|
|
2368
|
+
*
|
|
2369
|
+
* @param manifest - The manifest text to compile.
|
|
2370
|
+
* @param planned - The entries the plan emits, each in planned order.
|
|
2371
|
+
* @returns The manifest declaring every planned entry, or `undefined` when the text is not a
|
|
2372
|
+
* manifest object, or a section that must take an entry holds a value of another shape: `bin` not
|
|
2373
|
+
* an object, `exports` not a map of subpaths, or `files` not an array of strings.
|
|
2374
|
+
*
|
|
2375
|
+
* @remarks
|
|
2376
|
+
* The compiler inserts text instead of serializing the manifest, so every declared byte survives,
|
|
2377
|
+
* and a declared entry keeps its value whatever the plan holds. An inserted entry lands before the
|
|
2378
|
+
* first declared entry the plan orders after it, or after the last declared entry when none does,
|
|
2379
|
+
* and copies the indentation of the section's first entry; a nested value takes the same step per
|
|
2380
|
+
* level. An absent section is created as one top-level key holding the planned entries, before the
|
|
2381
|
+
* first declared key `MANIFEST_KEY_ORDER` orders after it, or last in the manifest object. A
|
|
2382
|
+
* manifest declaring every planned entry is returned unchanged.
|
|
2383
|
+
*
|
|
2384
|
+
* @example
|
|
2385
|
+
* ```ts
|
|
2386
|
+
* import { insertManifestEntries } from '@orkestrel/scaffold'
|
|
2387
|
+
*
|
|
2388
|
+
* insertManifestEntries('{\n\t"files": [\n\t\t"dist/src",\n\t\t"README.md"\n\t]\n}\n', {
|
|
2389
|
+
* bin: {},
|
|
2390
|
+
* files: ['dist/src', 'dist/bin', 'README.md'],
|
|
2391
|
+
* exports: {},
|
|
2392
|
+
* })
|
|
2393
|
+
* // '{\n\t"files": [\n\t\t"dist/src",\n\t\t"dist/bin",\n\t\t"README.md"\n\t]\n}\n'
|
|
2394
|
+
* ```
|
|
2395
|
+
*/
|
|
2396
|
+
export declare function insertManifestEntries(manifest: string, planned: ManifestEntrySet): string | undefined;
|
|
2397
|
+
|
|
2336
2398
|
/**
|
|
2337
2399
|
* Inserts dependencies into one section of package manifest text.
|
|
2338
2400
|
*
|
|
@@ -2430,6 +2492,21 @@ export declare class Compiler implements CompilerInterface {
|
|
|
2430
2492
|
*/
|
|
2431
2493
|
export declare const isAudit: Guard<Audit>;
|
|
2432
2494
|
|
|
2495
|
+
/**
|
|
2496
|
+
* Narrows a value to the stem of a `src/bin` module.
|
|
2497
|
+
* @param value - The candidate stem.
|
|
2498
|
+
* @returns True if the stem matches `BIN_MODULE_PATTERN` within the name length cap and names no
|
|
2499
|
+
* centralized file; false otherwise.
|
|
2500
|
+
* @example
|
|
2501
|
+
* ```ts
|
|
2502
|
+
* import { isBinModule } from '@orkestrel/scaffold'
|
|
2503
|
+
*
|
|
2504
|
+
* isBinModule('reporter') // true
|
|
2505
|
+
* isBinModule('helpers') // false
|
|
2506
|
+
* ```
|
|
2507
|
+
*/
|
|
2508
|
+
export declare function isBinModule(value: unknown): value is string;
|
|
2509
|
+
|
|
2433
2510
|
/**
|
|
2434
2511
|
* Narrows a value to a {@link Blueprint}.
|
|
2435
2512
|
*
|
|
@@ -2872,6 +2949,28 @@ export declare class Compiler implements CompilerInterface {
|
|
|
2872
2949
|
*/
|
|
2873
2950
|
export declare const isStylesExtension: Guard<StylesExtension>;
|
|
2874
2951
|
|
|
2952
|
+
/**
|
|
2953
|
+
* Narrows a manifest `exports` value to a map of subpaths.
|
|
2954
|
+
*
|
|
2955
|
+
* @param value - The declared `exports` value.
|
|
2956
|
+
* @returns True if the value is an object whose every key opens with `.`; false otherwise.
|
|
2957
|
+
*
|
|
2958
|
+
* @remarks
|
|
2959
|
+
* Node reads a string, an array, or an object whose keys are conditions, such as `import` and
|
|
2960
|
+
* `require`, as the root export alone, and refuses an object that mixes conditions with subpaths,
|
|
2961
|
+
* so a subpath can be added only to a subpath map. A value whose keys cannot be read answers
|
|
2962
|
+
* `false`.
|
|
2963
|
+
*
|
|
2964
|
+
* @example
|
|
2965
|
+
* ```ts
|
|
2966
|
+
* import { isSubpathMap } from '@orkestrel/scaffold'
|
|
2967
|
+
*
|
|
2968
|
+
* isSubpathMap({ '.': './index.js' }) // true
|
|
2969
|
+
* isSubpathMap({ import: './index.js' }) // false
|
|
2970
|
+
* ```
|
|
2971
|
+
*/
|
|
2972
|
+
export declare function isSubpathMap(value: unknown): value is Readonly<Record<string, unknown>>;
|
|
2973
|
+
|
|
2875
2974
|
/**
|
|
2876
2975
|
* Narrows a value to a surface an extension can extend.
|
|
2877
2976
|
* @param value - The candidate surface.
|
|
@@ -2934,6 +3033,16 @@ export declare class Compiler implements CompilerInterface {
|
|
|
2934
3033
|
*/
|
|
2935
3034
|
export declare type Lookup = 'found' | 'missing' | 'unmatched' | 'failed';
|
|
2936
3035
|
|
|
3036
|
+
/**
|
|
3037
|
+
* Lists the top-level manifest keys in the order a compiled manifest emits them.
|
|
3038
|
+
*
|
|
3039
|
+
* @remarks
|
|
3040
|
+
* An entry write that creates an absent `bin`, `files`, or `exports` key places it before the
|
|
3041
|
+
* first declared key this list orders after it, so a created key lands where a born manifest
|
|
3042
|
+
* carries it.
|
|
3043
|
+
*/
|
|
3044
|
+
export declare const MANIFEST_KEY_ORDER: readonly string[];
|
|
3045
|
+
|
|
2937
3046
|
/** Names the manifest path every compiler plan emits with birth ownership. */
|
|
2938
3047
|
export declare const MANIFEST_PATH = "package.json";
|
|
2939
3048
|
|
|
@@ -2958,6 +3067,20 @@ export declare class Compiler implements CompilerInterface {
|
|
|
2958
3067
|
readonly text: string;
|
|
2959
3068
|
}
|
|
2960
3069
|
|
|
3070
|
+
/**
|
|
3071
|
+
* Describes the `bin`, `files`, and `exports` entries a manifest carries.
|
|
3072
|
+
*
|
|
3073
|
+
* @remarks
|
|
3074
|
+
* `bin` maps each command name to the file it runs, `files` lists the packed paths, and
|
|
3075
|
+
* `exports` maps each subpath to its target or condition block. Each list keeps the order the
|
|
3076
|
+
* plan emits, and an entry write reads that order to place an inserted entry.
|
|
3077
|
+
*/
|
|
3078
|
+
export declare interface ManifestEntrySet {
|
|
3079
|
+
readonly bin: Readonly<Record<string, string>>;
|
|
3080
|
+
readonly files: readonly string[];
|
|
3081
|
+
readonly exports: Readonly<Record<string, unknown>>;
|
|
3082
|
+
}
|
|
3083
|
+
|
|
2961
3084
|
/**
|
|
2962
3085
|
* Describes the manifest regions a writing operation may change.
|
|
2963
3086
|
*
|
|
@@ -2971,12 +3094,15 @@ export declare class Compiler implements CompilerInterface {
|
|
|
2971
3094
|
* `overrides` names npm selector maps whose string leaves are replaced or inserted.
|
|
2972
3095
|
* Malformed ancestors and duplicate selected keys refuse the write. This metadata
|
|
2973
3096
|
* is independent of the artifact replacements carried by `Blueprint.overrides`.
|
|
3097
|
+
* `entries` names the planned `bin`, `files`, and `exports` entries, and the writer inserts each
|
|
3098
|
+
* one the manifest lacks. Absent, nothing is inserted.
|
|
2974
3099
|
*/
|
|
2975
3100
|
export declare interface ManifestRegionSet {
|
|
2976
3101
|
readonly pins: DependencyPinSet;
|
|
2977
3102
|
readonly scripts: readonly ManifestScript[];
|
|
2978
3103
|
readonly additions?: DependencyPinSet;
|
|
2979
3104
|
readonly overrides?: Readonly<Record<string, Readonly<Record<string, string>>>>;
|
|
3105
|
+
readonly entries?: ManifestEntrySet;
|
|
2980
3106
|
}
|
|
2981
3107
|
|
|
2982
3108
|
/**
|
|
@@ -3022,6 +3148,37 @@ export declare class Compiler implements CompilerInterface {
|
|
|
3022
3148
|
*/
|
|
3023
3149
|
export declare function manifestToDependencies(manifest: string): ManifestDependencySet;
|
|
3024
3150
|
|
|
3151
|
+
/**
|
|
3152
|
+
* Projects a package manifest's text to the planned `bin`, `files`, and `exports` entries it lacks.
|
|
3153
|
+
*
|
|
3154
|
+
* @param manifest - The `package.json` text.
|
|
3155
|
+
* @param planned - The entries the plan emits.
|
|
3156
|
+
* @returns The planned entries the manifest does not declare, each in planned order.
|
|
3157
|
+
*
|
|
3158
|
+
* @remarks
|
|
3159
|
+
* A planned command counts as declared when the manifest names it, or when any declared command
|
|
3160
|
+
* runs the planned file: a package keeps the command name it publishes. A string `bin` declares
|
|
3161
|
+
* the planned command when it names the planned file. A planned packed path counts as declared
|
|
3162
|
+
* when a declared path equals it or names a directory above it, as {@link matchesPackedPath} reads
|
|
3163
|
+
* the pair. A subpath counts as declared by name alone, so a declared entry holding another value
|
|
3164
|
+
* stays the package's. A string `exports`, a fallback array, or an object whose keys are conditions
|
|
3165
|
+
* rather than subpaths declares the root subpath `.` alone, as Node reads each. A section holding any other shape declares none of
|
|
3166
|
+
* its planned entries. A manifest that is not an object lacks nothing, because no entry can be read
|
|
3167
|
+
* from it or written into it.
|
|
3168
|
+
*
|
|
3169
|
+
* @example
|
|
3170
|
+
* ```ts
|
|
3171
|
+
* import { manifestToEntries } from '@orkestrel/scaffold'
|
|
3172
|
+
*
|
|
3173
|
+
* manifestToEntries('{"files": ["dist/src"]}', {
|
|
3174
|
+
* bin: {},
|
|
3175
|
+
* files: ['dist/src', 'dist/bin'],
|
|
3176
|
+
* exports: {},
|
|
3177
|
+
* }).files // ['dist/bin']
|
|
3178
|
+
* ```
|
|
3179
|
+
*/
|
|
3180
|
+
export declare function manifestToEntries(manifest: string, planned: ManifestEntrySet): ManifestEntrySet;
|
|
3181
|
+
|
|
3025
3182
|
/**
|
|
3026
3183
|
* Represents one string or object brace found in manifest text.
|
|
3027
3184
|
*
|
|
@@ -3176,6 +3333,30 @@ export declare class Compiler implements CompilerInterface {
|
|
|
3176
3333
|
*/
|
|
3177
3334
|
export declare function matchesOrchestrationPath(path: string): boolean;
|
|
3178
3335
|
|
|
3336
|
+
/**
|
|
3337
|
+
* Checks whether a declared `files` entry packs a planned one.
|
|
3338
|
+
*
|
|
3339
|
+
* @param declared - The entry the manifest declares.
|
|
3340
|
+
* @param planned - The entry the plan emits.
|
|
3341
|
+
* @returns True if the entries are equal, or the declared entry names a directory whose path
|
|
3342
|
+
* segments open the planned entry's; false otherwise.
|
|
3343
|
+
*
|
|
3344
|
+
* @remarks
|
|
3345
|
+
* A declared entry ending in `/**` or `/*` packs the directory it names, so `dist/**` packs
|
|
3346
|
+
* `dist/app`. No other glob is read: an entry such as `dist/*.js` packs no planned path it does not
|
|
3347
|
+
* equal. A negated entry such as `!dist/src/styles/index.js` excludes a path rather than packing
|
|
3348
|
+
* one, so only an equal entry declares it.
|
|
3349
|
+
*
|
|
3350
|
+
* @example
|
|
3351
|
+
* ```ts
|
|
3352
|
+
* import { matchesPackedPath } from '@orkestrel/scaffold'
|
|
3353
|
+
*
|
|
3354
|
+
* matchesPackedPath('dist', 'dist/app') // true
|
|
3355
|
+
* matchesPackedPath('dist-old', 'dist/app') // false
|
|
3356
|
+
* ```
|
|
3357
|
+
*/
|
|
3358
|
+
export declare function matchesPackedPath(declared: string, planned: string): boolean;
|
|
3359
|
+
|
|
3179
3360
|
/**
|
|
3180
3361
|
* Tests whether one emitted line fits the vendored formatter width.
|
|
3181
3362
|
*
|
|
@@ -3386,6 +3567,27 @@ export declare class Compiler implements CompilerInterface {
|
|
|
3386
3567
|
*/
|
|
3387
3568
|
export declare function nameToGuide(name: string): string;
|
|
3388
3569
|
|
|
3570
|
+
/**
|
|
3571
|
+
* Returns the canonical form of a path a manifest names inside its package.
|
|
3572
|
+
*
|
|
3573
|
+
* @param path - A `bin` target or a `files` entry.
|
|
3574
|
+
* @returns The path with `/` for every backslash, one `/` for every run of separators, and no
|
|
3575
|
+
* leading `./` or trailing `/`.
|
|
3576
|
+
*
|
|
3577
|
+
* @remarks
|
|
3578
|
+
* npm reads a backslash in a `bin` or `files` path as a separator and collapses repeated
|
|
3579
|
+
* separators, so `dist\bin\main.js` and `dist//bin/main.js` name `dist/bin/main.js`.
|
|
3580
|
+
*
|
|
3581
|
+
* @example
|
|
3582
|
+
* ```ts
|
|
3583
|
+
* import { normalizePackagePath } from '@orkestrel/scaffold'
|
|
3584
|
+
*
|
|
3585
|
+
* normalizePackagePath('./dist/bin/main.js') // 'dist/bin/main.js'
|
|
3586
|
+
* normalizePackagePath('dist//bin/main.js') // 'dist/bin/main.js'
|
|
3587
|
+
* ```
|
|
3588
|
+
*/
|
|
3589
|
+
export declare function normalizePackagePath(path: string): string;
|
|
3590
|
+
|
|
3389
3591
|
/**
|
|
3390
3592
|
* Lists the exact root paths that wire an agent bench or own an orchestration directory, frozen.
|
|
3391
3593
|
*
|
|
@@ -3980,15 +4182,6 @@ export declare class Compiler implements CompilerInterface {
|
|
|
3980
4182
|
*/
|
|
3981
4183
|
export declare function replacePlanRanges(plan: Plan, pins: DependencyPinSet): Plan | undefined;
|
|
3982
4184
|
|
|
3983
|
-
/** Lists the configuration files a workspace that publishes a Vitest reporter adds, frozen. */
|
|
3984
|
-
export declare const REPORTER_CONFIGS: readonly string[];
|
|
3985
|
-
|
|
3986
|
-
/** Names the reporter entry whose presence makes a workspace `reporter`. */
|
|
3987
|
-
export declare const REPORTER_ENTRY_PATH = "src/reporter/main.ts";
|
|
3988
|
-
|
|
3989
|
-
/** Names the built reporter module a reporter workspace's `./reporter` export loads. */
|
|
3990
|
-
export declare const REPORTER_OUTPUT_PATH = "dist/reporter/main.js";
|
|
3991
|
-
|
|
3992
4185
|
/** Lists the names a styles extension cannot occupy, frozen. */
|
|
3993
4186
|
export declare const RESERVED_SHEET_NAMES: readonly string[];
|
|
3994
4187
|
|