@domain-first/project-structure 7.2.0 → 8.0.0

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.
Files changed (64) hide show
  1. package/README.md +124 -25
  2. package/dist/201.js +87 -338
  3. package/dist/287.js +1183 -568
  4. package/dist/561.js +518 -0
  5. package/dist/711.js +22 -0
  6. package/dist/870.js +438 -0
  7. package/dist/agent-cli.d.ts +378 -0
  8. package/dist/agent-cli.spec.d.ts +1 -0
  9. package/dist/agent-identifiers.d.ts +4 -0
  10. package/dist/agent-requests.d.ts +488 -0
  11. package/dist/config-file.d.ts +231 -26
  12. package/dist/config-file.spec.d.ts +1 -0
  13. package/dist/context-dependencies.d.ts +16 -0
  14. package/dist/dependency-rules.d.ts +17 -17
  15. package/dist/file-system.d.ts +10 -1
  16. package/dist/implementation-choices.d.ts +8 -0
  17. package/dist/implementation-choices.spec.d.ts +1 -0
  18. package/dist/implementation-options-schema.d.ts +14 -0
  19. package/dist/index.cjs +3598 -583
  20. package/dist/index.js +20 -7
  21. package/dist/init.cjs +717 -122
  22. package/dist/init.js +24 -12
  23. package/dist/integration.cjs +3737 -186
  24. package/dist/integration.js +29 -17
  25. package/dist/integrations/rest-endpoint-generator.d.ts +4 -2
  26. package/dist/integrations/storybook.d.ts +1 -0
  27. package/dist/interaction.d.ts +41 -0
  28. package/dist/lint.cjs +165 -41
  29. package/dist/lint.js +22 -7
  30. package/dist/next-app.d.ts +7 -0
  31. package/dist/react.cjs +5128 -414
  32. package/dist/react.js +72 -60
  33. package/dist/system-implementations.d.ts +6 -0
  34. package/dist/upgrade-steps.d.ts +81 -0
  35. package/dist/upgrade-steps.spec.d.ts +1 -0
  36. package/dist/upgrade.cjs +593 -0
  37. package/dist/upgrade.d.ts +2 -0
  38. package/dist/upgrade.js +235 -0
  39. package/dist/use-cases/add-integration.d.ts +16 -1
  40. package/dist/use-cases/cross-context-dependencies.spec.d.ts +1 -0
  41. package/dist/use-cases/initialize.d.ts +4 -4
  42. package/dist/use-cases/initialize.spec.d.ts +1 -0
  43. package/dist/use-cases/prompt-implementation-type.d.ts +20 -0
  44. package/dist/use-cases/scaffold-react-page.d.ts +3 -1
  45. package/dist/wire-branches.d.ts +26 -0
  46. package/dist/wiring.d.ts +3 -2
  47. package/package.json +3 -2
  48. package/skills/df-ps-implement/SKILL.md +9 -8
  49. package/skills/df-ps-plan-feature/SKILL.md +8 -7
  50. package/skills/df-ps-react/SKILL.md +13 -7
  51. package/skills/df-ps-react/references/generators.md +6 -2
  52. package/skills/df-ps-scaffold/SKILL.md +28 -17
  53. package/skills/df-ps-scaffold/references/agent-mode.md +72 -0
  54. package/skills/df-ps-scaffold/references/agent-operations.md +155 -0
  55. package/skills/df-ps-scaffold/references/choosing-components.md +13 -13
  56. package/skills/df-ps-scaffold/references/generators.md +20 -3
  57. package/skills/df-ps-scaffold/references/units/aggregate.md +4 -3
  58. package/skills/df-ps-scaffold/references/units/bounded-context.md +1 -1
  59. package/skills/df-ps-scaffold/references/units/command-query.md +12 -12
  60. package/skills/df-ps-scaffold/references/units/implementation.md +2 -2
  61. package/skills/df-ps-scaffold/references/units/move-or-rename.md +1 -1
  62. package/skills/df-ps-scaffold/references/units/port.md +7 -4
  63. package/skills/df-ps-scaffold/references/units/use-case.md +1 -1
  64. package/skills/df-ps-scaffold/scripts/drive.mjs +9 -1
package/dist/react.js CHANGED
@@ -1,73 +1,85 @@
1
1
  #!/usr/bin/env node
2
2
  import { parseArgs } from "node:util";
3
3
  import { select as prompts_select } from "@inquirer/prompts";
4
- import { ProjectRoot, ConfigFile, Folder } from "./201.js";
4
+ import { runCLI } from "./561.js";
5
+ import { outdatedConfigMessage, ProjectRoot, ConfigFile, Folder } from "./870.js";
5
6
  import { scaffoldReactWidget, moveReactModuleUseCase, scaffoldReactPage, scaffoldReactUIKitComponent, scaffoldReactSharedHook, savePendingChanges } from "./287.js";
6
- const help = `Usage: df-react
7
+ runCLI('df-react', async ()=>{
8
+ const help = `Usage: df-react
7
9
 
8
10
  Scaffolds React modules of a Domain-First project: pages, widgets, UI-kit
9
11
  components and shared hooks, and moves or renames pages and widgets.
10
- Needs "useReact": true in domain-first.project-structure.config.json.
12
+ Needs frontend.react in domain-first.project-structure.config.json.
11
13
 
12
14
  Options:
15
+ --request <json|-> execute an operation without prompts; - reads stdin
16
+ --describe output request schema and project IDs as JSON
13
17
  -h, --help show this help`;
14
- const { values: values } = parseArgs({
15
- options: {
16
- help: {
17
- type: 'boolean',
18
- short: 'h',
19
- default: false
18
+ const { values } = parseArgs({
19
+ options: {
20
+ help: {
21
+ type: 'boolean',
22
+ short: 'h',
23
+ default: false
24
+ }
20
25
  }
21
- }
22
- });
23
- if (values.help) {
24
- console.log(help);
25
- process.exit(0);
26
- }
27
- if (!ConfigFile.exists) {
28
- console.log('No domain-first.project-structure.config.json found: run df-init first to initialize the project.');
29
- process.exit(1);
30
- }
31
- if (!ConfigFile.Instance.data.useReact) {
32
- console.log('React is off: set "useReact": true in domain-first.project-structure.config.json or add Storybook with df-integration.');
33
- process.exit(1);
34
- }
35
- const main = async ()=>{
36
- const reactFolder = new Folder(new ProjectRoot().path).subitem([
37
- ConfigFile.Instance.data.rootFolder,
38
- 'presentation',
39
- 'react'
40
- ]);
41
- const action = await prompts_select({
42
- message: 'Module: ',
43
- choices: [
44
- 'New widget',
45
- 'New page',
46
- 'New UI-kit component',
47
- 'New shared hook',
48
- 'Move or rename widget',
49
- 'Move or rename page'
50
- ]
51
26
  });
52
- switch(action){
53
- case 'New widget':
54
- return void await scaffoldReactWidget(reactFolder);
55
- case 'New page':
56
- return void await scaffoldReactPage(reactFolder);
57
- case 'New UI-kit component':
58
- return void await scaffoldReactUIKitComponent(reactFolder);
59
- case 'New shared hook':
60
- return void await scaffoldReactSharedHook(reactFolder);
61
- case 'Move or rename widget':
62
- return void await moveReactModuleUseCase(reactFolder, 'widget');
63
- case 'Move or rename page':
64
- return void await moveReactModuleUseCase(reactFolder, 'page');
65
- default:
66
- return;
27
+ if (values.help) {
28
+ console.log(help);
29
+ process.exit(0);
30
+ }
31
+ if (!ConfigFile.exists) {
32
+ console.log('No domain-first.project-structure.config.json found: run df-init first to initialize the project.');
33
+ process.exit(1);
34
+ }
35
+ if (ConfigFile.outdated) {
36
+ console.log(outdatedConfigMessage);
37
+ process.exit(1);
67
38
  }
68
- };
69
- const run = async ()=>{
70
- await main();
71
- await savePendingChanges();
72
- };
73
- run();
39
+ if (!ConfigFile.Instance.data.frontend?.react) {
40
+ console.log('React is not configured: run df-init --section frontend or add Storybook with df-integration.');
41
+ process.exit(1);
42
+ }
43
+ const main = async ()=>{
44
+ const reactFolder = new Folder(new ProjectRoot().path).subitem([
45
+ ConfigFile.Instance.data.project.rootFolder,
46
+ 'presentation',
47
+ 'react'
48
+ ]);
49
+ const action = await prompts_select({
50
+ message: 'Module: ',
51
+ choices: [
52
+ 'New widget',
53
+ 'New page',
54
+ 'New UI-kit component',
55
+ 'New shared hook',
56
+ 'Move or rename widget',
57
+ 'Move or rename page'
58
+ ]
59
+ });
60
+ switch(action){
61
+ case 'New widget':
62
+ return void await scaffoldReactWidget(reactFolder);
63
+ case 'New page':
64
+ return void await scaffoldReactPage(reactFolder);
65
+ case 'New UI-kit component':
66
+ return void await scaffoldReactUIKitComponent(reactFolder);
67
+ case 'New shared hook':
68
+ return void await scaffoldReactSharedHook(reactFolder);
69
+ case 'Move or rename widget':
70
+ return void await moveReactModuleUseCase(reactFolder, 'widget');
71
+ case 'Move or rename page':
72
+ return void await moveReactModuleUseCase(reactFolder, 'page');
73
+ default:
74
+ return;
75
+ }
76
+ };
77
+ const run = async ()=>{
78
+ await main();
79
+ await savePendingChanges();
80
+ };
81
+ await run();
82
+ }).catch((error)=>{
83
+ console.error(error);
84
+ process.exitCode = 1;
85
+ });
@@ -0,0 +1,6 @@
1
+ import type { ImplementationKind } from './implementation-choices';
2
+ /** Only implementation labels that activate generator or boundary behavior. */
3
+ export declare const systemImplementationChoices: (kind: ImplementationKind, crossContext?: boolean) => {
4
+ name: string;
5
+ value: string;
6
+ }[];
@@ -0,0 +1,81 @@
1
+ type Draft = Record<string, unknown>;
2
+ /**
3
+ * The config being upgraded. Steps run in order on the same draft, so a
4
+ * step sees the result of the previous ones.
5
+ */
6
+ export type UpgradeContext = {
7
+ config: Draft;
8
+ };
9
+ /**
10
+ * - `required`: other commands refuse to run until it is applied.
11
+ * - `optional`: changes generated code the user may have edited; asked one by one.
12
+ * - `manual`: a note about what the user does themselves; changes nothing.
13
+ */
14
+ export type UpgradeStepKind = 'required' | 'optional' | 'manual';
15
+ export type UpgradeStep = {
16
+ id: string;
17
+ kind: UpgradeStepKind;
18
+ title: string;
19
+ /** Whether the project needs the step. Must be false once it is applied. */
20
+ detect: (context: UpgradeContext) => boolean;
21
+ /** What the step changes, for review before anything is written. */
22
+ plan: (context: UpgradeContext) => string[];
23
+ /** Changes the draft config (and stages files). Not called for manual steps. */
24
+ apply?: (context: UpgradeContext) => void;
25
+ };
26
+ /**
27
+ * Upgrade steps in the order they run. Each detects by the project's shape
28
+ * whether it applies, so the command can run any number of times.
29
+ */
30
+ export declare const upgradeSteps: UpgradeStep[];
31
+ /** Shown after any change: skills of an earlier version describe the old CLI. */
32
+ export declare const skillsNote = "Update the agent skills to this version: npx df-skills";
33
+ export type PlannedStep = {
34
+ step: UpgradeStep;
35
+ changes: string[];
36
+ };
37
+ /**
38
+ * Runs the steps on a copy of the config. Optional steps are applied only
39
+ * when `acceptOptional` accepts them.
40
+ */
41
+ export declare const planUpgrade: (config: unknown, acceptOptional?: (step: PlannedStep) => Promise<boolean> | boolean, steps?: UpgradeStep[]) => Promise<{
42
+ planned: PlannedStep[];
43
+ changed: boolean;
44
+ config: {
45
+ [x: string]: unknown;
46
+ project: {
47
+ [x: string]: unknown;
48
+ rootFolder: string;
49
+ };
50
+ backend?: {
51
+ [x: string]: unknown;
52
+ domainFirstPackages: ("@domain-first/types" | "@domain-first/errors" | "@domain-first/handlers" | "@domain-first/wire" | "@domain-first/handlers-rest")[];
53
+ envBranches?: {
54
+ names: string[];
55
+ test?: string | undefined;
56
+ } | undefined;
57
+ withInMemoryDb?: boolean | undefined;
58
+ testingLibrary?: string | undefined;
59
+ implementations?: Partial<Record<"queries" | "commands" | "repositories" | "ports", {
60
+ primary: string[];
61
+ test: string[];
62
+ }>> | undefined;
63
+ rules?: {
64
+ dependencies?: Partial<Record<"queries" | "commands" | "use-cases" | "application-ports" | "repositories" | "domain-services" | "application-services" | "infrastructure-services" | "presentation-services", ("queries" | "commands" | "use-cases" | "application-ports" | "repositories" | "domain-services" | "application-services" | "infrastructure-services" | "presentation-services")[] | {
65
+ add?: ("queries" | "commands" | "use-cases" | "application-ports" | "repositories" | "domain-services" | "application-services" | "infrastructure-services" | "presentation-services")[] | undefined;
66
+ remove?: ("queries" | "commands" | "use-cases" | "application-ports" | "repositories" | "domain-services" | "application-services" | "infrastructure-services" | "presentation-services")[] | undefined;
67
+ }>> | undefined;
68
+ lint?: Partial<Record<"context-isolation" | "shared-kernel" | "layers" | "dependencies" | "react" | "clock", boolean>> | undefined;
69
+ } | undefined;
70
+ } | undefined;
71
+ frontend?: {
72
+ [x: string]: unknown;
73
+ react?: {
74
+ [x: string]: unknown;
75
+ framework?: "react" | "next" | undefined;
76
+ storybookFramework?: string | undefined;
77
+ } | undefined;
78
+ } | undefined;
79
+ } | undefined;
80
+ }>;
81
+ export {};
@@ -0,0 +1 @@
1
+ export {};