slicejs-cli 3.3.0 → 3.4.1

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 (46) hide show
  1. package/AGENTS.md +247 -0
  2. package/LICENSE +21 -21
  3. package/client.js +663 -626
  4. package/commands/Print.js +163 -167
  5. package/commands/Validations.js +92 -103
  6. package/commands/build/build.js +40 -40
  7. package/commands/buildProduction/buildProduction.js +576 -579
  8. package/commands/bundle/bundle.js +234 -235
  9. package/commands/createComponent/VisualComponentTemplate.js +55 -55
  10. package/commands/createComponent/createComponent.js +124 -126
  11. package/commands/deleteComponent/deleteComponent.js +77 -77
  12. package/commands/doctor/doctor.js +366 -369
  13. package/commands/getComponent/getComponent.js +684 -747
  14. package/commands/init/init.js +269 -261
  15. package/commands/listComponents/listComponents.js +172 -175
  16. package/commands/startServer/startServer.js +261 -264
  17. package/commands/startServer/watchServer.js +79 -79
  18. package/commands/types/types.js +69 -27
  19. package/commands/utils/LocalCliDelegation.js +53 -53
  20. package/commands/utils/PathHelper.js +75 -68
  21. package/commands/utils/VersionChecker.js +167 -167
  22. package/commands/utils/bundling/BundleGenerator.js +2292 -2292
  23. package/commands/utils/bundling/DependencyAnalyzer.js +925 -933
  24. package/commands/utils/loadConfig.js +31 -0
  25. package/commands/utils/updateManager.js +452 -453
  26. package/docs/superpowers/specs/2026-05-10-pwa-generate-design.md +105 -105
  27. package/package.json +58 -46
  28. package/post.js +66 -65
  29. package/tests/bundle-generator.test.js +691 -708
  30. package/tests/bundle-v2-register-output.test.js +470 -470
  31. package/tests/client-launcher-contract.test.js +211 -211
  32. package/tests/client-update-flow-contract.test.js +272 -272
  33. package/tests/component-registry-parse.test.js +34 -0
  34. package/tests/dependency-analyzer.test.js +24 -24
  35. package/tests/fixtures/components.js +8 -0
  36. package/tests/fixtures/sliceConfig.json +74 -0
  37. package/tests/getcomponent.test.js +407 -0
  38. package/tests/helpers/setup.js +97 -0
  39. package/tests/init-command-contract.test.js +46 -0
  40. package/tests/local-cli-delegation.test.js +81 -79
  41. package/tests/path-helper.test.js +206 -0
  42. package/tests/types-breakage.test.js +491 -0
  43. package/tests/types-generator-errors.test.js +361 -0
  44. package/tests/types-generator.test.js +172 -184
  45. package/tests/update-manager-notifications.test.js +88 -88
  46. package/.github/workflows/docs-render-cicd.yml +0 -65
package/commands/Print.js CHANGED
@@ -1,168 +1,164 @@
1
- import chalk from 'chalk';
2
-
3
- export default class Print {
4
- constructor() { }
5
-
6
- static error(message) {
7
- console.error(chalk.red(`❌ Error: ${message}`));
8
- }
9
-
10
- static success(message) {
11
- console.log(chalk.green(`✅ Success: ${message}`));
12
- }
13
-
14
- static warning(message) {
15
- console.log(chalk.yellow(`⚠️ Warning: ${message}`));
16
- }
17
-
18
- static info(message) {
19
- console.log(chalk.cyan(`ℹ️ Info: ${message}`));
20
- }
21
-
22
- static title(message) {
23
- console.log(chalk.magenta.bold(`🎯 ${message}`));
24
- }
25
-
26
- static subtitle(message) {
27
- console.log(chalk.blue(`📋 ${message}`));
28
- }
29
-
30
- static step(stepNumber, message) {
31
- console.log(chalk.cyan(`${stepNumber}. ${message}`));
32
- }
33
-
34
- static highlight(message) {
35
- console.log(chalk.bgYellow.black(` ${message} `));
36
- }
37
-
38
- static newLine() {
39
- console.log('');
40
- }
41
-
42
- static separator() {
43
- console.log(chalk.gray('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
44
- }
45
-
46
- // Métodos para el contexto específico del CLI
47
- static componentSuccess(componentName, action = 'processed') {
48
- console.log(chalk.green(`✅ ${componentName} ${action} successfully!`));
49
- }
50
-
51
- static componentError(componentName, action = 'processing', error) {
52
- console.error(chalk.red(`❌ Error ${action} ${componentName}: ${error}`));
53
- }
54
-
55
- static downloadProgress(fileName) {
56
- console.log(chalk.cyan(` 📥 Downloading ${fileName}...`));
57
- }
58
-
59
- static downloadSuccess(fileName) {
60
- console.log(chalk.green(` ${fileName}`));
61
- }
62
-
63
- static downloadError(fileName, error) {
64
- console.error(chalk.red(` ❌ Error downloading ${fileName}: ${error}`));
65
- }
66
-
67
- static registryUpdate(message) {
68
- console.log(chalk.magenta(`📝 Registry: ${message}`));
69
- }
70
-
71
- static versionInfo(component, currentVersion, latestVersion = null) {
72
- if (latestVersion && currentVersion !== latestVersion) {
73
- console.log(chalk.yellow(`🔄 ${component}: v${currentVersion} → v${latestVersion}`));
74
- } else {
75
- console.log(chalk.green(`✅ ${component}: v${currentVersion}`));
76
- }
77
- }
78
-
79
- static commandExample(description, command) {
80
- console.log(chalk.gray(`💡 ${description}:`));
81
- console.log(chalk.white(` ${command}`));
82
- }
83
-
84
- static summary(successful, failed, total) {
85
- Print.separator();
86
- console.log(chalk.bold('📊 Summary:'));
87
- if (successful > 0) {
88
- Print.success(`Successful: ${successful}/${total}`);
89
- }
90
- if (failed > 0) {
91
- Print.error(`Failed: ${failed}/${total}`);
92
- }
93
- Print.separator();
94
- }
95
-
96
- // Método para mostrar resultados de minificación
97
- static minificationResult(filename, originalSize, minifiedSize, savingsPercent) {
98
- const originalKB = (originalSize / 1024).toFixed(1);
99
- const minifiedKB = (minifiedSize / 1024).toFixed(1);
100
-
101
- console.log(chalk.green(` ✅ ${filename}`));
102
- console.log(chalk.gray(` ${originalKB}KB → ${minifiedKB}KB (${savingsPercent}% saved)`));
103
- }
104
-
105
- // Método para mostrar progreso de build
106
- static buildProgress(message) {
107
- console.log(chalk.cyan(`🔄 ${message}`));
108
- }
109
-
110
- // Método para mostrar estadísticas de servidor
111
- static serverStats(mode, port, directory) {
112
- Print.newLine();
113
- console.log(chalk.magenta(`🌐 Server Configuration:`));
114
- console.log(chalk.gray(` Mode: ${mode}`));
115
- console.log(chalk.gray(` Port: ${port}`));
116
- console.log(chalk.gray(` Serving: /${directory}`));
117
- Print.newLine();
118
- }
119
-
120
- // Método para mostrar que el servidor está listo con URL destacada
121
- static serverReady(port) {
122
- Print.newLine();
123
- console.log(chalk.bgGreen.black.bold(' ✓ SERVER READY '));
124
- Print.newLine();
125
- console.log(chalk.cyan.bold(` → Local: http://localhost:${port}`));
126
- console.log(chalk.gray(` → Network: http://127.0.0.1:${port}`));
127
- Print.newLine();
128
- console.log(chalk.yellow(` Press Ctrl+C to stop the server`));
129
- Print.newLine();
130
- }
131
-
132
- // Método para mostrar el estado del servidor durante inicio
133
- static serverStatus(status, message = '') {
134
- const icons = {
135
- checking: '🔍',
136
- starting: '🚀',
137
- ready: '✅',
138
- error: '❌'
139
- };
140
- const colors = {
141
- checking: chalk.cyan,
142
- starting: chalk.magenta,
143
- ready: chalk.green,
144
- error: chalk.red
145
- };
146
-
147
- const icon = icons[status] || 'ℹ️';
148
- const color = colors[status] || chalk.white;
149
- const displayMessage = message || status;
150
-
151
- console.log(color(`${icon} ${displayMessage}`));
152
- }
153
-
154
- // Método para mostrar que se está verificando el puerto
155
- static checkingPort(port) {
156
- console.log(chalk.cyan(`🔍 Checking port ${port}...`));
157
- }
158
-
159
- // Nuevo: Método para debug
160
- static debug(message) {
161
- console.log(chalk.gray(`🐛 DEBUG: ${message}`));
162
- }
163
-
164
- // Nuevo: Método para logs verbosos
165
- static verbose(message) {
166
- console.log(chalk.gray(`📝 ${message}`));
167
- }
1
+ import chalk from 'chalk';
2
+
3
+ export default class Print {
4
+ constructor() { }
5
+
6
+ static error(message) {
7
+ console.error(chalk.red(`❌ Error: ${message}`));
8
+ }
9
+
10
+ static success(message) {
11
+ console.log(chalk.green(`✅ Success: ${message}`));
12
+ }
13
+
14
+ static warning(message) {
15
+ console.log(chalk.yellow(`⚠️ Warning: ${message}`));
16
+ }
17
+
18
+ static info(message) {
19
+ console.log(chalk.cyan(`ℹ️ Info: ${message}`));
20
+ }
21
+
22
+ static title(message) {
23
+ console.log(chalk.magenta.bold(`🎯 ${message}`));
24
+ }
25
+
26
+ static subtitle(message) {
27
+ console.log(chalk.blue(`📋 ${message}`));
28
+ }
29
+
30
+ static step(stepNumber, message) {
31
+ console.log(chalk.cyan(`${stepNumber}. ${message}`));
32
+ }
33
+
34
+ static highlight(message) {
35
+ console.log(chalk.bgYellow.black(` ${message} `));
36
+ }
37
+
38
+ static newLine() {
39
+ console.log('');
40
+ }
41
+
42
+ static separator() {
43
+ console.log(chalk.gray('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
44
+ }
45
+
46
+ // Methods for CLI-specific context
47
+ static componentSuccess(componentName, action = 'processed') {
48
+ console.log(chalk.green(`✅ ${componentName} ${action} successfully!`));
49
+ }
50
+
51
+ static componentError(componentName, action = 'processing', error) {
52
+ console.error(chalk.red(`❌ Error ${action} ${componentName}: ${error}`));
53
+ }
54
+
55
+ static downloadProgress(fileName) {
56
+ console.log(chalk.cyan(` 📥 Downloading ${fileName}...`));
57
+ }
58
+
59
+ static downloadError(fileName) {
60
+ console.error(chalk.red(` ${fileName}`));
61
+ }
62
+
63
+ static registryUpdate(message) {
64
+ console.log(chalk.magenta(`📝 Registry: ${message}`));
65
+ }
66
+
67
+ static versionInfo(component, currentVersion, latestVersion = null) {
68
+ if (latestVersion && currentVersion !== latestVersion) {
69
+ console.log(chalk.yellow(`🔄 ${component}: v${currentVersion} → v${latestVersion}`));
70
+ } else {
71
+ console.log(chalk.green(`✅ ${component}: v${currentVersion}`));
72
+ }
73
+ }
74
+
75
+ static commandExample(description, command) {
76
+ console.log(chalk.gray(`💡 ${description}:`));
77
+ console.log(chalk.white(` ${command}`));
78
+ }
79
+
80
+ static summary(successful, failed, total) {
81
+ Print.separator();
82
+ console.log(chalk.bold('📊 Summary:'));
83
+ if (successful > 0) {
84
+ Print.success(`Successful: ${successful}/${total}`);
85
+ }
86
+ if (failed > 0) {
87
+ Print.error(`Failed: ${failed}/${total}`);
88
+ }
89
+ Print.separator();
90
+ }
91
+
92
+ // Method to show minification results
93
+ static minificationResult(filename, originalSize, minifiedSize, savingsPercent) {
94
+ const originalKB = (originalSize / 1024).toFixed(1);
95
+ const minifiedKB = (minifiedSize / 1024).toFixed(1);
96
+
97
+ console.log(chalk.green(` ✅ ${filename}`));
98
+ console.log(chalk.gray(` ${originalKB}KB ${minifiedKB}KB (${savingsPercent}% saved)`));
99
+ }
100
+
101
+ // Method to show build progress
102
+ static buildProgress(message) {
103
+ console.log(chalk.cyan(`🔄 ${message}`));
104
+ }
105
+
106
+ // Method to show server statistics
107
+ static serverStats(mode, port, directory) {
108
+ Print.newLine();
109
+ console.log(chalk.magenta(`🌐 Server Configuration:`));
110
+ console.log(chalk.gray(` Mode: ${mode}`));
111
+ console.log(chalk.gray(` Port: ${port}`));
112
+ console.log(chalk.gray(` Serving: /${directory}`));
113
+ Print.newLine();
114
+ }
115
+
116
+ // Method to show the server is ready with highlighted URL
117
+ static serverReady(port) {
118
+ Print.newLine();
119
+ console.log(chalk.bgGreen.black.bold(' ✓ SERVER READY '));
120
+ Print.newLine();
121
+ console.log(chalk.cyan.bold(` → Local: http://localhost:${port}`));
122
+ console.log(chalk.gray(` → Network: http://127.0.0.1:${port}`));
123
+ Print.newLine();
124
+ console.log(chalk.yellow(` Press Ctrl+C to stop the server`));
125
+ Print.newLine();
126
+ }
127
+
128
+ // Method to show server status during startup
129
+ static serverStatus(status, message = '') {
130
+ const icons = {
131
+ checking: '🔍',
132
+ starting: '🚀',
133
+ ready: '',
134
+ error: '❌'
135
+ };
136
+ const colors = {
137
+ checking: chalk.cyan,
138
+ starting: chalk.magenta,
139
+ ready: chalk.green,
140
+ error: chalk.red
141
+ };
142
+
143
+ const icon = icons[status] || 'ℹ️';
144
+ const color = colors[status] || chalk.white;
145
+ const displayMessage = message || status;
146
+
147
+ console.log(color(`${icon} ${displayMessage}`));
148
+ }
149
+
150
+ // Method to show port checking status
151
+ static checkingPort(port) {
152
+ console.log(chalk.cyan(`🔍 Checking port ${port}...`));
153
+ }
154
+
155
+ // New: Debug method
156
+ static debug(message) {
157
+ console.log(chalk.gray(`🐛 DEBUG: ${message}`));
158
+ }
159
+
160
+ // New: Verbose logging method
161
+ static verbose(message) {
162
+ console.log(chalk.gray(`📝 ${message}`));
163
+ }
168
164
  }
@@ -1,103 +1,92 @@
1
- import fs from 'fs';
2
- import path from 'path';
3
- import { fileURLToPath } from 'url';
4
- import { getConfigPath, getComponentsJsPath } from './utils/PathHelper.js';
5
-
6
- const __dirname = path.dirname(fileURLToPath(import.meta.url));
7
-
8
- class Validations {
9
- constructor() {
10
- this._config = null;
11
- this._categories = null;
12
- }
13
-
14
- _ensureConfig() {
15
- if (!this._config) {
16
- this._config = this.loadConfig();
17
- if (this._config) {
18
- this._categories = this._config.paths?.components;
19
- }
20
- }
21
- }
22
-
23
- get config() {
24
- this._ensureConfig();
25
- return this._config;
26
- }
27
-
28
- isValidComponentName(componentName) {
29
- // Expresión regular para verificar si el nombre contiene caracteres especiales
30
- const regex = /^[a-zA-Z][a-zA-Z0-9]*$/;
31
- return regex.test(componentName);
32
- }
33
-
34
- loadConfig() {
35
- try {
36
- const configPath = getConfigPath(import.meta.url);
37
- if (!fs.existsSync(configPath)) {
38
- // Return null silently - let commands handle missing config if needed
39
- return null;
40
- }
41
- const rawData = fs.readFileSync(configPath, 'utf-8');
42
-
43
- return JSON.parse(rawData);
44
- } catch (error) {
45
- console.error('\x1b[31m', `❌ Error loading configuration: ${error.message}`, '\x1b[0m');
46
- return null;
47
- }
48
- }
49
-
50
- getCategories() {
51
- this._ensureConfig();
52
- return this._categories;
53
- }
54
-
55
- getCategoryPath(category) {
56
- this._ensureConfig();
57
- return this._categories && this._categories[category] ? this._categories[category].path : null;
58
- }
59
-
60
- getCategoryType(category) {
61
- this._ensureConfig();
62
- return this._categories && this._categories[category] ? this._categories[category].type : null;
63
- }
64
-
65
- isValidCategory(category) {
66
- this._ensureConfig();
67
- if (!this._categories) return { isValid: false, category: null };
68
-
69
- const availableCategories = Object.keys(this._categories).map(cat => cat.toLowerCase());
70
-
71
- if (availableCategories.includes(category.toLowerCase())) {
72
- return { isValid: true, category };
73
- } else {
74
- return { isValid: false, category: null };
75
- }
76
- }
77
-
78
- componentExists(componentName) {
79
- try {
80
- const componentFilePath = getComponentsJsPath(import.meta.url);
81
-
82
- if (!fs.existsSync(componentFilePath)) {
83
- console.error('\x1b[31m', '❌ Error: components.js not found in expected path', '\x1b[0m');
84
- console.log('\x1b[36m', 'ℹ️ Info: Run "slice component list" to generate components.js', '\x1b[0m');
85
- return false;
86
- }
87
-
88
- const fileContent = fs.readFileSync(componentFilePath, 'utf-8');
89
- const components = eval(fileContent.replace('export default', '')); // Evalúa el contenido como objeto
90
-
91
- return components.hasOwnProperty(componentName);
92
-
93
- } catch (error) {
94
- console.error('\x1b[31m', `❌ Error checking component existence: ${error.message}`, '\x1b[0m');
95
- console.log('\x1b[36m', 'ℹ️ Info: The components.js file may be corrupted', '\x1b[0m');
96
- return false;
97
- }
98
- }
99
- }
100
-
101
- const validations = new Validations();
102
-
103
- export default validations;
1
+ import fs from 'fs';
2
+ import path from 'path';
3
+ import Print from './Print.js';
4
+ import { getComponentsJsPath } from './utils/PathHelper.js';
5
+ import { loadConfigSync } from './utils/loadConfig.js';
6
+
7
+ class Validations {
8
+ constructor() {
9
+ this._config = null;
10
+ this._categories = null;
11
+ }
12
+
13
+ _ensureConfig() {
14
+ if (!this._config) {
15
+ this._config = this.loadConfig();
16
+ if (this._config) {
17
+ this._categories = this._config.paths?.components;
18
+ }
19
+ }
20
+ }
21
+
22
+ get config() {
23
+ this._ensureConfig();
24
+ return this._config;
25
+ }
26
+
27
+ isValidComponentName(componentName) {
28
+ // Regex to check if the name contains special characters
29
+ const regex = /^[a-zA-Z][a-zA-Z0-9]*$/;
30
+ return regex.test(componentName);
31
+ }
32
+
33
+ loadConfig() {
34
+ return loadConfigSync(import.meta.url);
35
+ }
36
+
37
+ getCategories() {
38
+ this._ensureConfig();
39
+ return this._categories;
40
+ }
41
+
42
+ getCategoryPath(category) {
43
+ this._ensureConfig();
44
+ return this._categories && this._categories[category] ? this._categories[category].path : null;
45
+ }
46
+
47
+ getCategoryType(category) {
48
+ this._ensureConfig();
49
+ return this._categories && this._categories[category] ? this._categories[category].type : null;
50
+ }
51
+
52
+ isValidCategory(category) {
53
+ this._ensureConfig();
54
+ if (!this._categories) return { isValid: false, category: null };
55
+
56
+ const availableCategories = Object.keys(this._categories).map(cat => cat.toLowerCase());
57
+
58
+ if (availableCategories.includes(category.toLowerCase())) {
59
+ return { isValid: true, category };
60
+ } else {
61
+ return { isValid: false, category: null };
62
+ }
63
+ }
64
+
65
+ componentExists(componentName) {
66
+ try {
67
+ const componentFilePath = getComponentsJsPath(import.meta.url);
68
+
69
+ if (!fs.existsSync(componentFilePath)) {
70
+ Print.error('components.js not found in expected path');
71
+ Print.info('Run "slice component list" to generate components.js');
72
+ return false;
73
+ }
74
+
75
+ const fileContent = fs.readFileSync(componentFilePath, 'utf-8');
76
+ const match = fileContent.match(/const components = ({[\s\S]*?});/);
77
+ if (!match) return false;
78
+ const components = JSON.parse(match[1]);
79
+
80
+ return components.hasOwnProperty(componentName);
81
+
82
+ } catch (error) {
83
+ Print.error(`Error checking component existence: ${error.message}`);
84
+ Print.info('The components.js file may be corrupted');
85
+ return false;
86
+ }
87
+ }
88
+ }
89
+
90
+ const validations = new Validations();
91
+
92
+ export default validations;
@@ -1,40 +1,40 @@
1
- import bundle from '../bundle/bundle.js';
2
- import buildProduction, { serveProductionBuild } from '../buildProduction/buildProduction.js';
3
- import Print from '../Print.js';
4
-
5
- export default async function build(options = {}) {
6
- const minify = options.minify !== false;
7
- const obfuscate = options.obfuscate !== false;
8
-
9
- if (options.analyze) {
10
- return bundle({ analyze: true, verbose: options.verbose });
11
- }
12
-
13
- if (options.serve) {
14
- await serveProductionBuild(options.port);
15
- return true;
16
- }
17
-
18
- const success = await buildProduction({
19
- ...options,
20
- minify,
21
- obfuscate
22
- });
23
- if (!success) {
24
- return false;
25
- }
26
-
27
- Print.info('Generating bundles for production build...');
28
- await bundle({
29
- verbose: options.verbose,
30
- minify,
31
- obfuscate,
32
- output: 'dist'
33
- });
34
-
35
- if (options.preview) {
36
- await serveProductionBuild(options.port);
37
- }
38
-
39
- return true;
40
- }
1
+ import bundle from '../bundle/bundle.js';
2
+ import buildProduction, { serveProductionBuild } from '../buildProduction/buildProduction.js';
3
+ import Print from '../Print.js';
4
+
5
+ export default async function build(options = {}) {
6
+ const minify = options.minify !== false;
7
+ const obfuscate = options.obfuscate !== false;
8
+
9
+ if (options.analyze) {
10
+ return bundle({ analyze: true, verbose: options.verbose });
11
+ }
12
+
13
+ if (options.serve) {
14
+ await serveProductionBuild(options.port);
15
+ return true;
16
+ }
17
+
18
+ const success = await buildProduction({
19
+ ...options,
20
+ minify,
21
+ obfuscate
22
+ });
23
+ if (!success) {
24
+ return false;
25
+ }
26
+
27
+ Print.info('Generating bundles for production build...');
28
+ await bundle({
29
+ verbose: options.verbose,
30
+ minify,
31
+ obfuscate,
32
+ output: 'dist'
33
+ });
34
+
35
+ if (options.preview) {
36
+ await serveProductionBuild(options.port);
37
+ }
38
+
39
+ return true;
40
+ }