@rangka/client 0.1.1 → 0.1.3

package/dist/widgets/renderer/WidgetErrorBoundary.d.ts

@@ -0,0 +1,17 @@
+import { Component } from 'react';
+import type { ReactNode, ErrorInfo } from 'react';
+interface WidgetErrorBoundaryProps {
+    name: string;
+    children: ReactNode;
+}
+interface WidgetErrorBoundaryState {
+    error: Error | null;
+}
+export declare class WidgetErrorBoundary extends Component<WidgetErrorBoundaryProps, WidgetErrorBoundaryState> {
+    state: WidgetErrorBoundaryState;
+    static getDerivedStateFromError(error: Error): WidgetErrorBoundaryState;
+    componentDidCatch(error: Error, info: ErrorInfo): void;
+    render(): string | number | bigint | boolean | Iterable<ReactNode> | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<ReactNode> | null | undefined> | import("react").JSX.Element | null | undefined;
+}
+export {};
+//# sourceMappingURL=WidgetErrorBoundary.d.ts.map

package/dist/widgets/renderer/WidgetErrorBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetErrorBoundary.d.ts","sourceRoot":"","sources":["../../../src/widgets/renderer/WidgetErrorBoundary.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElD,UAAU,wBAAwB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,UAAU,wBAAwB;IAChC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,qBAAa,mBAAoB,SAAQ,SAAS,CAChD,wBAAwB,EACxB,wBAAwB,CACzB;IACC,KAAK,EAAE,wBAAwB,CAAmB;IAElD,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,wBAAwB;IAIvE,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS;IAS/C,MAAM;CAcP"}

package/dist/widgets/renderer/WidgetErrorBoundary.js

@@ -0,0 +1,18 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { Component } from 'react';
+export class WidgetErrorBoundary extends Component {
+    state = { error: null };
+    static getDerivedStateFromError(error) {
+        return { error };
+    }
+    componentDidCatch(error, info) {
+        console.error(`[rangka] Widget "${this.props.name}" crashed:\n`, error, '\n\nComponent stack:', info.componentStack);
+    }
+    render() {
+        if (this.state.error) {
+            return (_jsxs("div", { "data-widget-error": `Runtime error in: ${this.props.name}`, className: "rounded border border-destructive/30 bg-destructive/5 p-3 text-sm text-destructive", children: [_jsxs("p", { className: "font-medium", children: ["Widget error: ", this.props.name] }), _jsx("p", { className: "mt-1 text-xs opacity-75", children: this.state.error.message })] }));
+        }
+        return this.props.children;
+    }
+}
+//# sourceMappingURL=WidgetErrorBoundary.js.map

package/dist/widgets/renderer/WidgetErrorBoundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetErrorBoundary.js","sourceRoot":"","sources":["../../../src/widgets/renderer/WidgetErrorBoundary.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAYlC,MAAM,OAAO,mBAAoB,SAAQ,SAGxC;IACC,KAAK,GAA6B,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAElD,MAAM,CAAC,wBAAwB,CAAC,KAAY;QAC1C,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;IAED,iBAAiB,CAAC,KAAY,EAAE,IAAe;QAC7C,OAAO,CAAC,KAAK,CACX,oBAAoB,IAAI,CAAC,KAAK,CAAC,IAAI,cAAc,EACjD,KAAK,EACL,sBAAsB,EACtB,IAAI,CAAC,cAAc,CACpB,CAAC;IACJ,CAAC;IAED,MAAM;QACJ,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACrB,OAAO,CACL,oCACqB,qBAAqB,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EACzD,SAAS,EAAC,oFAAoF,aAE9F,aAAG,SAAS,EAAC,aAAa,+BAAgB,IAAI,CAAC,KAAK,CAAC,IAAI,IAAK,EAC9D,YAAG,SAAS,EAAC,yBAAyB,YAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,GAAK,IACjE,CACP,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC7B,CAAC;CACF"}

package/dist/widgets/renderer/WidgetRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WidgetRenderer.d.ts","sourceRoot":"","sources":["../../../src/widgets/renderer/WidgetRenderer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAY9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAWxD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACtC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;CAClD;AAED,wBAAgB,cAAc,CAAC,EAAE,IAAI,EAAE,QAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,mBAAmB,4BAyG/F"}
+{"version":3,"file":"WidgetRenderer.d.ts","sourceRoot":"","sources":["../../../src/widgets/renderer/WidgetRenderer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAc9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAWxD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACtC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;CAClD;AAED,wBAAgB,cAAc,CAAC,EAAE,IAAI,EAAE,QAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,mBAAmB,4BA+G/F"}

package/dist/widgets/renderer/WidgetRenderer.js

@@ -11,6 +11,8 @@ import { flattenContext } from '../context/types.js';
 import { parse, evaluate } from '../expression/index.js';
 import { extractLayoutProps, hasLayoutProps, resolveLayoutClasses } from '../lib/layout-props.js';
 import { useParams } from '../../router/hooks.js';
+import { LazyWidget } from './LazyWidget.js';
+import { WidgetErrorBoundary } from './WidgetErrorBoundary.js';
 function useRouteParams() {
     try {
         return useParams();
@@ -41,10 +43,6 @@ export function WidgetRenderer({ node, handlers = {}, fieldMeta, setValue }) {
     if (!visible)
         return null;
     const widgetEntry = getWidget(node.type);
-    if (!widgetEntry) {
-        return _jsx("div", { "data-widget-error": `Unknown widget: ${node.type}` });
-    }
-    const Component = widgetEntry.component;
     const widgetProps = {
         props: extractedWidgetProps,
         bind: {
@@ -64,6 +62,10 @@ export function WidgetRenderer({ node, handlers = {}, fieldMeta, setValue }) {
         childNodes: node.children,
         children: node.children ? (_jsx(WidgetContextProvider, { value: childContext, children: node.children.map((child, i) => (_jsx(WidgetRenderer, { node: child, handlers: handlers, fieldMeta: fieldMeta, setValue: setValue }, child.id ?? i))) })) : undefined,
     };
+    if (!widgetEntry) {
+        return _jsx(LazyWidget, { name: node.type, ...widgetProps });
+    }
+    const Component = widgetEntry.component;
     const dataAttrs = {
         'data-rangka-widget': node.type,
         'data-rangka-id': node.id ?? undefined,
@@ -73,10 +75,10 @@ export function WidgetRenderer({ node, handlers = {}, fieldMeta, setValue }) {
     };
     let rendered;
     if (node.bind?.model || node.source) {
-        rendered = (_jsx(WidgetContextProvider, { value: childContext, children: _jsx(Component, { ...widgetProps }) }));
+        rendered = (_jsx(WidgetContextProvider, { value: childContext, children: _jsx(WidgetErrorBoundary, { name: node.type, children: _jsx(Component, { ...widgetProps }) }) }));
     }
     else {
-        rendered = _jsx(Component, { ...widgetProps });
+        rendered = (_jsx(WidgetErrorBoundary, { name: node.type, children: _jsx(Component, { ...widgetProps }) }));
     }
     if (layoutClassName) {
         return (_jsx("div", { className: layoutClassName, ...dataAttrs, children: rendered }));

package/dist/widgets/renderer/WidgetRenderer.js.map

@@ -1 +1 @@
-{"version":3,"file":"WidgetRenderer.js","sourceRoot":"","sources":["../../../src/widgets/renderer/WidgetRenderer.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"WidgetRenderer.js","sourceRoot":"","sources":["../../../src/widgets/renderer/WidgetRenderer.tsx"],"names":[],"mappings":"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"}

package/package.json

@@ -1,8 +1,12 @@
 {
   "name": "@rangka/client",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "license": "MIT",
   "type": "module",
+  "files": [
+    "dist",
+    "README.md"
+  ],
   "exports": {
     ".": {
       "import": "./dist/index.js",
@@ -27,13 +31,12 @@
     "react-day-picker": "^10.0.1",
     "react-dom": "^19.1.0",
     "react-resizable-panels": "^4.11.2",
-    "recharts": "3.8.0",
     "shadcn": "^4.11.0",
     "sonner": "^2.0.7",
     "tailwind-merge": "^2.6.1",
     "tw-animate-css": "^1.4.0",
     "vaul": "^1.1.2",
-    "@rangka/shared": "0.1.1"
+    "@rangka/shared": "0.1.3"
   },
   "devDependencies": {
     "@tailwindcss/vite": "^4.1.0",
@@ -50,7 +53,7 @@
     "vitest": "^4.1.8"
   },
   "scripts": {
-    "build": "tsc --build && vite build --outDir dist/shell",
+    "build": "tsc --build && vite build --outDir dist/shell && node scripts/extract-theme.js",
     "dev": "vite",
     "test": "vitest run",
     "lint": "eslint src/"

package/.claude/skills/add-widget/SKILL.md

@@ -1,101 +0,0 @@
----
-name: add-widget
-description: Adding a new widget component to packages/client. Use when creating any new widget type.
----
-
-## Before you write any code
-
-1. Read an existing widget that is closest to what you are building:
-   - Input widget → `src/widgets/components/InputWidget.tsx`
-   - Display widget → `src/widgets/components/TextWidget.tsx`
-   - Container widget → `src/widgets/components/GroupWidget.tsx`
-   - Data widget → `src/widgets/components/DataWidget.tsx`
-   - Form widget → `src/widgets/form/FormWidget.tsx`
-
-2. Read the shared hooks you MUST use:
-   - `src/widgets/hooks/useBind.ts` — binding resolution
-   - `src/widgets/hooks/useAction.ts` — trigger handlers
-   - `src/widgets/types.ts` — WidgetProps interface
-
-3. Check if the logic you need already exists:
-   - Data fetching → `src/widgets/data/useModelRecord.ts` or `src/widgets/data/useModelQuery.ts`
-   - Form state → `src/widgets/form/FormContext.ts`
-   - Page state → `src/widgets/hooks/usePageState.ts`
-   - Expressions → `src/widgets/hooks/useExpression.ts`
-
-## Widget file template
-
-Every widget follows this exact structure:
-
-```typescript
-import React from 'react';
-import type { WidgetProps } from '../types.js';
-
-export function MyWidget({ props, bind, on, children }: WidgetProps) {
-  // Read props (typed from schema below)
-  const label = (props.label as string) ?? bind.meta?.label ?? '';
-
-  // Read bound value (ALWAYS via bind, never via useWidgetContext)
-  const value = bind.value;
-
-  // Write via bind.setValue (ALWAYS, never direct state)
-  const handleChange = (newVal: unknown) => {
-    bind.setValue?.(newVal);
-    on.change?.(newVal);  // fire trigger if applicable
-  };
-
-  // Read error from bind (comes from FormContext automatically)
-  const error = bind.error;
-
-  return (
-    <div>
-      {/* widget markup */}
-      {error && <p className="text-xs text-destructive mt-1">{error}</p>}
-    </div>
-  );
-}
-
-MyWidget.widgetMeta = {
-  name: 'my-widget',
-  label: 'My Widget',
-  category: 'input' as const,  // input | display | layout | action | data
-  schema: {
-    label: { type: 'string' as const },
-    // ... prop definitions
-  },
-  binding: 'field' as const,   // none | field | expression | record | model
-  triggers: ['change'],        // events this widget fires via on.*
-  container: false,            // true only if it renders children
-};
-```
-
-## Registration
-
-After creating the widget file, register it in `src/widgets/components/register.ts`:
-
-1. Add the import at the end of the import block
-2. Add the component to the `builtInWidgets` array
-
-## Rules
-
-- Props come from `props` (page definition config), NEVER from custom React props
-- Bound value comes from `bind.value`, NEVER from `useWidgetContext().record` directly
-- Writing goes through `bind.setValue`, which automatically handles form state integration
-- Triggers fire through `on.triggerName?.()`, NEVER by calling `dispatch` directly
-- Container widgets that provide new context use `childNodes` + `WidgetRenderer`, not `children`
-- All widgets use the `WidgetProps` interface unchanged. If you need a new field, update the shared type and ALL consumers
-- Use shadcn components from `src/components/ui/` for UI primitives
-- Use Tailwind classes, never inline styles
-- Error display pattern: `{bind.error && <p className="text-xs text-destructive mt-1">{bind.error}</p>}`
-
-## Checklist before done
-
-- [ ] Widget accepts only `WidgetProps` (no custom props)
-- [ ] Uses `bind.value` / `bind.setValue` for data (not custom state)
-- [ ] Fires triggers via `on.*` (not dispatch)
-- [ ] Has `widgetMeta` with all fields
-- [ ] Registered in `register.ts`
-- [ ] If container: renders via `childNodes` + `WidgetRenderer` when providing new context
-- [ ] If input: displays `bind.error` below the field
-- [ ] No new hooks that duplicate existing ones (useBind, useModelRecord, etc.)
-- [ ] Builds successfully: `pnpm --filter @rangka/client build`

package/.turbo/turbo-build.log

@@ -1,29 +0,0 @@
-
-> @rangka/client@0.1.1 build /home/runner/work/rangka-framework/rangka-framework/packages/client
-> tsc --build && vite build --outDir dist/shell
-
-vite v6.4.3 building for production...
-transforming...
-✓ 3086 modules transformed.
-rendering chunks...
-[plugin vite:reporter] 
-(!) /home/runner/work/rangka-framework/rangka-framework/packages/client/src/widgets/condition/evaluator.ts is dynamically imported by /home/runner/work/rangka-framework/rangka-framework/packages/client/src/widgets/action/dispatcher.ts but also statically imported by /home/runner/work/rangka-framework/rangka-framework/packages/client/src/widgets/condition/index.ts, dynamic import will not move module into another chunk.
-
-computing gzip size...
-dist/shell/index.html                                                0.39 kB │ gzip:   0.26 kB
-dist/shell/assets/inter-vietnamese-wght-normal-CBcvBZtf.woff2       10.25 kB
-dist/shell/assets/inter-greek-ext-wght-normal-DlzME5K_.woff2        11.23 kB
-dist/shell/assets/inter-cyrillic-wght-normal-DqGufNeO.woff2         18.75 kB
-dist/shell/assets/inter-greek-wght-normal-CkhJZR-_.woff2            19.00 kB
-dist/shell/assets/inter-cyrillic-ext-wght-normal-BOeWTOD4.woff2     25.96 kB
-dist/shell/assets/inter-latin-wght-normal-Dx4kXJAl.woff2            48.26 kB
-dist/shell/assets/inter-latin-ext-wght-normal-DO1Apj_S.woff2        85.07 kB
-dist/shell/assets/index-COLmoPYo.css                               164.49 kB │ gzip:  24.29 kB
-dist/shell/assets/index-Ck_eod9F.js                                  2.90 kB │ gzip:   1.13 kB
-dist/shell/assets/index--35CAvcP.js                              1,559.64 kB │ gzip: 373.20 kB
-
-(!) Some chunks are larger than 500 kB after minification. Consider:
-- Using dynamic import() to code-split the application
-- Use build.rollupOptions.output.manualChunks to improve chunking: https://rollupjs.org/configuration-options/#output-manualchunks
-- Adjust chunk size limit for this warning via build.chunkSizeWarningLimit.
-✓ built in 4.88s

package/CHANGELOG.md

@@ -1,25 +0,0 @@
-# @rangka/client
-
-## 0.1.1
-
-### Patch Changes
-
-- Updated dependencies []:
-  - @rangka/shared@0.1.1
-
-## 0.1.0
-
-### Minor Changes
-
-- [`438bf4a`](https://github.com/rangka-dev/rangka-framework/commit/438bf4a385b99d1e497e937375dc03aac101c8ec) Thanks [@irfnmzk](https://github.com/irfnmzk)! - Initial open source release
-
-  - Modular ERP framework with declarative models, hooks, services, and widgets
-  - CLI with dev server, build, and studio commands
-  - Studio AI development environment with WebSocket-based UI
-  - create-rangka scaffolding tool
-  - MIT licensed framework, AGPL licensed studio
-
-### Patch Changes
-
-- Updated dependencies [[`438bf4a`](https://github.com/rangka-dev/rangka-framework/commit/438bf4a385b99d1e497e937375dc03aac101c8ec)]:
-  - @rangka/shared@0.1.0

package/CLAUDE.md

@@ -1,236 +0,0 @@
-# CLAUDE.md — @rangka/client
-
-## Package overview
-
-The Rangka client shell — a pre-built SPA that serves as the runtime UI for all Rangka applications. It fetches metadata from the server (models, pages, navigation, permissions) and renders a complete admin interface without user code. Custom views/fields/cards are loaded as async chunks from `.rangka/`.
-
-## Tech stack
-
-- React 19, TypeScript 5
-- Tailwind CSS v4 (via `@tailwindcss/vite`)
-- TanStack Router (dynamic route building from page definitions)
-- TanStack React Query (data fetching, caching, mutations)
-- shadcn/ui — local component primitives in `src/components/ui/`
-- `@rangka/shared` — shared types (PageDefinition, WidgetNode, LayoutProps, etc.)
-
-## Project structure
-
-```
-src/
-├── api/          — HTTP client, auth, token, boot payload fetch
-├── auth/         — Login form, session expired screen
-├── boot/         — Boot state machine (BootProvider, BootGate, useBoot)
-├── components/
-│   └── ui/       — Local shadcn components (Collapsible, ResizablePanel, ScrollArea, etc.)
-├── context/      — React contexts (Meta, Permissions, User, ShellProviders)
-├── data/         — Data hooks (useSource, useRecord, useMutation, QueryProvider)
-├── router/       — Dynamic router (createShellRouter, buildRouteTree, hooks)
-├── shell/        — Shell layout (ShellLayout, Sidebar, PageOutlet, etc.)
-├── widgets/
-│   ├── action/     — Action dispatcher and handler types
-│   ├── binding/    — Binding resolver (field, expression, model)
-│   ├── components/ — Widget implementations (one file per widget)
-│   ├── context/    — WidgetContext type and builder
-│   ├── data/       — Shared data hooks (useModelRecord, useModelQuery)
-│   ├── form/       — FormWidget, FormContext, form state/validation/submit
-│   ├── hooks/      — Shared widget hooks (useBind, useAction, useCondition, etc.)
-│   ├── lib/        — Layout prop resolver, spacing maps
-│   ├── renderer/   — WidgetRenderer (resolves props, applies layout wrapper)
-│   └── state/      — Page-level state store (magic variables: $filter, $sort, $page, $search)
-├── App.tsx       — Root component
-├── main.tsx      — Entry point
-└── index.ts      — Public exports
-```
-
-## Widget system internals
-
-Every widget follows the same architecture. Understand this before creating or modifying any widget.
-
-### WidgetProps contract
-
-All widgets receive a single `WidgetProps` object. This is the public API. Never add custom props outside this interface.
-
-```typescript
-interface WidgetProps {
-  props: Record<string, unknown>; // widget-specific config from page definition
-  bind: {
-    value: unknown; // resolved binding value
-    setValue?: (val: unknown) => void; // setter (only for input widgets)
-    meta?: FieldMeta; // field metadata from model
-    error?: string; // validation error from FormContext
-    id?: string; // resolved record ID
-  };
-  on: Record<string, (...args: unknown[]) => void>; // trigger handlers
-  context: { record; model; mode; index }; // parent widget context
-  childNodes?: WidgetNode[]; // raw children for container widgets
-  children?: ReactNode; // pre-rendered children
-}
-```
-
-### Shared hooks (MUST reuse, never recreate)
-
-| Hook                               | Location                            | Purpose                                                                             |
-| ---------------------------------- | ----------------------------------- | ----------------------------------------------------------------------------------- |
-| `useBind`                          | `widgets/hooks/useBind.ts`          | Resolves binding to value/setValue/meta. Integrates with FormContext automatically. |
-| `useAction` / `useTriggerHandlers` | `widgets/hooks/useAction.ts`        | Dispatches actions. Merges form handlers when inside FormContext.                   |
-| `useWidgetContext`                 | `widgets/hooks/useWidgetContext.ts` | Access current WidgetContext (record, model, mode).                                 |
-| `useCondition`                     | `widgets/hooks/useCondition.ts`     | Evaluates visibility conditions.                                                    |
-| `useModelRecord`                   | `widgets/data/useModelRecord.ts`    | Fetch single record by model + id. Uses TanStack Query.                             |
-| `useModelQuery`                    | `widgets/data/useModelQuery.ts`     | Fetch list with pagination/sort/filter. Reads magic variables from StateStore.      |
-| `useDataQuery`                     | `widgets/hooks/useDataQuery.ts`     | Low-level hook for magic variable integration. Used by useModelQuery.               |
-| `usePageState`                     | `widgets/hooks/usePageState.ts`     | Access page-level StateStore for $filter, $sort, $page, $search.                    |
-| `useFormContext`                   | `widgets/form/FormContext.ts`       | Access form state. Returns null when not inside a FormProvider.                     |
-
-### Binding resolution flow
-
-1. `WidgetRenderer` calls `useBind(node.bind, fieldMeta, setValue)`
-2. `useBind` calls `resolveBinding()` which handles field/expression/model bindings
-3. If inside a `FormProvider` and bind has a field, `useBind` overrides with form-backed value/setValue/error
-4. The resolved `BindingResult` is passed to the widget via `widgetProps.bind`
-
-Widgets never call `resolveBinding` directly. They read from `bind.value` and write via `bind.setValue`.
-
-### Action dispatch flow
-
-1. `WidgetRenderer` calls `useTriggerHandlers(node.on, handlers, boundField)`
-2. Each trigger wraps actions in a function that calls `dispatch(action, context, handlers)`
-3. If inside a FormProvider, `form.submit` and `form.reset` handlers are merged automatically
-4. Widgets receive the final handlers via `widgetProps.on`
-
-Widgets fire triggers by calling `on.change?.(value)`, `on.click?.()`, etc. They never call `dispatch` directly.
-
-### Widget registration pattern
-
-Every widget file exports a component + static `widgetMeta`:
-
-```typescript
-export function MyWidget({ props, bind, on }: WidgetProps) { ... }
-
-MyWidget.widgetMeta = {
-  name: 'my-widget',           // unique type key (used in page definitions)
-  label: 'My Widget',
-  category: 'input' | 'display' | 'layout' | 'action' | 'data',
-  schema: { ... },             // prop definitions
-  binding: 'none' | 'field' | 'expression' | 'record' | 'model',
-  triggers: ['change', ...],   // events this widget can fire
-  container: false,            // true if it renders children
-};
-```
-
-Then add the import + entry in `widgets/components/register.ts`.
-
-### WidgetContext hierarchy
-
-- `WidgetContext` holds `record`, `model`, `mode`, `parent`
-- Container widgets (data, form, table, repeat) provide a new WidgetContext via `WidgetContextProvider`
-- Child widgets read their nearest context via `useWidgetContext()`
-- `buildContext(node, parentCtx)` in `widgets/context/builder.ts` derives child context from parent
-
-### Container widgets that render children
-
-Two patterns exist:
-
-1. **Render `children` prop directly** (most layout widgets: group, grid, section, card, split)
-2. **Render `childNodes` via WidgetRenderer** (data, form, repeat, table). Use this when the widget provides a new WidgetContext that children must inherit.
-
-Pattern 2 avoids context shadowing. If you render pre-built `children`, they already have their own WidgetContextProvider from the renderer. Use `childNodes` + manual WidgetRenderer when your widget needs to inject context.
-
-## Skills available
-
-- **`add-widget`** — step-by-step for creating any new widget type with checklist
-
-Read this skill before writing any new widget.
-
-## Rules
-
-### Layout widgets render Tailwind directly
-
-Layout widgets (Group, Grid, Split, Section, Spacer, ScrollArea, Stack) render Tailwind utility classes directly.
-
-- Group/Grid/Section/Spacer/Stack emit plain `<div>` elements with Tailwind classes
-- Split uses shadcn ResizablePanelGroup from `src/components/ui/resizable.tsx`
-- ScrollArea uses shadcn ScrollArea from `src/components/ui/scroll-area.tsx`
-- Section uses shadcn Collapsible from `src/components/ui/collapsible.tsx`
-
-### Universal layout props
-
-Any widget can accept layout props (`flex`, `span`, `rowSpan`, `align`, `width`, `height`, `minWidth`, `maxWidth`, `minHeight`, `maxHeight`, `scroll`, `padding`, `paddingX`, `paddingY`, `margin`, `marginX`, `marginY`, `hidden`). These are defined in the flat `props` field alongside widget-specific props.
-
-The WidgetRenderer extracts layout props and wraps the widget in a layout div when present. The resolver lives in `src/widgets/lib/layout-props.ts`.
-
-### Spacing tokens
-
-All spacing uses a 7-token scale on a 4px base grid:
-
-| Token | Value | Tailwind |
-| ----- | ----- | -------- |
-| none  | 0     | 0        |
-| xs    | 4px   | 1        |
-| sm    | 8px   | 2        |
-| md    | 16px  | 4        |
-| lg    | 24px  | 6        |
-| xl    | 32px  | 8        |
-| 2xl   | 48px  | 12       |
-
-### Always refer to the design system
-
-All visual decisions must follow `.interface-design/system.md` at the repo root. This includes:
-
-- Color tokens (use semantic names: `text`, `text-muted`, `surface`, `border`, etc.)
-- Spacing (4px grid via Tailwind utilities)
-- Typography (`text-sm` as default body, `text-xs` for labels)
-- Radius (`rounded-sm` for most elements)
-- Transitions (`duration-fast` for hover/focus)
-
-Never hardcode colors, shadows, or radii. Use the token system.
-
-### Styling
-
-- Use Tailwind utility classes exclusively — no inline styles, no CSS modules
-- Dark mode via `[data-theme="dark"]` attribute
-
-### Component patterns
-
-- Layout widgets render Tailwind directly
-- Non-layout widgets use local shadcn components from `src/components/ui/`
-- Keep shell components focused — one concern per file
-- Use the `useShell()` hook for toast, overlay, panel, and navigate actions
-
-### Data flow
-
-- All data comes from the server via `/api/meta/boot` (metadata) and `/api/{module}/{model}` (records)
-- `useSource` for lists with pagination/sort/filter
-- `useRecord` for single records
-- `useMutation` for create/update/delete
-- Never make raw fetch calls in components — use the data hooks
-
-### Custom view loading
-
-- Custom views are loaded via dynamic `import()` from the manifest at `/_rangka/manifest.json`
-- The shell resolves view names: custom views take priority over built-in views
-- Custom views receive `ViewProps` (source, config, shell, modelMeta)
-
-## Commands
-
-```bash
-pnpm dev:client              # Vite dev server on port 5173 (proxy to API on 3000)
-pnpm playground              # Start API server on port 3000
-pnpm --filter @rangka/client build   # Build shell → dist/shell/
-pnpm --filter @rangka/client test    # Run tests
-```
-
-## Don'ts
-
-- Don't hardcode colors or spacing — use tokens
-- Don't use inline styles — use Tailwind classes
-- Don't fetch data without hooks — use useSource/useRecord/useMutation
-- Don't import from `@rangka/core` — this is a browser package, core is server-only
-- Don't add direct DOM manipulation — use React patterns and `rangka:*` events for cross-panel communication
-- Don't create new data-fetching logic — use `useModelRecord` or `useModelQuery` from `widgets/data/`
-- Don't bypass `useBind` — every widget reads data through `bind.value` and writes through `bind.setValue`
-- Don't call `dispatch` directly from widgets — use the `on` handlers from WidgetProps
-- Don't add props outside the `WidgetProps` interface — extend `props` or `bind` in the shared types if needed
-- Don't create a new hook that duplicates `useBind`, `useAction`, `useModelRecord`, or `useModelQuery`
-- Don't read `useWidgetContext()` for field values — use `bind.value` which already resolves context + form state
-- Don't modify the `WidgetProps` interface without checking every existing widget that consumes it
-- Don't register a widget without `widgetMeta` — the registry depends on it

package/components.json

@@ -1,25 +0,0 @@
-{
-  "$schema": "https://ui.shadcn.com/schema.json",
-  "style": "radix-nova",
-  "rsc": false,
-  "tsx": true,
-  "tailwind": {
-    "config": "",
-    "css": "src/index.css",
-    "baseColor": "neutral",
-    "cssVariables": true,
-    "prefix": ""
-  },
-  "iconLibrary": "lucide",
-  "rtl": false,
-  "aliases": {
-    "components": "@/components",
-    "utils": "@/lib/utils",
-    "ui": "@/components/ui",
-    "lib": "@/lib",
-    "hooks": "@/hooks"
-  },
-  "menuColor": "default",
-  "menuAccent": "bold",
-  "registries": {}
-}

package/dist/components/ui/chart.d.ts

@@ -1,45 +0,0 @@
-import * as React from 'react';
-import * as RechartsPrimitive from 'recharts';
-import type { TooltipValueType } from 'recharts';
-declare const THEMES: {
-    readonly light: "";
-    readonly dark: ".dark";
-};
-type TooltipNameType = number | string;
-export type ChartConfig = Record<string, {
-    label?: React.ReactNode;
-    icon?: React.ComponentType;
-} & ({
-    color?: string;
-    theme?: never;
-} | {
-    color?: never;
-    theme: Record<keyof typeof THEMES, string>;
-})>;
-declare function ChartContainer({ id, className, children, config, initialDimension, ...props }: React.ComponentProps<'div'> & {
-    config: ChartConfig;
-    children: React.ComponentProps<typeof RechartsPrimitive.ResponsiveContainer>['children'];
-    initialDimension?: {
-        width: number;
-        height: number;
-    };
-}): React.JSX.Element;
-declare const ChartStyle: ({ id, config }: {
-    id: string;
-    config: ChartConfig;
-}) => React.JSX.Element | null;
-declare const ChartTooltip: typeof RechartsPrimitive.Tooltip;
-declare function ChartTooltipContent({ active, payload, className, indicator, hideLabel, hideIndicator, label, labelFormatter, labelClassName, formatter, color, nameKey, labelKey, }: React.ComponentProps<typeof RechartsPrimitive.Tooltip> & React.ComponentProps<'div'> & {
-    hideLabel?: boolean;
-    hideIndicator?: boolean;
-    indicator?: 'line' | 'dot' | 'dashed';
-    nameKey?: string;
-    labelKey?: string;
-} & Omit<RechartsPrimitive.DefaultTooltipContentProps<TooltipValueType, TooltipNameType>, 'accessibilityLayer'>): React.JSX.Element | null;
-declare const ChartLegend: React.MemoExoticComponent<(outsideProps: RechartsPrimitive.LegendProps) => React.ReactPortal | null>;
-declare function ChartLegendContent({ className, hideIcon, payload, verticalAlign, nameKey, }: React.ComponentProps<'div'> & {
-    hideIcon?: boolean;
-    nameKey?: string;
-} & RechartsPrimitive.DefaultLegendContentProps): React.JSX.Element | null;
-export { ChartContainer, ChartTooltip, ChartTooltipContent, ChartLegend, ChartLegendContent, ChartStyle, };
-//# sourceMappingURL=chart.d.ts.map

package/dist/components/ui/chart.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"chart.d.ts","sourceRoot":"","sources":["../../../src/components/ui/chart.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,iBAAiB,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAKjD,QAAA,MAAM,MAAM;;;CAAwC,CAAC;AAGrD,KAAK,eAAe,GAAG,MAAM,GAAG,MAAM,CAAC;AAEvC,MAAM,MAAM,WAAW,GAAG,MAAM,CAC9B,MAAM,EACN;IACE,KAAK,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IACxB,IAAI,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC5B,GAAG,CACA;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,GACjC;IAAE,KAAK,CAAC,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,OAAO,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAChE,CACF,CAAC;AAkBF,iBAAS,cAAc,CAAC,EACtB,EAAE,EACF,SAAS,EACT,QAAQ,EACR,MAAM,EACN,gBAAoC,EACpC,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG;IAC/B,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,iBAAiB,CAAC,mBAAmB,CAAC,CAAC,UAAU,CAAC,CAAC;IACzF,gBAAgB,CAAC,EAAE;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH,qBAsBA;AAED,QAAA,MAAM,UAAU,GAAI,gBAAgB;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,6BA2BtE,CAAC;AAEF,QAAA,MAAM,YAAY,kCAA4B,CAAC;AAE/C,iBAAS,mBAAmB,CAAC,EAC3B,MAAM,EACN,OAAO,EACP,SAAS,EACT,SAAiB,EACjB,SAAiB,EACjB,aAAqB,EACrB,KAAK,EACL,cAAc,EACd,cAAc,EACd,SAAS,EACT,KAAK,EACL,OAAO,EACP,QAAQ,GACT,EAAE,KAAK,CAAC,cAAc,CAAC,OAAO,iBAAiB,CAAC,OAAO,CAAC,GACvD,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG;IAC5B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,QAAQ,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,IAAI,CACN,iBAAiB,CAAC,0BAA0B,CAAC,gBAAgB,EAAE,eAAe,CAAC,EAC/E,oBAAoB,CACrB,4BAiHF;AAED,QAAA,MAAM,WAAW,sGAA2B,CAAC;AAE7C,iBAAS,kBAAkB,CAAC,EAC1B,SAAS,EACT,QAAgB,EAChB,OAAO,EACP,aAAwB,EACxB,OAAO,GACR,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,iBAAiB,CAAC,yBAAyB,4BA4C9C;AA2BD,OAAO,EACL,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,WAAW,EACX,kBAAkB,EAClB,UAAU,GACX,CAAC"}