@yoyaflow/yoya-ui 0.3.3 → 0.4.0

package/package.json

@@ -1,38 +1,41 @@
 {
   "name": "@yoyaflow/yoya-ui",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "A browser-native JS UI library with declarative HTML authoring: component library, router, i18n, theming and layout, works with or without a build tool, SSR-ready.",
   "type": "module",
   "private": false,
-  "main": "./dist/yoya-ui.umd.js",
-  "module": "./dist/yoya.ui.js",
+  "main": "./dist/yoya.ui-router.umd.js",
+  "module": "./dist/yoya.ui-router.full.js",
   "style": "./dist/yoya.ui.css",
   "types": "./types/index.d.ts",
   "exports": {
     ".": {
       "types": "./types/index.d.ts",
-      "import": "./dist/yoya.ui.js",
-      "require": "./dist/yoya-ui.umd.js"
+      "import": "./dist/yoya.ui-router.full.js"
     },
     "./core": {
       "types": "./types/yoya.core.d.ts",
       "import": "./dist/yoya.core.js"
     },
-    "./devtools": {
-      "types": "./types/yoya.devtools.d.ts",
-      "import": "./dist/yoya.devtools.js"
+    "./ui": {
+      "types": "./types/yoya.ui.d.ts",
+      "import": "./dist/yoya.ui.js"
+    },
+    "./router": {
+      "types": "./types/yoya.router.d.ts",
+      "import": "./dist/yoya.router.js"
     },
     "./echart": {
       "types": "./types/yoya.echart.d.ts",
       "import": "./dist/yoya.echart.js"
     },
-    "./ssr": {
-      "types": "./types/yoya.ssr.d.ts",
-      "import": "./dist/yoya.ssr.js"
+    "./three": {
+      "types": "./types/yoya.three.d.ts",
+      "import": "./dist/yoya.three.js"
     },
-    "./ui": {
-      "types": "./types/index.d.ts",
-      "import": "./dist/yoya.ui.js"
+    "./devtools": {
+      "types": "./types/yoya.devtools.d.ts",
+      "import": "./dist/yoya.devtools.js"
     },
     "./ui.css": "./dist/yoya.ui.css",
     "./package.json": "./package.json"
@@ -99,6 +102,7 @@
     "leaflet": "^1.9.4",
     "prettier": "^3.9.6",
     "quill": "^2.0.3",
+    "three": "^0.185.1",
     "typescript": "^7.0.2",
     "vite": "^8.2.0",
     "vitest": "^4.1.10"

package/types/index.d.ts

@@ -1,4 +1,4 @@
 /**
  * Default entry types for the `yoya-ui` package root.
  */
-export * from './yoya.ui.js';
+export * from './yoya.ui-router.js';

package/types/three.d.ts

@@ -0,0 +1,77 @@
+import type { ElementFactory, ElementOptions, SetupCallback, SetupInput } from './core.js';
+import type { HtmlElementNode } from './html.js';
+
+/** Minimal Three.js module shape accepted by threeLib(). */
+export interface ThreeLib {
+  PerspectiveCamera: new (...args: any[]) => any;
+  Scene: new (...args: any[]) => any;
+  WebGLRenderer: new (options?: Record<string, any>) => ThreeRenderer;
+  [key: string]: any;
+}
+
+/** Renderer surface used by the component. */
+export interface ThreeRenderer {
+  domElement: HTMLCanvasElement;
+  dispose(): void;
+  render(scene: any, camera: any): void;
+  setPixelRatio(value: number): void;
+  setSize(width: number, height: number): void;
+}
+
+/** Handed to onReady / onFrame callbacks after the renderer mounts. */
+export interface ThreeInstanceApi {
+  camera: any;
+  renderer: ThreeRenderer;
+  scene: any;
+  threeLib: ThreeLib;
+}
+
+/** Reported by onResize callbacks. */
+export interface ThreeResizeSize {
+  height: number;
+  width: number;
+}
+
+/** Three.js scene host (the three library itself is not bundled). */
+export class VThree extends HtmlElementNode {
+  threeLib(lib: ThreeLib): VThree;
+  getThreeLib(): ThreeLib | null;
+  scene(): any;
+  scene(value: any): VThree;
+  getScene(): any;
+  camera(): any;
+  camera(value: any): VThree;
+  getCamera(): any;
+  rendererOptions(): Record<string, any>;
+  rendererOptions(value: Record<string, any>): VThree;
+  width(): number | string;
+  width(value: number | string): VThree;
+  height(): number | string;
+  height(value: number | string): VThree;
+  devicePixelRatio(): number | null;
+  devicePixelRatio(value: number | null): VThree;
+  autoResize(): boolean;
+  autoResize(value: boolean): VThree;
+  autoRender(): boolean;
+  autoRender(value: boolean): VThree;
+  onReady(callback: (api: ThreeInstanceApi) => void): VThree;
+  onResize(callback: (size: ThreeResizeSize) => void): VThree;
+  onFrame(callback: (api: ThreeInstanceApi) => void): VThree;
+  getRenderer(): ThreeRenderer | null;
+  start(): VThree;
+  stop(): VThree;
+  render(): VThree;
+  resize(): VThree;
+  dispose(): VThree;
+}
+
+export const vThree: ElementFactory<VThree> & {
+  (first?: SetupInput<VThree> | null, callback?: SetupCallback<VThree>): VThree;
+};
+
+/** Parent-shortcut surface merged onto HtmlElementNode. */
+export interface ThreeParentShortcuts {
+  vThree(first?: SetupInput<VThree> | null, callback?: SetupCallback<VThree>): VThree;
+}
+
+export type { ElementOptions };

package/types/yoya.router.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Entry types for `yoya-ui/router`: router plus SSR rendering primitives
+ * (core / html / layout / theme are provided by `yoya-ui/core` and
+ * `yoya-ui/ui` respectively).
+ */
+export * from './router.js';
+export * from './ssr.js';

package/types/yoya.three.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Entry types for `yoya-ui/three`: the Three.js component.
+ */
+export { VThree, vThree } from './three.js';

package/types/yoya.ui-router.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Entry types for the self-contained `yoya.ui-router.full` bundle:
+ * core + ui (components / layout / theme) + router + SSR primitives.
+ */
+export * from './core.js';
+export * from './html.js';
+export * from './svg.js';
+export * from './layout.js';
+export * from './actions.js';
+export * from './navigation.js';
+export * from './feedback.js';
+export * from './form.js';
+export * from './data-display.js';
+export * from './async.js';
+export * from './i18n.js';
+export * from './theme.js';
+export * from './router.js';
+export * from './effects.js';
+export * from './ssr.js';

package/types/yoya.ui.d.ts

@@ -1,9 +1,7 @@
 /**
- * Entry types for the `yoya-ui` root export (and `yoya-ui/ui`).
+ * Entry types for `yoya-ui/ui`: components + layout + theme.
+ * Core is provided by `yoya-ui/core`; router/SSR by `yoya-ui/router`.
  */
-export * from './core.js';
-export * from './html.js';
-export * from './svg.js';
 export * from './layout.js';
 export * from './actions.js';
 export * from './navigation.js';
@@ -13,7 +11,4 @@ export * from './data-display.js';
 export * from './async.js';
 export * from './i18n.js';
 export * from './theme.js';
-export * from './router.js';
 export * from './effects.js';
-export { VEchart, vEchart } from './chart.js';
-export * from './ssr.js';