@codespark/framework 1.0.0 → 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 TonyL1u
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,129 @@
+# @codespark/framework
+
+Core framework abstraction for the [Codespark](https://codesparkjs.com) ecosystem. Provides a unified API for analyzing and compiling code across different frameworks (React, HTML, Markdown).
+
+## Documentation
+
+Visit [https://codesparkjs.com/docs/framework](https://codesparkjs.com/docs/framework) to view the documentation.
+
+## Installation
+
+```bash
+npm install @codespark/framework
+# or
+pnpm add @codespark/framework
+```
+
+## Usage
+
+### Using Built-in Frameworks
+
+```ts
+import { react } from '@codespark/framework/react';
+import { html } from '@codespark/framework/html';
+import { markdown } from '@codespark/framework/markdown';
+
+// Analyze and compile React code
+const files = {
+  './App.tsx': `
+    export default function App() {
+      return <h1>Hello World</h1>;
+    }
+  `
+};
+
+react.analyze('./App.tsx', files);
+const compiled = react.compile();
+```
+
+### Registering Frameworks
+
+```ts
+import { registerFramework, registry } from '@codespark/framework';
+import { react } from '@codespark/framework/react';
+
+// Register a framework
+registerFramework(react);
+
+// Get a registered framework
+const framework = registry.get('react');
+
+// List all registered frameworks
+const frameworks = registry.list(); // ['react']
+```
+
+### Creating Custom Frameworks
+
+```ts
+import { Framework, type Outputs } from '@codespark/framework';
+
+class MyFramework extends Framework {
+  readonly name = 'my-framework';
+  readonly imports = {
+    'my-lib': 'https://esm.sh/my-lib'
+  };
+  outputs: Outputs = new Map();
+
+  analyze(entry: string, files: Record<string, string>) {
+    // Analyze dependencies and populate outputs
+  }
+
+  compile(): string {
+    const builder = this.createBuilder();
+    // Build runtime code
+    return builder.toString();
+  }
+}
+```
+
+## API
+
+### `Framework` (Abstract Class)
+
+Base class for all framework implementations.
+
+| Property/Method | Description |
+|-----------------|-------------|
+| `name` | Framework identifier |
+| `imports` | Import map for external dependencies |
+| `outputs` | Analyzed outputs by loader type |
+| `analyze(entry, files)` | Analyze entry file and its dependencies |
+| `compile()` | Compile analyzed code to executable string |
+| `getOutput(type)` | Get outputs for a specific loader type |
+
+### `registerFramework(framework, name?)`
+
+Register a framework instance to the global registry.
+
+### `registry`
+
+Global framework registry instance.
+
+| Method | Description |
+|--------|-------------|
+| `get(name)` | Get a framework by name |
+| `list()` | List all registered framework names |
+| `register(framework, name?)` | Register a framework |
+
+### Loader Types
+
+```ts
+enum LoaderType {
+  ESModule = 'esmodule',  // JavaScript/TypeScript modules
+  Style = 'style',        // CSS stylesheets
+  Script = 'script',      // Script tags
+  Asset = 'asset'         // HTML and other assets
+}
+```
+
+## Built-in Frameworks
+
+| Framework | Import Path | Description |
+|-----------|-------------|-------------|
+| React | `@codespark/framework/react` | React with JSX/TSX support |
+| HTML | `@codespark/framework/html` | HTML with inline scripts and styles |
+| Markdown | `@codespark/framework/markdown` | Markdown to HTML |
+
+## License
+
+MIT

package/dist/react.js

@@ -233,13 +233,13 @@ function processFile(path, files, outputs, visited) {
 	switch (output.type) {
 		case LoaderType.ESModule: {
 			const { content, dependencies, externals } = output;
+			for (const depPath of Object.values(dependencies)) processFile(depPath, files, outputs, visited);
 			getOutputList(outputs, LoaderType.ESModule).push({
 				path,
 				content,
 				dependencies,
 				externals
 			});
-			for (const depPath of Object.values(dependencies)) processFile(depPath, files, outputs, visited);
 			break;
 		}
 		case LoaderType.Style: {
@@ -288,7 +288,7 @@ var Framework = class extends Framework$1 {
 		this.outputs = analyze(entry, files);
 	}
 	compile() {
-		const transformed = this.transformModulesToBlob([...this.getOutput(LoaderType.ESModule)].reverse());
+		const transformed = this.transformModulesToBlob([...this.getOutput(LoaderType.ESModule)]);
 		const builder = this.createBuilder(transformed);
 		const ast = parse(transformed, {
 			sourceType: "module",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codespark/framework",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "type": "module",
   "description": "Framework registration API for codespark ecosystem",
   "keywords": [