@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
@@ -0,0 +1,112 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { parseSource, traverse } from '../blocks/ast-parser.js';
4
+
5
+ /**
6
+ * Converts a Babel AST literal/object/array node to a JS value.
7
+ * Unwraps defineWpMenus({...}) (and other) call wrappers.
8
+ */
9
+ function astToValue(node) {
10
+ if (!node) return null;
11
+ switch (node.type) {
12
+ case 'StringLiteral':
13
+ return node.value;
14
+ case 'NumericLiteral':
15
+ return node.value;
16
+ case 'BooleanLiteral':
17
+ return node.value;
18
+ case 'NullLiteral':
19
+ return null;
20
+ case 'ArrayExpression':
21
+ return node.elements.map((el) => astToValue(el));
22
+ case 'ObjectExpression': {
23
+ const obj = {};
24
+ for (const prop of node.properties) {
25
+ if (prop.type === 'ObjectProperty') {
26
+ const key = prop.key.name || prop.key.value;
27
+ obj[key] = astToValue(prop.value);
28
+ }
29
+ }
30
+ return obj;
31
+ }
32
+ case 'UnaryExpression': {
33
+ if (node.operator === '-' && node.argument?.type === 'NumericLiteral') {
34
+ return -node.argument.value;
35
+ }
36
+ return null;
37
+ }
38
+ case 'CallExpression': {
39
+ // Handles defineWpMenus({...}) wrapper
40
+ if (node.arguments && node.arguments[0]) {
41
+ return astToValue(node.arguments[0]);
42
+ }
43
+ return null;
44
+ }
45
+ case 'TSAsExpression':
46
+ case 'TSSatisfiesExpression':
47
+ case 'TSTypeAssertion':
48
+ case 'TSNonNullExpression':
49
+ return astToValue(node.expression);
50
+ default:
51
+ return null;
52
+ }
53
+ }
54
+
55
+ function isMenuMap(value) {
56
+ return value && typeof value === 'object' && !Array.isArray(value);
57
+ }
58
+
59
+ /**
60
+ * Loads navigation menus from cms/menus.ts (preferred) or cms/menus.json.
61
+ * Matches the dual-resolution used for products/mock-data.
62
+ *
63
+ * @param {string} themeRoot
64
+ * @returns {Record<string, Array<any>>}
65
+ */
66
+ export function loadMenusData(themeRoot) {
67
+ const tsPath = path.join(themeRoot, 'cms', 'menus.ts');
68
+ const jsonPath = path.join(themeRoot, 'cms', 'menus.json');
69
+
70
+ if (fs.existsSync(tsPath)) {
71
+ try {
72
+ const code = fs.readFileSync(tsPath, 'utf8');
73
+ const ast = parseSource(code);
74
+ let extracted = null;
75
+
76
+ traverse(ast, {
77
+ ExportNamedDeclaration(astPath) {
78
+ const decl = astPath.node.declaration;
79
+ if (decl && decl.declarations) {
80
+ for (const d of decl.declarations) {
81
+ if (d.id?.name === 'menus' && d.init) {
82
+ extracted = astToValue(d.init);
83
+ }
84
+ }
85
+ }
86
+ },
87
+ ExportDefaultDeclaration(astPath) {
88
+ if (!extracted && astPath.node.declaration) {
89
+ extracted = astToValue(astPath.node.declaration);
90
+ }
91
+ },
92
+ });
93
+
94
+ if (isMenuMap(extracted)) return extracted;
95
+ if (extracted && isMenuMap(extracted.menus)) return extracted.menus;
96
+ } catch (e) {
97
+ console.warn(`⚠️ [ForgeWP Menus] Could not load ${tsPath}: ${e.message}`);
98
+ }
99
+ }
100
+
101
+ if (fs.existsSync(jsonPath)) {
102
+ try {
103
+ const raw = JSON.parse(fs.readFileSync(jsonPath, 'utf8'));
104
+ if (isMenuMap(raw)) return raw;
105
+ if (raw && isMenuMap(raw.menus)) return raw.menus;
106
+ } catch (e) {
107
+ console.warn(`⚠️ [ForgeWP Menus] Could not parse ${jsonPath}: ${e.message}`);
108
+ }
109
+ }
110
+
111
+ return {};
112
+ }
@@ -0,0 +1,148 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { parseSource, traverse } from '../blocks/ast-parser.js';
4
+
5
+ /**
6
+ * Converts a Babel AST literal/object/array node to a JS value.
7
+ * Unwraps defineTranslations({...}) (and other) call wrappers.
8
+ */
9
+ function astToValue(node) {
10
+ if (!node) return null;
11
+ switch (node.type) {
12
+ case 'StringLiteral':
13
+ return node.value;
14
+ case 'NumericLiteral':
15
+ return node.value;
16
+ case 'BooleanLiteral':
17
+ return node.value;
18
+ case 'NullLiteral':
19
+ return null;
20
+ case 'ArrayExpression':
21
+ return node.elements.map((el) => astToValue(el));
22
+ case 'ObjectExpression': {
23
+ const obj = {};
24
+ for (const prop of node.properties) {
25
+ if (prop.type === 'ObjectProperty') {
26
+ const key = prop.key.name || prop.key.value;
27
+ obj[key] = astToValue(prop.value);
28
+ }
29
+ }
30
+ return obj;
31
+ }
32
+ case 'UnaryExpression': {
33
+ if (node.operator === '-' && node.argument?.type === 'NumericLiteral') {
34
+ return -node.argument.value;
35
+ }
36
+ return null;
37
+ }
38
+ case 'CallExpression': {
39
+ if (node.arguments && node.arguments[0]) {
40
+ return astToValue(node.arguments[0]);
41
+ }
42
+ return null;
43
+ }
44
+ case 'TSAsExpression':
45
+ case 'TSSatisfiesExpression':
46
+ case 'TSTypeAssertion':
47
+ case 'TSNonNullExpression':
48
+ return astToValue(node.expression);
49
+ default:
50
+ return null;
51
+ }
52
+ }
53
+
54
+ function isLocaleMap(value) {
55
+ return value && typeof value === 'object' && !Array.isArray(value);
56
+ }
57
+
58
+ export function translationsSourcePath(themeRoot) {
59
+ const tsPath = path.join(themeRoot, 'cms', 'translations.ts');
60
+ const jsonPath = path.join(themeRoot, 'cms', 'translations.json');
61
+ if (fs.existsSync(tsPath)) return tsPath;
62
+ if (fs.existsSync(jsonPath)) return jsonPath;
63
+ return null;
64
+ }
65
+
66
+ /**
67
+ * Loads i18n dictionaries from cms/translations.ts (preferred) or cms/translations.json.
68
+ *
69
+ * @param {string} themeRoot
70
+ * @returns {Record<string, Record<string, string>>}
71
+ */
72
+ export function loadTranslationsData(themeRoot) {
73
+ const tsPath = path.join(themeRoot, 'cms', 'translations.ts');
74
+ const jsonPath = path.join(themeRoot, 'cms', 'translations.json');
75
+
76
+ if (fs.existsSync(tsPath)) {
77
+ try {
78
+ const code = fs.readFileSync(tsPath, 'utf8');
79
+ const ast = parseSource(code);
80
+ let extracted = null;
81
+
82
+ traverse(ast, {
83
+ ExportNamedDeclaration(astPath) {
84
+ const decl = astPath.node.declaration;
85
+ if (decl && decl.declarations) {
86
+ for (const d of decl.declarations) {
87
+ if (d.id?.name === 'translations' && d.init) {
88
+ extracted = astToValue(d.init);
89
+ }
90
+ }
91
+ }
92
+ },
93
+ ExportDefaultDeclaration(astPath) {
94
+ if (!extracted && astPath.node.declaration) {
95
+ extracted = astToValue(astPath.node.declaration);
96
+ }
97
+ },
98
+ });
99
+
100
+ if (isLocaleMap(extracted)) return extracted;
101
+ if (extracted && isLocaleMap(extracted.translations)) return extracted.translations;
102
+ } catch (e) {
103
+ console.warn(`⚠️ [ForgeWP i18n] Could not load ${tsPath}: ${e.message}`);
104
+ }
105
+ }
106
+
107
+ if (fs.existsSync(jsonPath)) {
108
+ try {
109
+ const raw = JSON.parse(fs.readFileSync(jsonPath, 'utf8'));
110
+ if (isLocaleMap(raw)) return raw;
111
+ } catch (e) {
112
+ console.warn(`⚠️ [ForgeWP i18n] Could not parse ${jsonPath}: ${e.message}`);
113
+ }
114
+ }
115
+
116
+ return {};
117
+ }
118
+
119
+ /**
120
+ * Writes translations back to cms/translations.ts when that file exists,
121
+ * otherwise to cms/translations.json. Creates translations.ts when neither exists.
122
+ *
123
+ * @param {string} themeRoot
124
+ * @param {Record<string, Record<string, string>>} translations
125
+ * @returns {string} absolute path written
126
+ */
127
+ export function writeTranslationsData(themeRoot, translations) {
128
+ const cmsDir = path.join(themeRoot, 'cms');
129
+ if (!fs.existsSync(cmsDir)) {
130
+ fs.mkdirSync(cmsDir, { recursive: true });
131
+ }
132
+
133
+ const tsPath = path.join(cmsDir, 'translations.ts');
134
+ const jsonPath = path.join(cmsDir, 'translations.json');
135
+ const body = JSON.stringify(translations, null, 2);
136
+
137
+ if (fs.existsSync(tsPath) || !fs.existsSync(jsonPath)) {
138
+ const content =
139
+ `import { defineTranslations } from '@forgewp/react';\n\n` +
140
+ `export const translations = defineTranslations(${body});\n\n` +
141
+ `export default translations;\n`;
142
+ fs.writeFileSync(tsPath, content, 'utf8');
143
+ return tsPath;
144
+ }
145
+
146
+ fs.writeFileSync(jsonPath, body, 'utf8');
147
+ return jsonPath;
148
+ }