raktajs 0.1.2 → 0.1.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 (27) hide show
  1. package/README.md +104 -70
  2. package/dist/cli/build.d.ts.map +1 -1
  3. package/dist/cli/dev.d.ts.map +1 -1
  4. package/dist/cli/rakta.js +355 -92
  5. package/dist/cli/rakta.js.map +11 -10
  6. package/dist/cli/start.d.ts.map +1 -1
  7. package/dist/forge/build.d.ts.map +1 -1
  8. package/dist/forge/clientEntry.d.ts +9 -0
  9. package/dist/forge/clientEntry.d.ts.map +1 -0
  10. package/dist/forge/devServer.d.ts +1 -1
  11. package/dist/forge/devServer.d.ts.map +1 -1
  12. package/dist/forge/index.js +275 -22
  13. package/dist/forge/index.js.map +7 -6
  14. package/dist/forge/types.d.ts +4 -0
  15. package/dist/forge/types.d.ts.map +1 -1
  16. package/dist/index.js +283 -28
  17. package/dist/index.js.map +8 -7
  18. package/dist/render/index.js +7 -4
  19. package/dist/render/index.js.map +3 -3
  20. package/dist/render/renderer.d.ts +3 -0
  21. package/dist/render/renderer.d.ts.map +1 -1
  22. package/dist/tide/adapter.d.ts.map +1 -1
  23. package/dist/tide/index.js +10 -5
  24. package/dist/tide/index.js.map +4 -4
  25. package/dist/tide/types.d.ts +2 -0
  26. package/dist/tide/types.d.ts.map +1 -1
  27. package/package.json +1 -1
package/README.md CHANGED
@@ -1,90 +1,124 @@
1
- # rakta
2
-
3
- The core framework package of **Rakta.js** — a lightweight, composable
4
- frontend framework on Bun, React, and TypeScript.
5
-
6
- > Small in size. Fierce in speed. Alive in every route.
7
- > Bun in the engine. React at the core. Cirebon in the soul. Garuda in the heart.
8
-
9
- This package is rarely installed directly — most people get it through
10
- [`create-rakta-app`](https://www.npmjs.com/package/create-rakta-app). It is
11
- documented here for contributors and for people building custom tooling on
12
- top of Rakta.js.
13
-
14
- ## What's inside
15
-
16
- | Module | Import | Feature name | Purpose |
17
- | --- | --- | --- | --- |
18
- | Router | `rakta/router` | MendungWeave | File-based route scanning, matching, and manifest generation |
19
- | Components | `rakta/components` | ShrimpStep / TrusmiFrame | `<click to="">` navigation and `<picture path="">` images |
20
- | RPC | `rakta/rpc` | CarubanWire | Type-safe procedure router and client, inspired by tRPC |
21
- | Store | `rakta/store` | — | Lightweight, Zustand-inspired state store using `useSyncExternalStore` |
22
- | Schema | `rakta/schema` | — | Runtime validation with static type inference |
23
- | HTTP | `rakta/http` | PanturaFetch | A small, typed `fetch`-based HTTP client with interceptors |
24
- | SEO | `rakta/seo` | WaliSignal / SunyaragiCrown | Metadata, `<head>` rendering, sitemap, and robots.txt helpers |
25
- | Auto import | `rakta/auto-import` | TrusmiThread | Scans `app/`, `components/`, `lib/` and writes `.rakta/auto-imports.ts` |
26
- | Render | `rakta/render` | NorthCoastFlow | Render mode resolution (CSR / SSR / SSG / CSG / SPA / Hybrid) |
27
- | Forge | `rakta/forge` | CherbonsEngine | Dev server, build, and project inspection |
28
- | Tide | `rakta/tide` | — | Request/response runtime context helpers |
29
- | Config | `rakta/config` | — | `defineConfig` / `loadConfig` for `rakta.config.ts` |
30
-
31
- ## Installation
1
+ # Rakta.js
2
+
3
+ Rakta.js is a lightweight React framework for Bun and TypeScript.
4
+
5
+ **Small in size. Fierce in speed. Alive in every route.**
6
+
7
+ ## Features
8
+
9
+ - File-based routing from the `app/` directory
10
+ - Bun-powered dev server, production build, and start command
11
+ - React 19 client rendering with generated client entrypoints
12
+ - Route manifest generation and route inspection
13
+ - Rendering mode configuration: `csr`, `spa`, `ssr`, `ssg`, `csg`, and `hybrid`
14
+ - SEO config for default title and description
15
+ - Public `favicon.ico` support through `public/favicon.ico`
16
+ - Rakta navigation with `<click to="/path">`
17
+ - Schema validation utilities
18
+ - Type-safe RPC primitives
19
+ - Lightweight store utilities
20
+ - Typed HTTP client helpers
21
+ - PWA helpers for manifest, cache, and service worker building blocks
22
+ - Auto-import scanner and generator
23
+
24
+ ## Create A Project
32
25
 
33
26
  ```bash
34
- bun add rakta
27
+ bun create rakta-app@latest my-app
28
+ cd my-app
29
+ bun install
30
+ bun run dev
35
31
  ```
36
32
 
37
- `rakta` declares `react` and `react-dom` (`>=19.0.0`) as peer dependencies.
33
+ The default starter includes a Rakta welcome screen and ShrimpRun, an offline-browser-game-style starter built with React state and SVG animation.
38
34
 
39
- ## Quick example
35
+ ## CLI
40
36
 
41
- ```ts
42
- import { defineConfig } from "rakta/config";
37
+ ```bash
38
+ rakta dev
39
+ rakta build
40
+ rakta start
41
+ rakta routes
42
+ rakta make page about
43
+ rakta make layout dashboard
44
+ rakta make api users
45
+ rakta imports:generate
46
+ rakta rpc:types
47
+ rakta seo:generate
48
+ rakta doctor
49
+ ```
50
+
51
+ ## Config
43
52
 
44
- export default defineConfig({
45
- appName: "My App",
46
- render: { defaultMode: "csr" },
53
+ ```ts
54
+ import { defineRaktaConfig } from "raktajs";
55
+
56
+ export default defineRaktaConfig({
57
+ appName: "My Rakta App",
58
+ seo: {
59
+ defaultTitle:
60
+ "Rakta.js | Small in size. Fierce in speed. Alive in every route",
61
+ defaultDescription:
62
+ "Built with Rakta.js - Small in size. Fierce in speed. Alive in every route.",
63
+ },
64
+ render: {
65
+ defaultMode: "csr",
66
+ routes: {
67
+ "/": "csr",
68
+ "/docs": "ssg",
69
+ "/dashboard": "csr",
70
+ },
71
+ },
47
72
  });
48
73
  ```
49
74
 
50
- ```tsx
51
- // app/page.tsx
52
- import { Click } from "rakta/components";
53
-
54
- export default function HomePage() {
55
- return (
56
- <main>
57
- <h1>Welcome</h1>
58
- <click to="/about">About</click>
59
- </main>
60
- );
61
- }
75
+ ## App Routes
76
+
77
+ ```txt
78
+ app/
79
+ layout.tsx
80
+ page.tsx
81
+ about/
82
+ page.tsx
83
+ api/
84
+ hello/
85
+ route.ts
62
86
  ```
63
87
 
64
- ## CLI
88
+ ## Public Assets
65
89
 
66
- The `rakta` package also exposes a CLI binary:
90
+ Put static files in `public/`.
67
91
 
68
- ```bash
69
- bun rakta dev
70
- bun rakta build
71
- bun rakta start
72
- bun rakta routes
73
- bun rakta make page about
74
- bun rakta make layout dashboard
75
- bun rakta make api users
76
- bun rakta seo:generate
77
- bun rakta imports:generate
78
- bun rakta rpc:types
79
- bun rakta doctor
92
+ ```txt
93
+ public/
94
+ favicon.ico
80
95
  ```
81
96
 
82
- ## Documentation
97
+ Rakta.js automatically emits:
98
+
99
+ ```html
100
+ <link rel="icon" href="/favicon.ico" sizes="any" />
101
+ ```
83
102
 
84
- Full documentation lives in the repository root under
85
- [`docs/en`](../../docs/en) (English) and [`docs/id`](../../docs/id)
86
- (Bahasa Indonesia).
103
+ ## Package Exports
104
+
105
+ ```txt
106
+ raktajs
107
+ raktajs/components
108
+ raktajs/router
109
+ raktajs/render
110
+ raktajs/config
111
+ raktajs/seo
112
+ raktajs/pwa
113
+ raktajs/rpc
114
+ raktajs/schema
115
+ raktajs/http
116
+ raktajs/store
117
+ raktajs/auto-import
118
+ raktajs/forge
119
+ raktajs/tide
120
+ ```
87
121
 
88
122
  ## License
89
123
 
90
- MIT — Rhein Sullivan | Vyagra Nexus™
124
+ MIT - Rhein Sullivan | Vyagra Nexus
package/dist/cli/build.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/cli/build.ts"],"names":[],"mappings":"AAYA,wBAAsB,YAAY,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuC7E"}
1
+ {"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/cli/build.ts"],"names":[],"mappings":"AAYA,wBAAsB,YAAY,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwC7E"}
package/dist/cli/dev.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/cli/dev.ts"],"names":[],"mappings":"AAIA,wBAAsB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAa3E"}
1
+ {"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/cli/dev.ts"],"names":[],"mappings":"AAIA,wBAAsB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiB3E"}