@domain-first/project-structure 8.10.0 → 8.11.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 (50) hide show
  1. package/README.md +17 -7
  2. package/dist/115.js +142 -141
  3. package/dist/201.js +10 -1
  4. package/dist/287.js +983 -434
  5. package/dist/364.js +79 -0
  6. package/dist/38.js +29 -13
  7. package/dist/561.js +167 -93
  8. package/dist/agent-cli.d.ts +13 -2
  9. package/dist/agent-requests.d.ts +76 -2
  10. package/dist/config-file.d.ts +25 -1
  11. package/dist/frontend-cli.d.ts +3 -0
  12. package/dist/frontend-modules.d.ts +9 -0
  13. package/dist/graph.cjs +10 -1
  14. package/dist/index.cjs +3470 -2913
  15. package/dist/init.cjs +325 -83
  16. package/dist/integration.cjs +3470 -2913
  17. package/dist/integrations/openapi.d.ts +9 -2
  18. package/dist/integrations/orval.d.ts +31 -4
  19. package/dist/integrations/rest-endpoint-generator.d.ts +11 -7
  20. package/dist/integrations/storybook.d.ts +19 -1
  21. package/dist/lint.cjs +40 -15
  22. package/dist/lint.js +1 -1
  23. package/dist/page-router.d.ts +18 -0
  24. package/dist/react-module-move.d.ts +27 -12
  25. package/dist/react.cjs +1577 -993
  26. package/dist/react.js +2 -102
  27. package/dist/rest-adapters.d.ts +13 -0
  28. package/dist/svelte-agent-cli.spec.d.ts +1 -0
  29. package/dist/svelte.cjs +7311 -0
  30. package/dist/svelte.d.ts +2 -0
  31. package/dist/svelte.js +3 -0
  32. package/dist/sveltekit-app.d.ts +7 -0
  33. package/dist/upgrade-steps.d.ts +6 -1
  34. package/dist/upgrade.cjs +12 -2
  35. package/dist/use-cases/add-integration.d.ts +1 -1
  36. package/dist/use-cases/delete-react-module.d.ts +4 -4
  37. package/dist/use-cases/index.d.ts +1 -0
  38. package/dist/use-cases/move-react-module.d.ts +2 -2
  39. package/dist/use-cases/rest-endpoint-generator.d.ts +6 -4
  40. package/dist/use-cases/scaffold-svelte-modules.d.ts +22 -0
  41. package/package.json +2 -1
  42. package/skills/df-ps-implement/SKILL.md +3 -3
  43. package/skills/df-ps-plan-feature/SKILL.md +2 -2
  44. package/skills/df-ps-scaffold/SKILL.md +11 -10
  45. package/skills/df-ps-scaffold/references/agent-mode.md +1 -1
  46. package/skills/df-ps-scaffold/references/agent-operations.md +8 -4
  47. package/skills/df-ps-scaffold/references/generators.md +1 -1
  48. package/skills/df-ps-scaffold/references/work-plan.md +1 -1
  49. package/skills/df-ps-svelte/SKILL.md +49 -0
  50. package/skills/df-ps-svelte/references/generators.md +56 -0
package/dist/react.cjs CHANGED
@@ -481,6 +481,7 @@ const lintChecks = [
481
481
  'layers',
482
482
  'dependencies',
483
483
  'react',
484
+ 'svelte',
484
485
  'clock',
485
486
  'config'
486
487
  ];
@@ -525,8 +526,16 @@ const reactConfigSchema = external_zod_default().object({
525
526
  ]).optional(),
526
527
  storybookFramework: external_zod_default().string().optional()
527
528
  }).passthrough();
529
+ const svelteConfigSchema = external_zod_default().object({
530
+ framework: external_zod_default()["enum"]([
531
+ 'svelte',
532
+ 'sveltekit'
533
+ ]).optional(),
534
+ storybookFramework: external_zod_default().string().optional()
535
+ }).passthrough();
528
536
  const frontendConfigSchema = external_zod_default().object({
529
- react: reactConfigSchema.optional()
537
+ react: reactConfigSchema.optional(),
538
+ svelte: svelteConfigSchema.optional()
530
539
  }).passthrough();
531
540
  const configSchema = external_zod_default().object({
532
541
  project: projectConfigSchema,
@@ -1591,6 +1600,11 @@ const nextAppFolder = (root)=>[
1591
1600
  'app',
1592
1601
  'src/app'
1593
1602
  ].find((folder)=>new file_system_Folder(external_node_path_default().join(root, folder)).exists) ?? 'app';
1603
+ const usesSvelteKit = ()=>config_file_ConfigFile.exists && config_file_ConfigFile.Instance.data.frontend?.svelte?.framework === 'sveltekit';
1604
+ const svelteKitRoutesFolder = (root)=>[
1605
+ 'src/routes',
1606
+ 'routes'
1607
+ ].find((folder)=>new file_system_Folder(external_node_path_default().join(root, folder)).exists) ?? 'src/routes';
1594
1608
  const external_node_module_namespaceObject = require("node:module");
1595
1609
  const stripJsonComments = (source)=>source.replace(/("(?:\\.|[^"\\])*")|\/\/[^\n]*|\/\*[\s\S]*?\*\//g, (_, text)=>text ? text : '').replace(/,(\s*[}\]])/g, '$1');
1596
1610
  const resolveExtends = (fromFile, target)=>{
@@ -1670,196 +1684,863 @@ const scaffoldReactPage = async (presentationReactFolder)=>{
1670
1684
  if (hint) report(hint);
1671
1685
  }
1672
1686
  };
1673
- const openapiExtractorPath = "scripts/extract-open-api-data-from-endpoint.ts";
1674
- const rootFolderSegments = (rootFolder, indent = 20)=>rootFolder.split(/[\\/]/).map((segment)=>segment.trim()).filter((segment)=>!!segment && '.' !== segment).map((segment)=>`'${segment}',\n${' '.repeat(indent)}`).join('');
1675
- const endpointFileLookup = (rootFolder)=>` // A context is the start of the route, nested ones included
1676
- // (/sales/orders/...). A controller is the next folder; other
1677
- // routes belong to the context root in presentation/rest/(root).
1678
- const contextsFolder = path.join(
1679
- ${rootFolderSegments(rootFolder, 16)}'bounded-contexts'
1680
- );
1681
- const endpointFile = Array.from(
1682
- { length: routeMetadata.path.length },
1683
- (_, index) => index + 1
1684
- )
1685
- .flatMap((contextLength) => {
1686
- const restFolder = path.join(
1687
- contextsFolder,
1688
- ...routeMetadata.path.slice(0, contextLength),
1689
- 'presentation',
1690
- 'rest'
1691
- );
1692
- const endpointPath = [
1693
- ...routeMetadata.path
1694
- .slice(contextLength)
1695
- .map(pathParameterAsName),
1696
- \`\${routeMetadata.method.toUpperCase()}.ts\`
1697
- ];
1698
- return [
1699
- path.join(restFolder, ...endpointPath),
1700
- path.join(restFolder, '(root)', ...endpointPath)
1701
- ];
1702
- })
1703
- .map((file) => project.getSourceFile(file))
1704
- .find((file) => !!file);
1705
- `;
1706
- const openapiExtractor = (rootFolder)=>`import path from 'node:path';
1707
- import {
1708
- type DocNode,
1709
- DocPlainText,
1710
- TSDocConfiguration,
1711
- TSDocParser,
1712
- TSDocTagDefinition,
1713
- TSDocTagSyntaxKind
1714
- } from '@microsoft/tsdoc';
1715
- import { Node, Project, type SourceFile, SyntaxKind } from 'ts-morph';
1716
-
1717
- type BlockTag = \`@\${string}\`;
1718
-
1719
- type OpenApiDataTags = {
1720
- /** Omit to take the summary from the comment text before the first tag. */
1721
- summary?: BlockTag;
1722
- description?: BlockTag;
1687
+ const ignoredFolders = new Set([
1688
+ 'node_modules',
1689
+ '.git',
1690
+ '.next',
1691
+ '.svelte-kit',
1692
+ 'dist',
1693
+ 'build',
1694
+ 'out',
1695
+ 'coverage',
1696
+ 'storybook-static'
1697
+ ]);
1698
+ const codeExtension = /\.(?:tsx?|mts|cts|jsx?|mjs|cjs|mdx|svelte)$/;
1699
+ const escapeRegExp = (value)=>value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
1700
+ const module_move_walk = (folder)=>{
1701
+ if (!external_node_fs_default().existsSync(folder)) return [];
1702
+ return external_node_fs_default().readdirSync(folder, {
1703
+ withFileTypes: true
1704
+ }).flatMap((entry)=>{
1705
+ const entryPath = external_node_path_default().join(folder, entry.name);
1706
+ if (entry.isDirectory()) return ignoredFolders.has(entry.name) ? [] : module_move_walk(entryPath);
1707
+ return entry.isFile() ? [
1708
+ entryPath
1709
+ ] : [];
1710
+ });
1723
1711
  };
1724
-
1725
- type OpenApiData = Partial<{
1726
- summary: string;
1727
- description: string;
1728
- operationId: string;
1729
- }>;
1730
-
1731
- const project = new Project({
1732
- tsConfigFilePath: 'tsconfig.json'
1733
- });
1734
-
1735
- const getText = (node: DocNode): string =>
1736
- node
1737
- .getChildNodes()
1738
- .map((child) => {
1739
- if (child instanceof DocPlainText) {
1740
- return child.text;
1741
- }
1742
-
1743
- return getText(child);
1744
- })
1745
- .join('');
1746
-
1747
- const getRawCommentText = (comment: string): string =>
1748
- comment
1749
- .replace(/^\\/\\*\\*/, '')
1750
- .replace(/\\*\\/$/, '')
1751
- .split(/\\r?\\n/)
1752
- .map((line) => line.replace(/^\\s*\\*\\s?/, ''))
1753
- .join('\\n');
1754
-
1755
- // TSDoc treats an unknown tag as summary content, so every block tag of the
1756
- // comment has to be registered for the summary section to end before it.
1757
- const parseSummary = (comment: string): string | undefined => {
1758
- const configuration = new TSDocConfiguration();
1759
- const tagNames = getRawCommentText(comment).matchAll(/(?:^|\\n)\\s*(@\\w+)/g);
1760
-
1761
- for (const [, tagName] of tagNames) {
1762
- if (!configuration.tryGetTagDefinition(tagName)) {
1763
- configuration.addTagDefinition(
1764
- new TSDocTagDefinition({
1765
- tagName,
1766
- syntaxKind: TSDocTagSyntaxKind.BlockTag
1767
- })
1768
- );
1769
- }
1712
+ const toPosix = (value)=>value.split(external_node_path_default().sep).join('/');
1713
+ const readAliases = (projectRoot)=>{
1714
+ const tsconfig = external_node_path_default().join(projectRoot, 'tsconfig.json');
1715
+ if (!external_node_fs_default().existsSync(tsconfig)) return [];
1716
+ try {
1717
+ const { compilerOptions = {} } = JSON.parse(stripJsonComments(external_node_fs_default().readFileSync(tsconfig, 'utf8')));
1718
+ const base = external_node_path_default().resolve(projectRoot, compilerOptions.baseUrl ?? '.');
1719
+ return Object.entries(compilerOptions.paths ?? {}).filter(([pattern, targets])=>pattern.endsWith('*') && targets[0]?.endsWith('*')).map(([pattern, [target]])=>({
1720
+ prefix: pattern.slice(0, -1),
1721
+ target: external_node_path_default().resolve(base, target.slice(0, -1))
1722
+ }));
1723
+ } catch {
1724
+ return [];
1770
1725
  }
1771
-
1772
- const { docComment } = new TSDocParser(configuration).parseString(comment);
1773
-
1774
- return getText(docComment.summarySection).trim() || undefined;
1775
1726
  };
1776
-
1777
- // Parsed by hand rather than through TSDoc, which drops the line breaks.
1778
- const getTagText = (comment: string, tag: BlockTag): string | undefined => {
1779
- const tagMatch = getRawCommentText(comment).match(
1780
- new RegExp(
1781
- \`(?:^|\\\\n)\\\\s*\${tag}(?:[ \\\\t]*\\\\n|[ \\\\t]+)([\\\\s\\\\S]*?)(?=\\\\n\\\\s*@\\\\w+|\\\\s*$)\`
1782
- )
1783
- );
1784
-
1785
- return tagMatch?.[1].trim() || undefined;
1727
+ const specifierPattern = /(\bfrom\s*|\bimport\s*\(\s*|\bimport\s+|\brequire\s*\(\s*|\bmock\s*\(\s*)(['"])([^'"\n]+)\2/g;
1728
+ const reExportPattern = /\bexport\s+(?:type\s+)?(?:\*(?:\s+as\s+[\w$]+)?|\{[^}]*\})\s*from\s*(['"])([^'"\n]+)\1/g;
1729
+ const importPaths = (file)=>{
1730
+ const withoutExtension = file.replace(codeExtension, '');
1731
+ return 'index' === external_node_path_default().basename(withoutExtension) ? [
1732
+ withoutExtension,
1733
+ external_node_path_default().dirname(withoutExtension)
1734
+ ] : [
1735
+ withoutExtension
1736
+ ];
1786
1737
  };
1787
-
1788
- // Endpoints pass their logic as the generator's first argument
1789
- // (\`this.endpointGenerator(this.handler.handle, ...)\`), while other injected
1790
- // queries only serve as helpers, e.g. guest checks.
1791
- const findHandlerClass = (endpointFile: SourceFile) =>
1792
- endpointFile
1793
- .getDescendantsOfKind(SyntaxKind.CallExpression)
1794
- .map((call) => call.getArguments()[0])
1795
- .filter(Node.isPropertyAccessExpression)
1796
- .find((argument) => argument.getName() === 'handle')
1797
- ?.getExpression()
1798
- .getType()
1799
- .getSymbol()
1800
- ?.getDeclarations()
1801
- .find(Node.isClassDeclaration);
1802
-
1803
- // Path parameters (\`:id\`) can't be part of file and folder names
1804
- // everywhere (Windows), so endpoints name them \`_id_\` there.
1805
- const pathParameterAsName = (segment: string) =>
1806
- segment.startsWith(':') ? \`_\${segment.slice(1)}_\` : segment;
1807
-
1808
- export const createOpenApiDataFromEndpointLogicExtractor = ({
1809
- summary: summaryTag,
1810
- description: descriptionTag = '@description'
1811
- }: OpenApiDataTags = {}) => {
1812
- return (routeMetadata: {
1813
- method: string;
1814
- path: readonly string[];
1815
- }): OpenApiData | undefined => {
1816
- try {
1817
- ${endpointFileLookup(rootFolder)}
1818
- if (!endpointFile) {
1819
- return undefined;
1820
- }
1821
-
1822
- const declaration = findHandlerClass(endpointFile);
1823
- const operationId = declaration?.getName();
1824
- const comment = declaration?.getJsDocs().at(-1)?.getText();
1825
-
1826
- if (!comment) {
1827
- return { operationId };
1828
- }
1829
-
1830
- return {
1831
- summary: summaryTag
1832
- ? getTagText(comment, summaryTag)
1833
- : parseSummary(comment),
1834
- description: getTagText(comment, descriptionTag),
1835
- operationId
1836
- };
1837
- } catch (e: unknown) {
1838
- console.error(e);
1839
- return undefined;
1840
- }
1738
+ const projectImports = (projectRoot)=>{
1739
+ const aliases = readAliases(projectRoot);
1740
+ const resolve = (specifier, fromFile)=>{
1741
+ if (specifier.startsWith('.')) return {
1742
+ resolved: external_node_path_default().resolve(external_node_path_default().dirname(fromFile), specifier),
1743
+ alias: void 0
1744
+ };
1745
+ const alias = aliases.find(({ prefix })=>specifier.startsWith(prefix));
1746
+ return alias ? {
1747
+ resolved: external_node_path_default().resolve(alias.target, specifier.slice(alias.prefix.length)),
1748
+ alias
1749
+ } : void 0;
1750
+ };
1751
+ const specifierFor = (fromFile, toPath, alias)=>{
1752
+ const aliased = alias && toPosix(external_node_path_default().relative(alias.target, toPath));
1753
+ if (aliased && !aliased.startsWith('..')) return `${alias.prefix}${aliased}`;
1754
+ const relative = toPosix(external_node_path_default().relative(external_node_path_default().dirname(fromFile), toPath));
1755
+ return relative.startsWith('.') ? relative : `./${relative}`;
1756
+ };
1757
+ const codeFiles = new Map(module_move_walk(projectRoot).filter((file)=>codeExtension.test(file)).map((file)=>[
1758
+ file,
1759
+ external_node_fs_default().readFileSync(file, 'utf8')
1760
+ ]));
1761
+ const importsOf = (file)=>[
1762
+ ...(codeFiles.get(file) ?? '').matchAll(specifierPattern)
1763
+ ].map(([, , , specifier])=>resolve(specifier, file)?.resolved).filter((resolved)=>!!resolved);
1764
+ return {
1765
+ resolve,
1766
+ specifierFor,
1767
+ codeFiles,
1768
+ importsOf
1841
1769
  };
1842
1770
  };
1843
- `;
1844
- const openapiScriptPath = "scripts/generate-openapi.ts";
1845
- const defaultOpenapiPath = (withNext)=>withNext ? 'public/openapi.json' : 'openapi.json';
1846
- const extractorPackages = [
1847
- 'ts-morph',
1848
- '@microsoft/tsdoc'
1849
- ];
1850
- const swaggerPagePath = (rootFolder)=>external_node_path_default().posix.join(rootFolder.replaceAll('\\', '/'), 'presentation/react/pages/swagger-page.tsx');
1851
- const swaggerPage = (rootFolder, outputPath, withNext = false)=>{
1852
- const specImport = external_node_path_default().posix.relative(external_node_path_default().posix.dirname(swaggerPagePath(rootFolder)), outputPath);
1853
- const page = reactPageContent('Swagger', {
1854
- imports: [
1855
- "import 'swagger-ui-react/swagger-ui.css'",
1856
- "import SwaggerUI from 'swagger-ui-react'",
1857
- `import spec from '${specImport.startsWith('.') ? specImport : `./${specImport}`}' with { type: 'json' }`
1858
- ],
1771
+ const stageModuleMove = ({ projectRoot, stopAt, moves, movedPath, rename, everyFile = (content)=>content, stopAtFor })=>{
1772
+ const stopFor = (file)=>stopAtFor?.(file) ?? stopAt;
1773
+ const { resolve, specifierFor, codeFiles } = projectImports(projectRoot);
1774
+ const barrels = new Set();
1775
+ const isBarrel = (resolved)=>barrels.has(resolved.replace(codeExtension, ''));
1776
+ for(let found = true; found;){
1777
+ found = false;
1778
+ for (const [file, content] of codeFiles){
1779
+ if (moves.has(file) || isBarrel(file)) continue;
1780
+ const reExportsModule = [
1781
+ ...content.matchAll(reExportPattern)
1782
+ ].some(([, , specifier])=>{
1783
+ const resolution = resolve(specifier, file);
1784
+ return !!resolution && (!!movedPath(resolution.resolved) || isBarrel(resolution.resolved));
1785
+ });
1786
+ if (reExportsModule) {
1787
+ for (const importPath of importPaths(file))barrels.add(importPath);
1788
+ found = true;
1789
+ }
1790
+ }
1791
+ }
1792
+ const rewrite = (content, oldFile, newFile)=>{
1793
+ let referencesModule = false;
1794
+ const rewritten = content.replace(specifierPattern, (match, keyword, quote, specifier)=>{
1795
+ const resolution = resolve(specifier, oldFile);
1796
+ if (!resolution) return match;
1797
+ const moved = movedPath(resolution.resolved);
1798
+ if (moved || isBarrel(resolution.resolved)) referencesModule = true;
1799
+ if (!moved && oldFile === newFile) return match;
1800
+ const next = specifierFor(newFile, moved ?? resolution.resolved, resolution.alias);
1801
+ return `${keyword}${quote}${next}${quote}`;
1802
+ });
1803
+ const changed = everyFile(rewritten);
1804
+ if (!referencesModule && !moves.has(oldFile)) return changed;
1805
+ return rename(changed, {
1806
+ moved: moves.has(oldFile)
1807
+ });
1808
+ };
1809
+ for (const [file, newFile] of moves)if (!codeFiles.has(file) && newFile !== file) new file_system_File(file).moveTo(newFile, stopFor(file));
1810
+ const updated = [];
1811
+ for (const [file, content] of codeFiles){
1812
+ const newFile = moves.get(file);
1813
+ const next = rewrite(content, file, newFile ?? file);
1814
+ if (newFile && newFile !== file) {
1815
+ new file_system_File(newFile).data = next;
1816
+ new file_system_File(file).delete(stopFor(file));
1817
+ } else if (next !== content) {
1818
+ new file_system_File(file).update(next);
1819
+ if (!newFile) updated.push(file);
1820
+ }
1821
+ }
1822
+ return {
1823
+ moves: [
1824
+ ...moves
1825
+ ].filter(([from, to])=>from !== to),
1826
+ updated
1827
+ };
1828
+ };
1829
+ const frontendExtensions = {
1830
+ react: {
1831
+ component: '.tsx',
1832
+ hook: '.ts'
1833
+ },
1834
+ svelte: {
1835
+ component: '.svelte',
1836
+ hook: '.svelte.ts'
1837
+ }
1838
+ };
1839
+ const kindLayouts = (framework)=>{
1840
+ const { component, hook } = frontendExtensions[framework];
1841
+ return {
1842
+ page: {
1843
+ folder: 'pages',
1844
+ nested: true,
1845
+ inFolder: false,
1846
+ ownFile: (fileBase)=>new RegExp(`^${escapeRegExp(fileBase)}-page(?:\\.|$)`),
1847
+ target: (reactFolder, { folders, fileName })=>external_node_path_default().join(reactFolder, 'pages', ...folders, `${fileName}-page${component}`),
1848
+ classPrefix: '(use)?',
1849
+ classSuffix: 'Page'
1850
+ },
1851
+ widget: {
1852
+ folder: 'widgets',
1853
+ nested: true,
1854
+ inFolder: true,
1855
+ target: (reactFolder, { folders, folderName })=>external_node_path_default().join(reactFolder, 'widgets', ...folders, folderName),
1856
+ classPrefix: '(use)?',
1857
+ classSuffix: 'Widget|UIModel',
1858
+ storyTitle: (segments)=>[
1859
+ 'Widgets',
1860
+ ...segments
1861
+ ].join('/')
1862
+ },
1863
+ 'ui-kit': {
1864
+ folder: 'ui-kit',
1865
+ nested: false,
1866
+ inFolder: true,
1867
+ target: (reactFolder, { fileName })=>external_node_path_default().join(reactFolder, 'ui-kit', fileName),
1868
+ classPrefix: '()',
1869
+ classSuffix: 'Props(?![\\w$])|(?![\\w$])',
1870
+ storyTitle: (segments)=>`UI-kit/${segments.join('')}`
1871
+ },
1872
+ hook: {
1873
+ folder: 'hooks',
1874
+ nested: false,
1875
+ inFolder: false,
1876
+ ownFile: (fileBase)=>new RegExp(`^use-${escapeRegExp(fileBase)}(?:\\.|$)`),
1877
+ target: (reactFolder, { fileName })=>external_node_path_default().join(reactFolder, 'hooks', `use-${fileName}${hook}`),
1878
+ classPrefix: '(use)',
1879
+ classSuffix: '(?![\\w$])'
1880
+ }
1881
+ };
1882
+ };
1883
+ const reactKindLayouts = kindLayouts('react');
1884
+ const svelteKindLayouts = kindLayouts('svelte');
1885
+ const frontendKindLayouts = (framework)=>'svelte' === framework ? svelteKindLayouts : reactKindLayouts;
1886
+ const reactKindTitles = {
1887
+ page: [
1888
+ 'Page',
1889
+ 'pages'
1890
+ ],
1891
+ widget: [
1892
+ 'Widget',
1893
+ 'widgets'
1894
+ ],
1895
+ 'ui-kit': [
1896
+ 'UI-kit component',
1897
+ 'UI-kit components'
1898
+ ],
1899
+ hook: [
1900
+ 'Shared hook',
1901
+ 'shared hooks'
1902
+ ]
1903
+ };
1904
+ const reactModuleName = (kind, rawName)=>'hook' === kind ? rawName.trim().replace(/^use-/, '') : rawName;
1905
+ const react_module_move_nestedName = (folders, fileBase)=>{
1906
+ const prefix = `${folders.join('-')}-`;
1907
+ const last = folders.length && fileBase.startsWith(prefix) ? fileBase.slice(prefix.length) : fileBase;
1908
+ return [
1909
+ ...folders,
1910
+ last
1911
+ ].join('/');
1912
+ };
1913
+ const declaredClassName = (filePaths, suffix, name)=>{
1914
+ for (const filePath of filePaths){
1915
+ if (!external_node_fs_default().existsSync(filePath)) continue;
1916
+ const declared = external_node_fs_default().readFileSync(filePath, 'utf8').match(new RegExp(`(?:export\\s+(?:const|function)|\\bdefault\\s+as)\\s+(\\w+)${suffix}\\b`))?.[1];
1917
+ if (declared) return declared;
1918
+ }
1919
+ return new NestedName(name).ClassName;
1920
+ };
1921
+ const findUiKit = (reactFolder, framework)=>{
1922
+ const { component } = frontendExtensions[framework];
1923
+ const root = external_node_path_default().join(reactFolder, 'ui-kit');
1924
+ if (!external_node_fs_default().existsSync(root)) return [];
1925
+ return external_node_fs_default().readdirSync(root, {
1926
+ withFileTypes: true
1927
+ }).filter((entry)=>entry.isDirectory() && external_node_fs_default().existsSync(external_node_path_default().join(root, entry.name, `${entry.name}${component}`))).map(({ name })=>({
1928
+ kind: 'ui-kit',
1929
+ name,
1930
+ path: external_node_path_default().join(root, name),
1931
+ fileBase: name,
1932
+ ClassName: declaredClassName([
1933
+ external_node_path_default().join(root, name, `${name}${component}`),
1934
+ external_node_path_default().join(root, name, 'index.ts')
1935
+ ], '', name)
1936
+ }));
1937
+ };
1938
+ const hookFile = {
1939
+ react: /\.tsx?$/,
1940
+ svelte: /\.svelte\.[jt]s$/
1941
+ };
1942
+ const findHooks = (reactFolder, framework)=>{
1943
+ const root = external_node_path_default().join(reactFolder, 'hooks');
1944
+ if (!external_node_fs_default().existsSync(root)) return [];
1945
+ const extension = hookFile[framework];
1946
+ return external_node_fs_default().readdirSync(root).filter((file)=>/^use-/.test(file) && extension.test(file) && !/\.(spec|test)\./.test(file)).map((file)=>{
1947
+ const name = file.replace(/^use-/, '').replace(extension, '');
1948
+ const content = external_node_fs_default().readFileSync(external_node_path_default().join(root, file), 'utf8');
1949
+ return {
1950
+ kind: 'hook',
1951
+ name,
1952
+ path: external_node_path_default().join(root, file),
1953
+ fileBase: name,
1954
+ ClassName: content.match(/export\s+(?:const|function)\s+use(\w+)\b/)?.[1] ?? new NestedName(name).ClassName
1955
+ };
1956
+ });
1957
+ };
1958
+ const findReactModules = (reactFolder, kind, framework = 'react')=>{
1959
+ const { component } = frontendExtensions[framework];
1960
+ const modules = 'ui-kit' === kind ? findUiKit(reactFolder, framework) : 'hook' === kind ? findHooks(reactFolder, framework) : 'page' === kind ? module_move_walk(external_node_path_default().join(reactFolder, 'pages')).filter((file)=>file.endsWith(`-page${component}`)).map((file)=>{
1961
+ const folders = external_node_path_default().relative(external_node_path_default().join(reactFolder, 'pages'), external_node_path_default().dirname(file)).split(external_node_path_default().sep).filter((segment)=>!!segment);
1962
+ const fileBase = external_node_path_default().basename(file, `-page${component}`);
1963
+ const name = react_module_move_nestedName(folders, fileBase);
1964
+ return {
1965
+ kind,
1966
+ name,
1967
+ path: file,
1968
+ fileBase,
1969
+ ClassName: declaredClassName([
1970
+ file
1971
+ ], 'Page', name)
1972
+ };
1973
+ }) : module_move_walk(external_node_path_default().join(reactFolder, 'widgets')).filter((file)=>file.endsWith(`-widget${component}`)).map((file)=>{
1974
+ const folder = external_node_path_default().dirname(file);
1975
+ const name = toPosix(external_node_path_default().relative(external_node_path_default().join(reactFolder, 'widgets'), folder));
1976
+ return {
1977
+ kind,
1978
+ name,
1979
+ path: folder,
1980
+ fileBase: external_node_path_default().basename(file, `-widget${component}`),
1981
+ ClassName: declaredClassName([
1982
+ file,
1983
+ external_node_path_default().join(folder, 'index.ts')
1984
+ ], 'Widget', name)
1985
+ };
1986
+ });
1987
+ return modules.sort((a, b)=>a.name.localeCompare(b.name));
1988
+ };
1989
+ const react_module_move_targetPath = (reactFolder, module, rawName, framework)=>frontendKindLayouts(framework)[module.kind].target(reactFolder, new NestedName(reactModuleName(module.kind, rawName)));
1990
+ const validateMove = (reactFolder, module, rawName, framework = 'react')=>{
1991
+ const nameError = NestedName.validate(rawName);
1992
+ if (true !== nameError) return nameError;
1993
+ if (!reactKindLayouts[module.kind].nested && /[\\/]/.test(rawName)) return 'UI-kit components and shared hooks have no folders: enter a name without "/"';
1994
+ const target = react_module_move_targetPath(reactFolder, module, rawName, framework);
1995
+ if (target !== module.path && external_node_fs_default().existsSync(target)) return `${external_node_path_default().relative(reactFolder, target)} already exists`;
1996
+ if (target.startsWith(`${module.path}${external_node_path_default().sep}`)) return 'A widget cannot be moved into itself';
1997
+ return true;
1998
+ };
1999
+ const react_module_move_routeFolder = (appFolder, rawName)=>{
2000
+ const { folders, folderName } = new NestedName(rawName);
2001
+ return external_node_path_default().join(appFolder, ...folders, folderName);
2002
+ };
2003
+ const routeFiles = (folder)=>external_node_fs_default().existsSync(folder) ? external_node_fs_default().readdirSync(folder, {
2004
+ withFileTypes: true
2005
+ }).filter((entry)=>entry.isFile()).map((entry)=>external_node_path_default().join(folder, entry.name)) : [];
2006
+ const moveReactModule = (projectRoot, reactFolder, module, rawName, route, framework = 'react')=>{
2007
+ const layout = frontendKindLayouts(framework)[module.kind];
2008
+ const newName = new NestedName(reactModuleName(module.kind, rawName));
2009
+ const target = react_module_move_targetPath(reactFolder, module, rawName, framework);
2010
+ const newClassName = newName.ClassName;
2011
+ const renameFile = (name)=>name.replace(new RegExp(`^(use-)?${escapeRegExp(module.fileBase)}(?=[-.]|$)`), (_, use = '')=>`${use}${newName.fileName}`);
2012
+ const oldFolder = layout.inFolder ? module.path : external_node_path_default().dirname(module.path);
2013
+ const newFolder = layout.inFolder ? target : external_node_path_default().dirname(target);
2014
+ const ownsPath = (candidate)=>layout.inFolder ? candidate === oldFolder || candidate.startsWith(`${oldFolder}${external_node_path_default().sep}`) : external_node_path_default().dirname(candidate) === oldFolder && layout.ownFile(module.fileBase).test(external_node_path_default().basename(candidate));
2015
+ const routeFileSet = new Set(route ? routeFiles(route.from) : []);
2016
+ const routeTarget = (candidate)=>{
2017
+ if (!route) return;
2018
+ const file = [
2019
+ ...routeFileSet
2020
+ ].find((x)=>x === candidate || x.replace(codeExtension, '') === candidate);
2021
+ if (!file) return;
2022
+ const moved = external_node_path_default().join(route.to, external_node_path_default().relative(route.from, file));
2023
+ return file === candidate ? moved : moved.replace(codeExtension, '');
2024
+ };
2025
+ const movedPath = (candidate)=>{
2026
+ const routed = routeTarget(candidate);
2027
+ if (routed) return routed;
2028
+ if (!ownsPath(candidate)) return;
2029
+ const segments = external_node_path_default().relative(oldFolder, candidate).split(external_node_path_default().sep);
2030
+ const last = segments.length - 1;
2031
+ segments[last] = renameFile(segments[last]);
2032
+ return external_node_path_default().join(newFolder, ...segments);
2033
+ };
2034
+ const moduleFiles = reactModuleFiles(module, framework);
2035
+ const moves = new Map([
2036
+ ...moduleFiles,
2037
+ ...routeFileSet
2038
+ ].map((file)=>[
2039
+ file,
2040
+ movedPath(file) ?? file
2041
+ ]));
2042
+ const classPattern = new RegExp(`(?<![\\w$])${layout.classPrefix}${escapeRegExp(module.ClassName)}(?=${layout.classSuffix})`, 'g');
2043
+ const oldTitle = layout.storyTitle?.('ui-kit' === module.kind ? [
2044
+ module.ClassName
2045
+ ] : module.name.split('/').map((segment)=>new NestedName(segment).ClassName));
2046
+ const titlePattern = oldTitle && new RegExp(`(['"\`])${escapeRegExp(oldTitle)}\\1`, 'g');
2047
+ const newTitle = layout.storyTitle?.('ui-kit' === module.kind ? [
2048
+ newClassName
2049
+ ] : newName.classNameSegments);
2050
+ return stageModuleMove({
2051
+ projectRoot,
2052
+ stopAt: reactFolder,
2053
+ stopAtFor: (file)=>route && routeFileSet.has(file) ? route.appFolder : void 0,
2054
+ moves,
2055
+ movedPath,
2056
+ rename: (content, { moved })=>{
2057
+ const renamed = content.replace(classPattern, (_, use)=>`${use ?? ''}${newClassName}`);
2058
+ return moved && titlePattern ? renamed.replace(titlePattern, (_, quote)=>`${quote}${newTitle}${quote}`) : renamed;
2059
+ }
2060
+ });
2061
+ };
2062
+ const routePageFile = {
2063
+ react: 'page.tsx',
2064
+ svelte: '+page.svelte'
2065
+ };
2066
+ const pageRouteFolder = (appFolder, page, framework = 'react')=>{
2067
+ const folder = react_module_move_routeFolder(appFolder, page.name);
2068
+ const routePage = external_node_path_default().join(folder, routePageFile[framework]);
2069
+ return external_node_fs_default().existsSync(routePage) && new RegExp(`(?<![\\w$])${page.ClassName}Page(?![\\w$])`).test(external_node_fs_default().readFileSync(routePage, 'utf8')) ? folder : void 0;
2070
+ };
2071
+ const reactModuleFiles = (module, framework)=>{
2072
+ const layout = frontendKindLayouts(framework)[module.kind];
2073
+ if (layout.inFolder) return module_move_walk(module.path);
2074
+ const folder = external_node_path_default().dirname(module.path);
2075
+ const own = layout.ownFile(module.fileBase);
2076
+ return external_node_fs_default().readdirSync(folder, {
2077
+ withFileTypes: true
2078
+ }).filter((entry)=>entry.isFile() && own.test(entry.name)).map((entry)=>external_node_path_default().join(folder, entry.name));
2079
+ };
2080
+ const importSpecifier = /(?:\bfrom\s*|\bimport\s*\(\s*|\brequire\s*\(\s*|\bimport\s+)(['"])([^'"\n]+)\1/g;
2081
+ const deleteReactModule = (projectRoot, reactFolder, module, route, framework = 'react')=>{
2082
+ const moduleFiles = reactModuleFiles(module, framework);
2083
+ const routeFileList = route ? routeFiles(route.folder) : [];
2084
+ const own = new Set([
2085
+ ...moduleFiles,
2086
+ ...routeFileList
2087
+ ]);
2088
+ const stems = new Set(moduleFiles.map((file)=>file.replace(codeExtension, '')));
2089
+ const isModule = (resolved)=>stems.has(resolved) || moduleFiles.includes(resolved) || frontendKindLayouts(framework)[module.kind].inFolder && (resolved === module.path || resolved.startsWith(`${module.path}${external_node_path_default().sep}`));
2090
+ const { codeFiles, resolve } = projectImports(projectRoot);
2091
+ const relative = (file)=>toPosix(external_node_path_default().relative(projectRoot, file));
2092
+ const usedBy = [];
2093
+ for (const [file, content] of codeFiles)if (!own.has(file)) for (const [, , specifier] of content.matchAll(importSpecifier)){
2094
+ const target = resolve(specifier, file)?.resolved;
2095
+ if (target && isModule(target)) usedBy.push([
2096
+ relative(file),
2097
+ relative(target)
2098
+ ]);
2099
+ }
2100
+ if (usedBy.length) return {
2101
+ usedBy
2102
+ };
2103
+ for (const file of moduleFiles)new file_system_File(file).delete(reactFolder);
2104
+ for (const file of routeFileList)new file_system_File(file).delete(route.appFolder);
2105
+ return {
2106
+ deleted: [
2107
+ ...moduleFiles,
2108
+ ...routeFileList
2109
+ ]
2110
+ };
2111
+ };
2112
+ const svelteComponentContent = (propsType)=>`
2113
+ <script lang="ts" module>
2114
+ export type ${propsType} = {}
2115
+ </script>
2116
+
2117
+ <script lang="ts">
2118
+ let props: ${propsType} = $props()
2119
+ </script>
2120
+ `.trim();
2121
+ const svelteStory = (storybookFramework, componentName, componentFile, title)=>`
2122
+ import type { Meta, StoryObj } from '${storybookFramework}'
2123
+ import ${componentName} from './${componentFile}'
2124
+
2125
+ const meta = {
2126
+ title: '${title}',
2127
+ component: ${componentName}
2128
+ } satisfies Meta<typeof ${componentName}>
2129
+
2130
+ export default meta
2131
+
2132
+ type Story = StoryObj<typeof meta>
2133
+
2134
+ export const Default: Story = {
2135
+ args: {}
2136
+ }
2137
+ `.trim();
2138
+ const scaffold_svelte_modules_storybookFramework = ()=>config_file_ConfigFile.Instance.data.frontend?.svelte?.storybookFramework;
2139
+ const svelteKitRouteContent = (ClassName, pageImport)=>`
2140
+ <script lang="ts">
2141
+ import ${ClassName}Page from '${pageImport}'
2142
+ </script>
2143
+
2144
+ <${ClassName}Page />
2145
+ `.trim();
2146
+ const scaffold_svelte_modules_relativeImport = (fromFile, toFile)=>{
2147
+ const relative = external_node_path_default().relative(external_node_path_default().dirname(fromFile), toFile).split(external_node_path_default().sep).join('/');
2148
+ return relative.startsWith('.') ? relative : `./${relative}`;
2149
+ };
2150
+ const scaffoldSvelteKitRoute = (name, pagePath)=>{
2151
+ const root = new project_root_ProjectRoot().path;
2152
+ const route = external_node_path_default().join(root, svelteKitRoutesFolder(root), ...name.folders, name.folderName, routePageFile.svelte);
2153
+ const relativeRoute = external_node_path_default().relative(root, route).split(external_node_path_default().sep).join('/');
2154
+ const routeFile = new file_system_File(route);
2155
+ const content = svelteKitRouteContent(name.ClassName, scaffold_svelte_modules_relativeImport(route, pagePath));
2156
+ if (routeFile.exists) return routeFile.data === content ? void 0 : `${relativeRoute} already exists: render ${name.ClassName}Page there yourself.`;
2157
+ routeFile.data = content;
2158
+ };
2159
+ const scaffoldSveltePage = async (presentationSvelteFolder)=>{
2160
+ const name = await interaction_input({
2161
+ key: 'name',
2162
+ message: 'Provide name (folders split by "/"):',
2163
+ validate: NestedName.validate
2164
+ });
2165
+ const nestedName = new NestedName(name);
2166
+ const { folders, ClassName, fileName } = nestedName;
2167
+ const pageFile = presentationSvelteFolder.subitem([
2168
+ 'pages',
2169
+ ...folders
2170
+ ]).createFile(`${fileName}-page.svelte`, svelteComponentContent(`${ClassName}PageProps`));
2171
+ if (usesSvelteKit()) {
2172
+ const hint = scaffoldSvelteKitRoute(nestedName, pageFile.path);
2173
+ if (hint) report(hint);
2174
+ }
2175
+ };
2176
+ const scaffoldSvelteWidget = async (presentationSvelteFolder)=>{
2177
+ const widgetName = await interaction_input({
2178
+ key: 'name',
2179
+ message: 'Name (folders split by "/"): ',
2180
+ validate: NestedName.validate
2181
+ });
2182
+ const widgetType = await interaction_select({
2183
+ choices: [
2184
+ 'monolithic',
2185
+ 'with separated ui',
2186
+ 'headless'
2187
+ ],
2188
+ key: 'widgetType',
2189
+ message: 'Type: '
2190
+ });
2191
+ const { folders, folderName, ClassName, fileName, classNameSegments } = new NestedName(widgetName);
2192
+ const folder = presentationSvelteFolder.subitem([
2193
+ 'widgets',
2194
+ ...folders,
2195
+ folderName
2196
+ ]);
2197
+ const storyTitle = [
2198
+ 'Widgets',
2199
+ ...classNameSegments
2200
+ ].join('/');
2201
+ const widgetFileName = `${fileName}-widget`;
2202
+ const uiFileName = `${fileName}-widget-ui`;
2203
+ const uiModelFileName = `use-${fileName}-ui-model`;
2204
+ if ('monolithic' === widgetType) {
2205
+ folder.createFile('index.ts', `
2206
+ export { default as ${ClassName}Widget } from './${widgetFileName}.svelte'
2207
+ export type { ${ClassName}WidgetProps } from './${widgetFileName}.svelte'
2208
+ `.trim());
2209
+ folder.createFile(`${widgetFileName}.svelte`, svelteComponentContent(`${ClassName}WidgetProps`));
2210
+ return;
2211
+ }
2212
+ folder.createFile('index.ts', `
2213
+ export { default as ${ClassName}Widget } from './${widgetFileName}.svelte'
2214
+ export type { ${ClassName}WidgetProps } from './types'
2215
+ `.trim());
2216
+ if ('with separated ui' === widgetType) {
2217
+ folder.createFile('types.ts', `
2218
+ export type ${ClassName}WidgetProps = { }
2219
+
2220
+ export type ${ClassName}WidgetUIProps = { }
2221
+ `.trim());
2222
+ folder.createFile(`${widgetFileName}.svelte`, `
2223
+ <script lang="ts">
2224
+ import type { ${ClassName}WidgetProps } from './types'
2225
+ import ${ClassName}WidgetUI from './ui/${uiFileName}.svelte'
2226
+ import { use${ClassName}UIModel } from './hooks/${uiModelFileName}.svelte'
2227
+
2228
+ let props: ${ClassName}WidgetProps = $props()
2229
+ const uiModel = use${ClassName}UIModel(props)
2230
+ </script>
2231
+
2232
+ <${ClassName}WidgetUI {...uiModel} />
2233
+ `.trim());
2234
+ folder.subitem([
2235
+ 'ui'
2236
+ ]).createFile(`${uiFileName}.svelte`, `
2237
+ <script lang="ts">
2238
+ import type { ${ClassName}WidgetUIProps } from '../types'
2239
+
2240
+ let props: ${ClassName}WidgetUIProps = $props()
2241
+ </script>
2242
+ `.trim());
2243
+ const framework = scaffold_svelte_modules_storybookFramework();
2244
+ if (framework) folder.subitem([
2245
+ 'ui'
2246
+ ]).createFile(`${uiFileName}.stories.ts`, svelteStory(framework, `${ClassName}WidgetUI`, `${uiFileName}.svelte`, storyTitle));
2247
+ folder.subitem([
2248
+ 'hooks'
2249
+ ]).createFile(`${uiModelFileName}.svelte.ts`, `
2250
+ import type { ${ClassName}WidgetProps, ${ClassName}WidgetUIProps } from '../types'
2251
+
2252
+ export const use${ClassName}UIModel = (widgetProps: ${ClassName}WidgetProps): ${ClassName}WidgetUIProps => {
2253
+ return {}
2254
+ }
2255
+ `.trim());
2256
+ return;
2257
+ }
2258
+ folder.createFile('types.ts', `
2259
+ import type { Component } from 'svelte'
2260
+
2261
+ export type ${ClassName}WidgetUIProps = { }
2262
+
2263
+ export type ${ClassName}WidgetProps = {
2264
+ UI: Component<${ClassName}WidgetUIProps>
2265
+ }
2266
+ `.trim());
2267
+ folder.createFile(`${widgetFileName}.svelte`, `
2268
+ <script lang="ts">
2269
+ import type { ${ClassName}WidgetProps } from './types'
2270
+ import { use${ClassName}UIModel } from './hooks/${uiModelFileName}.svelte'
2271
+
2272
+ let { UI, ...widgetProps }: ${ClassName}WidgetProps = $props()
2273
+ const uiModel = use${ClassName}UIModel(widgetProps)
2274
+ </script>
2275
+
2276
+ <UI {...uiModel} />
2277
+ `.trim());
2278
+ folder.subitem([
2279
+ 'hooks'
2280
+ ]).createFile(`${uiModelFileName}.svelte.ts`, `
2281
+ import type { ${ClassName}WidgetProps, ${ClassName}WidgetUIProps } from '../types'
2282
+
2283
+ export const use${ClassName}UIModel = (widgetProps: Omit<${ClassName}WidgetProps, 'UI'>): ${ClassName}WidgetUIProps => {
2284
+ return {}
2285
+ }
2286
+ `.trim());
2287
+ };
2288
+ const scaffoldSvelteUIKitComponent = async (presentationSvelteFolder)=>{
2289
+ const name = await interaction_input({
2290
+ key: 'name',
2291
+ message: 'Name: '
2292
+ });
2293
+ const { ClassName, fileName } = new UnknownFormatNaming(name);
2294
+ const componentFolder = presentationSvelteFolder.subitem([
2295
+ 'ui-kit',
2296
+ fileName
2297
+ ]);
2298
+ componentFolder.createFile('index.ts', `
2299
+ export { default as ${ClassName} } from './${fileName}.svelte'
2300
+ export type { ${ClassName}Props } from './${fileName}.svelte'
2301
+ `.trim());
2302
+ componentFolder.createFile(`${fileName}.svelte`, svelteComponentContent(`${ClassName}Props`));
2303
+ const framework = scaffold_svelte_modules_storybookFramework();
2304
+ if (framework) componentFolder.createFile(`${fileName}.stories.ts`, svelteStory(framework, ClassName, `${fileName}.svelte`, `UI-kit/${ClassName}`));
2305
+ };
2306
+ const scaffoldSvelteSharedHook = async (presentationSvelteFolder)=>{
2307
+ const name = await interaction_input({
2308
+ key: 'name',
2309
+ message: 'Name without "use" (e.g. debounce): '
2310
+ });
2311
+ const { ClassName, fileName } = new UnknownFormatNaming(name.trim().replace(/^use-/, ''));
2312
+ presentationSvelteFolder.subitem([
2313
+ 'hooks'
2314
+ ]).createFile(`use-${fileName}.svelte.ts`, `
2315
+ export const use${ClassName} = () => {
2316
+ return {}
2317
+ }
2318
+ `.trim());
2319
+ };
2320
+ const openapiExtractorPath = "scripts/extract-open-api-data-from-endpoint.ts";
2321
+ const rootFolderSegments = (rootFolder, indent = 20)=>rootFolder.split(/[\\/]/).map((segment)=>segment.trim()).filter((segment)=>!!segment && '.' !== segment).map((segment)=>`'${segment}',\n${' '.repeat(indent)}`).join('');
2322
+ const endpointFileLookup = (rootFolder)=>` // A context is the start of the route, nested ones included
2323
+ // (/sales/orders/...). A controller is the next folder; other
2324
+ // routes belong to the context root in presentation/rest/(root).
2325
+ const contextsFolder = path.join(
2326
+ ${rootFolderSegments(rootFolder, 16)}'bounded-contexts'
2327
+ );
2328
+ const endpointFile = Array.from(
2329
+ { length: routeMetadata.path.length },
2330
+ (_, index) => index + 1
2331
+ )
2332
+ .flatMap((contextLength) => {
2333
+ const restFolder = path.join(
2334
+ contextsFolder,
2335
+ ...routeMetadata.path.slice(0, contextLength),
2336
+ 'presentation',
2337
+ 'rest'
2338
+ );
2339
+ const endpointPath = [
2340
+ ...routeMetadata.path
2341
+ .slice(contextLength)
2342
+ .map(pathParameterAsName),
2343
+ \`\${routeMetadata.method.toUpperCase()}.ts\`
2344
+ ];
2345
+ return [
2346
+ path.join(restFolder, ...endpointPath),
2347
+ path.join(restFolder, '(root)', ...endpointPath)
2348
+ ];
2349
+ })
2350
+ .map((file) => project.getSourceFile(file))
2351
+ .find((file) => !!file);
2352
+ `;
2353
+ const openapiExtractor = (rootFolder)=>`import path from 'node:path';
2354
+ import {
2355
+ type DocNode,
2356
+ DocPlainText,
2357
+ TSDocConfiguration,
2358
+ TSDocParser,
2359
+ TSDocTagDefinition,
2360
+ TSDocTagSyntaxKind
2361
+ } from '@microsoft/tsdoc';
2362
+ import { Node, Project, type SourceFile, SyntaxKind } from 'ts-morph';
2363
+
2364
+ type BlockTag = \`@\${string}\`;
2365
+
2366
+ type OpenApiDataTags = {
2367
+ /** Omit to take the summary from the comment text before the first tag. */
2368
+ summary?: BlockTag;
2369
+ description?: BlockTag;
2370
+ };
2371
+
2372
+ type OpenApiData = Partial<{
2373
+ summary: string;
2374
+ description: string;
2375
+ operationId: string;
2376
+ }>;
2377
+
2378
+ const project = new Project({
2379
+ tsConfigFilePath: 'tsconfig.json'
2380
+ });
2381
+
2382
+ const getText = (node: DocNode): string =>
2383
+ node
2384
+ .getChildNodes()
2385
+ .map((child) => {
2386
+ if (child instanceof DocPlainText) {
2387
+ return child.text;
2388
+ }
2389
+
2390
+ return getText(child);
2391
+ })
2392
+ .join('');
2393
+
2394
+ const getRawCommentText = (comment: string): string =>
2395
+ comment
2396
+ .replace(/^\\/\\*\\*/, '')
2397
+ .replace(/\\*\\/$/, '')
2398
+ .split(/\\r?\\n/)
2399
+ .map((line) => line.replace(/^\\s*\\*\\s?/, ''))
2400
+ .join('\\n');
2401
+
2402
+ // TSDoc treats an unknown tag as summary content, so every block tag of the
2403
+ // comment has to be registered for the summary section to end before it.
2404
+ const parseSummary = (comment: string): string | undefined => {
2405
+ const configuration = new TSDocConfiguration();
2406
+ const tagNames = getRawCommentText(comment).matchAll(/(?:^|\\n)\\s*(@\\w+)/g);
2407
+
2408
+ for (const [, tagName] of tagNames) {
2409
+ if (!configuration.tryGetTagDefinition(tagName)) {
2410
+ configuration.addTagDefinition(
2411
+ new TSDocTagDefinition({
2412
+ tagName,
2413
+ syntaxKind: TSDocTagSyntaxKind.BlockTag
2414
+ })
2415
+ );
2416
+ }
2417
+ }
2418
+
2419
+ const { docComment } = new TSDocParser(configuration).parseString(comment);
2420
+
2421
+ return getText(docComment.summarySection).trim() || undefined;
2422
+ };
2423
+
2424
+ // Parsed by hand rather than through TSDoc, which drops the line breaks.
2425
+ const getTagText = (comment: string, tag: BlockTag): string | undefined => {
2426
+ const tagMatch = getRawCommentText(comment).match(
2427
+ new RegExp(
2428
+ \`(?:^|\\\\n)\\\\s*\${tag}(?:[ \\\\t]*\\\\n|[ \\\\t]+)([\\\\s\\\\S]*?)(?=\\\\n\\\\s*@\\\\w+|\\\\s*$)\`
2429
+ )
2430
+ );
2431
+
2432
+ return tagMatch?.[1].trim() || undefined;
2433
+ };
2434
+
2435
+ // Endpoints pass their logic as the generator's first argument
2436
+ // (\`this.endpointGenerator(this.handler.handle, ...)\`), while other injected
2437
+ // queries only serve as helpers, e.g. guest checks.
2438
+ const findHandlerClass = (endpointFile: SourceFile) =>
2439
+ endpointFile
2440
+ .getDescendantsOfKind(SyntaxKind.CallExpression)
2441
+ .map((call) => call.getArguments()[0])
2442
+ .filter(Node.isPropertyAccessExpression)
2443
+ .find((argument) => argument.getName() === 'handle')
2444
+ ?.getExpression()
2445
+ .getType()
2446
+ .getSymbol()
2447
+ ?.getDeclarations()
2448
+ .find(Node.isClassDeclaration);
2449
+
2450
+ // Path parameters (\`:id\`) can't be part of file and folder names
2451
+ // everywhere (Windows), so endpoints name them \`_id_\` there.
2452
+ const pathParameterAsName = (segment: string) =>
2453
+ segment.startsWith(':') ? \`_\${segment.slice(1)}_\` : segment;
2454
+
2455
+ export const createOpenApiDataFromEndpointLogicExtractor = ({
2456
+ summary: summaryTag,
2457
+ description: descriptionTag = '@description'
2458
+ }: OpenApiDataTags = {}) => {
2459
+ return (routeMetadata: {
2460
+ method: string;
2461
+ path: readonly string[];
2462
+ }): OpenApiData | undefined => {
2463
+ try {
2464
+ ${endpointFileLookup(rootFolder)}
2465
+ if (!endpointFile) {
2466
+ return undefined;
2467
+ }
2468
+
2469
+ const declaration = findHandlerClass(endpointFile);
2470
+ const operationId = declaration?.getName();
2471
+ const comment = declaration?.getJsDocs().at(-1)?.getText();
2472
+
2473
+ if (!comment) {
2474
+ return { operationId };
2475
+ }
2476
+
2477
+ return {
2478
+ summary: summaryTag
2479
+ ? getTagText(comment, summaryTag)
2480
+ : parseSummary(comment),
2481
+ description: getTagText(comment, descriptionTag),
2482
+ operationId
2483
+ };
2484
+ } catch (e: unknown) {
2485
+ console.error(e);
2486
+ return undefined;
2487
+ }
2488
+ };
2489
+ };
2490
+ `;
2491
+ const openapiScriptPath = "scripts/generate-openapi.ts";
2492
+ const defaultOpenapiPath = ()=>usesNext() ? 'public/openapi.json' : usesSvelteKit() ? 'static/openapi.json' : 'openapi.json';
2493
+ const extractorPackages = [
2494
+ 'ts-morph',
2495
+ '@microsoft/tsdoc'
2496
+ ];
2497
+ const swaggerPagePath = (rootFolder, framework = 'react')=>external_node_path_default().posix.join(rootFolder.replaceAll('\\', '/'), 'svelte' === framework ? 'presentation/svelte/pages/swagger-page.svelte' : 'presentation/react/pages/swagger-page.tsx');
2498
+ const specImportOf = (pagePath, outputPath)=>{
2499
+ const specImport = external_node_path_default().posix.relative(external_node_path_default().posix.dirname(pagePath), outputPath);
2500
+ return specImport.startsWith('.') ? specImport : `./${specImport}`;
2501
+ };
2502
+ const swaggerPage = (rootFolder, outputPath, withNext = false)=>{
2503
+ const page = reactPageContent('Swagger', {
2504
+ imports: [
2505
+ "import 'swagger-ui-react/swagger-ui.css'",
2506
+ "import SwaggerUI from 'swagger-ui-react'",
2507
+ `import spec from '${specImportOf(swaggerPagePath(rootFolder), outputPath)}' with { type: 'json' }`
2508
+ ],
1859
2509
  body: '<SwaggerUI displayOperationId spec={spec} />'
1860
2510
  });
1861
2511
  return withNext ? `'use client'\n\n${page}` : page;
1862
2512
  };
2513
+ const svelteSwaggerPage = (rootFolder, outputPath)=>`
2514
+ <script lang="ts" module>
2515
+ export type SwaggerPageProps = {}
2516
+ </script>
2517
+
2518
+ <script lang="ts">
2519
+ import 'swagger-ui/dist/swagger-ui.css'
2520
+ import { onMount } from 'svelte'
2521
+ import spec from '${specImportOf(swaggerPagePath(rootFolder, 'svelte'), outputPath)}'
2522
+
2523
+ let props: SwaggerPageProps = $props()
2524
+ let container: HTMLDivElement
2525
+
2526
+ onMount(async () => {
2527
+ const { default: SwaggerUI } = await import('swagger-ui')
2528
+ SwaggerUI({ domNode: container, spec, displayOperationId: true })
2529
+ })
2530
+ </script>
2531
+
2532
+ <div bind:this={container}></div>
2533
+ `.trim();
2534
+ const swaggerPackages = {
2535
+ react: {
2536
+ dependency: 'swagger-ui-react',
2537
+ types: '@types/swagger-ui-react'
2538
+ },
2539
+ svelte: {
2540
+ dependency: 'swagger-ui',
2541
+ types: '@types/swagger-ui'
2542
+ }
2543
+ };
1863
2544
  const openapiScripts = {
1864
2545
  openapi: `tsx --env-file-if-exists=.env ${openapiScriptPath}`
1865
2546
  };
@@ -1918,7 +2599,7 @@ const addOpenapi = async ()=>{
1918
2599
  const outputPath = await interaction_input({
1919
2600
  key: 'openapiPath',
1920
2601
  message: 'OpenAPI document path:',
1921
- default: defaultOpenapiPath(usesNext()),
2602
+ default: defaultOpenapiPath(),
1922
2603
  validate: (value)=>splitPath(value).length ? true : 'Path is required'
1923
2604
  });
1924
2605
  const withExtractor = await interaction_confirm({
@@ -1926,7 +2607,9 @@ const addOpenapi = async ()=>{
1926
2607
  message: "Fill operationId, summary and description from the endpoint logic TSDoc?",
1927
2608
  default: true
1928
2609
  });
1929
- const withSwaggerPage = Boolean(config_file_ConfigFile.Instance.data.frontend?.react) && await interaction_confirm({
2610
+ const { frontend } = config_file_ConfigFile.Instance.data;
2611
+ const framework = frontend?.svelte ? 'svelte' : frontend?.react ? 'react' : void 0;
2612
+ const withSwaggerPage = !!framework && await interaction_confirm({
1930
2613
  key: 'swaggerPage',
1931
2614
  message: 'Add a Swagger UI page?',
1932
2615
  default: true
@@ -1940,15 +2623,16 @@ const addOpenapi = async ()=>{
1940
2623
  const generatorFile = new file_system_File(external_node_path_default().join(root, openapiScriptPath));
1941
2624
  const content = openapiGenerator(rootFolder, apiTitle(manifest.name), routePrefix, splitPath(outputPath).join('/'), withExtractor);
1942
2625
  if (!generatorFile.exists || generatorFile.data !== content) generatorFile.data = content;
1943
- const withNextRoute = withSwaggerPage && usesNext();
1944
- let nextRouteHint;
2626
+ const routeFile = withSwaggerPage && 'react' === framework && usesNext() ? `${nextAppFolder(root)}/swagger/page.tsx` : withSwaggerPage && 'svelte' === framework && usesSvelteKit() ? `${svelteKitRoutesFolder(root)}/swagger/+page.svelte` : void 0;
2627
+ let routeHint;
1945
2628
  if (withSwaggerPage) {
1946
- const pagePath = external_node_path_default().join(root, swaggerPagePath(rootFolder));
2629
+ const pagePath = external_node_path_default().join(root, swaggerPagePath(rootFolder, framework));
1947
2630
  const pageFile = new file_system_File(pagePath);
1948
- const page = swaggerPage(rootFolder, splitPath(outputPath).join('/'), withNextRoute);
2631
+ const page = 'svelte' === framework ? svelteSwaggerPage(rootFolder, splitPath(outputPath).join('/')) : swaggerPage(rootFolder, splitPath(outputPath).join('/'), !!routeFile);
1949
2632
  if (!pageFile.exists || pageFile.data !== page) pageFile.data = page;
1950
- if (withNextRoute) nextRouteHint = scaffoldNextRoute(new NestedName('swagger'), pagePath);
2633
+ if (routeFile) routeHint = ('svelte' === framework ? scaffoldSvelteKitRoute : scaffoldNextRoute)(new NestedName('swagger'), pagePath);
1951
2634
  }
2635
+ const packages = swaggerPackages[framework ?? 'react'];
1952
2636
  const resolveJsonModule = withSwaggerPage ? compilerOption(external_node_path_default().join(root, 'tsconfig.json'), 'resolveJsonModule') : true;
1953
2637
  const hasRestHandlers = new file_system_File(external_node_path_default().join(root, rootFolder, 'presentation', 'rest', 'index.ts')).exists;
1954
2638
  const missingExtractorPackages = withExtractor ? extractorPackages.filter((name)=>!dependencies[name]) : [];
@@ -1962,11 +2646,11 @@ const addOpenapi = async ()=>{
1962
2646
  ...missingExtractorPackages.length ? [
1963
2647
  `npm install --save-dev ${missingExtractorPackages.join(' ')}`
1964
2648
  ] : [],
1965
- ...withSwaggerPage && !dependencies['swagger-ui-react'] ? [
1966
- 'npm install swagger-ui-react'
2649
+ ...withSwaggerPage && !dependencies[packages.dependency] ? [
2650
+ `npm install ${packages.dependency}`
1967
2651
  ] : [],
1968
- ...withSwaggerPage && !dependencies['@types/swagger-ui-react'] ? [
1969
- 'npm install --save-dev @types/swagger-ui-react'
2652
+ ...withSwaggerPage && !dependencies[packages.types] ? [
2653
+ `npm install --save-dev ${packages.types}`
1970
2654
  ] : [],
1971
2655
  ...true === resolveJsonModule || null === resolveJsonModule ? [] : [
1972
2656
  'set "resolveJsonModule": true in compilerOptions of tsconfig.json — the Swagger UI page imports the OpenAPI document as JSON'
@@ -1974,11 +2658,11 @@ const addOpenapi = async ()=>{
1974
2658
  ...describeScripts(selected, {
1975
2659
  openapi: `generate the OpenAPI document from restHandlers in ${splitPath(outputPath).join('/')}`
1976
2660
  }),
1977
- ...withSwaggerPage && !withNextRoute ? [
1978
- `SwaggerPage from ${swaggerPagePath(rootFolder)} shows ${splitPath(outputPath).join('/')} once it is generated — render it on a route of your app`
2661
+ ...withSwaggerPage && !routeFile ? [
2662
+ `SwaggerPage from ${swaggerPagePath(rootFolder, framework)} shows ${splitPath(outputPath).join('/')} once it is generated — render it on a route of your app`
1979
2663
  ] : [],
1980
- ...withNextRoute ? [
1981
- nextRouteHint ?? `/swagger shows ${splitPath(outputPath).join('/')} once it is generated — the route is ${nextAppFolder(root)}/swagger/page.tsx`
2664
+ ...routeFile ? [
2665
+ routeHint ?? `/swagger shows ${splitPath(outputPath).join('/')} once it is generated — the route is ${routeFile}`
1982
2666
  ] : [],
1983
2667
  ...hasRestHandlers ? [] : [
1984
2668
  `restHandlers appear in ${external_node_path_default().posix.join(rootFolder, 'presentation/rest/index.ts')} with the first REST endpoint generated with @domain-first/wire`
@@ -1992,20 +2676,28 @@ const addGitignoreEntry = (root, entry)=>{
1992
2676
  const newline = ignored.includes('\r\n') ? '\r\n' : '\n';
1993
2677
  gitignore.update(`${ignored}${ignored && !ignored.endsWith('\n') ? newline : ''}${entry}${newline}`);
1994
2678
  };
1995
- const dataLayerFolder = (rootFolder, target)=>external_node_path_default().posix.join(rootFolder.replaceAll('\\', '/'), 'hooks' === target ? 'presentation/react/data-layer' : 'presentation/data-layer');
1996
- const orvalScripts = (rootFolder, targets)=>({
1997
- 'client:orval': targets.map((target)=>`orval --config ${JSON.stringify(`${dataLayerFolder(rootFolder, target)}/orval.config.ts`)}`).join(' && ')
2679
+ const dataLayerFolder = (rootFolder, target, framework = 'react')=>external_node_path_default().posix.join(rootFolder.replaceAll('\\', '/'), 'hooks' === target ? `presentation/${framework}/data-layer` : 'presentation/data-layer');
2680
+ const orvalScripts = (rootFolder, targets, framework = 'react')=>({
2681
+ 'client:orval': targets.map((target)=>`orval --config ${JSON.stringify(`${dataLayerFolder(rootFolder, target, framework)}/orval.config.ts`)}`).join(' && ')
1998
2682
  });
1999
- const orvalConfig = (rootFolder, openapiPath, withNext, target = 'hooks', mutatorPath = './api-client/mutator.ts')=>{
2000
- const inputPath = external_node_path_default().posix.relative(dataLayerFolder(rootFolder, target), openapiPath);
2001
- const baseUrl = withNext ? `
2683
+ const orvalBaseUrls = {
2684
+ next: 'process.env.NEXT_PUBLIC_API_BASE_URL ?? ""',
2685
+ svelte: 'import.meta.env.VITE_API_BASE_URL ?? ""'
2686
+ };
2687
+ const orvalConfig = (rootFolder, openapiPath, baseUrlSource, target = 'hooks', mutatorPath = './api-client/mutator.ts', framework = 'react')=>{
2688
+ const inputPath = external_node_path_default().posix.relative(dataLayerFolder(rootFolder, target, framework), openapiPath);
2689
+ const baseUrl = baseUrlSource ? `
2002
2690
  baseUrl: {
2003
- runtime: 'process.env.NEXT_PUBLIC_API_BASE_URL ?? ""'
2691
+ runtime: '${orvalBaseUrls[baseUrlSource]}'
2004
2692
  },` : '';
2693
+ const svelteQuery = 'hooks' === target && 'svelte' === framework;
2005
2694
  const client = 'hooks' === target ? `
2006
- client: 'react-query',
2695
+ client: '${svelteQuery ? 'svelte-query' : 'react-query'}',
2007
2696
  httpClient: 'fetch',` : `
2008
2697
  client: 'fetch',`;
2698
+ const packageJson = svelteQuery ? `
2699
+ // Svelte Query 6 (runes) even before it is installed; an installed version wins
2700
+ packageJson: './${svelteQueryPackageJsonFile}',` : '';
2009
2701
  const query = 'hooks' === target ? `,
2010
2702
  query: {
2011
2703
  version: 5
@@ -2018,7 +2710,7 @@ export default defineConfig({
2018
2710
  output: {
2019
2711
  mode: 'tags-split',
2020
2712
  target: './orval',
2021
- schemas: './orval/model',${client}${baseUrl}
2713
+ schemas: './orval/model',${client}${packageJson}${baseUrl}
2022
2714
  clean: true,
2023
2715
  override: {
2024
2716
  mutator: {
@@ -2034,6 +2726,14 @@ export default defineConfig({
2034
2726
  });
2035
2727
  `;
2036
2728
  };
2729
+ const svelteQueryPackageJsonFile = 'orval.package.json';
2730
+ const svelteQueryPackageJson = `${JSON.stringify({
2731
+ private: true,
2732
+ dependencies: {
2733
+ '@tanstack/svelte-query': '^6.0.0'
2734
+ }
2735
+ }, null, 4)}
2736
+ `;
2037
2737
  const orvalMutator = `/** Error of the generated requests, with the parsed response body. */
2038
2738
  export class ApiError<Body = unknown> extends Error {
2039
2739
  constructor(
@@ -2079,7 +2779,44 @@ export const QueryProvider: FC<{ children: ReactNode }> = ({ children }) => {
2079
2779
  </QueryClientProvider>
2080
2780
  );
2081
2781
  };
2082
- `;
2782
+ `;
2783
+ const svelteQueryProvider = (withSvelteKit)=>`<script lang="ts">
2784
+ import { QueryClient, QueryClientProvider } from '@tanstack/svelte-query'
2785
+ import type { Snippet } from 'svelte'${withSvelteKit ? "\n import { browser } from '$app/environment'" : ''}
2786
+
2787
+ let { children }: { children: Snippet } = $props()
2788
+
2789
+ // One client per app instance; a module-level client would be shared between requests on the server
2790
+ const queryClient = new QueryClient(${withSvelteKit ? `{
2791
+ defaultOptions: { queries: { enabled: browser } }
2792
+ }` : ''})
2793
+ </script>
2794
+
2795
+ <QueryClientProvider client={queryClient}>
2796
+ {@render children()}
2797
+ </QueryClientProvider>
2798
+ `;
2799
+ const svelteKitQueryLayout = (providerImport)=>`<script lang="ts">
2800
+ import type { Snippet } from 'svelte'
2801
+ import QueryProvider from '${providerImport}'
2802
+
2803
+ let { children }: { children: Snippet } = $props()
2804
+ </script>
2805
+
2806
+ <QueryProvider>
2807
+ {@render children()}
2808
+ </QueryProvider>
2809
+ `;
2810
+ const connectSvelteKitProvider = (root, providerPath)=>{
2811
+ const layoutPath = external_node_path_default().posix.join(svelteKitRoutesFolder(root), '+layout.svelte');
2812
+ const layout = new file_system_File(external_node_path_default().join(root, layoutPath));
2813
+ if (!layout.exists) {
2814
+ const providerImport = external_node_path_default().posix.relative(external_node_path_default().posix.dirname(layoutPath), providerPath);
2815
+ layout.data = svelteKitQueryLayout(providerImport.startsWith('.') ? providerImport : `./${providerImport}`);
2816
+ return;
2817
+ }
2818
+ return layout.data.includes('QueryProvider') ? void 0 : `Wrap {@render children()} of ${layoutPath} in QueryProvider from ${providerPath}`;
2819
+ };
2083
2820
  const openapiOutputPath = (root)=>{
2084
2821
  const generator = new file_system_File(external_node_path_default().join(root, openapiScriptPath));
2085
2822
  if (!generator.exists) return;
@@ -2087,7 +2824,7 @@ const openapiOutputPath = (root)=>{
2087
2824
  };
2088
2825
  const addOrval = async ()=>{
2089
2826
  const { project: { rootFolder }, frontend } = config_file_ConfigFile.Instance.data;
2090
- const useReact = Boolean(frontend?.react);
2827
+ const framework = frontend?.svelte ? 'svelte' : frontend?.react ? 'react' : void 0;
2091
2828
  const root = new project_root_ProjectRoot().path;
2092
2829
  const manifestFile = new file_system_File(external_node_path_default().join(root, 'package.json'));
2093
2830
  const manifest = JSON.parse(manifestFile.data);
@@ -2095,20 +2832,22 @@ const addOrval = async ()=>{
2095
2832
  ...manifest.dependencies,
2096
2833
  ...manifest.devDependencies
2097
2834
  };
2098
- const withNext = usesNext();
2835
+ const withSvelteKit = usesSvelteKit();
2836
+ const baseUrl = 'svelte' === framework ? 'svelte' : usesNext() ? 'next' : void 0;
2837
+ const hooksFramework = framework ?? 'react';
2099
2838
  const generatedOpenapiPath = openapiOutputPath(root);
2100
2839
  const openapiPath = await interaction_input({
2101
2840
  key: 'openapiPath',
2102
2841
  message: 'OpenAPI document path:',
2103
- default: generatedOpenapiPath ?? defaultOpenapiPath(withNext),
2842
+ default: generatedOpenapiPath ?? defaultOpenapiPath(),
2104
2843
  validate: (value)=>value.trim() ? true : 'Path is required'
2105
2844
  });
2106
- const targets = useReact ? await interaction_checkbox({
2845
+ const targets = framework ? await interaction_checkbox({
2107
2846
  key: 'targets',
2108
2847
  message: 'Generate:',
2109
2848
  choices: [
2110
2849
  {
2111
- name: 'React Query hooks',
2850
+ name: 'svelte' === framework ? 'Svelte Query hooks' : 'React Query hooks',
2112
2851
  value: 'hooks',
2113
2852
  checked: true
2114
2853
  },
@@ -2121,16 +2860,23 @@ const addOrval = async ()=>{
2121
2860
  }) : [
2122
2861
  'client'
2123
2862
  ];
2124
- const selected = await addPackageScripts(manifestFile, orvalScripts(rootFolder, targets));
2863
+ const selected = await addPackageScripts(manifestFile, orvalScripts(rootFolder, targets, hooksFramework));
2864
+ const layer = (target)=>dataLayerFolder(rootFolder, target, hooksFramework);
2865
+ const providerFile = 'svelte' === hooksFramework ? 'query-provider.svelte' : 'query-provider.tsx';
2866
+ const providerContent = 'svelte' === hooksFramework ? svelteQueryProvider(withSvelteKit) : queryProvider;
2125
2867
  const document = external_node_path_default().posix.normalize(openapiPath.trim().replaceAll('\\', '/'));
2126
2868
  const withClient = targets.includes('client');
2127
2869
  for (const target of targets){
2128
- const dataLayer = dataLayerFolder(rootFolder, target);
2870
+ const dataLayer = layer(target);
2129
2871
  const sharedMutator = 'hooks' === target && withClient;
2130
- const mutatorPath = sharedMutator ? `${external_node_path_default().posix.relative(dataLayer, dataLayerFolder(rootFolder, 'client'))}/api-client/mutator.ts` : void 0;
2872
+ const mutatorPath = sharedMutator ? `${external_node_path_default().posix.relative(dataLayer, layer('client'))}/api-client/mutator.ts` : void 0;
2131
2873
  const configFile = new file_system_File(external_node_path_default().join(root, dataLayer, 'orval.config.ts'));
2132
- const content = orvalConfig(rootFolder, document, withNext, target, mutatorPath);
2874
+ const content = orvalConfig(rootFolder, document, baseUrl, target, mutatorPath, hooksFramework);
2133
2875
  if (!configFile.exists || configFile.data !== content) configFile.data = content;
2876
+ if ('hooks' === target && 'svelte' === hooksFramework) {
2877
+ const versions = new file_system_File(external_node_path_default().join(root, dataLayer, svelteQueryPackageJsonFile));
2878
+ if (!versions.exists || versions.data !== svelteQueryPackageJson) versions.data = svelteQueryPackageJson;
2879
+ }
2134
2880
  for (const [name, fileContent] of [
2135
2881
  ...sharedMutator ? [] : [
2136
2882
  [
@@ -2140,8 +2886,8 @@ const addOrval = async ()=>{
2140
2886
  ],
2141
2887
  ...'hooks' === target ? [
2142
2888
  [
2143
- 'query-provider.tsx',
2144
- queryProvider
2889
+ providerFile,
2890
+ providerContent
2145
2891
  ]
2146
2892
  ] : []
2147
2893
  ]){
@@ -2150,10 +2896,14 @@ const addOrval = async ()=>{
2150
2896
  }
2151
2897
  addGitignoreEntry(root, `/${dataLayer}/orval/`);
2152
2898
  }
2153
- const generated = targets.map((target)=>'hooks' === target ? `React Query hooks in ${dataLayerFolder(rootFolder, 'hooks')}/orval` : `a typed API client in ${dataLayerFolder(rootFolder, 'client')}/orval`);
2899
+ const withHooks = targets.includes('hooks');
2900
+ const providerPath = `${layer('hooks')}/${providerFile}`;
2901
+ const layoutNote = withHooks && 'svelte' === hooksFramework && withSvelteKit ? connectSvelteKitProvider(root, providerPath) : void 0;
2902
+ const queryPackage = 'svelte' === hooksFramework ? '@tanstack/svelte-query' : '@tanstack/react-query';
2903
+ const generated = targets.map((target)=>'hooks' === target ? `${'svelte' === hooksFramework ? 'Svelte' : 'React'} Query hooks in ${layer('hooks')}/orval` : `a typed API client in ${layer('client')}/orval`);
2154
2904
  const missing = (names)=>names.filter((name)=>!dependencies[name]);
2155
- const runtime = missing(targets.includes('hooks') ? [
2156
- '@tanstack/react-query'
2905
+ const runtime = missing(withHooks ? [
2906
+ queryPackage
2157
2907
  ] : []);
2158
2908
  const development = missing([
2159
2909
  'orval'
@@ -2168,8 +2918,11 @@ const addOrval = async ()=>{
2168
2918
  ...describeScripts(selected, {
2169
2919
  'client:orval': `generate ${generated.join(' and ')} from ${openapiPath.trim()}`
2170
2920
  }),
2171
- ...targets.includes('hooks') ? [
2172
- `Wrap your app in QueryProvider from ${dataLayerFolder(rootFolder, 'hooks')}/query-provider.tsx`
2921
+ ...withHooks && !('svelte' === hooksFramework && withSvelteKit) ? [
2922
+ `Wrap your app in QueryProvider from ${providerPath}`
2923
+ ] : [],
2924
+ ...layoutNote ? [
2925
+ layoutNote
2173
2926
  ] : [],
2174
2927
  ...generatedOpenapiPath ? [] : [
2175
2928
  'npx df-integration → OpenAPI generates the OpenAPI document the client is built from'
@@ -2409,6 +3162,22 @@ const addPrisma = async ()=>{
2409
3162
  })
2410
3163
  ];
2411
3164
  };
3165
+ const rest_adapters_restAdapters = {
3166
+ next: {
3167
+ package: '@domain-first/handlers-next',
3168
+ adapter: 'nextAdapter',
3169
+ endpoints: 'nextEndpoints',
3170
+ key: 'nextAdapter',
3171
+ routePath: (root)=>external_node_path_default().posix.join(nextAppFolder(root), 'api/[...path]/route.ts')
3172
+ },
3173
+ svelte: {
3174
+ package: '@domain-first/handlers-svelte',
3175
+ adapter: 'svelteAdapter',
3176
+ endpoints: 'svelteEndpoints',
3177
+ key: 'svelteAdapter',
3178
+ routePath: (root)=>external_node_path_default().posix.join(svelteKitRoutesFolder(root), 'api/[...path]/+server.ts')
3179
+ }
3180
+ };
2412
3181
  const kindTitles = {
2413
3182
  repositories: 'Repositories',
2414
3183
  'domain-services': 'Domain services',
@@ -2603,15 +3372,16 @@ const scaffoldNewPresentationService = async (boundedContextFolder)=>{
2603
3372
  if (wireFile) await wireNewModuleDependencies(boundedContextFolder, wireFile);
2604
3373
  };
2605
3374
  const rest_endpoint_generator_name = 'rest-endpoint-generator';
2606
- const scaffoldRestEndpointGenerator = (sharedFolder, { withNextAdapter = false } = {})=>createPresentationService(sharedFolder, rest_endpoint_generator_name, (className)=>{
2607
- const adapter = withNextAdapter ? 'nextAdapter' : 'adapter';
3375
+ const scaffoldRestEndpointGenerator = (sharedFolder, { adapter: framework } = {})=>createPresentationService(sharedFolder, rest_endpoint_generator_name, (className)=>{
3376
+ const known = framework && rest_adapters_restAdapters[framework];
3377
+ const adapter = known ? known.adapter : 'adapter';
2608
3378
  return `
2609
3379
  import {
2610
- ${withNextAdapter ? '' : ' type Adapter,\n'} type EndpointGenerator,
3380
+ ${known ? '' : ' type Adapter,\n'} type EndpointGenerator,
2611
3381
  createEndpoint,
2612
3382
  invalidRequest
2613
3383
  } from '@domain-first/handlers-rest'
2614
- ${withNextAdapter ? "import { nextAdapter } from '@domain-first/handlers-next'" : `
3384
+ ${known ? `import { ${known.adapter} } from '${known.package}'` : `
2615
3385
  /**
2616
3386
  * The adapter of your HTTP framework.
2617
3387
  */
@@ -2636,16 +3406,17 @@ const findRestEndpointGenerator = (sharedFolder)=>{
2636
3406
  wireFile: external_node_path_default().join(sharedFolder.path, 'wiring', 'presentation-services', `wire-${rest_endpoint_generator_name}-presentation-service.ts`)
2637
3407
  };
2638
3408
  };
2639
- const nextRoutePath = (root)=>external_node_path_default().posix.join(nextAppFolder(root), 'api/[...path]/route.ts');
2640
- const nextRoute = (restHandlersImport)=>`
2641
- import { nextEndpoints } from '@domain-first/handlers-next'
3409
+ const catchAllRoute = (adapter, restHandlersImport)=>{
3410
+ const { endpoints, package: packageName } = rest_adapters_restAdapters[adapter];
3411
+ return `
3412
+ import { ${endpoints} } from '${packageName}'
2642
3413
  ${restHandlersImport ? `import { restHandlers } from '${restHandlersImport}'
2643
3414
 
2644
- const handler = nextEndpoints(restHandlers)` : `
3415
+ const handler = ${endpoints}(restHandlers)` : `
2645
3416
  /**
2646
3417
  * Pass the endpoints' handle here; their paths are relative to this route's folder.
2647
3418
  */
2648
- const handler = nextEndpoints([])`}
3419
+ const handler = ${endpoints}([])`}
2649
3420
 
2650
3421
  export const GET = handler
2651
3422
  export const POST = handler
@@ -2653,14 +3424,15 @@ export const PUT = handler
2653
3424
  export const PATCH = handler
2654
3425
  export const DELETE = handler
2655
3426
  `.trim();
2656
- const rest_endpoint_generator_scaffoldNextRoute = (root)=>{
3427
+ };
3428
+ const scaffoldCatchAllRoute = (root, adapter)=>{
2657
3429
  const { rootFolder } = config_file_ConfigFile.Instance.data.project;
2658
3430
  const { domainFirstPackages } = config_file_ConfigFile.backend;
2659
- const routePath = nextRoutePath(root);
3431
+ const routePath = rest_adapters_restAdapters[adapter].routePath(root);
2660
3432
  const routeFile = external_node_path_default().join(root, routePath);
2661
3433
  if (new file_system_File(routeFile).exists) return [];
2662
3434
  if (!domainFirstPackages.includes('@domain-first/wire')) {
2663
- new file_system_File(routeFile).data = nextRoute(void 0);
3435
+ new file_system_File(routeFile).data = catchAllRoute(adapter, void 0);
2664
3436
  return [];
2665
3437
  }
2666
3438
  const restFolder = new file_system_Folder(root).subitem([
@@ -2668,16 +3440,21 @@ const rest_endpoint_generator_scaffoldNextRoute = (root)=>{
2668
3440
  'presentation',
2669
3441
  'rest'
2670
3442
  ]);
2671
- new file_system_File(routeFile).data = nextRoute(relativeImport(routeFile, restFolder.path));
3443
+ new file_system_File(routeFile).data = catchAllRoute(adapter, relativeImport(routeFile, restFolder.path));
2672
3444
  return new file_system_File(external_node_path_default().join(restFolder.path, 'index.ts')).exists ? [] : [
2673
3445
  `${routePath} serves restHandlers from ${external_node_path_default().posix.join(rootFolder.replaceAll('\\', '/'), 'presentation/rest/index.ts')}, which appears with the first REST endpoint — generate one with df-scaffold (Presentation → New Handlers-REST Endpoint) and the route compiles`
2674
3446
  ];
2675
3447
  };
2676
- const rest_endpoint_generator_askNextAdapter = async ({ nextSelected } = {})=>(nextSelected ?? usesNext()) && await interaction_confirm({
2677
- key: 'nextAdapter',
2678
- message: 'Use @domain-first/handlers-next for REST endpoints'
2679
- });
2680
- const rest_endpoint_generator_scaffoldRestEndpointGeneratorFiles = ({ withNextAdapter })=>{
3448
+ const frameworkRestAdapter = ()=>usesNext() ? 'next' : usesSvelteKit() ? 'svelte' : void 0;
3449
+ const rest_endpoint_generator_askRestAdapter = async ({ adapter = frameworkRestAdapter() } = {})=>{
3450
+ if (!adapter) return;
3451
+ const { key, package: packageName } = rest_adapters_restAdapters[adapter];
3452
+ return await interaction_confirm({
3453
+ key,
3454
+ message: `Use ${packageName} for REST endpoints`
3455
+ }) ? adapter : void 0;
3456
+ };
3457
+ const rest_endpoint_generator_scaffoldRestEndpointGeneratorFiles = ({ adapter })=>{
2681
3458
  const root = new project_root_ProjectRoot().path;
2682
3459
  const generatorExisted = restEndpointGeneratorApplied();
2683
3460
  const routeNotes = file_system_withoutOverwrites(()=>{
@@ -2685,40 +3462,64 @@ const rest_endpoint_generator_scaffoldRestEndpointGeneratorFiles = ({ withNextAd
2685
3462
  config_file_ConfigFile.Instance.data.project.rootFolder,
2686
3463
  'shared-kernel'
2687
3464
  ]), {
2688
- withNextAdapter
3465
+ adapter
2689
3466
  });
2690
- return withNextAdapter ? rest_endpoint_generator_scaffoldNextRoute(root) : [];
3467
+ return adapter ? scaffoldCatchAllRoute(root, adapter) : [];
2691
3468
  });
2692
- if (!withNextAdapter) return [];
3469
+ if (!adapter) return [];
3470
+ const { adapter: adapterName, package: packageName } = rest_adapters_restAdapters[adapter];
2693
3471
  return [
2694
3472
  ...missing_domain_first_packages_missingPackages([
2695
- '@domain-first/handlers-next'
3473
+ packageName
2696
3474
  ]),
2697
3475
  ...routeNotes,
2698
3476
  ...generatorExisted ? [
2699
- 'the existing endpoint generator was kept — pass nextAdapter from @domain-first/handlers-next to its createEndpoint calls'
3477
+ `the existing endpoint generator was kept — pass ${adapterName} from ${packageName} to its createEndpoint calls`
2700
3478
  ] : []
2701
3479
  ];
2702
3480
  };
2703
3481
  const addRestEndpointGenerator = async ()=>rest_endpoint_generator_scaffoldRestEndpointGeneratorFiles({
2704
- withNextAdapter: await rest_endpoint_generator_askNextAdapter()
3482
+ adapter: await rest_endpoint_generator_askRestAdapter()
2705
3483
  });
2706
3484
  const restEndpointGeneratorApplied = ()=>Boolean(findRestEndpointGenerator(new file_system_Folder(new project_root_ProjectRoot().path).subitem([
2707
3485
  config_file_ConfigFile.Instance.data.project.rootFolder,
2708
3486
  'shared-kernel'
2709
3487
  ])));
2710
- const storybook_storybookFrameworkPackage = '@storybook/react-vite';
2711
- const storybookFiles = (relativeProjectRoot)=>({
3488
+ const storybookFrameworkPackage = '@storybook/react-vite';
3489
+ const svelteStorybookPackages = {
3490
+ svelte: '@storybook/svelte-vite',
3491
+ sveltekit: '@storybook/sveltekit'
3492
+ };
3493
+ const storybookFamily = ()=>config_file_ConfigFile.Instance.data.frontend?.svelte ? 'svelte' : 'react';
3494
+ const storybookTitle = ()=>config_file_ConfigFile.exists && config_file_ConfigFile.Instance.data.frontend?.svelte ? 'sveltekit' === config_file_ConfigFile.Instance.data.frontend.svelte.framework ? 'Storybook (SvelteKit)' : 'Storybook (Svelte + Vite)' : 'Storybook (React + Vite)';
3495
+ const storybookFolder = ()=>`presentation/${storybookFamily()}/.storybook`;
3496
+ const storybookPreview = (frameworkPackage)=>`import type { Preview } from '${frameworkPackage}';
3497
+
3498
+ const preview: Preview = {
3499
+ parameters: {
3500
+ controls: {
3501
+ matchers: {
3502
+ color: /(background|color)$/i,
3503
+ date: /Date$/i
3504
+ }
3505
+ }
3506
+ }
3507
+ };
3508
+
3509
+ export default preview;
3510
+ `;
3511
+ const svelteStorybookFiles = (relativeProjectRoot, frameworkPackage)=>{
3512
+ const withPlugin = frameworkPackage === svelteStorybookPackages.svelte;
3513
+ return {
2712
3514
  'main.ts': `import { resolve } from 'node:path';
2713
- import react from '@vitejs/plugin-react';
2714
- import type { StorybookConfig } from '${storybook_storybookFrameworkPackage}';
3515
+ import type { StorybookConfig } from '${frameworkPackage}';
2715
3516
 
2716
3517
  const projectRoot = resolve(import.meta.dirname, ${JSON.stringify(relativeProjectRoot)});
2717
3518
 
2718
3519
  const config: StorybookConfig = {
2719
- stories: ['../**/*.mdx', '../**/*.stories.@(ts|tsx)'],
3520
+ stories: ['../**/*.mdx', '../**/*.stories.@(ts|svelte)'],
2720
3521
  framework: {
2721
- name: '${storybook_storybookFrameworkPackage}',
3522
+ name: '${frameworkPackage}',
2722
3523
  options: {}
2723
3524
  },
2724
3525
  core: {
@@ -2726,9 +3527,20 @@ const config: StorybookConfig = {
2726
3527
  },
2727
3528
  async viteFinal(viteConfig) {
2728
3529
  const { mergeConfig } = await import('vite');
3530
+ ${withPlugin ? ` const { svelte } = await import('@sveltejs/vite-plugin-svelte');
3531
+ const hasSvelte = (viteConfig.plugins ?? [])
3532
+ .flat(Infinity)
3533
+ .some(
3534
+ (plugin) =>
3535
+ !!plugin &&
3536
+ typeof plugin === 'object' &&
3537
+ 'name' in plugin &&
3538
+ String(plugin.name).startsWith('vite-plugin-svelte')
3539
+ );
2729
3540
 
2730
3541
  return mergeConfig(viteConfig, {
2731
- plugins: [react()],
3542
+ plugins: hasSvelte ? [] : [svelte()],` : `
3543
+ return mergeConfig(viteConfig, {`}
2732
3544
  resolve: {
2733
3545
  alias: {
2734
3546
  '@': projectRoot
@@ -2740,36 +3552,118 @@ const config: StorybookConfig = {
2740
3552
 
2741
3553
  export default config;
2742
3554
  `,
2743
- 'preview.ts': `import type { Preview } from '${storybook_storybookFrameworkPackage}';
3555
+ 'preview.ts': storybookPreview(frameworkPackage)
3556
+ };
3557
+ };
3558
+ const storybookFiles = (relativeProjectRoot)=>({
3559
+ 'main.ts': `import { resolve } from 'node:path';
3560
+ import react from '@vitejs/plugin-react';
3561
+ import type { StorybookConfig } from '${storybookFrameworkPackage}';
2744
3562
 
2745
- const preview: Preview = {
2746
- parameters: {
2747
- controls: {
2748
- matchers: {
2749
- color: /(background|color)$/i,
2750
- date: /Date$/i
3563
+ const projectRoot = resolve(import.meta.dirname, ${JSON.stringify(relativeProjectRoot)});
3564
+
3565
+ const config: StorybookConfig = {
3566
+ stories: ['../**/*.mdx', '../**/*.stories.@(ts|tsx)'],
3567
+ framework: {
3568
+ name: '${storybookFrameworkPackage}',
3569
+ options: {}
3570
+ },
3571
+ core: {
3572
+ disableTelemetry: true
3573
+ },
3574
+ async viteFinal(viteConfig) {
3575
+ const { mergeConfig } = await import('vite');
3576
+
3577
+ return mergeConfig(viteConfig, {
3578
+ plugins: [react()],
3579
+ resolve: {
3580
+ alias: {
3581
+ '@': projectRoot
3582
+ }
2751
3583
  }
2752
- }
3584
+ });
2753
3585
  }
2754
3586
  };
2755
3587
 
2756
- export default preview;
2757
- `
3588
+ export default config;
3589
+ `,
3590
+ 'preview.ts': storybookPreview(storybookFrameworkPackage)
2758
3591
  });
2759
- const storybookScripts = (rootFolder)=>{
2760
- const folder = external_node_path_default().posix.join(rootFolder.replaceAll('\\', '/'), 'presentation/react');
3592
+ const storybookScripts = (rootFolder, family = 'react')=>{
3593
+ const folder = external_node_path_default().posix.join(rootFolder.replaceAll('\\', '/'), `presentation/${family}`);
2761
3594
  const quote = (value)=>JSON.stringify(value);
2762
3595
  return {
2763
3596
  storybook: `storybook dev -p 6006 -c ${quote(`${folder}/.storybook`)}`,
2764
3597
  'build-storybook': `storybook build -c ${quote(`${folder}/.storybook`)} -o ${quote(`${folder}/storybook-static`)}`
2765
3598
  };
2766
3599
  };
3600
+ const addSvelteStorybook = async ()=>{
3601
+ const config = config_file_ConfigFile.Instance.data;
3602
+ const svelte = config.frontend?.svelte ?? {};
3603
+ const frameworkPackage = svelteStorybookPackages['sveltekit' === svelte.framework ? 'sveltekit' : 'svelte'];
3604
+ const root = new project_root_ProjectRoot().path;
3605
+ const manifestFile = new file_system_File(external_node_path_default().join(root, 'package.json'));
3606
+ const manifest = JSON.parse(manifestFile.data);
3607
+ const selected = await addPackageScripts(manifestFile, storybookScripts(config.project.rootFolder, 'svelte'));
3608
+ const folder = new file_system_Folder(root).subitem([
3609
+ config.project.rootFolder,
3610
+ 'presentation',
3611
+ 'svelte',
3612
+ '.storybook'
3613
+ ]);
3614
+ for (const [name, content] of Object.entries(svelteStorybookFiles(external_node_path_default().relative(folder.path, root).split(external_node_path_default().sep).join('/'), frameworkPackage))){
3615
+ const file = new file_system_File(external_node_path_default().join(folder.path, name));
3616
+ if (!file.exists || file.data !== content) file.data = content;
3617
+ }
3618
+ if (svelte.storybookFramework !== frameworkPackage) config_file_ConfigFile.update({
3619
+ frontend: {
3620
+ ...config.frontend,
3621
+ svelte: {
3622
+ ...svelte,
3623
+ storybookFramework: frameworkPackage
3624
+ }
3625
+ }
3626
+ });
3627
+ const buildFolder = external_node_path_default().posix.join(config.project.rootFolder.replaceAll('\\', '/'), 'presentation/svelte/storybook-static');
3628
+ addGitignoreEntry(root, `/${buildFolder}/`);
3629
+ const dependencies = {
3630
+ ...manifest.dependencies,
3631
+ ...manifest.devDependencies
3632
+ };
3633
+ const missing = [
3634
+ 'storybook',
3635
+ frameworkPackage,
3636
+ 'vite',
3637
+ ...frameworkPackage === svelteStorybookPackages.svelte ? [
3638
+ '@sveltejs/vite-plugin-svelte'
3639
+ ] : []
3640
+ ].filter((name)=>!dependencies[name]);
3641
+ const missingSvelte = ('sveltekit' === svelte.framework ? [
3642
+ '@sveltejs/kit',
3643
+ 'svelte'
3644
+ ] : [
3645
+ 'svelte'
3646
+ ]).filter((name)=>!dependencies[name]);
3647
+ return [
3648
+ ...missing.length ? [
3649
+ `npm install --save-dev ${missing.join(' ')}`
3650
+ ] : [],
3651
+ ...missingSvelte.length ? [
3652
+ `npm install ${missingSvelte.join(' ')}`
3653
+ ] : [],
3654
+ ...describeScripts(selected, {
3655
+ storybook: 'start Storybook on http://localhost:6006',
3656
+ 'build-storybook': `build static Storybook into ${buildFolder}`
3657
+ })
3658
+ ];
3659
+ };
2767
3660
  const storybook_addStorybook = async ()=>{
2768
3661
  const config = config_file_ConfigFile.Instance.data;
2769
- if ((!config.frontend?.react || config.frontend?.react?.storybookFramework && config.frontend?.react?.storybookFramework !== storybook_storybookFrameworkPackage) && !await interaction_confirm({
3662
+ if (config.frontend?.svelte) return addSvelteStorybook();
3663
+ if ((!config.frontend?.react || config.frontend?.react?.storybookFramework && config.frontend?.react?.storybookFramework !== storybookFrameworkPackage) && !await interaction_confirm({
2770
3664
  key: 'configureReact',
2771
3665
  requestRequired: true,
2772
- message: `Configure React scaffolding with ${storybook_storybookFrameworkPackage}?`,
3666
+ message: `Configure React scaffolding with ${storybookFrameworkPackage}?`,
2773
3667
  default: false
2774
3668
  })) return [];
2775
3669
  const root = new project_root_ProjectRoot().path;
@@ -2786,12 +3680,12 @@ const storybook_addStorybook = async ()=>{
2786
3680
  const file = new file_system_File(external_node_path_default().join(folder.path, name));
2787
3681
  if (!file.exists || file.data !== content) file.data = content;
2788
3682
  }
2789
- if (!config.frontend?.react || config.frontend?.react?.storybookFramework !== storybook_storybookFrameworkPackage) config_file_ConfigFile.update({
3683
+ if (!config.frontend?.react || config.frontend?.react?.storybookFramework !== storybookFrameworkPackage) config_file_ConfigFile.update({
2790
3684
  frontend: {
2791
3685
  ...config.frontend,
2792
3686
  react: {
2793
3687
  ...config.frontend?.react,
2794
- storybookFramework: storybook_storybookFrameworkPackage
3688
+ storybookFramework: storybookFrameworkPackage
2795
3689
  }
2796
3690
  }
2797
3691
  });
@@ -2803,7 +3697,7 @@ const storybook_addStorybook = async ()=>{
2803
3697
  };
2804
3698
  const missing = [
2805
3699
  'storybook',
2806
- storybook_storybookFrameworkPackage,
3700
+ storybookFrameworkPackage,
2807
3701
  'vite',
2808
3702
  '@vitejs/plugin-react'
2809
3703
  ].filter((name)=>!dependencies[name]);
@@ -2814,156 +3708,15 @@ const storybook_addStorybook = async ()=>{
2814
3708
  return [
2815
3709
  ...missing.length ? [
2816
3710
  `npm install --save-dev ${missing.join(' ')}`
2817
- ] : [],
2818
- ...missingReact.length ? [
2819
- `npm install ${missingReact.join(' ')}`
2820
- ] : [],
2821
- ...describeScripts(selected, {
2822
- storybook: 'start Storybook on http://localhost:6006',
2823
- 'build-storybook': `build static Storybook into ${buildFolder}`
2824
- })
2825
- ];
2826
- };
2827
- const ignoredFolders = new Set([
2828
- 'node_modules',
2829
- '.git',
2830
- '.next',
2831
- 'dist',
2832
- 'build',
2833
- 'out',
2834
- 'coverage',
2835
- 'storybook-static'
2836
- ]);
2837
- const codeExtension = /\.(?:tsx?|mts|cts|jsx?|mjs|cjs|mdx)$/;
2838
- const escapeRegExp = (value)=>value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
2839
- const module_move_walk = (folder)=>{
2840
- if (!external_node_fs_default().existsSync(folder)) return [];
2841
- return external_node_fs_default().readdirSync(folder, {
2842
- withFileTypes: true
2843
- }).flatMap((entry)=>{
2844
- const entryPath = external_node_path_default().join(folder, entry.name);
2845
- if (entry.isDirectory()) return ignoredFolders.has(entry.name) ? [] : module_move_walk(entryPath);
2846
- return entry.isFile() ? [
2847
- entryPath
2848
- ] : [];
2849
- });
2850
- };
2851
- const toPosix = (value)=>value.split(external_node_path_default().sep).join('/');
2852
- const readAliases = (projectRoot)=>{
2853
- const tsconfig = external_node_path_default().join(projectRoot, 'tsconfig.json');
2854
- if (!external_node_fs_default().existsSync(tsconfig)) return [];
2855
- try {
2856
- const { compilerOptions = {} } = JSON.parse(stripJsonComments(external_node_fs_default().readFileSync(tsconfig, 'utf8')));
2857
- const base = external_node_path_default().resolve(projectRoot, compilerOptions.baseUrl ?? '.');
2858
- return Object.entries(compilerOptions.paths ?? {}).filter(([pattern, targets])=>pattern.endsWith('*') && targets[0]?.endsWith('*')).map(([pattern, [target]])=>({
2859
- prefix: pattern.slice(0, -1),
2860
- target: external_node_path_default().resolve(base, target.slice(0, -1))
2861
- }));
2862
- } catch {
2863
- return [];
2864
- }
2865
- };
2866
- const specifierPattern = /(\bfrom\s*|\bimport\s*\(\s*|\bimport\s+|\brequire\s*\(\s*|\bmock\s*\(\s*)(['"])([^'"\n]+)\2/g;
2867
- const reExportPattern = /\bexport\s+(?:type\s+)?(?:\*(?:\s+as\s+[\w$]+)?|\{[^}]*\})\s*from\s*(['"])([^'"\n]+)\1/g;
2868
- const importPaths = (file)=>{
2869
- const withoutExtension = file.replace(codeExtension, '');
2870
- return 'index' === external_node_path_default().basename(withoutExtension) ? [
2871
- withoutExtension,
2872
- external_node_path_default().dirname(withoutExtension)
2873
- ] : [
2874
- withoutExtension
2875
- ];
2876
- };
2877
- const projectImports = (projectRoot)=>{
2878
- const aliases = readAliases(projectRoot);
2879
- const resolve = (specifier, fromFile)=>{
2880
- if (specifier.startsWith('.')) return {
2881
- resolved: external_node_path_default().resolve(external_node_path_default().dirname(fromFile), specifier),
2882
- alias: void 0
2883
- };
2884
- const alias = aliases.find(({ prefix })=>specifier.startsWith(prefix));
2885
- return alias ? {
2886
- resolved: external_node_path_default().resolve(alias.target, specifier.slice(alias.prefix.length)),
2887
- alias
2888
- } : void 0;
2889
- };
2890
- const specifierFor = (fromFile, toPath, alias)=>{
2891
- const aliased = alias && toPosix(external_node_path_default().relative(alias.target, toPath));
2892
- if (aliased && !aliased.startsWith('..')) return `${alias.prefix}${aliased}`;
2893
- const relative = toPosix(external_node_path_default().relative(external_node_path_default().dirname(fromFile), toPath));
2894
- return relative.startsWith('.') ? relative : `./${relative}`;
2895
- };
2896
- const codeFiles = new Map(module_move_walk(projectRoot).filter((file)=>codeExtension.test(file)).map((file)=>[
2897
- file,
2898
- external_node_fs_default().readFileSync(file, 'utf8')
2899
- ]));
2900
- const importsOf = (file)=>[
2901
- ...(codeFiles.get(file) ?? '').matchAll(specifierPattern)
2902
- ].map(([, , , specifier])=>resolve(specifier, file)?.resolved).filter((resolved)=>!!resolved);
2903
- return {
2904
- resolve,
2905
- specifierFor,
2906
- codeFiles,
2907
- importsOf
2908
- };
2909
- };
2910
- const stageModuleMove = ({ projectRoot, stopAt, moves, movedPath, rename, everyFile = (content)=>content, stopAtFor })=>{
2911
- const stopFor = (file)=>stopAtFor?.(file) ?? stopAt;
2912
- const { resolve, specifierFor, codeFiles } = projectImports(projectRoot);
2913
- const barrels = new Set();
2914
- const isBarrel = (resolved)=>barrels.has(resolved.replace(codeExtension, ''));
2915
- for(let found = true; found;){
2916
- found = false;
2917
- for (const [file, content] of codeFiles){
2918
- if (moves.has(file) || isBarrel(file)) continue;
2919
- const reExportsModule = [
2920
- ...content.matchAll(reExportPattern)
2921
- ].some(([, , specifier])=>{
2922
- const resolution = resolve(specifier, file);
2923
- return !!resolution && (!!movedPath(resolution.resolved) || isBarrel(resolution.resolved));
2924
- });
2925
- if (reExportsModule) {
2926
- for (const importPath of importPaths(file))barrels.add(importPath);
2927
- found = true;
2928
- }
2929
- }
2930
- }
2931
- const rewrite = (content, oldFile, newFile)=>{
2932
- let referencesModule = false;
2933
- const rewritten = content.replace(specifierPattern, (match, keyword, quote, specifier)=>{
2934
- const resolution = resolve(specifier, oldFile);
2935
- if (!resolution) return match;
2936
- const moved = movedPath(resolution.resolved);
2937
- if (moved || isBarrel(resolution.resolved)) referencesModule = true;
2938
- if (!moved && oldFile === newFile) return match;
2939
- const next = specifierFor(newFile, moved ?? resolution.resolved, resolution.alias);
2940
- return `${keyword}${quote}${next}${quote}`;
2941
- });
2942
- const changed = everyFile(rewritten);
2943
- if (!referencesModule && !moves.has(oldFile)) return changed;
2944
- return rename(changed, {
2945
- moved: moves.has(oldFile)
2946
- });
2947
- };
2948
- for (const [file, newFile] of moves)if (!codeFiles.has(file) && newFile !== file) new file_system_File(file).moveTo(newFile, stopFor(file));
2949
- const updated = [];
2950
- for (const [file, content] of codeFiles){
2951
- const newFile = moves.get(file);
2952
- const next = rewrite(content, file, newFile ?? file);
2953
- if (newFile && newFile !== file) {
2954
- new file_system_File(newFile).data = next;
2955
- new file_system_File(file).delete(stopFor(file));
2956
- } else if (next !== content) {
2957
- new file_system_File(file).update(next);
2958
- if (!newFile) updated.push(file);
2959
- }
2960
- }
2961
- return {
2962
- moves: [
2963
- ...moves
2964
- ].filter(([from, to])=>from !== to),
2965
- updated
2966
- };
3711
+ ] : [],
3712
+ ...missingReact.length ? [
3713
+ `npm install ${missingReact.join(' ')}`
3714
+ ] : [],
3715
+ ...describeScripts(selected, {
3716
+ storybook: 'start Storybook on http://localhost:6006',
3717
+ 'build-storybook': `build static Storybook into ${buildFolder}`
3718
+ })
3719
+ ];
2967
3720
  };
2968
3721
  const serviceLayout = (layer)=>({
2969
3722
  title: `${layer[0].toUpperCase()}${layer.slice(1)} services`,
@@ -3016,7 +3769,7 @@ const aggregateOwnFiles = (name)=>[
3016
3769
  `${name}-repository.spec.ts`,
3017
3770
  'index.ts'
3018
3771
  ];
3019
- const kindLayouts = {
3772
+ const backend_module_move_kindLayouts = {
3020
3773
  aggregate: {
3021
3774
  title: 'Aggregates',
3022
3775
  core: (ClassName)=>`${ClassName}Repository`,
@@ -3073,7 +3826,7 @@ const projectRootOf = (folder)=>{
3073
3826
  }
3074
3827
  };
3075
3828
  const integrationSpecFile = (unit, label)=>{
3076
- const layout = kindLayouts[unit.kind];
3829
+ const layout = backend_module_move_kindLayouts[unit.kind];
3077
3830
  const place = {
3078
3831
  ownerPath: unit.ownerPath,
3079
3832
  name: unit.name
@@ -3099,9 +3852,9 @@ const backend_module_move_subfolders = (folder)=>external_node_fs_default().exis
3099
3852
  }).filter((entry)=>entry.isDirectory()).map((entry)=>entry.name).sort() : [];
3100
3853
  const namesBySuffix = (folder, suffix)=>external_node_fs_default().existsSync(folder) ? external_node_fs_default().readdirSync(folder).filter((file)=>file.endsWith(suffix) && !file.endsWith('.spec.ts')).map((file)=>file.slice(0, -suffix.length)).sort() : [];
3101
3854
  const labelsOf = (ownerPath, kind, name)=>{
3102
- const { implementations } = kindLayouts[kind];
3855
+ const { implementations } = backend_module_move_kindLayouts[kind];
3103
3856
  if (!implementations) return [];
3104
- return backend_module_move_subfolders(external_node_path_default().join(ownerPath, implementations)).filter((label)=>kindLayouts[kind].files({
3857
+ return backend_module_move_subfolders(external_node_path_default().join(ownerPath, implementations)).filter((label)=>backend_module_move_kindLayouts[kind].files({
3105
3858
  ownerPath,
3106
3859
  name
3107
3860
  }, [
@@ -3139,7 +3892,7 @@ const findBackendUnits = (ownerPath)=>{
3139
3892
  const kebabName = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
3140
3893
  const lowerFirst = (value)=>value[0].toLowerCase() + value.slice(1);
3141
3894
  const unitMoves = (unit, target)=>{
3142
- const layout = kindLayouts[unit.kind];
3895
+ const layout = backend_module_move_kindLayouts[unit.kind];
3143
3896
  const from = layout.files(unit, unit.labels);
3144
3897
  const to = layout.files(target, unit.labels);
3145
3898
  const moves = new Map();
@@ -3166,7 +3919,7 @@ const unitMoves = (unit, target)=>{
3166
3919
  };
3167
3920
  const validateBackendMove = (unit, target, sharedKernelPath)=>{
3168
3921
  if (!kebabName.test(target.name)) return 'Use kebab-case: lowercase words split by "-", e.g. place-order';
3169
- if (target.ownerPath === sharedKernelPath && !kindLayouts[unit.kind].sharedKernel) return `${kindLayouts[unit.kind].title} are not part of the Shared Kernel`;
3922
+ if (target.ownerPath === sharedKernelPath && !backend_module_move_kindLayouts[unit.kind].sharedKernel) return `${backend_module_move_kindLayouts[unit.kind].title} are not part of the Shared Kernel`;
3170
3923
  if (target.ownerPath === unit.ownerPath && target.name === unit.name && target.aggregate === unit.aggregate) return 'Nothing to change: enter a new name or pick another place';
3171
3924
  for (const [from, to] of unitMoves(unit, target))if (to !== from && external_node_fs_default().existsSync(to)) return `${external_node_path_default().relative(target.ownerPath, to)} already exists`;
3172
3925
  return true;
@@ -3195,7 +3948,7 @@ const isolationAllows = (rootFolderPath, from, to)=>{
3195
3948
  return inside('domain/errors') || from.replace(codeExtension, '') === inMemoryDbFile(rootFolderPath).replace(codeExtension, '') && inside('domain');
3196
3949
  };
3197
3950
  const moveBackendUnit = (projectRoot, rootFolderPath, unit, target)=>{
3198
- const layout = kindLayouts[unit.kind];
3951
+ const layout = backend_module_move_kindLayouts[unit.kind];
3199
3952
  const moves = unitMoves(unit, target);
3200
3953
  const withoutExtension = new Map([
3201
3954
  ...moves
@@ -3340,7 +4093,7 @@ const projectRelative = (fromFile, toFile)=>{
3340
4093
  const relative = toPosix(external_node_path_default().relative(external_node_path_default().dirname(fromFile), toFile.replace(codeExtension, '')));
3341
4094
  return relative.startsWith('.') ? relative : `./${relative}`;
3342
4095
  };
3343
- const importSpecifier = /(?:\bfrom\s*|\bimport\s*\(\s*|\brequire\s*\(\s*|\bimport\s+)(['"])([^'"\n]+)\1/g;
4096
+ const backend_module_move_importSpecifier = /(?:\bfrom\s*|\bimport\s*\(\s*|\brequire\s*\(\s*|\bimport\s+)(['"])([^'"\n]+)\1/g;
3344
4097
  const backend_module_move_importLine = /^\s*(?:import|export)\b[^'"\n]*\bfrom\s*(['"])([^'"\n]+)\1;?\s*$/;
3345
4098
  const deleteBackendUnit = (projectRoot, rootFolderPath, unit)=>{
3346
4099
  const files = [
@@ -3382,7 +4135,7 @@ const deleteBackendUnit = (projectRoot, rootFolderPath, unit)=>{
3382
4135
  for (const [file, original] of codeFiles){
3383
4136
  if (fileSet.has(file)) continue;
3384
4137
  const content = cleaned.get(file) ?? original;
3385
- for (const [, , specifier] of content.matchAll(importSpecifier)){
4138
+ for (const [, , specifier] of content.matchAll(backend_module_move_importSpecifier)){
3386
4139
  const target = resolved(specifier, file);
3387
4140
  if (target && isUnit(target)) usedBy.push([
3388
4141
  relative(file),
@@ -3417,18 +4170,18 @@ const contractKinds = [
3417
4170
  ];
3418
4171
  const implementations_withWiring = ()=>config_file_ConfigFile.backend.domainFirstPackages.includes('@domain-first/wire');
3419
4172
  const withHandlers = ()=>config_file_ConfigFile.backend.domainFirstPackages.includes('@domain-first/handlers');
3420
- const contractFile = (unit)=>'aggregate' === unit.kind ? `domain/aggregates/${unit.name}/${unit.name}-repository.ts` : kindLayouts[unit.kind].files(unit, [])[0];
4173
+ const contractFile = (unit)=>'aggregate' === unit.kind ? `domain/aggregates/${unit.name}/${unit.name}-repository.ts` : backend_module_move_kindLayouts[unit.kind].files(unit, [])[0];
3421
4174
  const findContracts = (ownerPath)=>findBackendUnits(ownerPath).filter((unit)=>contractKinds.includes(unit.kind) && external_node_fs_default().existsSync(external_node_path_default().join(ownerPath, contractFile(unit))));
3422
4175
  const implementationWireName = (label)=>`wire${new UnknownFormatNaming(label).ClassName}Implementation`;
3423
- const contractClassName = (unit)=>kindLayouts[unit.kind].core(new UnknownFormatNaming(unit.name).ClassName);
4176
+ const contractClassName = (unit)=>backend_module_move_kindLayouts[unit.kind].core(new UnknownFormatNaming(unit.name).ClassName);
3424
4177
  const implementationClassName = (unit, label)=>`${new UnknownFormatNaming(label).ClassName}${contractClassName(unit)}`;
3425
4178
  const implementationFile = (unit, label)=>{
3426
- const { implementations } = kindLayouts[unit.kind];
3427
- return kindLayouts[unit.kind].files(unit, [
4179
+ const { implementations } = backend_module_move_kindLayouts[unit.kind];
4180
+ return backend_module_move_kindLayouts[unit.kind].files(unit, [
3428
4181
  label
3429
4182
  ]).find((file)=>file.startsWith(`${implementations}/`));
3430
4183
  };
3431
- const contractWireFile = (unit)=>kindLayouts[unit.kind].files(unit, []).find((file)=>file.startsWith('wiring/'));
4184
+ const contractWireFile = (unit)=>backend_module_move_kindLayouts[unit.kind].files(unit, []).find((file)=>file.startsWith('wiring/'));
3432
4185
  const handlerImplementation = (ContractName, ClassName, contractImport)=>withHandlers() ? `
3433
4186
  import { defineHandler } from '@domain-first/handlers'
3434
4187
  import { ${ContractName} } from '${contractImport}'
@@ -3594,7 +4347,7 @@ const scaffoldIntegrationSpec = (unit, label)=>{
3594
4347
  if (!specPath) return;
3595
4348
  const spec = new file_system_File(specPath);
3596
4349
  if (spec.exists) return;
3597
- const layout = kindLayouts[unit.kind];
4350
+ const layout = backend_module_move_kindLayouts[unit.kind];
3598
4351
  const naming = new UnknownFormatNaming(unit.name);
3599
4352
  const core = layout.core(naming.ClassName);
3600
4353
  const files = layout.files({
@@ -4109,10 +4862,10 @@ const integrationIds = [
4109
4862
  const integrations = [
4110
4863
  {
4111
4864
  id: 'storybook',
4112
- name: 'Storybook (React + Vite)',
4865
+ name: storybookTitle,
4113
4866
  group: 'frontend',
4114
4867
  run: storybook_addStorybook,
4115
- applied: ()=>createdInRoot('presentation/react/.storybook/main.ts')
4868
+ applied: ()=>createdInRoot(`${storybookFolder()}/main.ts`)
4116
4869
  },
4117
4870
  {
4118
4871
  id: 'rest-endpoint-generator',
@@ -4178,9 +4931,10 @@ const integrations = [
4178
4931
  group: 'frontend',
4179
4932
  run: addOrval,
4180
4933
  available: ()=>withHandlersRest(),
4181
- applied: ()=>createdInRoot('presentation/react/data-layer/orval.config.ts') || createdInRoot('presentation/data-layer/orval.config.ts')
4934
+ applied: ()=>createdInRoot('presentation/react/data-layer/orval.config.ts') || createdInRoot('presentation/svelte/data-layer/orval.config.ts') || createdInRoot('presentation/data-layer/orval.config.ts')
4182
4935
  }
4183
4936
  ];
4937
+ const nameOf = ({ name })=>'string' == typeof name ? name : name();
4184
4938
  const addIntegration = async ({ save = true } = {})=>{
4185
4939
  const available = integrations.filter(({ group, available })=>('backend' !== group || Boolean(config_file_ConfigFile.Instance.data.backend)) && (available?.() ?? true)).map((value)=>({
4186
4940
  value,
@@ -4194,7 +4948,7 @@ const addIntegration = async ({ save = true } = {})=>{
4194
4948
  return items.length ? [
4195
4949
  new prompts_namespaceObject.Separator(title),
4196
4950
  ...items.map(({ value })=>({
4197
- name: `${value.name} · ${value.group}`,
4951
+ name: `${nameOf(value)} · ${value.group}`,
4198
4952
  value
4199
4953
  }))
4200
4954
  ] : [];
@@ -4217,7 +4971,7 @@ const addIntegration = async ({ save = true } = {})=>{
4217
4971
  };
4218
4972
  const integrationDescriptions = ()=>integrations.map((integration)=>({
4219
4973
  id: integration.id,
4220
- name: integration.name,
4974
+ name: nameOf(integration),
4221
4975
  group: integration.group,
4222
4976
  available: ('backend' !== integration.group || Boolean(config_file_ConfigFile.Instance.data.backend)) && (integration.available?.() ?? true)
4223
4977
  }));
@@ -4323,421 +5077,137 @@ const scaffoldRequestSchema = external_zod_default().discriminatedUnion('operati
4323
5077
  ...agent_requests_owner,
4324
5078
  contract: agent_requests_id.describe('Exact contract ID from --describe.'),
4325
5079
  implementation: agent_requests_implementation,
4326
- environments: external_zod_default().array(agent_requests_name).min(1).optional().describe('Required when the contract wire is envBranchedWire; omit it otherwise.'),
4327
- ...agent_requests_wired
4328
- }),
4329
- agent_requests_operation('endpoint', {
4330
- ...common,
4331
- ...agent_requests_owner,
4332
- controller: agent_requests_name.optional().describe('Omit for the context-root controller (root): `/<context>/<path>`.'),
4333
- method: external_zod_default()["enum"]([
4334
- 'get',
4335
- 'post',
4336
- 'put',
4337
- 'patch',
4338
- 'delete'
4339
- ]),
4340
- path: external_zod_default().string().regex(/^(?:\/?(?:[a-zA-Z0-9_-]+|:[a-zA-Z][a-zA-Z0-9_]*))*\/?$/),
4341
- handler: agent_requests_id.optional().describe('Exact handler module ID from --describe. Required when the context has wired queries, commands or use cases; omit it otherwise.')
4342
- }),
4343
- agent_requests_operation('wire-dependency', {
4344
- ...common,
4345
- ...agent_requests_owner,
4346
- module: agent_requests_id.describe('Exact wiring target ID, including implementation class, from --describe.'),
4347
- dependencies: agent_requests_dependencies
4348
- }),
4349
- agent_requests_operation('delete', {
4350
- ...common,
4351
- ...agent_requests_owner,
4352
- module: agent_requests_id.describe('Exact unit ID from --describe. Refused while other files use it.')
4353
- }),
4354
- agent_requests_operation('move', {
4355
- ...common,
4356
- ...agent_requests_owner,
4357
- module: agent_requests_id.describe('Exact unit ID from --describe.'),
4358
- targetContext: agent_requests_nestedName.optional(),
4359
- name: agent_requests_name.optional(),
4360
- aggregate: agent_requests_name.optional()
4361
- })
4362
- ]);
4363
- const reactRequestSchema = external_zod_default().discriminatedUnion('operation', [
4364
- agent_requests_operation('page', {
4365
- ...common,
4366
- name: agent_requests_nestedName
4367
- }),
4368
- agent_requests_operation('widget', {
4369
- ...common,
4370
- name: agent_requests_nestedName,
4371
- widgetType: external_zod_default()["enum"]([
4372
- 'monolithic',
4373
- 'separated',
4374
- 'headless'
4375
- ]).optional()
4376
- }),
4377
- agent_requests_operation('ui-kit-component', {
4378
- ...common,
4379
- name: agent_requests_name
4380
- }),
4381
- agent_requests_operation('shared-hook', {
4382
- ...common,
4383
- name: agent_requests_name
4384
- }),
4385
- agent_requests_operation('move-page', {
4386
- ...common,
4387
- module: agent_requests_nestedName,
4388
- name: agent_requests_nestedName,
4389
- moveRoute: external_zod_default().boolean().optional().describe('With Next.js and a route at the page path: move it too (default true). Omit it without such a route.')
4390
- }),
4391
- agent_requests_operation('delete-page', {
4392
- ...common,
4393
- module: agent_requests_nestedName,
4394
- deleteRoute: external_zod_default().boolean().optional().describe("With Next.js and the page's own route: delete it too (default true). Omit it without such a route.")
4395
- }),
4396
- agent_requests_operation('delete-widget', {
4397
- ...common,
4398
- module: agent_requests_nestedName
4399
- }),
4400
- agent_requests_operation('move-ui-kit-component', {
4401
- ...common,
4402
- module: agent_requests_name,
4403
- name: agent_requests_name
4404
- }),
4405
- agent_requests_operation('move-shared-hook', {
4406
- ...common,
4407
- module: agent_requests_name,
4408
- name: agent_requests_name
4409
- }),
4410
- agent_requests_operation('delete-ui-kit-component', {
4411
- ...common,
4412
- module: agent_requests_name
4413
- }),
4414
- agent_requests_operation('delete-shared-hook', {
4415
- ...common,
4416
- module: agent_requests_name
4417
- }),
4418
- agent_requests_operation('move-widget', {
4419
- ...common,
4420
- module: agent_requests_nestedName,
4421
- name: agent_requests_nestedName
4422
- })
4423
- ]);
4424
- const agent_requests_relativePath = external_zod_default().string().regex(/^[a-zA-Z0-9_.-]+(?:\/[a-zA-Z0-9_.-]+)*$/).refine((value)=>!value.split('/').some((part)=>'.' === part || '..' === part), 'Use a project-relative path without . or .. segments.');
4425
- const integrationRequestSchema = agent_requests_operation('add', {
4426
- ...common,
4427
- integrations: external_zod_default().array(external_zod_default()["enum"](integrationIds)).min(1),
4428
- nextAdapter: external_zod_default().boolean().optional(),
4429
- configureReact: external_zod_default().boolean().optional(),
4430
- replaceTestingLibrary: external_zod_default().boolean().optional(),
4431
- integrationTestTypes: external_zod_default().array(agent_requests_name).optional().describe('testcontainers with wire: saved primary implementation types whose implementations get integration specs. Omitted: the configured list stays.'),
4432
- withService: external_zod_default().boolean().optional(),
4433
- routePrefix: external_zod_default().string().regex(/^\/?[a-zA-Z0-9_/-]*$/).optional(),
4434
- openapiPath: agent_requests_relativePath.optional(),
4435
- withExtractor: external_zod_default().boolean().optional(),
4436
- swaggerPage: external_zod_default().boolean().optional(),
4437
- targets: external_zod_default().array(external_zod_default()["enum"]([
4438
- 'hooks',
4439
- 'client'
4440
- ])).min(1).optional(),
4441
- scriptConflicts: external_zod_default().record(agent_requests_id, external_zod_default()["enum"]([
4442
- 'keep',
4443
- 'replace',
4444
- 'rename'
4445
- ])).optional(),
4446
- scriptNames: external_zod_default().record(agent_requests_id, external_zod_default().string().regex(/^[a-zA-Z0-9:_-]+$/)).optional()
4447
- });
4448
- const requestSchemaFor = (command)=>({
4449
- 'df-scaffold': scaffoldRequestSchema,
4450
- 'df-react': reactRequestSchema,
4451
- 'df-integration': integrationRequestSchema
4452
- })[command];
4453
- const reactKindLayouts = {
4454
- page: {
4455
- folder: 'pages',
4456
- nested: true,
4457
- inFolder: false,
4458
- ownFile: (fileBase)=>new RegExp(`^${escapeRegExp(fileBase)}-page(?:\\.|$)`),
4459
- target: (reactFolder, { folders, fileName })=>external_node_path_default().join(reactFolder, 'pages', ...folders, `${fileName}-page.tsx`),
4460
- classPrefix: '(use)?',
4461
- classSuffix: 'Page'
4462
- },
4463
- widget: {
4464
- folder: 'widgets',
4465
- nested: true,
4466
- inFolder: true,
4467
- target: (reactFolder, { folders, folderName })=>external_node_path_default().join(reactFolder, 'widgets', ...folders, folderName),
4468
- classPrefix: '(use)?',
4469
- classSuffix: 'Widget|UIModel',
4470
- storyTitle: (segments)=>[
4471
- 'Widgets',
4472
- ...segments
4473
- ].join('/')
4474
- },
4475
- 'ui-kit': {
4476
- folder: 'ui-kit',
4477
- nested: false,
4478
- inFolder: true,
4479
- target: (reactFolder, { fileName })=>external_node_path_default().join(reactFolder, 'ui-kit', fileName),
4480
- classPrefix: '()',
4481
- classSuffix: 'Props(?![\\w$])|(?![\\w$])',
4482
- storyTitle: (segments)=>`UI-kit/${segments.join('')}`
4483
- },
4484
- hook: {
4485
- folder: 'hooks',
4486
- nested: false,
4487
- inFolder: false,
4488
- ownFile: (fileBase)=>new RegExp(`^use-${escapeRegExp(fileBase)}(?:\\.|$)`),
4489
- target: (reactFolder, { fileName })=>external_node_path_default().join(reactFolder, 'hooks', `use-${fileName}.ts`),
4490
- classPrefix: '(use)',
4491
- classSuffix: '(?![\\w$])'
4492
- }
4493
- };
4494
- const reactKindTitles = {
4495
- page: [
4496
- 'Page',
4497
- 'pages'
4498
- ],
4499
- widget: [
4500
- 'Widget',
4501
- 'widgets'
4502
- ],
4503
- 'ui-kit': [
4504
- 'UI-kit component',
4505
- 'UI-kit components'
4506
- ],
4507
- hook: [
4508
- 'Shared hook',
4509
- 'shared hooks'
4510
- ]
4511
- };
4512
- const reactModuleName = (kind, rawName)=>'hook' === kind ? rawName.trim().replace(/^use-/, '') : rawName;
4513
- const react_module_move_nestedName = (folders, fileBase)=>{
4514
- const prefix = `${folders.join('-')}-`;
4515
- const last = folders.length && fileBase.startsWith(prefix) ? fileBase.slice(prefix.length) : fileBase;
4516
- return [
4517
- ...folders,
4518
- last
4519
- ].join('/');
4520
- };
4521
- const declaredClassName = (filePath, suffix, name)=>{
4522
- const content = external_node_fs_default().readFileSync(filePath, 'utf8');
4523
- const declared = content.match(new RegExp(`export\\s+(?:const|function)\\s+(\\w+)${suffix}\\b`))?.[1];
4524
- return declared ?? new NestedName(name).ClassName;
4525
- };
4526
- const findUiKit = (reactFolder)=>{
4527
- const root = external_node_path_default().join(reactFolder, 'ui-kit');
4528
- if (!external_node_fs_default().existsSync(root)) return [];
4529
- return external_node_fs_default().readdirSync(root, {
4530
- withFileTypes: true
4531
- }).filter((entry)=>entry.isDirectory() && external_node_fs_default().existsSync(external_node_path_default().join(root, entry.name, `${entry.name}.tsx`))).map(({ name })=>({
4532
- kind: 'ui-kit',
4533
- name,
4534
- path: external_node_path_default().join(root, name),
4535
- fileBase: name,
4536
- ClassName: declaredClassName(external_node_path_default().join(root, name, `${name}.tsx`), '', name)
4537
- }));
4538
- };
4539
- const findHooks = (reactFolder)=>{
4540
- const root = external_node_path_default().join(reactFolder, 'hooks');
4541
- if (!external_node_fs_default().existsSync(root)) return [];
4542
- return external_node_fs_default().readdirSync(root).filter((file)=>/^use-.+\.tsx?$/.test(file) && !/\.(spec|test)\./.test(file)).map((file)=>{
4543
- const name = file.replace(/^use-/, '').replace(/\.tsx?$/, '');
4544
- const content = external_node_fs_default().readFileSync(external_node_path_default().join(root, file), 'utf8');
4545
- return {
4546
- kind: 'hook',
4547
- name,
4548
- path: external_node_path_default().join(root, file),
4549
- fileBase: name,
4550
- ClassName: content.match(/export\s+(?:const|function)\s+use(\w+)\b/)?.[1] ?? new NestedName(name).ClassName
4551
- };
4552
- });
4553
- };
4554
- const findReactModules = (reactFolder, kind)=>{
4555
- const modules = 'ui-kit' === kind ? findUiKit(reactFolder) : 'hook' === kind ? findHooks(reactFolder) : 'page' === kind ? module_move_walk(external_node_path_default().join(reactFolder, 'pages')).filter((file)=>file.endsWith('-page.tsx')).map((file)=>{
4556
- const folders = external_node_path_default().relative(external_node_path_default().join(reactFolder, 'pages'), external_node_path_default().dirname(file)).split(external_node_path_default().sep).filter((segment)=>!!segment);
4557
- const fileBase = external_node_path_default().basename(file, '-page.tsx');
4558
- const name = react_module_move_nestedName(folders, fileBase);
4559
- return {
4560
- kind,
4561
- name,
4562
- path: file,
4563
- fileBase,
4564
- ClassName: declaredClassName(file, 'Page', name)
4565
- };
4566
- }) : module_move_walk(external_node_path_default().join(reactFolder, 'widgets')).filter((file)=>file.endsWith('-widget.tsx')).map((file)=>{
4567
- const folder = external_node_path_default().dirname(file);
4568
- const name = toPosix(external_node_path_default().relative(external_node_path_default().join(reactFolder, 'widgets'), folder));
4569
- return {
4570
- kind,
4571
- name,
4572
- path: folder,
4573
- fileBase: external_node_path_default().basename(file, '-widget.tsx'),
4574
- ClassName: declaredClassName(file, 'Widget', name)
4575
- };
4576
- });
4577
- return modules.sort((a, b)=>a.name.localeCompare(b.name));
4578
- };
4579
- const react_module_move_targetPath = (reactFolder, module, rawName)=>reactKindLayouts[module.kind].target(reactFolder, new NestedName(reactModuleName(module.kind, rawName)));
4580
- const validateMove = (reactFolder, module, rawName)=>{
4581
- const nameError = NestedName.validate(rawName);
4582
- if (true !== nameError) return nameError;
4583
- if (!reactKindLayouts[module.kind].nested && /[\\/]/.test(rawName)) return 'UI-kit components and shared hooks have no folders: enter a name without "/"';
4584
- const target = react_module_move_targetPath(reactFolder, module, rawName);
4585
- if (target !== module.path && external_node_fs_default().existsSync(target)) return `${external_node_path_default().relative(reactFolder, target)} already exists`;
4586
- if (target.startsWith(`${module.path}${external_node_path_default().sep}`)) return 'A widget cannot be moved into itself';
4587
- return true;
4588
- };
4589
- const react_module_move_routeFolder = (appFolder, rawName)=>{
4590
- const { folders, folderName } = new NestedName(rawName);
4591
- return external_node_path_default().join(appFolder, ...folders, folderName);
4592
- };
4593
- const routeFiles = (folder)=>external_node_fs_default().existsSync(folder) ? external_node_fs_default().readdirSync(folder, {
4594
- withFileTypes: true
4595
- }).filter((entry)=>entry.isFile()).map((entry)=>external_node_path_default().join(folder, entry.name)) : [];
4596
- const moveReactModule = (projectRoot, reactFolder, module, rawName, route)=>{
4597
- const layout = reactKindLayouts[module.kind];
4598
- const newName = new NestedName(reactModuleName(module.kind, rawName));
4599
- const target = react_module_move_targetPath(reactFolder, module, rawName);
4600
- const newClassName = newName.ClassName;
4601
- const renameFile = (name)=>name.replace(new RegExp(`^(use-)?${escapeRegExp(module.fileBase)}(?=[-.]|$)`), (_, use = '')=>`${use}${newName.fileName}`);
4602
- const oldFolder = layout.inFolder ? module.path : external_node_path_default().dirname(module.path);
4603
- const newFolder = layout.inFolder ? target : external_node_path_default().dirname(target);
4604
- const ownsPath = (candidate)=>layout.inFolder ? candidate === oldFolder || candidate.startsWith(`${oldFolder}${external_node_path_default().sep}`) : external_node_path_default().dirname(candidate) === oldFolder && layout.ownFile(module.fileBase).test(external_node_path_default().basename(candidate));
4605
- const routeFileSet = new Set(route ? routeFiles(route.from) : []);
4606
- const routeTarget = (candidate)=>{
4607
- if (!route) return;
4608
- const file = [
4609
- ...routeFileSet
4610
- ].find((x)=>x === candidate || x.replace(codeExtension, '') === candidate);
4611
- if (!file) return;
4612
- const moved = external_node_path_default().join(route.to, external_node_path_default().relative(route.from, file));
4613
- return file === candidate ? moved : moved.replace(codeExtension, '');
4614
- };
4615
- const movedPath = (candidate)=>{
4616
- const routed = routeTarget(candidate);
4617
- if (routed) return routed;
4618
- if (!ownsPath(candidate)) return;
4619
- const segments = external_node_path_default().relative(oldFolder, candidate).split(external_node_path_default().sep);
4620
- const last = segments.length - 1;
4621
- segments[last] = renameFile(segments[last]);
4622
- return external_node_path_default().join(newFolder, ...segments);
4623
- };
4624
- const moduleFiles = reactModuleFiles(module);
4625
- const moves = new Map([
4626
- ...moduleFiles,
4627
- ...routeFileSet
4628
- ].map((file)=>[
4629
- file,
4630
- movedPath(file) ?? file
4631
- ]));
4632
- const classPattern = new RegExp(`(?<![\\w$])${layout.classPrefix}${escapeRegExp(module.ClassName)}(?=${layout.classSuffix})`, 'g');
4633
- const oldTitle = layout.storyTitle?.('ui-kit' === module.kind ? [
4634
- module.ClassName
4635
- ] : module.name.split('/').map((segment)=>new NestedName(segment).ClassName));
4636
- const titlePattern = oldTitle && new RegExp(`(['"\`])${escapeRegExp(oldTitle)}\\1`, 'g');
4637
- const newTitle = layout.storyTitle?.('ui-kit' === module.kind ? [
4638
- newClassName
4639
- ] : newName.classNameSegments);
4640
- return stageModuleMove({
4641
- projectRoot,
4642
- stopAt: reactFolder,
4643
- stopAtFor: (file)=>route && routeFileSet.has(file) ? route.appFolder : void 0,
4644
- moves,
4645
- movedPath,
4646
- rename: (content, { moved })=>{
4647
- const renamed = content.replace(classPattern, (_, use)=>`${use ?? ''}${newClassName}`);
4648
- return moved && titlePattern ? renamed.replace(titlePattern, (_, quote)=>`${quote}${newTitle}${quote}`) : renamed;
4649
- }
4650
- });
4651
- };
4652
- const pageRouteFolder = (appFolder, page)=>{
4653
- const folder = react_module_move_routeFolder(appFolder, page.name);
4654
- const routePage = external_node_path_default().join(folder, 'page.tsx');
4655
- return external_node_fs_default().existsSync(routePage) && new RegExp(`(?<![\\w$])${page.ClassName}Page(?![\\w$])`).test(external_node_fs_default().readFileSync(routePage, 'utf8')) ? folder : void 0;
4656
- };
4657
- const reactModuleFiles = (module)=>{
4658
- const layout = reactKindLayouts[module.kind];
4659
- if (layout.inFolder) return module_move_walk(module.path);
4660
- const folder = external_node_path_default().dirname(module.path);
4661
- const own = layout.ownFile(module.fileBase);
4662
- return external_node_fs_default().readdirSync(folder, {
4663
- withFileTypes: true
4664
- }).filter((entry)=>entry.isFile() && own.test(entry.name)).map((entry)=>external_node_path_default().join(folder, entry.name));
4665
- };
4666
- const react_module_move_importSpecifier = /(?:\bfrom\s*|\bimport\s*\(\s*|\brequire\s*\(\s*|\bimport\s+)(['"])([^'"\n]+)\1/g;
4667
- const deleteReactModule = (projectRoot, reactFolder, module, route)=>{
4668
- const moduleFiles = reactModuleFiles(module);
4669
- const routeFileList = route ? routeFiles(route.folder) : [];
4670
- const own = new Set([
4671
- ...moduleFiles,
4672
- ...routeFileList
5080
+ environments: external_zod_default().array(agent_requests_name).min(1).optional().describe('Required when the contract wire is envBranchedWire; omit it otherwise.'),
5081
+ ...agent_requests_wired
5082
+ }),
5083
+ agent_requests_operation('endpoint', {
5084
+ ...common,
5085
+ ...agent_requests_owner,
5086
+ controller: agent_requests_name.optional().describe('Omit for the context-root controller (root): `/<context>/<path>`.'),
5087
+ method: external_zod_default()["enum"]([
5088
+ 'get',
5089
+ 'post',
5090
+ 'put',
5091
+ 'patch',
5092
+ 'delete'
5093
+ ]),
5094
+ path: external_zod_default().string().regex(/^(?:\/?(?:[a-zA-Z0-9_-]+|:[a-zA-Z][a-zA-Z0-9_]*))*\/?$/),
5095
+ handler: agent_requests_id.optional().describe('Exact handler module ID from --describe. Required when the context has wired queries, commands or use cases; omit it otherwise.')
5096
+ }),
5097
+ agent_requests_operation('wire-dependency', {
5098
+ ...common,
5099
+ ...agent_requests_owner,
5100
+ module: agent_requests_id.describe('Exact wiring target ID, including implementation class, from --describe.'),
5101
+ dependencies: agent_requests_dependencies
5102
+ }),
5103
+ agent_requests_operation('delete', {
5104
+ ...common,
5105
+ ...agent_requests_owner,
5106
+ module: agent_requests_id.describe('Exact unit ID from --describe. Refused while other files use it.')
5107
+ }),
5108
+ agent_requests_operation('move', {
5109
+ ...common,
5110
+ ...agent_requests_owner,
5111
+ module: agent_requests_id.describe('Exact unit ID from --describe.'),
5112
+ targetContext: agent_requests_nestedName.optional(),
5113
+ name: agent_requests_name.optional(),
5114
+ aggregate: agent_requests_name.optional()
5115
+ })
5116
+ ]);
5117
+ const frontendRequestSchema = (router)=>external_zod_default().discriminatedUnion('operation', [
5118
+ agent_requests_operation('page', {
5119
+ ...common,
5120
+ name: agent_requests_nestedName
5121
+ }),
5122
+ agent_requests_operation('widget', {
5123
+ ...common,
5124
+ name: agent_requests_nestedName,
5125
+ widgetType: external_zod_default()["enum"]([
5126
+ 'monolithic',
5127
+ 'separated',
5128
+ 'headless'
5129
+ ]).optional()
5130
+ }),
5131
+ agent_requests_operation('ui-kit-component', {
5132
+ ...common,
5133
+ name: agent_requests_name
5134
+ }),
5135
+ agent_requests_operation('shared-hook', {
5136
+ ...common,
5137
+ name: agent_requests_name
5138
+ }),
5139
+ agent_requests_operation('move-page', {
5140
+ ...common,
5141
+ module: agent_requests_nestedName,
5142
+ name: agent_requests_nestedName,
5143
+ moveRoute: external_zod_default().boolean().optional().describe(`With ${router} and a route at the page path: move it too (default true). Omit it without such a route.`)
5144
+ }),
5145
+ agent_requests_operation('delete-page', {
5146
+ ...common,
5147
+ module: agent_requests_nestedName,
5148
+ deleteRoute: external_zod_default().boolean().optional().describe(`With ${router} and the page's own route: delete it too (default true). Omit it without such a route.`)
5149
+ }),
5150
+ agent_requests_operation('delete-widget', {
5151
+ ...common,
5152
+ module: agent_requests_nestedName
5153
+ }),
5154
+ agent_requests_operation('move-ui-kit-component', {
5155
+ ...common,
5156
+ module: agent_requests_name,
5157
+ name: agent_requests_name
5158
+ }),
5159
+ agent_requests_operation('move-shared-hook', {
5160
+ ...common,
5161
+ module: agent_requests_name,
5162
+ name: agent_requests_name
5163
+ }),
5164
+ agent_requests_operation('delete-ui-kit-component', {
5165
+ ...common,
5166
+ module: agent_requests_name
5167
+ }),
5168
+ agent_requests_operation('delete-shared-hook', {
5169
+ ...common,
5170
+ module: agent_requests_name
5171
+ }),
5172
+ agent_requests_operation('move-widget', {
5173
+ ...common,
5174
+ module: agent_requests_nestedName,
5175
+ name: agent_requests_nestedName
5176
+ })
4673
5177
  ]);
4674
- const stems = new Set(moduleFiles.map((file)=>file.replace(codeExtension, '')));
4675
- const isModule = (resolved)=>stems.has(resolved) || reactKindLayouts[module.kind].inFolder && (resolved === module.path || resolved.startsWith(`${module.path}${external_node_path_default().sep}`));
4676
- const { codeFiles, resolve } = projectImports(projectRoot);
4677
- const relative = (file)=>toPosix(external_node_path_default().relative(projectRoot, file));
4678
- const usedBy = [];
4679
- for (const [file, content] of codeFiles)if (!own.has(file)) for (const [, , specifier] of content.matchAll(react_module_move_importSpecifier)){
4680
- const target = resolve(specifier, file)?.resolved;
4681
- if (target && isModule(target)) usedBy.push([
4682
- relative(file),
4683
- relative(target)
4684
- ]);
4685
- }
4686
- if (usedBy.length) return {
4687
- usedBy
4688
- };
4689
- for (const file of moduleFiles)new file_system_File(file).delete(reactFolder);
4690
- for (const file of routeFileList)new file_system_File(file).delete(route.appFolder);
4691
- return {
4692
- deleted: [
4693
- ...moduleFiles,
4694
- ...routeFileList
4695
- ]
4696
- };
4697
- };
4698
- const rootControllerFolder = '(root)';
4699
- const pathParameterAsName = (segment)=>segment.startsWith(':') ? `_${segment.slice(1)}_` : segment;
4700
- const isPathParameterName = (name)=>name.startsWith(':') || /^_.+_$/.test(name);
4701
- const endpointFileNames = new Set([
4702
- 'get',
4703
- 'post',
4704
- 'put',
4705
- 'patch',
4706
- 'delete'
4707
- ].map((method)=>`${method.toUpperCase()}.ts`));
4708
- const rest_layout_entries = (folder)=>external_node_fs_default().existsSync(folder) ? external_node_fs_default().readdirSync(folder, {
4709
- withFileTypes: true
4710
- }) : [];
4711
- const rest_layout_subfolders = (folder)=>rest_layout_entries(folder).filter((entry)=>entry.isDirectory()).map((entry)=>entry.name);
4712
- const restFolders = (boundedContextFolder)=>({
4713
- presentation: external_node_path_default().join(boundedContextFolder, 'presentation', 'rest'),
4714
- wiring: external_node_path_default().join(boundedContextFolder, 'wiring', 'presentation', 'rest')
4715
- });
4716
- const restControllers = (boundedContextFolder)=>rest_layout_subfolders(restFolders(boundedContextFolder).presentation).filter((name)=>name !== rootControllerFolder && !isPathParameterName(name));
4717
- const rootStaticSegments = (boundedContextFolder)=>rest_layout_subfolders(external_node_path_default().join(restFolders(boundedContextFolder).presentation, rootControllerFolder)).filter((name)=>!isPathParameterName(name));
4718
- const legacyRootEndpoints = (boundedContextFolder)=>{
4719
- const { presentation, wiring } = restFolders(boundedContextFolder);
4720
- return {
4721
- endpointFiles: rest_layout_entries(presentation).filter((entry)=>entry.isFile() && endpointFileNames.has(entry.name)).map((entry)=>external_node_path_default().join(presentation, entry.name)),
4722
- parameterFolders: rest_layout_subfolders(presentation).filter(isPathParameterName).map((name)=>external_node_path_default().join(presentation, name)),
4723
- wireFiles: rest_layout_entries(wiring).filter((entry)=>entry.isFile() && 'index.ts' !== entry.name && /\.ts$/.test(entry.name)).map((entry)=>external_node_path_default().join(wiring, entry.name))
4724
- };
4725
- };
4726
- const hasLegacyRootEndpoints = (boundedContextFolder)=>Object.values(legacyRootEndpoints(boundedContextFolder)).some((paths)=>paths.length > 0);
4727
- const systemImplementationChoices = (kind, crossContext = false)=>{
4728
- if ('ports' === kind) return crossContext ? [
4729
- {
4730
- name: 'System: cross-context (calls handlers in another bounded context)',
4731
- value: crossContextImplementation
4732
- }
4733
- ] : [];
4734
- return config_file_ConfigFile.exists && usesInMemoryDb('in-memory') ? [
4735
- {
4736
- name: 'System: in-memory (uses the shared in-memory database)',
4737
- value: 'in-memory'
4738
- }
4739
- ] : [];
4740
- };
5178
+ const reactRequestSchema = frontendRequestSchema('Next.js');
5179
+ const svelteRequestSchema = frontendRequestSchema('SvelteKit');
5180
+ const agent_requests_relativePath = external_zod_default().string().regex(/^[a-zA-Z0-9_.-]+(?:\/[a-zA-Z0-9_.-]+)*$/).refine((value)=>!value.split('/').some((part)=>'.' === part || '..' === part), 'Use a project-relative path without . or .. segments.');
5181
+ const integrationRequestSchema = agent_requests_operation('add', {
5182
+ ...common,
5183
+ integrations: external_zod_default().array(external_zod_default()["enum"](integrationIds)).min(1),
5184
+ nextAdapter: external_zod_default().boolean().optional(),
5185
+ svelteAdapter: external_zod_default().boolean().optional(),
5186
+ configureReact: external_zod_default().boolean().optional(),
5187
+ replaceTestingLibrary: external_zod_default().boolean().optional(),
5188
+ integrationTestTypes: external_zod_default().array(agent_requests_name).optional().describe('testcontainers with wire: saved primary implementation types whose implementations get integration specs. Omitted: the configured list stays.'),
5189
+ withService: external_zod_default().boolean().optional(),
5190
+ routePrefix: external_zod_default().string().regex(/^\/?[a-zA-Z0-9_/-]*$/).optional(),
5191
+ openapiPath: agent_requests_relativePath.optional(),
5192
+ withExtractor: external_zod_default().boolean().optional(),
5193
+ swaggerPage: external_zod_default().boolean().optional(),
5194
+ targets: external_zod_default().array(external_zod_default()["enum"]([
5195
+ 'hooks',
5196
+ 'client'
5197
+ ])).min(1).optional(),
5198
+ scriptConflicts: external_zod_default().record(agent_requests_id, external_zod_default()["enum"]([
5199
+ 'keep',
5200
+ 'replace',
5201
+ 'rename'
5202
+ ])).optional(),
5203
+ scriptNames: external_zod_default().record(agent_requests_id, external_zod_default().string().regex(/^[a-zA-Z0-9:_-]+$/)).optional()
5204
+ });
5205
+ const requestSchemaFor = (command)=>({
5206
+ 'df-scaffold': scaffoldRequestSchema,
5207
+ 'df-react': reactRequestSchema,
5208
+ 'df-svelte': svelteRequestSchema,
5209
+ 'df-integration': integrationRequestSchema
5210
+ })[command];
4741
5211
  const deleteBackendUnitUseCase = async (ownerFolder)=>{
4742
5212
  const root = new project_root_ProjectRoot().path;
4743
5213
  const rootFolderPath = external_node_path_default().join(root, config_file_ConfigFile.Instance.data.project.rootFolder);
@@ -4747,10 +5217,10 @@ const deleteBackendUnitUseCase = async (ownerFolder)=>{
4747
5217
  key: 'module',
4748
5218
  id: unitId,
4749
5219
  message: 'Module to delete:',
4750
- choices: Object.keys(kindLayouts).flatMap((kind)=>{
5220
+ choices: Object.keys(backend_module_move_kindLayouts).flatMap((kind)=>{
4751
5221
  const group = units.filter((x)=>x.kind === kind);
4752
5222
  return group.length ? [
4753
- new prompts_namespaceObject.Separator(`── ${kindLayouts[group[0].kind].title}`),
5223
+ new prompts_namespaceObject.Separator(`── ${backend_module_move_kindLayouts[group[0].kind].title}`),
4754
5224
  ...group.map((value)=>({
4755
5225
  name: value.aggregate ? `${value.name} (${value.aggregate})` : value.name,
4756
5226
  value
@@ -4789,10 +5259,32 @@ const deleteBackendUnitUseCase = async (ownerFolder)=>{
4789
5259
  report('Cancelled: nothing was deleted.');
4790
5260
  }
4791
5261
  };
4792
- const deleteReactModuleUseCase = async (presentationReactFolder, kind)=>{
5262
+ const pageRouter = (framework)=>{
5263
+ if ('react' === framework) return usesNext() ? {
5264
+ title: 'Next.js',
5265
+ folder: nextAppFolder,
5266
+ pageFile: routePageFile.react
5267
+ } : void 0;
5268
+ return usesSvelteKit() ? {
5269
+ title: 'SvelteKit',
5270
+ folder: svelteKitRoutesFolder,
5271
+ pageFile: routePageFile.svelte
5272
+ } : void 0;
5273
+ };
5274
+ const frameworkTitles = {
5275
+ react: {
5276
+ title: 'React',
5277
+ cli: 'df-react'
5278
+ },
5279
+ svelte: {
5280
+ title: 'Svelte',
5281
+ cli: 'df-svelte'
5282
+ }
5283
+ };
5284
+ const deleteReactModuleUseCase = async (presentationReactFolder, kind, framework = 'react')=>{
4793
5285
  const reactFolder = presentationReactFolder.path;
4794
- const modules = findReactModules(reactFolder, kind);
4795
- if (!modules.length) return void report(`No ${reactKindTitles[kind][1]} generated by df-react were found.`);
5286
+ const modules = findReactModules(reactFolder, kind, framework);
5287
+ if (!modules.length) return void report(`No ${reactKindTitles[kind][1]} generated by ${frameworkTitles[framework].cli} were found.`);
4796
5288
  const module = await interaction_select({
4797
5289
  key: 'module',
4798
5290
  id: (value)=>value.name,
@@ -4805,17 +5297,18 @@ const deleteReactModuleUseCase = async (presentationReactFolder, kind)=>{
4805
5297
  });
4806
5298
  const root = new project_root_ProjectRoot().path;
4807
5299
  const relative = (file)=>external_node_path_default().relative(root, file).split(external_node_path_default().sep).join('/');
4808
- const appFolder = external_node_path_default().join(root, nextAppFolder(root));
4809
- const routeFolder = 'page' === kind && usesNext() ? pageRouteFolder(appFolder, module) : void 0;
5300
+ const router = 'page' === kind ? pageRouter(framework) : void 0;
5301
+ const appFolder = router && external_node_path_default().join(root, router.folder(root));
5302
+ const routeFolder = router && appFolder ? pageRouteFolder(appFolder, module, framework) : void 0;
4810
5303
  const withRoute = !!routeFolder && await interaction_confirm({
4811
5304
  key: 'deleteRoute',
4812
- message: `Delete its Next.js route too: ${relative(routeFolder)}? Its URL stops working.`,
5305
+ message: `Delete its ${router?.title} route too: ${relative(routeFolder)}? Its URL stops working.`,
4813
5306
  default: true
4814
5307
  });
4815
- const result = deleteReactModule(root, reactFolder, module, withRoute && routeFolder ? {
5308
+ const result = deleteReactModule(root, reactFolder, module, withRoute && routeFolder && appFolder ? {
4816
5309
  appFolder,
4817
5310
  folder: routeFolder
4818
- } : void 0);
5311
+ } : void 0, framework);
4819
5312
  if (result.usedBy) {
4820
5313
  if (isNonInteractive()) throw new RequestError('DELETE_NOT_ALLOWED', `Other files still use the ${kind}.`, {
4821
5314
  usedBy: result.usedBy
@@ -4853,10 +5346,10 @@ const moveBackendUnitUseCase = async (ownerFolder)=>{
4853
5346
  key: 'module',
4854
5347
  id: unitId,
4855
5348
  message: 'Module:',
4856
- choices: Object.keys(kindLayouts).flatMap((kind)=>{
5349
+ choices: Object.keys(backend_module_move_kindLayouts).flatMap((kind)=>{
4857
5350
  const group = units.filter((x)=>x.kind === kind);
4858
5351
  return group.length ? [
4859
- new prompts_namespaceObject.Separator(`── ${kindLayouts[group[0].kind].title}`),
5352
+ new prompts_namespaceObject.Separator(`── ${backend_module_move_kindLayouts[group[0].kind].title}`),
4860
5353
  ...group.map((value)=>({
4861
5354
  name: value.aggregate ? `${value.name} (${value.aggregate})` : value.name,
4862
5355
  value
@@ -4870,7 +5363,7 @@ const moveBackendUnitUseCase = async (ownerFolder)=>{
4870
5363
  const places = [
4871
5364
  unit.ownerPath,
4872
5365
  ...contexts,
4873
- ...kindLayouts[unit.kind].sharedKernel ? [
5366
+ ...backend_module_move_kindLayouts[unit.kind].sharedKernel ? [
4874
5367
  sharedKernelPath
4875
5368
  ] : []
4876
5369
  ].filter((place, index, all)=>all.indexOf(place) === index);
@@ -4938,17 +5431,18 @@ const moveBackendUnitUseCase = async (ownerFolder)=>{
4938
5431
  report('Cancelled: nothing was written.');
4939
5432
  }
4940
5433
  };
4941
- const promptRouteMove = async (root, page, newName)=>{
4942
- if (!usesNext()) return;
4943
- const appFolder = external_node_path_default().join(root, nextAppFolder(root));
4944
- const from = pageRouteFolder(appFolder, page);
5434
+ const promptRouteMove = async (root, page, newName, framework)=>{
5435
+ const router = pageRouter(framework);
5436
+ if (!router) return;
5437
+ const appFolder = external_node_path_default().join(root, router.folder(root));
5438
+ const from = pageRouteFolder(appFolder, page, framework);
4945
5439
  const to = react_module_move_routeFolder(appFolder, newName);
4946
5440
  const relative = (file)=>external_node_path_default().relative(root, file).split(external_node_path_default().sep).join('/');
4947
5441
  if (!from || from === to) return;
4948
- if (external_node_fs_default().existsSync(external_node_path_default().join(to, 'page.tsx'))) return void report(`${relative(to)}/page.tsx already exists: the route ${relative(from)} stays.`);
5442
+ if (external_node_fs_default().existsSync(external_node_path_default().join(to, router.pageFile))) return void report(`${relative(to)}/${router.pageFile} already exists: the route ${relative(from)} stays.`);
4949
5443
  const move = await interaction_confirm({
4950
5444
  key: 'moveRoute',
4951
- message: `Move the Next.js route too: ${relative(from)} → ${relative(to)}? Its URL changes.`,
5445
+ message: `Move the ${router.title} route too: ${relative(from)} → ${relative(to)}? Its URL changes.`,
4952
5446
  default: true
4953
5447
  });
4954
5448
  return move ? {
@@ -4957,10 +5451,10 @@ const promptRouteMove = async (root, page, newName)=>{
4957
5451
  to
4958
5452
  } : void 0;
4959
5453
  };
4960
- const moveReactModuleUseCase = async (presentationReactFolder, kind)=>{
5454
+ const moveReactModuleUseCase = async (presentationReactFolder, kind, framework = 'react')=>{
4961
5455
  const reactFolder = presentationReactFolder.path;
4962
- const modules = findReactModules(reactFolder, kind);
4963
- if (!modules.length) return void report(`No ${reactKindTitles[kind][1]} generated by df-react were found.`);
5456
+ const modules = findReactModules(reactFolder, kind, framework);
5457
+ if (!modules.length) return void report(`No ${reactKindTitles[kind][1]} generated by ${frameworkTitles[framework].cli} were found.`);
4964
5458
  const module = await interaction_select({
4965
5459
  key: 'module',
4966
5460
  id: (value)=>value.name,
@@ -4973,14 +5467,14 @@ const moveReactModuleUseCase = async (presentationReactFolder, kind)=>{
4973
5467
  });
4974
5468
  const name = await interaction_input({
4975
5469
  key: 'name',
4976
- message: reactKindLayouts[kind].nested ? 'New name (folders split by "/"):' : 'New name:',
5470
+ message: frontendKindLayouts(framework)[kind].nested ? 'New name (folders split by "/"):' : 'New name:',
4977
5471
  default: module.name,
4978
- validate: (value)=>validateMove(reactFolder, module, value)
5472
+ validate: (value)=>validateMove(reactFolder, module, value, framework)
4979
5473
  });
4980
5474
  const root = new project_root_ProjectRoot().path;
4981
5475
  const relative = (file)=>external_node_path_default().relative(root, file).split(external_node_path_default().sep).join('/');
4982
- const route = 'page' === kind ? await promptRouteMove(root, module, name) : void 0;
4983
- const { moves, updated } = moveReactModule(root, reactFolder, module, name, route);
5476
+ const route = 'page' === kind ? await promptRouteMove(root, module, name, framework) : void 0;
5477
+ const { moves, updated } = moveReactModule(root, reactFolder, module, name, route, framework);
4984
5478
  if (!moves.length && !updated.length) return void report('Nothing to change.');
4985
5479
  report([
4986
5480
  'Files to move:',
@@ -4999,6 +5493,20 @@ const moveReactModuleUseCase = async (presentationReactFolder, kind)=>{
4999
5493
  report('Cancelled: nothing was written.');
5000
5494
  }
5001
5495
  };
5496
+ const systemImplementationChoices = (kind, crossContext = false)=>{
5497
+ if ('ports' === kind) return crossContext ? [
5498
+ {
5499
+ name: 'System: cross-context (calls handlers in another bounded context)',
5500
+ value: crossContextImplementation
5501
+ }
5502
+ ] : [];
5503
+ return config_file_ConfigFile.exists && usesInMemoryDb('in-memory') ? [
5504
+ {
5505
+ name: 'System: in-memory (uses the shared in-memory database)',
5506
+ value: 'in-memory'
5507
+ }
5508
+ ] : [];
5509
+ };
5002
5510
  const enterImplementationTypeOnce = Symbol('enter-implementation-type-once');
5003
5511
  const implementationTypeEntryChoices = [
5004
5512
  {
@@ -5591,6 +6099,35 @@ export const ${names.namespace(ClassName)} = errorNamespace('${contextName}').su
5591
6099
  const namespaceFile = currentErrorFolder.file(`${namespace}.ts`);
5592
6100
  namespaceFile.addLineIfMissing(errorClass(names.error(`${namespaceNaming.ClassName}${ClassName}`), exportedNamespace(namespaceFile, names.namespace(namespaceNaming.ClassName)), fileName), '\n\n');
5593
6101
  };
6102
+ const rootControllerFolder = '(root)';
6103
+ const pathParameterAsName = (segment)=>segment.startsWith(':') ? `_${segment.slice(1)}_` : segment;
6104
+ const isPathParameterName = (name)=>name.startsWith(':') || /^_.+_$/.test(name);
6105
+ const endpointFileNames = new Set([
6106
+ 'get',
6107
+ 'post',
6108
+ 'put',
6109
+ 'patch',
6110
+ 'delete'
6111
+ ].map((method)=>`${method.toUpperCase()}.ts`));
6112
+ const rest_layout_entries = (folder)=>external_node_fs_default().existsSync(folder) ? external_node_fs_default().readdirSync(folder, {
6113
+ withFileTypes: true
6114
+ }) : [];
6115
+ const rest_layout_subfolders = (folder)=>rest_layout_entries(folder).filter((entry)=>entry.isDirectory()).map((entry)=>entry.name);
6116
+ const restFolders = (boundedContextFolder)=>({
6117
+ presentation: external_node_path_default().join(boundedContextFolder, 'presentation', 'rest'),
6118
+ wiring: external_node_path_default().join(boundedContextFolder, 'wiring', 'presentation', 'rest')
6119
+ });
6120
+ const restControllers = (boundedContextFolder)=>rest_layout_subfolders(restFolders(boundedContextFolder).presentation).filter((name)=>name !== rootControllerFolder && !isPathParameterName(name));
6121
+ const rootStaticSegments = (boundedContextFolder)=>rest_layout_subfolders(external_node_path_default().join(restFolders(boundedContextFolder).presentation, rootControllerFolder)).filter((name)=>!isPathParameterName(name));
6122
+ const legacyRootEndpoints = (boundedContextFolder)=>{
6123
+ const { presentation, wiring } = restFolders(boundedContextFolder);
6124
+ return {
6125
+ endpointFiles: rest_layout_entries(presentation).filter((entry)=>entry.isFile() && endpointFileNames.has(entry.name)).map((entry)=>external_node_path_default().join(presentation, entry.name)),
6126
+ parameterFolders: rest_layout_subfolders(presentation).filter(isPathParameterName).map((name)=>external_node_path_default().join(presentation, name)),
6127
+ wireFiles: rest_layout_entries(wiring).filter((entry)=>entry.isFile() && 'index.ts' !== entry.name && /\.ts$/.test(entry.name)).map((entry)=>external_node_path_default().join(wiring, entry.name))
6128
+ };
6129
+ };
6130
+ const hasLegacyRootEndpoints = (boundedContextFolder)=>Object.values(legacyRootEndpoints(boundedContextFolder)).some((paths)=>paths.length > 0);
5594
6131
  const newController = 'New controller';
5595
6132
  const rootControllerChoice = 'No controller (context root)';
5596
6133
  const sourceFolder = ()=>new file_system_Folder(new project_root_ProjectRoot().path).subitem([
@@ -6275,6 +6812,85 @@ export const use${ClassName}UIModel = (widgetProps: Omit<${ClassName}WidgetProps
6275
6812
  break;
6276
6813
  }
6277
6814
  };
6815
+ const frontendOperations = (folder, framework)=>{
6816
+ const scaffold = 'svelte' === framework ? {
6817
+ page: scaffoldSveltePage,
6818
+ widget: scaffoldSvelteWidget,
6819
+ 'ui-kit-component': scaffoldSvelteUIKitComponent,
6820
+ 'shared-hook': scaffoldSvelteSharedHook
6821
+ } : {
6822
+ page: scaffoldReactPage,
6823
+ widget: scaffoldReactWidget,
6824
+ 'ui-kit-component': scaffoldReactUIKitComponent,
6825
+ 'shared-hook': scaffoldReactSharedHook
6826
+ };
6827
+ const move = (kind)=>()=>moveReactModuleUseCase(folder, kind, framework);
6828
+ const remove = (kind)=>()=>deleteReactModuleUseCase(folder, kind, framework);
6829
+ return {
6830
+ page: ()=>scaffold.page(folder),
6831
+ widget: ()=>scaffold.widget(folder),
6832
+ 'ui-kit-component': ()=>scaffold['ui-kit-component'](folder),
6833
+ 'shared-hook': ()=>scaffold['shared-hook'](folder),
6834
+ 'move-page': move('page'),
6835
+ 'move-widget': move('widget'),
6836
+ 'move-ui-kit-component': move('ui-kit'),
6837
+ 'move-shared-hook': move('hook'),
6838
+ 'delete-page': remove('page'),
6839
+ 'delete-widget': remove('widget'),
6840
+ 'delete-ui-kit-component': remove('ui-kit'),
6841
+ 'delete-shared-hook': remove('hook')
6842
+ };
6843
+ };
6844
+ const frontendMenu = [
6845
+ [
6846
+ 'New widget',
6847
+ 'widget'
6848
+ ],
6849
+ [
6850
+ 'New page',
6851
+ 'page'
6852
+ ],
6853
+ [
6854
+ 'New UI-kit component',
6855
+ 'ui-kit-component'
6856
+ ],
6857
+ [
6858
+ 'New shared hook',
6859
+ 'shared-hook'
6860
+ ],
6861
+ [
6862
+ 'Move or rename widget',
6863
+ 'move-widget'
6864
+ ],
6865
+ [
6866
+ 'Move or rename page',
6867
+ 'move-page'
6868
+ ],
6869
+ [
6870
+ 'Move or rename UI-kit component',
6871
+ 'move-ui-kit-component'
6872
+ ],
6873
+ [
6874
+ 'Move or rename shared hook',
6875
+ 'move-shared-hook'
6876
+ ],
6877
+ [
6878
+ 'Delete widget',
6879
+ 'delete-widget'
6880
+ ],
6881
+ [
6882
+ 'Delete page',
6883
+ 'delete-page'
6884
+ ],
6885
+ [
6886
+ 'Delete UI-kit component',
6887
+ 'delete-ui-kit-component'
6888
+ ],
6889
+ [
6890
+ 'Delete shared hook',
6891
+ 'delete-shared-hook'
6892
+ ]
6893
+ ];
6278
6894
  const requireProject = ()=>{
6279
6895
  try {
6280
6896
  return new project_root_ProjectRoot().path;
@@ -6311,12 +6927,24 @@ const ownerFor = (context)=>{
6311
6927
  });
6312
6928
  return owner.folder;
6313
6929
  };
6930
+ const frontendFrameworkOf = (command)=>'df-react' === command ? 'react' : 'df-svelte' === command ? 'svelte' : void 0;
6931
+ const frontendModules = (root, rootFolder, framework)=>[
6932
+ 'page',
6933
+ 'widget',
6934
+ 'ui-kit',
6935
+ 'hook'
6936
+ ].flatMap((kind)=>findReactModules(external_node_path_default().join(root, rootFolder, 'presentation', framework), kind, framework).map((module)=>({
6937
+ kind,
6938
+ name: module.name,
6939
+ file: external_node_path_default().relative(root, module.path).split(external_node_path_default().sep).join('/')
6940
+ })));
6314
6941
  const precondition = (command)=>{
6315
6942
  requireProject();
6316
6943
  if (!config_file_ConfigFile.exists) throw new RequestError('CONFIG_NOT_FOUND', 'Ask the project owner to run df-init.');
6317
6944
  if (config_file_ConfigFile.outdated) throw new RequestError('CONFIG_OUTDATED', 'The config has the format of an earlier major version: ask the project owner to run df-upgrade.');
6318
6945
  if ('df-scaffold' === command && !config_file_ConfigFile.Instance.data.backend) throw new RequestError('BACKEND_NOT_CONFIGURED', 'Ask the project owner to run df-init --section backend.');
6319
- if ('df-react' === command && !config_file_ConfigFile.Instance.data.frontend?.react) throw new RequestError('FRONTEND_NOT_CONFIGURED', 'Ask the project owner to run df-init --section frontend.');
6946
+ const framework = frontendFrameworkOf(command);
6947
+ if (framework && !config_file_ConfigFile.Instance.data.frontend?.[framework]) throw new RequestError('FRONTEND_NOT_CONFIGURED', 'Ask the project owner to run df-init --section frontend.');
6320
6948
  };
6321
6949
  const describeAgentCommand = (command)=>{
6322
6950
  let root;
@@ -6385,16 +7013,8 @@ const describeAgentCommand = (command)=>{
6385
7013
  ])) : void 0
6386
7014
  })),
6387
7015
  integrations: integrationDescriptionsSafe(configured),
6388
- reactModules: config?.frontend?.react ? [
6389
- 'page',
6390
- 'widget',
6391
- 'ui-kit',
6392
- 'hook'
6393
- ].flatMap((kind)=>findReactModules(external_node_path_default().join(root, config.project.rootFolder, 'presentation/react'), kind).map((module)=>({
6394
- kind,
6395
- name: module.name,
6396
- file: relative(module.path)
6397
- }))) : []
7016
+ reactModules: config?.frontend?.react ? frontendModules(root, config.project.rootFolder, 'react') : [],
7017
+ svelteModules: config?.frontend?.svelte ? frontendModules(root, config.project.rootFolder, 'svelte') : []
6398
7018
  } : null
6399
7019
  };
6400
7020
  };
@@ -6496,29 +7116,16 @@ const executeScaffold = async (request, owner)=>{
6496
7116
  };
6497
7117
  return actions[request.operation]();
6498
7118
  };
6499
- const executeReact = async (request)=>{
7119
+ const executeFrontend = async (request, framework)=>{
6500
7120
  const folder = new file_system_Folder(requireProject()).subitem([
6501
7121
  config_file_ConfigFile.Instance.data.project.rootFolder,
6502
- 'presentation/react'
7122
+ 'presentation',
7123
+ framework
6503
7124
  ]);
6504
7125
  const kindOf = (operation)=>operation.endsWith('-page') ? 'page' : operation.endsWith('-widget') ? 'widget' : operation.endsWith('-ui-kit-component') ? 'ui-kit' : operation.endsWith('-shared-hook') ? 'hook' : void 0;
6505
7126
  const kind = /^(move|delete)-/.test(request.operation) ? kindOf(request.operation) : void 0;
6506
- if (kind && !findReactModules(folder.path, kind).length) throw new RequestError('TARGET_NOT_FOUND', `No React ${reactKindTitles[kind][1]} here.`);
6507
- const actions = {
6508
- page: ()=>scaffoldReactPage(folder),
6509
- widget: ()=>scaffoldReactWidget(folder),
6510
- 'ui-kit-component': ()=>scaffoldReactUIKitComponent(folder),
6511
- 'shared-hook': ()=>scaffoldReactSharedHook(folder),
6512
- 'move-page': ()=>moveReactModuleUseCase(folder, 'page'),
6513
- 'move-widget': ()=>moveReactModuleUseCase(folder, 'widget'),
6514
- 'delete-page': ()=>deleteReactModuleUseCase(folder, 'page'),
6515
- 'delete-widget': ()=>deleteReactModuleUseCase(folder, 'widget'),
6516
- 'move-ui-kit-component': ()=>moveReactModuleUseCase(folder, 'ui-kit'),
6517
- 'move-shared-hook': ()=>moveReactModuleUseCase(folder, 'hook'),
6518
- 'delete-ui-kit-component': ()=>deleteReactModuleUseCase(folder, 'ui-kit'),
6519
- 'delete-shared-hook': ()=>deleteReactModuleUseCase(folder, 'hook')
6520
- };
6521
- return actions[request.operation]();
7127
+ if (kind && !findReactModules(folder.path, kind, framework).length) throw new RequestError('TARGET_NOT_FOUND', `No ${frameworkTitles[framework].title} ${reactKindTitles[kind][1]} here.`);
7128
+ return frontendOperations(folder, framework)[request.operation]();
6522
7129
  };
6523
7130
  const executeAgentRequest = async (command, value)=>{
6524
7131
  discardPendingChanges();
@@ -6539,7 +7146,7 @@ const executeAgentRequest = async (command, value)=>{
6539
7146
  let nextSteps = [];
6540
7147
  if ('df-scaffold' === command) if ('bounded-context' === request.operation) await scaffoldNewBoundedContextUseCase();
6541
7148
  else await executeScaffold(request, owner);
6542
- else if ('df-react' === command) await executeReact(request);
7149
+ else if (frontendFrameworkOf(command)) await executeFrontend(request, frontendFrameworkOf(command));
6543
7150
  else nextSteps = await addIntegration({
6544
7151
  save: false
6545
7152
  });
@@ -6624,103 +7231,80 @@ const runCLI = async (command, interactive)=>{
6624
7231
  process.exitCode = 1;
6625
7232
  }
6626
7233
  };
6627
- runCLI('df-react', async ()=>{
6628
- const help = `Usage: df-react
7234
+ const texts = {
7235
+ react: {
7236
+ command: 'df-react',
7237
+ help: `Usage: df-react
6629
7238
 
6630
7239
  Scaffolds React modules of a Domain-First project: pages, widgets, UI-kit
6631
7240
  components and shared hooks, and moves or renames pages and widgets.
6632
- Needs frontend.react in domain-first.project-structure.config.json.
7241
+ Needs frontend.react in domain-first.project-structure.config.json.`,
7242
+ notConfigured: 'React is not configured: run df-init --section frontend or add Storybook with df-integration.'
7243
+ },
7244
+ svelte: {
7245
+ command: 'df-svelte',
7246
+ help: `Usage: df-svelte
7247
+
7248
+ Scaffolds Svelte 5 modules of a Domain-First project: pages, widgets, UI-kit
7249
+ components and shared hooks (.svelte.ts), and moves, renames or deletes
7250
+ them. With SvelteKit, pages get their routes in src/routes.
7251
+ Needs frontend.svelte in domain-first.project-structure.config.json.`,
7252
+ notConfigured: 'Svelte is not configured: run df-init --section frontend.'
7253
+ }
7254
+ };
7255
+ const runFrontendCLI = (framework)=>{
7256
+ const { command, help, notConfigured } = texts[framework];
7257
+ return runCLI(command, async ()=>{
7258
+ const { values } = (0, external_node_util_namespaceObject.parseArgs)({
7259
+ options: {
7260
+ help: {
7261
+ type: 'boolean',
7262
+ short: 'h',
7263
+ default: false
7264
+ }
7265
+ }
7266
+ });
7267
+ if (values.help) {
7268
+ console.log(`${help}
6633
7269
 
6634
7270
  Options:
6635
7271
  --request <json|-> execute an operation without prompts; - reads stdin
6636
7272
  --describe output request schema and project IDs as JSON
6637
- -h, --help show this help`;
6638
- const { values } = (0, external_node_util_namespaceObject.parseArgs)({
6639
- options: {
6640
- help: {
6641
- type: 'boolean',
6642
- short: 'h',
6643
- default: false
6644
- }
7273
+ -h, --help show this help`);
7274
+ process.exit(0);
6645
7275
  }
6646
- });
6647
- if (values.help) {
6648
- console.log(help);
6649
- process.exit(0);
6650
- }
6651
- if (!config_file_ConfigFile.exists) {
6652
- console.log('No domain-first.project-structure.config.json found: run df-init first to initialize the project.');
6653
- process.exit(1);
6654
- }
6655
- if (config_file_ConfigFile.outdated) {
6656
- console.log(outdatedConfigMessage);
6657
- process.exit(1);
6658
- }
6659
- if (!config_file_ConfigFile.Instance.data.frontend?.react) {
6660
- console.log('React is not configured: run df-init --section frontend or add Storybook with df-integration.');
6661
- process.exit(1);
6662
- }
6663
- const main = async ()=>{
6664
- const reactFolder = new file_system_Folder(new project_root_ProjectRoot().path).subitem([
7276
+ if (!config_file_ConfigFile.exists) {
7277
+ console.log('No domain-first.project-structure.config.json found: run df-init first to initialize the project.');
7278
+ process.exit(1);
7279
+ }
7280
+ if (config_file_ConfigFile.outdated) {
7281
+ console.log(outdatedConfigMessage);
7282
+ process.exit(1);
7283
+ }
7284
+ if (!config_file_ConfigFile.Instance.data.frontend?.[framework]) {
7285
+ console.log(notConfigured);
7286
+ process.exit(1);
7287
+ }
7288
+ const folder = new file_system_Folder(new project_root_ProjectRoot().path).subitem([
6665
7289
  config_file_ConfigFile.Instance.data.project.rootFolder,
6666
7290
  'presentation',
6667
- 'react'
7291
+ framework
6668
7292
  ]);
6669
- const action = await (0, prompts_namespaceObject.select)({
7293
+ const operation = await (0, prompts_namespaceObject.select)({
6670
7294
  message: 'Module: ',
6671
- choices: [
6672
- 'New widget',
6673
- 'New page',
6674
- 'New UI-kit component',
6675
- 'New shared hook',
6676
- 'Move or rename widget',
6677
- 'Move or rename page',
6678
- 'Move or rename UI-kit component',
6679
- 'Move or rename shared hook',
6680
- 'Delete widget',
6681
- 'Delete page',
6682
- 'Delete UI-kit component',
6683
- 'Delete shared hook'
6684
- ]
7295
+ choices: frontendMenu.map(([name, value])=>({
7296
+ name,
7297
+ value
7298
+ }))
6685
7299
  });
6686
- switch(action){
6687
- case 'New widget':
6688
- return void await scaffoldReactWidget(reactFolder);
6689
- case 'New page':
6690
- return void await scaffoldReactPage(reactFolder);
6691
- case 'New UI-kit component':
6692
- return void await scaffoldReactUIKitComponent(reactFolder);
6693
- case 'New shared hook':
6694
- return void await scaffoldReactSharedHook(reactFolder);
6695
- case 'Move or rename widget':
6696
- return void await moveReactModuleUseCase(reactFolder, 'widget');
6697
- case 'Move or rename page':
6698
- return void await moveReactModuleUseCase(reactFolder, 'page');
6699
- case 'Delete widget':
6700
- return void await deleteReactModuleUseCase(reactFolder, 'widget');
6701
- case 'Delete page':
6702
- return void await deleteReactModuleUseCase(reactFolder, 'page');
6703
- case 'Move or rename UI-kit component':
6704
- return void await moveReactModuleUseCase(reactFolder, 'ui-kit');
6705
- case 'Move or rename shared hook':
6706
- return void await moveReactModuleUseCase(reactFolder, 'hook');
6707
- case 'Delete UI-kit component':
6708
- return void await deleteReactModuleUseCase(reactFolder, 'ui-kit');
6709
- case 'Delete shared hook':
6710
- return void await deleteReactModuleUseCase(reactFolder, 'hook');
6711
- default:
6712
- return;
6713
- }
6714
- };
6715
- const run = async ()=>{
6716
- await main();
7300
+ await frontendOperations(folder, framework)[operation]();
6717
7301
  await savePendingChanges();
6718
- };
6719
- await run();
6720
- }).catch((error)=>{
6721
- console.error(error);
6722
- process.exitCode = 1;
6723
- });
7302
+ }).catch((error)=>{
7303
+ console.error(error);
7304
+ process.exitCode = 1;
7305
+ });
7306
+ };
7307
+ runFrontendCLI('react');
6724
7308
  for(var __rspack_i in __webpack_exports__)exports[__rspack_i] = __webpack_exports__[__rspack_i];
6725
7309
  Object.defineProperty(exports, '__esModule', {
6726
7310
  value: true