@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.
- package/README.md +17 -7
- package/dist/115.js +142 -141
- package/dist/201.js +10 -1
- package/dist/287.js +983 -434
- package/dist/364.js +79 -0
- package/dist/38.js +29 -13
- package/dist/561.js +167 -93
- package/dist/agent-cli.d.ts +13 -2
- package/dist/agent-requests.d.ts +76 -2
- package/dist/config-file.d.ts +25 -1
- package/dist/frontend-cli.d.ts +3 -0
- package/dist/frontend-modules.d.ts +9 -0
- package/dist/graph.cjs +10 -1
- package/dist/index.cjs +3470 -2913
- package/dist/init.cjs +325 -83
- package/dist/integration.cjs +3470 -2913
- package/dist/integrations/openapi.d.ts +9 -2
- package/dist/integrations/orval.d.ts +31 -4
- package/dist/integrations/rest-endpoint-generator.d.ts +11 -7
- package/dist/integrations/storybook.d.ts +19 -1
- package/dist/lint.cjs +40 -15
- package/dist/lint.js +1 -1
- package/dist/page-router.d.ts +18 -0
- package/dist/react-module-move.d.ts +27 -12
- package/dist/react.cjs +1577 -993
- package/dist/react.js +2 -102
- package/dist/rest-adapters.d.ts +13 -0
- package/dist/svelte-agent-cli.spec.d.ts +1 -0
- package/dist/svelte.cjs +7311 -0
- package/dist/svelte.d.ts +2 -0
- package/dist/svelte.js +3 -0
- package/dist/sveltekit-app.d.ts +7 -0
- package/dist/upgrade-steps.d.ts +6 -1
- package/dist/upgrade.cjs +12 -2
- package/dist/use-cases/add-integration.d.ts +1 -1
- package/dist/use-cases/delete-react-module.d.ts +4 -4
- package/dist/use-cases/index.d.ts +1 -0
- package/dist/use-cases/move-react-module.d.ts +2 -2
- package/dist/use-cases/rest-endpoint-generator.d.ts +6 -4
- package/dist/use-cases/scaffold-svelte-modules.d.ts +22 -0
- package/package.json +2 -1
- package/skills/df-ps-implement/SKILL.md +3 -3
- package/skills/df-ps-plan-feature/SKILL.md +2 -2
- package/skills/df-ps-scaffold/SKILL.md +11 -10
- package/skills/df-ps-scaffold/references/agent-mode.md +1 -1
- package/skills/df-ps-scaffold/references/agent-operations.md +8 -4
- package/skills/df-ps-scaffold/references/generators.md +1 -1
- package/skills/df-ps-scaffold/references/work-plan.md +1 -1
- package/skills/df-ps-svelte/SKILL.md +49 -0
- 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
|
|
1674
|
-
|
|
1675
|
-
|
|
1676
|
-
|
|
1677
|
-
|
|
1678
|
-
|
|
1679
|
-
|
|
1680
|
-
|
|
1681
|
-
|
|
1682
|
-
|
|
1683
|
-
|
|
1684
|
-
|
|
1685
|
-
|
|
1686
|
-
|
|
1687
|
-
|
|
1688
|
-
|
|
1689
|
-
|
|
1690
|
-
|
|
1691
|
-
|
|
1692
|
-
|
|
1693
|
-
|
|
1694
|
-
|
|
1695
|
-
|
|
1696
|
-
|
|
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
|
-
|
|
1726
|
-
|
|
1727
|
-
|
|
1728
|
-
|
|
1729
|
-
}
|
|
1730
|
-
|
|
1731
|
-
|
|
1732
|
-
|
|
1733
|
-
|
|
1734
|
-
|
|
1735
|
-
|
|
1736
|
-
|
|
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
|
-
|
|
1778
|
-
const
|
|
1779
|
-
const
|
|
1780
|
-
|
|
1781
|
-
|
|
1782
|
-
)
|
|
1783
|
-
|
|
1784
|
-
|
|
1785
|
-
|
|
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
|
-
|
|
1789
|
-
|
|
1790
|
-
|
|
1791
|
-
|
|
1792
|
-
|
|
1793
|
-
|
|
1794
|
-
.
|
|
1795
|
-
|
|
1796
|
-
|
|
1797
|
-
|
|
1798
|
-
|
|
1799
|
-
|
|
1800
|
-
|
|
1801
|
-
.
|
|
1802
|
-
|
|
1803
|
-
|
|
1804
|
-
|
|
1805
|
-
|
|
1806
|
-
|
|
1807
|
-
|
|
1808
|
-
|
|
1809
|
-
|
|
1810
|
-
|
|
1811
|
-
|
|
1812
|
-
|
|
1813
|
-
|
|
1814
|
-
|
|
1815
|
-
|
|
1816
|
-
|
|
1817
|
-
|
|
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
|
|
1845
|
-
const
|
|
1846
|
-
const
|
|
1847
|
-
'
|
|
1848
|
-
|
|
1849
|
-
|
|
1850
|
-
const
|
|
1851
|
-
|
|
1852
|
-
|
|
1853
|
-
|
|
1854
|
-
|
|
1855
|
-
|
|
1856
|
-
|
|
1857
|
-
|
|
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(
|
|
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
|
|
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
|
|
1944
|
-
let
|
|
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('/'),
|
|
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 (
|
|
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[
|
|
1966
|
-
|
|
2649
|
+
...withSwaggerPage && !dependencies[packages.dependency] ? [
|
|
2650
|
+
`npm install ${packages.dependency}`
|
|
1967
2651
|
] : [],
|
|
1968
|
-
...withSwaggerPage && !dependencies[
|
|
1969
|
-
|
|
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 && !
|
|
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
|
-
...
|
|
1981
|
-
|
|
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 ?
|
|
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
|
|
2000
|
-
|
|
2001
|
-
|
|
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: '
|
|
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
|
|
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
|
|
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(
|
|
2842
|
+
default: generatedOpenapiPath ?? defaultOpenapiPath(),
|
|
2104
2843
|
validate: (value)=>value.trim() ? true : 'Path is required'
|
|
2105
2844
|
});
|
|
2106
|
-
const targets =
|
|
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 =
|
|
2870
|
+
const dataLayer = layer(target);
|
|
2129
2871
|
const sharedMutator = 'hooks' === target && withClient;
|
|
2130
|
-
const mutatorPath = sharedMutator ? `${external_node_path_default().posix.relative(dataLayer,
|
|
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,
|
|
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
|
-
|
|
2144
|
-
|
|
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
|
|
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(
|
|
2156
|
-
|
|
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
|
-
...
|
|
2172
|
-
`Wrap your app in QueryProvider from ${
|
|
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, {
|
|
2607
|
-
const
|
|
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
|
-
${
|
|
3380
|
+
${known ? '' : ' type Adapter,\n'} type EndpointGenerator,
|
|
2611
3381
|
createEndpoint,
|
|
2612
3382
|
invalidRequest
|
|
2613
3383
|
} from '@domain-first/handlers-rest'
|
|
2614
|
-
${
|
|
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
|
|
2640
|
-
const
|
|
2641
|
-
|
|
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 =
|
|
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 =
|
|
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
|
-
|
|
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 =
|
|
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 =
|
|
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 =
|
|
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
|
|
2677
|
-
|
|
2678
|
-
|
|
2679
|
-
}
|
|
2680
|
-
|
|
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
|
-
|
|
3465
|
+
adapter
|
|
2689
3466
|
});
|
|
2690
|
-
return
|
|
3467
|
+
return adapter ? scaffoldCatchAllRoute(root, adapter) : [];
|
|
2691
3468
|
});
|
|
2692
|
-
if (!
|
|
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
|
-
|
|
3473
|
+
packageName
|
|
2696
3474
|
]),
|
|
2697
3475
|
...routeNotes,
|
|
2698
3476
|
...generatorExisted ? [
|
|
2699
|
-
|
|
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
|
-
|
|
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
|
|
2711
|
-
const
|
|
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
|
|
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|
|
|
3520
|
+
stories: ['../**/*.mdx', '../**/*.stories.@(ts|svelte)'],
|
|
2720
3521
|
framework: {
|
|
2721
|
-
name: '${
|
|
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: [
|
|
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':
|
|
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
|
|
2746
|
-
|
|
2747
|
-
|
|
2748
|
-
|
|
2749
|
-
|
|
2750
|
-
|
|
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
|
|
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('\\', '/'),
|
|
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 (
|
|
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 ${
|
|
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 !==
|
|
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:
|
|
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
|
-
|
|
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
|
|
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 =
|
|
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 } =
|
|
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)=>
|
|
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 =
|
|
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 && !
|
|
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 =
|
|
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
|
|
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(
|
|
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` :
|
|
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)=>
|
|
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 } =
|
|
3427
|
-
return
|
|
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)=>
|
|
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 =
|
|
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:
|
|
4865
|
+
name: storybookTitle,
|
|
4113
4866
|
group: 'frontend',
|
|
4114
4867
|
run: storybook_addStorybook,
|
|
4115
|
-
applied: ()=>createdInRoot(
|
|
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
|
|
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
|
|
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
|
|
4364
|
-
|
|
4365
|
-
|
|
4366
|
-
|
|
4367
|
-
|
|
4368
|
-
|
|
4369
|
-
|
|
4370
|
-
|
|
4371
|
-
|
|
4372
|
-
|
|
4373
|
-
|
|
4374
|
-
|
|
4375
|
-
|
|
4376
|
-
|
|
4377
|
-
|
|
4378
|
-
|
|
4379
|
-
|
|
4380
|
-
|
|
4381
|
-
|
|
4382
|
-
|
|
4383
|
-
|
|
4384
|
-
|
|
4385
|
-
|
|
4386
|
-
|
|
4387
|
-
|
|
4388
|
-
|
|
4389
|
-
|
|
4390
|
-
|
|
4391
|
-
|
|
4392
|
-
|
|
4393
|
-
|
|
4394
|
-
|
|
4395
|
-
|
|
4396
|
-
|
|
4397
|
-
|
|
4398
|
-
|
|
4399
|
-
|
|
4400
|
-
|
|
4401
|
-
|
|
4402
|
-
|
|
4403
|
-
|
|
4404
|
-
|
|
4405
|
-
|
|
4406
|
-
|
|
4407
|
-
|
|
4408
|
-
|
|
4409
|
-
|
|
4410
|
-
|
|
4411
|
-
|
|
4412
|
-
|
|
4413
|
-
|
|
4414
|
-
|
|
4415
|
-
|
|
4416
|
-
|
|
4417
|
-
|
|
4418
|
-
|
|
4419
|
-
|
|
4420
|
-
|
|
4421
|
-
|
|
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
|
-
|
|
4675
|
-
|
|
4676
|
-
|
|
4677
|
-
|
|
4678
|
-
|
|
4679
|
-
|
|
4680
|
-
|
|
4681
|
-
|
|
4682
|
-
|
|
4683
|
-
|
|
4684
|
-
|
|
4685
|
-
|
|
4686
|
-
|
|
4687
|
-
|
|
4688
|
-
|
|
4689
|
-
|
|
4690
|
-
|
|
4691
|
-
|
|
4692
|
-
|
|
4693
|
-
|
|
4694
|
-
|
|
4695
|
-
|
|
4696
|
-
|
|
4697
|
-
|
|
4698
|
-
|
|
4699
|
-
|
|
4700
|
-
|
|
4701
|
-
const
|
|
4702
|
-
|
|
4703
|
-
|
|
4704
|
-
|
|
4705
|
-
|
|
4706
|
-
|
|
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(
|
|
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(`── ${
|
|
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
|
|
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
|
|
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
|
|
4809
|
-
const
|
|
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
|
|
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(
|
|
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(`── ${
|
|
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
|
-
...
|
|
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
|
-
|
|
4943
|
-
|
|
4944
|
-
const
|
|
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,
|
|
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
|
|
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
|
|
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:
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
|
6507
|
-
|
|
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 (
|
|
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
|
-
|
|
6628
|
-
|
|
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
|
-
|
|
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
|
-
|
|
6648
|
-
|
|
6649
|
-
|
|
6650
|
-
|
|
6651
|
-
|
|
6652
|
-
|
|
6653
|
-
|
|
6654
|
-
|
|
6655
|
-
|
|
6656
|
-
|
|
6657
|
-
|
|
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
|
-
|
|
7291
|
+
framework
|
|
6668
7292
|
]);
|
|
6669
|
-
const
|
|
7293
|
+
const operation = await (0, prompts_namespaceObject.select)({
|
|
6670
7294
|
message: 'Module: ',
|
|
6671
|
-
choices: [
|
|
6672
|
-
|
|
6673
|
-
|
|
6674
|
-
|
|
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
|
-
|
|
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
|
-
|
|
6720
|
-
|
|
6721
|
-
|
|
6722
|
-
|
|
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
|