@nan0web/ui 1.3.0 → 1.5.2

package/README.md

@@ -1,5 +1,7 @@
 # @nan0web/ui
 
+🏴󠁧󠁢󠁥󠁮󠁧󠁿 [English](./README.md) | 🇺🇦 [Українською](./docs/uk/README.md)
+
 <!-- %PACKAGE_STATUS% -->
 
 A lightweight, agnostic UI framework designed with the **nan0web philosophy**
@@ -172,6 +174,29 @@ import { Welcome } from '@nan0web/ui'
 const output = Welcome({ user: { name: 'Test' } })
 console.info(output) // ← Welcome Test!
 ```
+### Master IDE (Component Sandbox)
+
+The Master IDE (OlmuiInspector) provides a unified environment for testing and documenting
+web components across platforms. It supports:
+
+- **NaN0 Spec** — a concise YAML-based shorthand for declaring component variations.
+- **OlmuiInspector** — unified UI for exploring component models and props.
+- **Live Preview** — real-time rendering of component states.
+- **i18n UI** — fully localized interface for global developers.
+
+It follows the **Olmui** core pattern: *One Logic — Many UI* (same manifest powers both CLI and Web).
+
+#### NaN0 Spec (YAML)
+
+Concise format for defining variations:
+
+How to define a component variation using NaN0 Spec?
+```yaml
+- Button: Primary
+  $variant: brand
+  $outline: true
+```
+
 ## Playground Demos
 
 The library includes rich playground demos:
@@ -205,6 +230,10 @@ Explore:
 - [App](./src/App/)
 - [Models](./src/Model/)
 
+## Project Architecture & Specs
+
+How the universal block spec is designed? - [check Universal Blocks Spec (`project.md`)](./project.md)
+
 ## Contributing
 
 How to contribute? - [check here](./CONTRIBUTING.md)

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nan0web/ui",
-	"version": "1.3.0",
+	"version": "1.5.2",
 	"description": "NaN•Web UI. One application logic (algorithm) and many UI.",
 	"main": "src/index.js",
 	"types": "types/index.d.ts",
@@ -18,17 +18,21 @@
 		"test:coverage": "node --experimental-test-coverage --test-coverage-include=\"src/**/*.js\" --test-coverage-exclude=\"src/**/*.test.js\" --test \"src/**/*.test.js\"",
 		"test:coverage:collect": "nan0test coverage",
 		"test:docs": "node --test src/README.md.js",
+		"release:spec": "node --test \"releases/**/*.spec.js\"",
 		"test:release": "node --test \"releases/**/*.test.js\"",
 		"test:status": "nan0test status --hide-name",
 		"test:play": "node --test --test-timeout=3333 \"play/**/*.test.js\"",
-		"test:all": "npm run test && npm run test:docs && npm run test:play && npm run build && npm run knip",
+		"test:e2e": "playwright test",
+		"test:all": "npm run test && npm run test:docs && npm run test:play && npm run test:e2e && npm run build && npm run knip",
 		"knip": "knip --production",
 		"precommit": "npm test",
 		"prepush": "npm test",
 		"prepare": "husky",
 		"release": "nan0release publish",
 		"clean": "rm -rf .cache/ && rm -rf dist/",
-		"clean:modules": "rm -rf node_modules"
+		"clean:modules": "rm -rf node_modules",
+		"docs:dev": "node docs/site/scripts/generate-pages.js && vite docs/site",
+		"docs:build": "node docs/site/scripts/generate-pages.js && vite build docs/site"
 	},
 	"exports": {
 		".": {
@@ -55,21 +59,27 @@
 	"license": "ISC",
 	"packageManager": "pnpm@10.11.0",
 	"devDependencies": {
-		"@nan0web/event": "^1.0.0",
-		"@nan0web/i18n": "^1.0.1",
-		"@nan0web/release": "1.0.1",
-		"@nan0web/test": "1.1.0",
-		"@nan0web/ui-cli": "1.0.2",
+		"@nan0web/event": "*",
+		"@nan0web/i18n": "*",
+		"@nan0web/release": "*",
+		"@nan0web/test": "*",
+		"@nan0web/ui-cli": "*",
+		"@nan0web/ui-lit": "workspace:*",
+		"@playwright/test": "^1.58.2",
+		"@rollup/plugin-yaml": "^4.1.2",
 		"@vitest/coverage-v8": "^3.2.4",
 		"husky": "^9.1.7",
+		"js-yaml": "^4.1.1",
 		"knip": "^5.83.1",
+		"lit": "^3.3.2",
+		"vite": "^6.0.0",
 		"vitest": "^3.2.4"
 	},
 	"dependencies": {
-		"@nan0web/co": "^2.0.0",
-		"@nan0web/event": "^1.0.0",
-		"@nan0web/log": "1.1.1",
-		"@nan0web/types": "^1.2.0",
+		"@nan0web/co": "*",
+		"@nan0web/event": "*",
+		"@nan0web/log": "*",
+		"@nan0web/types": "*",
 		"string-width": "^7.2.0"
 	}
 }

package/src/README.md.js

@@ -30,6 +30,8 @@ function testRender() {
 	 * @docs
 	 * # @nan0web/ui
 	 *
+	 * 🏴󠁧󠁢󠁥󠁮󠁧󠁿 [English](./README.md) | 🇺🇦 [Українською](./docs/uk/README.md)
+	 *
 	 * <!-- %PACKAGE_STATUS% -->
 	 *
 	 * A lightweight, agnostic UI framework designed with the **nan0web philosophy**
@@ -276,6 +278,35 @@ function testRender() {
 		])
 	})
 
+	/**
+	 * @docs
+	 * ### Master IDE (Component Sandbox)
+	 *
+	 * The Master IDE (OlmuiInspector) provides a unified environment for testing and documenting
+	 * web components across platforms. It supports:
+	 *
+	 * - **NaN0 Spec** — a concise YAML-based shorthand for declaring component variations.
+	 * - **OlmuiInspector** — unified UI for exploring component models and props.
+	 * - **Live Preview** — real-time rendering of component states.
+	 * - **i18n UI** — fully localized interface for global developers.
+	 *
+	 * It follows the **Olmui** core pattern: *One Logic — Many UI* (same manifest powers both CLI and Web).
+	 *
+	 * #### NaN0 Spec (YAML)
+	 *
+	 * Concise format for defining variations:
+	 */
+	it('How to define a component variation using NaN0 Spec?', () => {
+		/**
+		 * ```yaml
+		 * - Button: Primary
+		 *   $variant: brand
+		 *   $outline: true
+		 * ```
+		 */
+		assert.ok(pkg.name === '@nan0web/ui')
+	})
+
 	/**
 	 * @docs
 	 * ## Playground Demos
@@ -320,6 +351,10 @@ function testRender() {
 	 * - [App](./src/App/)
 	 * - [Models](./src/Model/)
 	 *
+	 * ## Project Architecture & Specs
+	 *
+	 * How the universal block spec is designed? - [check Universal Blocks Spec (`project.md`)](./project.md)
+	 *
 	 * ## Contributing
 	 */
 	it('How to contribute? - [check here](./CONTRIBUTING.md)', async () => {