@alkimia/framework 0.1.2 → 0.1.3

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.
@@ -0,0 +1,3 @@
1
+ {
2
+ "model": "grok-code-fast-1"
3
+ }
package/README.md CHANGED
@@ -1,9 +1,9 @@
1
1
 
2
- # Alkimia Framework CLI
2
+ # Alkimia Framework
3
3
 
4
4
  ## Overview
5
5
 
6
- The **Alkimia Framework CLI** is a command-line tool designed to enhance the development experience within the Alkimia framework. Alkimia is a JavaScript framework that strives to minimize abstraction, encouraging developers to work directly with JavaScript and the HTML DOM. Unlike frameworks such as React, Alkimia emphasizes simplicity and direct manipulation of the DOM, making it easier to build dynamic web applications without the overhead of heavy abstractions.
6
+ The Alkimia Framework (version 0.1.2) is a JavaScript framework that strives to minimize abstraction, encouraging developers to work directly with JavaScript and the HTML DOM. Unlike frameworks such as React, Alkimia emphasizes simplicity and direct manipulation of the DOM, making it easier to build dynamic web applications without the overhead of heavy abstractions. It includes a CLI tool to scaffold components interactively.
7
7
 
8
8
  ### Key Principles
9
9
 
@@ -13,11 +13,6 @@ The **Alkimia Framework CLI** is a command-line tool designed to enhance the dev
13
13
  - **Encouraged Verbosity**: To further reduce abstractions, the framework encourages verbosity. This ensures that the code remains clear and understandable, even for complex applications.
14
14
  - **View Module Creation**: The CLI offers the option to create modules that require a view. In such cases, HTML and SCSS placeholder files are added automatically. Additionally, a playground folder is included in each module, providing an introduction to the component's usage, including data binding.
15
15
 
16
- ### Features
17
-
18
- - **Component Creation**: Effortlessly generate new components with predefined structures tailored to your project.
19
- - **State Management**: Seamlessly integrate state management using Alkimia's built-in utilities.
20
- - **Resource Management**: Efficiently import and manage various resources with ease.
21
16
  ## Features
22
17
 
23
18
  - **Component Creation**: Easily generate new components with predefined structures.
@@ -28,52 +23,46 @@ The **Alkimia Framework CLI** is a command-line tool designed to enhance the dev
28
23
  ## Directory Structure
29
24
 
30
25
  ```
31
- alkimia-framework-cli/
32
- ├── apptest/
33
- │ └── InputElement/
34
- │ ├── InputElement.js
35
- │ ├── InputElement.html
36
- │ ├── InputElement.scss
37
- │ └── playground/
38
- │ ├── index.mjs
39
- │ └── package.json
26
+ @alkimia/framework/
27
+ ├── cli.js # CLI entry point
28
+ ├── index.js # Main exports
40
29
  ├── src/
41
- │ ├── createComponent.js
42
- │ ├── libs/
43
- └── StatesFactory.js
44
- │ └── makeResourcesImportable.js
45
- ├── cli.js
46
- ├── index.mjs
30
+ │ ├── createComponent.js # Component generator logic
31
+ │ ├── modulesMaker.js # Module templates
32
+ ├── makeResourcesImportable.js # Resource bundling
33
+ │ └── vite.config.js # Build config
34
+ ├── components/ # Example generated components
35
+ │ └── LoginWith2fa/
36
+ ├── sample/ # Sample projects
37
+ ├── package.json
38
+ ├── eslint.config.mjs
47
39
  └── README.md
48
40
  ```
49
41
 
50
42
  ## Installation
51
43
 
52
- To install the Alkimia Framework CLI, you need to have Node.js and npm installed on your machine. Then, run the following command:
44
+ To install the Alkimia Framework, you need to have Node.js and npm installed on your machine. Then, run the following command:
53
45
 
54
46
  ```bash
55
- npm install -g alkimia-framework-cli
47
+ npm install -g @alkimia/framework
56
48
  ```
57
49
 
58
50
  ## Usage
59
51
 
60
- Usage instructions for the CLI tool go here. For example:
61
-
62
- ### Creating a New Component
63
-
64
- To create a new component, run:
52
+ The Alkimia Framework includes a CLI tool for scaffolding components. After installation, run the CLI interactively:
65
53
 
66
54
  ```bash
67
- alkimia create-component <component-name>
55
+ alkimia
68
56
  ```
69
57
 
70
- ### Managing States
71
-
72
- Documentation for managing states using the `StatesFactory` utility.
58
+ You'll be prompted for:
59
+ - Directory (e.g., `src`)
60
+ - Component name
61
+ - Options (e.g., include DOM, playground, states sample)
73
62
 
74
- ### Importing Resources
63
+ This generates a new component module in the specified directory with optional HTML, SCSS, and playground files.
75
64
 
76
- Instructions for using the `makeResourcesImportable` function to manage your resources efficiently.
65
+ For more details on state management or resource importing, see the generated component examples in the `components/` directory or the @alkimia/lib documentation.
77
66
 
78
67
  ## Contributing
79
68
 
@@ -91,5 +80,5 @@ If you wish to contribute to the Alkimia Framework CLI, please follow the guidel
91
80
 
92
81
  ## License
93
82
 
94
- This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
83
+ This project is licensed under the ISC License - see the [LICENSE](LICENSE) file for details.
95
84
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@alkimia/framework",
3
- "version": "0.1.2",
3
+ "version": "0.1.3",
4
4
  "description": "Alkimia framework to build JavaScript modules ",
5
5
  "main": "src/createComponent.js",
6
6
  "type": "module",