@forgewp/compiler 0.4.3 → 0.4.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (133) hide show
  1. package/README.md +59 -0
  2. package/bin/add.js +20 -14
  3. package/bin/cli.js +145 -70
  4. package/bin/doctor.js +21 -12
  5. package/bin/export.js +69 -20
  6. package/bin/fresh.js +5 -0
  7. package/bin/i18n-extract.js +3 -10
  8. package/bin/i18n-translate.js +15 -24
  9. package/bin/make-block.js +13 -0
  10. package/bin/make-editable.js +166 -0
  11. package/bin/make-form.js +131 -0
  12. package/bin/make-loop.js +40 -43
  13. package/bin/make-mail.js +27 -0
  14. package/bin/make-post-type.js +57 -29
  15. package/bin/make-sandbox.js +62 -11
  16. package/bin/make-section.js +221 -0
  17. package/bin/make-shell.js +375 -0
  18. package/bin/repair.js +14 -26
  19. package/bin/seed.js +119 -0
  20. package/bin/sync-routes.js +107 -85
  21. package/lib/adapters/html-adapter.js +5 -0
  22. package/lib/adapters/stub-adapter.js +4 -0
  23. package/lib/add-component.js +153 -92
  24. package/lib/asset-loader.js +313 -3
  25. package/lib/assets/asset-graph.js +432 -0
  26. package/lib/assets/asset-pipeline.js +125 -0
  27. package/lib/assets/diagnostics-report.js +345 -0
  28. package/lib/assets/external-fetcher.js +173 -0
  29. package/lib/assets/font-orchestrator.js +348 -0
  30. package/lib/assets/font-usage-scanner.js +242 -0
  31. package/lib/assets/image-optimizer.js +229 -0
  32. package/lib/assets/index.js +51 -0
  33. package/lib/assets/preload-generator.js +70 -0
  34. package/lib/assets/public-url.js +153 -0
  35. package/lib/block-authoring-help.js +11 -0
  36. package/lib/blocks/ast-parser.js +67 -0
  37. package/lib/blocks/discover-blocks.js +146 -0
  38. package/lib/blocks/editor-scope.js +733 -0
  39. package/lib/blocks/editor-transpiler.js +1229 -0
  40. package/lib/blocks/index.js +2838 -0
  41. package/lib/blocks/php-transpiler.js +4928 -0
  42. package/lib/blocks/scanner.js +1487 -0
  43. package/lib/blocks/shared-utils.js +290 -0
  44. package/lib/blocks/source-sanitize.js +1449 -0
  45. package/lib/blueprints.js +31 -91
  46. package/lib/build-assets.js +38 -33
  47. package/lib/collect-page-template-routes.js +102 -0
  48. package/lib/collect-static-routes.js +175 -0
  49. package/lib/diagnostics.js +58 -33
  50. package/lib/export-theme.js +84 -5
  51. package/lib/extract-template-content.js +90 -0
  52. package/lib/forms-preview.js +42 -0
  53. package/lib/functions/cpt-routing.js +69 -0
  54. package/lib/functions/forms.js +2461 -0
  55. package/lib/functions/hydration-enqueuer.js +400 -0
  56. package/lib/functions/index.js +1623 -0
  57. package/lib/functions/load-menus.js +112 -0
  58. package/lib/functions/load-translations.js +148 -0
  59. package/lib/functions/rest-endpoints.js +2923 -0
  60. package/lib/functions/routing.js +765 -0
  61. package/lib/functions/seed-mock-data.js +392 -0
  62. package/lib/functions/seed-products.js +481 -0
  63. package/lib/functions/settings-page.js +273 -0
  64. package/lib/functions/theme-setup.js +494 -0
  65. package/lib/generate-theme.js +1916 -339
  66. package/lib/hydration/editable-schemas.js +332 -0
  67. package/lib/hydration/enter-hidden-initial.js +65 -0
  68. package/lib/hydration/form-schemas.js +227 -0
  69. package/lib/hydration/index.js +12 -0
  70. package/lib/hydration/is-interactive.js +951 -0
  71. package/lib/hydration/island-split.js +1231 -0
  72. package/lib/hydration/islands-scanner.js +599 -0
  73. package/lib/hydration/resolve-island-chunk.js +103 -0
  74. package/lib/hydration/resolve-island-component.js +52 -0
  75. package/lib/hydration/rollup-inputs.js +81 -0
  76. package/lib/hydration/root-class-extractor.js +220 -0
  77. package/lib/hydration/scan-app-providers.js +154 -0
  78. package/lib/hydration/static-lint.js +382 -0
  79. package/lib/hydration/transform.js +257 -0
  80. package/lib/hydration/uses-block-area.js +49 -0
  81. package/lib/hydration/utils.js +119 -0
  82. package/lib/i18n/translation-cache.js +141 -0
  83. package/lib/icon-registry.js +72 -0
  84. package/lib/index.d.ts +287 -8
  85. package/lib/index.js +2 -1
  86. package/lib/load-config.js +338 -242
  87. package/lib/mail-templates.js +37 -0
  88. package/lib/markup-processor.js +388 -102
  89. package/lib/node-runtime.js +7 -0
  90. package/lib/page-config-plugin.js +64 -20
  91. package/lib/php-builders.js +383 -44
  92. package/lib/react-adapter.js +983 -235
  93. package/lib/registration-metadata.js +11 -0
  94. package/lib/render-theme.mts +1410 -616
  95. package/lib/route-layout.js +76 -0
  96. package/lib/template-discovery.js +58 -0
  97. package/lib/theme-compatibility.js +32 -0
  98. package/lib/validate-export.js +2 -2
  99. package/lib/validate.js +27 -5
  100. package/lib/virtual-plugin.js +319 -0
  101. package/lib/walkthrough.md +26 -0
  102. package/package.json +16 -5
  103. package/templates/auth/cms/email-logs.json +9 -0
  104. package/templates/auth/cms/menus.json +11 -0
  105. package/templates/auth/cms/mock-data.json +123 -0
  106. package/templates/auth/cms/roles.json +7 -0
  107. package/templates/auth/cms/sessions.json +1 -0
  108. package/templates/auth/cms/site-settings.json +28 -0
  109. package/templates/auth/cms/translations.json +4 -0
  110. package/templates/auth/cms/users.json +46 -0
  111. package/templates/auth/components/forgot-password-form-wrapper.tsx +10 -2
  112. package/templates/auth/components/login-form-wrapper.tsx +118 -21
  113. package/templates/auth/components/reset-password-form-wrapper.tsx +10 -2
  114. package/templates/auth/components/signup-form-wrapper.tsx +2 -2
  115. package/templates/auth/components/verify-email-view-wrapper.tsx +5 -5
  116. package/templates/auth/pages/DashboardPage.tsx +1 -4
  117. package/templates/auth/pages/ForgotPasswordPage.tsx +1 -4
  118. package/templates/auth/pages/LoginPage.tsx +1 -4
  119. package/templates/auth/pages/ResetPasswordPage.tsx +1 -4
  120. package/templates/auth/pages/SignUpPage.tsx +1 -4
  121. package/templates/auth/pages/VerifyEmailPage.tsx +1 -4
  122. package/templates/auth/ui/button.tsx +57 -0
  123. package/templates/auth/ui/card.tsx +76 -0
  124. package/templates/auth/ui/field.tsx +242 -0
  125. package/templates/auth/ui/input.tsx +22 -0
  126. package/templates/auth/ui/label.tsx +24 -0
  127. package/templates/auth/ui/separator.tsx +31 -0
  128. package/templates/menus.json +12 -10
  129. package/templates/users.json +8 -4
  130. package/templates/wordpress.tsx +690 -245
  131. package/lib/block-compiler.js +0 -552
  132. package/lib/functions-builder.js +0 -2970
  133. package/lib/hydration-scanner.js +0 -833
@@ -1,113 +1,131 @@
1
1
  #!/usr/bin/env node
2
2
 
3
- import { existsSync, readFileSync, writeFileSync, mkdirSync } from "node:fs";
4
- import path from "node:path";
5
- import pc from "picocolors";
6
- import { loadConfig } from "../lib/load-config.js";
7
- import { loadFrameworkAdapter } from "../lib/framework-adapter.js";
3
+ import { existsSync, writeFileSync, mkdirSync } from 'node:fs';
4
+ import path from 'node:path';
5
+ import pc from 'picocolors';
6
+ import { loadConfig } from '../lib/load-config.js';
7
+ import { loadFrameworkAdapter } from '../lib/framework-adapter.js';
8
+ import { loadMenusData } from '../lib/functions/load-menus.js';
8
9
 
9
- console.log(`\n⚡ ${pc.bold(pc.bgCyan(pc.black(" FORGEWP SITEMAP COMPILER (SYNC:ROUTES) ")))}\n`);
10
+ console.log(
11
+ `\n⚡ ${pc.bold(pc.bgCyan(pc.black(' FORGEWP SITEMAP COMPILER (SYNC:ROUTES) ')))}\n`,
12
+ );
10
13
 
11
14
  const projectRoot = process.cwd();
12
15
  const args = process.argv.slice(2);
13
- const isForce = args.includes("--force") || args.includes("--override");
14
-
15
- // 1. Locate menus configuration file
16
- let menusPath = path.join(projectRoot, "cms", "menus.json");
17
- let menus = null;
18
-
19
- if (!existsSync(menusPath)) {
20
- // Try fallback in mock-data.json
21
- const mockDataPath = path.join(projectRoot, "cms", "mock-data.json");
22
- if (existsSync(mockDataPath)) {
23
- try {
24
- const mockData = JSON.parse(readFileSync(mockDataPath, "utf8"));
25
- if (mockData.menu) {
26
- menus = mockData.menu;
27
- console.log(` ℹ️ Using legacy menus block inside: cms/mock-data.json`);
28
- }
29
- } catch (e) {
30
- // Ignored
31
- }
32
- }
33
- if (!menus) {
34
- menus = {
35
- _comment: "⚡ ForgeWP Navigation Menus — Edit this file to add/remove links in local dev. Run 'pnpm forgewp sync:routes' to auto-scaffold corresponding React pages!",
36
- primary: [
37
- { title: "Home", url: "/" },
38
- { title: "New", url: "/new" },
39
- { title: "Men", url: "/men" },
40
- { title: "Women", url: "/women" }
41
- ],
42
- utility: [
43
- { title: "Help", url: "/help" },
44
- { title: "Sign In", url: "/login" }
45
- ]
46
- };
47
-
48
- const dir = path.dirname(menusPath);
49
- if (!existsSync(dir)) {
50
- mkdirSync(dir, { recursive: true });
51
- }
52
- writeFileSync(menusPath, JSON.stringify(menus, null, 2), "utf8");
53
- console.log(` 🎉 ${pc.green("Created dedicated sitemap source")}: cms/menus.json`);
16
+ const isForce = args.includes('--force') || args.includes('--override');
17
+
18
+ // 1. Locate menus configuration file (cms/menus.ts preferred, cms/menus.json fallback)
19
+ const menusTsPath = path.join(projectRoot, 'cms', 'menus.ts');
20
+ const menusPath = path.join(projectRoot, 'cms', 'menus.json');
21
+ let menus = loadMenusData(projectRoot);
22
+
23
+ const hasMenuLocations = Object.keys(menus).some(
24
+ (k) => !k.startsWith('_') && Array.isArray(menus[k]),
25
+ );
26
+
27
+ if (hasMenuLocations) {
28
+ if (existsSync(menusTsPath)) {
29
+ console.log(` 📖 ${pc.green('Loaded sitemap source')}: cms/menus.ts`);
30
+ } else {
31
+ console.log(` 📖 ${pc.green('Loaded sitemap source')}: cms/menus.json`);
54
32
  }
55
33
  } else {
56
- try {
57
- menus = JSON.parse(readFileSync(menusPath, "utf8"));
58
- console.log(` 📖 ${pc.green("Loaded sitemap source")}: cms/menus.json`);
59
- } catch (err) {
60
- console.error(pc.red(`\n❌ Error: Failed to parse cms/menus.json.\nReason: ${err.message}`));
61
- process.exit(1);
34
+ menus = {
35
+ _comment:
36
+ "⚡ ForgeWP Navigation Menus — Edit this file to add/remove links in local dev. Run 'pnpm forgewp sync:routes' to auto-scaffold corresponding React pages!",
37
+ primary: [
38
+ { title: 'Home', url: '/' },
39
+ { title: 'New', url: '/new' },
40
+ { title: 'Men', url: '/men' },
41
+ { title: 'Women', url: '/women' },
42
+ ],
43
+ utility: [
44
+ { title: 'Help', url: '/help' },
45
+ { title: 'Sign In', url: '/login' },
46
+ ],
47
+ };
48
+
49
+ const dir = path.dirname(menusPath);
50
+ if (!existsSync(dir)) {
51
+ mkdirSync(dir, { recursive: true });
62
52
  }
53
+ writeFileSync(menusPath, JSON.stringify(menus, null, 2), 'utf8');
54
+ console.log(
55
+ ` 🎉 ${pc.green('Created dedicated sitemap source')}: cms/menus.json`,
56
+ );
63
57
  }
64
58
 
65
- // 2. Extract unique local paths and sanitize them
59
+ // 2. Extract unique local paths and sanitize them recursively
66
60
  const routesToScaffold = [];
67
- const seenUrls = new Set(["/", ""]);
61
+ const seenUrls = new Set(['/', '']);
68
62
 
69
- for (const [location, items] of Object.entries(menus)) {
70
- if (!Array.isArray(items)) continue;
63
+ function extractRoutesFromItems(items) {
64
+ if (!Array.isArray(items)) return;
71
65
  for (const item of items) {
72
- if (!item.url || typeof item.url !== "string") continue;
73
- let url = item.url.trim();
74
-
75
- // Skip external, anchors, mailto, etc.
76
- if (
77
- url.startsWith("http://") ||
78
- url.startsWith("https://") ||
79
- url.startsWith("#") ||
80
- url.startsWith("mailto:") ||
81
- url.startsWith("tel:")
82
- ) {
83
- continue;
84
- }
66
+ if (item && item.url && typeof item.url === 'string') {
67
+ let url = item.url.trim();
68
+
69
+ // Skip external, anchors, mailto, etc.
70
+ if (
71
+ !url.startsWith('http://') &&
72
+ !url.startsWith('https://') &&
73
+ !url.startsWith('#') &&
74
+ !url.startsWith('mailto:') &&
75
+ !url.startsWith('tel:')
76
+ ) {
77
+ // Menu fragments navigate within an existing page; they are not pages
78
+ // that should be scaffolded by route synchronization.
79
+ url = url.split(/[?#]/)[0] || '/';
80
+
81
+ // Normalize starting slash
82
+ if (!url.startsWith('/')) {
83
+ url = '/' + url;
84
+ }
85
85
 
86
- // Normalize starting slash
87
- if (!url.startsWith("/")) {
88
- url = "/" + url;
86
+ if (url === '/') {
87
+ if (item && Array.isArray(item.children)) {
88
+ extractRoutesFromItems(item.children);
89
+ }
90
+ continue;
91
+ }
92
+
93
+ if (!seenUrls.has(url)) {
94
+ seenUrls.add(url);
95
+ routesToScaffold.push({
96
+ path: url,
97
+ title: item.title || url.replace('/', ''),
98
+ });
99
+ }
100
+ }
89
101
  }
90
102
 
91
- if (seenUrls.has(url)) continue;
92
- seenUrls.add(url);
103
+ if (item && Array.isArray(item.children)) {
104
+ extractRoutesFromItems(item.children);
105
+ }
106
+ }
107
+ }
93
108
 
94
- routesToScaffold.push({
95
- path: url,
96
- title: item.title || url.replace("/", "")
97
- });
109
+ for (const [location, items] of Object.entries(menus)) {
110
+ if (!location.startsWith('_')) {
111
+ extractRoutesFromItems(items);
98
112
  }
99
113
  }
100
114
 
101
115
  if (routesToScaffold.length === 0) {
102
- console.log(pc.yellow(`\nℹ️ No local pages to synchronize inside your sitemap menu config.`));
116
+ console.log(
117
+ pc.yellow(
118
+ `\nℹ️ No local pages to synchronize inside your sitemap menu config.`,
119
+ ),
120
+ );
103
121
  process.exit(0);
104
122
  }
105
123
 
106
124
  // Load configuration and invoke adapter
107
- let frameworkAdapter = "react";
125
+ let frameworkAdapter = 'react';
108
126
  try {
109
127
  const config = await loadConfig(projectRoot);
110
- frameworkAdapter = config.frameworkAdapter || "react";
128
+ frameworkAdapter = config.frameworkAdapter || 'react';
111
129
  } catch (err) {
112
130
  // Use default
113
131
  }
@@ -115,14 +133,18 @@ try {
115
133
  try {
116
134
  const adapterModule = await loadFrameworkAdapter(frameworkAdapter);
117
135
  const adapter = adapterModule.default || adapterModule;
118
- if (typeof adapter.onSyncRoutes === "function") {
136
+ if (typeof adapter.onSyncRoutes === 'function') {
119
137
  await adapter.onSyncRoutes(projectRoot, {
120
138
  routesToScaffold,
121
139
  isForce,
122
- pc
140
+ pc,
123
141
  });
124
142
  } else {
125
- console.log(pc.yellow(` ⚠️ No sync:routes hook implemented for framework adapter: ${frameworkAdapter}`));
143
+ console.log(
144
+ pc.yellow(
145
+ ` ⚠️ No sync:routes hook implemented for framework adapter: ${frameworkAdapter}`,
146
+ ),
147
+ );
126
148
  }
127
149
  } catch (err) {
128
150
  console.error(pc.red(`\n❌ Failed to execute sync:routes: ${err.message}`));
@@ -55,6 +55,11 @@ export function onMakeBlock(themeRoot, { pascalCase, pc }) {
55
55
  console.log(` Block "${pascalCase}" was not created.\n`);
56
56
  }
57
57
 
58
+ export function onMakeShell(themeRoot, { pascalCase, pc }) {
59
+ console.log(pc.yellow(`\n⚠️ The Static HTML framework adapter does not support parent shell blocks.`));
60
+ console.log(` Shell "${pascalCase}" was not created.\n`);
61
+ }
62
+
58
63
  export function onMakeLoop(themeRoot, { pascalCase, pc }) {
59
64
  console.log(pc.yellow(`\n⚠️ The Static HTML framework adapter does not support custom loops.`));
60
65
  console.log(` Loop "${pascalCase}" was not created.\n`);
@@ -40,6 +40,10 @@ export function onMakeBlock(themeRoot, { pascalCase, pc }) {
40
40
  console.log(pc.yellow(`\n⚠️ The Stub framework adapter does not support custom Gutenberg blocks.`));
41
41
  }
42
42
 
43
+ export function onMakeShell(themeRoot, { pascalCase, pc }) {
44
+ console.log(pc.yellow(`\n⚠️ The Stub framework adapter does not support parent shell blocks.`));
45
+ }
46
+
43
47
  export function onMakeLoop(themeRoot, { pascalCase, pc }) {
44
48
  console.log(pc.yellow(`\n⚠️ The Stub framework adapter does not support custom loops.`));
45
49
  }