@larose-ui/core 0.1.0 → 0.1.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 (2) hide show
  1. package/README.md +55 -0
  2. package/package.json +8 -3
package/README.md ADDED
@@ -0,0 +1,55 @@
1
+ # @larose-ui/core
2
+
3
+ > Framework-agnostic types, state machines, and runtime contracts.
4
+
5
+ Part of **[laRose UI](https://github.com/hamdymohamedak/larose-ui)** — the UI Operating System for modern SaaS applications.
6
+
7
+ ## Install
8
+
9
+ ```bash
10
+ npm install @larose-ui/core
11
+ # or
12
+ pnpm add @larose-ui/core
13
+ # or
14
+ yarn add @larose-ui/core
15
+ ```
16
+
17
+
18
+
19
+ ## Quick start
20
+
21
+ ```tsx
22
+ import { createAsyncStateMachine, classifyHttpError } from '@larose-ui/core';
23
+
24
+ const machine = createAsyncStateMachine();
25
+ machine.send({ type: 'START' });
26
+ ```
27
+
28
+ ## Features
29
+
30
+ - Shared TypeScript types (`UIState`, `AsyncState`, `Environment`)
31
+ - Async state machine factory
32
+ - HTTP error classification
33
+ - Runtime event bus and session state machine
34
+ - Feature flag evaluators
35
+
36
+ ## Related packages
37
+
38
+ | Layer | Packages |
39
+ |-------|----------|
40
+ | Foundation | `@larose-ui/core`, `@larose-ui/tokens`, `@larose-ui/react` |
41
+ | Runtime | `@larose-ui/runtime`, `@larose-ui/network`, `@larose-ui/offline` |
42
+ | Intelligence | `@larose-ui/data`, `@larose-ui/forms`, `@larose-ui/permissions` |
43
+ | Platform | `@larose-ui/observability`, `@larose-ui/enterprise`, `@larose-ui/ai` |
44
+
45
+ ## Documentation
46
+
47
+ - [Monorepo README](https://github.com/hamdymohamedak/larose-ui#readme)
48
+ - [Package docs](https://github.com/hamdymohamedak/larose-ui/blob/main/docs/runtime/RUNTIME_2.md)
49
+ - [Architecture](https://github.com/hamdymohamedak/larose-ui/blob/main/docs/architecture/ARCHITECTURE.md)
50
+ - [Roadmap](https://github.com/hamdymohamedak/larose-ui/blob/main/docs/ROADMAP.md)
51
+ - [Report an issue](https://github.com/hamdymohamedak/larose-ui/issues)
52
+
53
+ ## License
54
+
55
+ MIT © [laRose UI](https://github.com/hamdymohamedak/larose-ui)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@larose-ui/core",
3
- "version": "0.1.0",
3
+ "version": "0.1.1",
4
4
  "description": "Core types, state machines, and utilities for laRose UI platform",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -13,7 +13,8 @@
13
13
  }
14
14
  },
15
15
  "files": [
16
- "dist"
16
+ "dist",
17
+ "README.md"
17
18
  ],
18
19
  "devDependencies": {
19
20
  "tsup": "^8.3.5",
@@ -26,7 +27,7 @@
26
27
  },
27
28
  "repository": {
28
29
  "type": "git",
29
- "url": "https://github.com/larose-ui/larose.git",
30
+ "url": "git+https://github.com/hamdymohamedak/larose-ui.git",
30
31
  "directory": "packages/core"
31
32
  },
32
33
  "keywords": [
@@ -36,6 +37,10 @@
36
37
  "design-system",
37
38
  "saas"
38
39
  ],
40
+ "homepage": "https://github.com/hamdymohamedak/larose-ui/blob/main/packages/core#readme",
41
+ "bugs": {
42
+ "url": "https://github.com/hamdymohamedak/larose-ui/issues"
43
+ },
39
44
  "scripts": {
40
45
  "build": "tsup src/index.ts --format esm --dts --clean",
41
46
  "dev": "tsup src/index.ts --format esm --dts --watch",