@object-ui/runner 17.3.0 → 17.6.0

package/CHANGELOG.md

@@ -1,5 +1,283 @@
 # @object-ui/runner
 
+## 17.6.0
+
+### Patch Changes
+
+- 5607092: objectui#4029 — the repo root now lints `no-console` (`error`, allowing
+  `warn`/`error`) so a stray module- or function-scope `console.log`/`info`/
+  `debug` fails CI instead of shipping silently (as `console.log('Registering
+  object-map...')` did in #7139, caught only by hand). Landing the rule meant
+  individually judging every real hit outside the tooling exemptions
+  (`scripts/**`, `**/examples/**`, test files, `packages/cli/src/**`,
+  `packages/create-plugin/src/**`) — this changeset covers the published
+  packages whose call sites changed:
+  
+  - `@object-ui/app-shell`: `ObjectDataPage`'s dropped-URL-filter message is a
+    real diagnostic (data silently discarded), so it moves from `console.debug`
+    to `console.warn` to match the house convention.
+  - `@object-ui/plugin-detail`: `DetailView`'s Web Share API failure now reports
+    via `console.error` (it is a real failure, not debug noise); a redundant
+    "Link copied to clipboard" success log is removed.
+  - `@object-ui/fields`: `MasterDetailField`'s `handleView` stub no longer logs
+    the item it does nothing with.
+  - `@object-ui/runner`: `App`'s loader-selection debug prints, `LayoutRenderer`'s
+    unused click-handler stub log, and `MockDataSource`'s per-call narration
+    (`find`/`create`/`getObjectSchema`) are removed — none diagnosed a problem,
+    they only echoed the happy path.
+  - `object-ui` (VS Code extension): the "extension is now active!" activation
+    log is removed.
+  
+  No behavior changes beyond console output. `@object-ui/core` and
+  `@object-ui/data-objectstack` also touch `no-console`-adjacent lines
+  (`debugLog`/`debugTime`/`debugTimeEnd`, `createQuietHttpLogger`) but only to
+  add `eslint-disable-next-line` documentation — those ARE the repo's
+  deliberate debug/logger infrastructure, not leaked residue, so their own
+  changeset carries empty frontmatter.
+- Updated dependencies [88085e3]
+- Updated dependencies [516663d]
+- Updated dependencies [feb6b16]
+- Updated dependencies [460c4d0]
+- Updated dependencies [0ae27f7]
+- Updated dependencies [2533ec5]
+- Updated dependencies [78c0f9a]
+- Updated dependencies [bbe8b86]
+- Updated dependencies [e132433]
+- Updated dependencies [8477be5]
+- Updated dependencies [f95434b]
+- Updated dependencies [279fb13]
+- Updated dependencies [2e82ab2]
+- Updated dependencies [ad07b65]
+- Updated dependencies [41f498b]
+- Updated dependencies [e1d4251]
+- Updated dependencies [40d3a33]
+- Updated dependencies [8b9dc62]
+- Updated dependencies [1184192]
+- Updated dependencies [a2a9747]
+- Updated dependencies [a1609a6]
+- Updated dependencies [53f23bc]
+- Updated dependencies [c4533dc]
+- Updated dependencies [be60815]
+- Updated dependencies [37f6844]
+- Updated dependencies [93de4f6]
+- Updated dependencies [2b50261]
+- Updated dependencies [384f30d]
+- Updated dependencies [ac600e5]
+- Updated dependencies [97fba31]
+- Updated dependencies [232f61a]
+- Updated dependencies [d374caf]
+- Updated dependencies [5673576]
+- Updated dependencies [c1ef923]
+- Updated dependencies [911ceaa]
+- Updated dependencies [98eab36]
+- Updated dependencies [af5e292]
+- Updated dependencies [3fbbea1]
+- Updated dependencies [3241559]
+- Updated dependencies [7f96b10]
+- Updated dependencies [167ec42]
+- Updated dependencies [616a2a5]
+- Updated dependencies [0046d8f]
+- Updated dependencies [f1d4748]
+- Updated dependencies [b1119ec]
+- Updated dependencies [9f23d2b]
+- Updated dependencies [578e025]
+- Updated dependencies [af025ee]
+- Updated dependencies [598c89a]
+- Updated dependencies [4a0bd17]
+- Updated dependencies [b8b9af4]
+- Updated dependencies [31676be]
+- Updated dependencies [8c0d52e]
+- Updated dependencies [aff10e2]
+- Updated dependencies [70a774b]
+- Updated dependencies [9ce096f]
+- Updated dependencies [e05db88]
+- Updated dependencies [7458a41]
+- Updated dependencies [5ffcc14]
+- Updated dependencies [d971e51]
+- Updated dependencies [97abb24]
+- Updated dependencies [deb157a]
+- Updated dependencies [d2ce342]
+- Updated dependencies [9695da7]
+- Updated dependencies [75444e3]
+- Updated dependencies [58b8346]
+- Updated dependencies [2d0bd16]
+- Updated dependencies [d298be8]
+- Updated dependencies [dad51e5]
+- Updated dependencies [1c9c342]
+- Updated dependencies [787c738]
+- Updated dependencies [8396656]
+- Updated dependencies [dbbd38a]
+- Updated dependencies [2165d88]
+- Updated dependencies [93fe362]
+- Updated dependencies [dfc6975]
+- Updated dependencies [3cf4de0]
+- Updated dependencies [c9dc811]
+- Updated dependencies [144ef9b]
+- Updated dependencies [138ab04]
+- Updated dependencies [a0b9e91]
+- Updated dependencies [99bd015]
+  - @object-ui/types@17.6.0
+  - @object-ui/react@17.6.0
+  - @object-ui/plugin-kanban@17.6.0
+  - @object-ui/components@17.6.0
+  - @object-ui/core@17.6.0
+  - @object-ui/plugin-charts@17.6.0
+
+## 17.5.0
+
+### Patch Changes
+
+- d0c3b26: Every plain `<button>` now declares its `type`. HTML defaults an untyped button to
+  `type="submit"`, so any of these buttons would submit the form it was composed into
+  instead of running its own handler — a real risk for renderers (`drawer`, `tree-view`,
+  `navigation-overlay`) whose placement inside a form is a JSON metadata decision. 114
+  sites were converted to `type="button"`; no site was a genuine submit button, and the
+  DOM is otherwise unchanged.
+
+  The defect class is now closed mechanically by a new `object-ui/button-has-type` ESLint
+  rule (error), so the next untyped button fails CI at write time rather than being found
+  by a fourth audit round (objectui#4045, closing the objectui#3344 family).
+
+- Updated dependencies [ceccdcf]
+- Updated dependencies [d6e5124]
+- Updated dependencies [debad27]
+- Updated dependencies [dc2aa3e]
+- Updated dependencies [ee66e2e]
+- Updated dependencies [ee26e65]
+- Updated dependencies [5900ac5]
+- Updated dependencies [f650253]
+- Updated dependencies [3d9769a]
+- Updated dependencies [8f85f8b]
+- Updated dependencies [d0c3b26]
+- Updated dependencies [3fc2971]
+- Updated dependencies [aca27fa]
+- Updated dependencies [dde7283]
+- Updated dependencies [4dadf0d]
+- Updated dependencies [ae10a01]
+- Updated dependencies [92876f0]
+- Updated dependencies [f279deb]
+- Updated dependencies [4b70d28]
+- Updated dependencies [eb7f586]
+- Updated dependencies [e901131]
+- Updated dependencies [d9d3463]
+- Updated dependencies [2a40f69]
+- Updated dependencies [bec3e14]
+- Updated dependencies [613b167]
+- Updated dependencies [b4d3c22]
+- Updated dependencies [1f9b905]
+- Updated dependencies [cb13400]
+- Updated dependencies [bc64bfe]
+- Updated dependencies [abb0f81]
+- Updated dependencies [38ab505]
+- Updated dependencies [3e19fe7]
+- Updated dependencies [2c8ad7c]
+- Updated dependencies [fa21254]
+- Updated dependencies [b953a97]
+- Updated dependencies [d7f3e30]
+- Updated dependencies [7e4f0e5]
+- Updated dependencies [a84385b]
+- Updated dependencies [45e1949]
+- Updated dependencies [0b49d60]
+- Updated dependencies [bcd3e02]
+- Updated dependencies [92250d6]
+- Updated dependencies [c1d939f]
+- Updated dependencies [49ae9f4]
+- Updated dependencies [a3ae404]
+- Updated dependencies [5fac011]
+- Updated dependencies [bfdf3d4]
+- Updated dependencies [bb68488]
+- Updated dependencies [b1e42d0]
+- Updated dependencies [2459a3e]
+- Updated dependencies [d6aa172]
+- Updated dependencies [fe52a04]
+- Updated dependencies [3f5f87c]
+- Updated dependencies [f5e1143]
+- Updated dependencies [f148a64]
+- Updated dependencies [bb68488]
+- Updated dependencies [9461dd3]
+- Updated dependencies [47f551b]
+- Updated dependencies [ab04728]
+- Updated dependencies [5bf09fd]
+  - @object-ui/react@17.5.0
+  - @object-ui/components@17.5.0
+  - @object-ui/core@17.5.0
+  - @object-ui/plugin-charts@17.5.0
+  - @object-ui/types@17.5.0
+  - @object-ui/plugin-kanban@17.5.0
+
+## 17.4.0
+
+### Patch Changes
+
+- 04fb8b8: Runner in-app navigation now carries the current query string across to the pushed URL instead of `pushState`-ing a bare path. Opening the Runner with `?api=<base>` and clicking a sidebar entry no longer drops the parameter from the address bar, so reloading or sharing the resulting URL still reaches the same backend rather than silently falling back to the (normally empty) `LocalBundleLoader` and rendering `Page not found`. The whole query string is preserved, not just `api` — `@object-ui/core`'s `?__debug…` flags survive navigation for the same reason. A navigation target that spells out its own query keeps it and wins on collision, with the remaining current parameters merged in behind it (#3578).
+- 03f25f7: Complete `packages/runner/vite.config.ts`'s workspace alias table to the full
+  transitive import closure, so `@object-ui/runner` boots and builds from the
+  monorepo sources without a prior `pnpm -w build` (objectui#3575).
+
+  The table aliased 7 `@object-ui/*` specifiers to `packages/*/src`, but those
+  `src` trees import 8 more workspace packages that were not aliased. Those fell
+  back to Node resolution and landed on `packages/<pkg>/dist`, which does not
+  exist in a fresh install-only checkout — so the "From Source" flow documented in
+  `content/docs/utilities/runner.mdx` (`pnpm install` then `pnpm dev`, no build
+  step) failed with "Failed to run dependency scan" and served HTTP 500 for every
+  module on the chain. `pnpm --filter @object-ui/runner build` failed the same way.
+
+  Newly aliased: `i18n`, `sdui-parser`, `react-runtime`, `fields`, `plugin-detail`
+  (first layer), `providers` and `permissions` (only reachable once the first layer
+  resolves to src), and `data-objectstack` (a type-only import that esbuild erases,
+  so the dependency scan never reported it).
+
+  This is user-visible in the published artifact, because the alias table is not
+  scoped by `command` and therefore applies to `vite build` as well. Bundling the
+  newly aliased packages from src stops the per-icon `lucide-react/dynamic.mjs`
+  chunks from being inlined, so the build now emits ~1.7k lazy icon micro-chunks
+  like `apps/console` does. `build.modulePreload` is disabled to match console, so
+  those chunks are not all preloaded on first paint: the measured initial eager
+  payload drops from 4231003 to 591795 bytes, while total `dist` size grows about
+  5.5% because the previously inlined icons are now separate files.
+
+- Updated dependencies [794c497]
+- Updated dependencies [993336f]
+- Updated dependencies [f0a625a]
+- Updated dependencies [b5980f4]
+- Updated dependencies [8aad9fd]
+- Updated dependencies [6719877]
+- Updated dependencies [56ff091]
+- Updated dependencies [0cbdca8]
+- Updated dependencies [d229dfa]
+- Updated dependencies [ecae400]
+- Updated dependencies [a7e39a8]
+- Updated dependencies [4bc6c23]
+- Updated dependencies [d3e738a]
+- Updated dependencies [c3b01a7]
+- Updated dependencies [7ed3360]
+- Updated dependencies [0fa5e4d]
+- Updated dependencies [5bfaabd]
+- Updated dependencies [e06810e]
+- Updated dependencies [ab3ad4f]
+- Updated dependencies [c2fd122]
+- Updated dependencies [e24d767]
+- Updated dependencies [aca561a]
+- Updated dependencies [48132f7]
+- Updated dependencies [0ef9dfd]
+- Updated dependencies [1d723e3]
+- Updated dependencies [0109f54]
+- Updated dependencies [7e5bb5d]
+- Updated dependencies [fbc23e0]
+- Updated dependencies [e6fdbdc]
+- Updated dependencies [54233b1]
+- Updated dependencies [97b63d7]
+- Updated dependencies [6bb454a]
+- Updated dependencies [523be48]
+- Updated dependencies [7e2b7e9]
+- Updated dependencies [c1e1e6b]
+  - @object-ui/components@17.4.0
+  - @object-ui/react@17.4.0
+  - @object-ui/core@17.4.0
+  - @object-ui/types@17.4.0
+  - @object-ui/plugin-charts@17.4.0
+  - @object-ui/plugin-kanban@17.4.0
+
 ## 17.3.0
 
 ### Patch Changes
@@ -1191,6 +1469,7 @@
 ### Patch Changes
 
 - 1b6dc64: fix: complete Tailwind v3→v4 migration cleanup
+
   - Rename deprecated `flex-shrink-0` → `shrink-0` and `flex-grow-N` →
     `grow-N` (Tailwind v4 dropped the long-form aliases). Affects
     data-table, fields/index, FileField, ChatbotEnhanced,
@@ -1494,6 +1773,7 @@
 - New plugin-object and ObjectQL SDK updates
 
   **Added:**
+
   - New Plugin: @object-ui/plugin-object - ObjectQL plugin for automatic table and form generation
     - ObjectTable: Auto-generates tables from ObjectQL object schemas
     - ObjectForm: Auto-generates forms from ObjectQL object schemas with create/edit/view modes
@@ -1502,6 +1782,7 @@
   - ObjectQL Integration: Enhanced ObjectQLDataSource with getObjectSchema() method using MetadataApiClient
 
   **Changed:**
+
   - Updated @objectql/sdk from ^1.8.3 to ^1.9.1
   - Updated @objectql/types from ^1.8.3 to ^1.9.1
 

package/README.md

@@ -5,22 +5,29 @@ Universal Object UI Application Runner - A standalone development server and run
 ## Features
 
 - **Schema Development** - Test and debug Object UI schemas in isolation
-- **Hot Reload** - Automatic reload on schema changes
-- **Plugin Support** - Pre-configured with popular plugins (Kanban, Charts, etc.)
+- **No-Restart Edits** - Under `src/app-data/` the dev server picks metadata changes up
+  without a restart, because that JSON is part of Vite's module graph; behind `?api=` it
+  cannot, because Vite never sees your backend ([Metadata Loading](#metadata-loading))
+- **Plugin Support** - Pre-configured with the Kanban and Charts plugins
 - **Development Ready** - Built-in Vite development server
 - **Production Build** - Optimized build for deployment
 
-## Installation
+## Running the Runner
 
-```bash
-pnpm add @object-ui/runner
-```
+The runner is an application, not a library: `package.json` declares no `main`,
+`module`, `exports` or `types`, so there is nothing to `import` from
+`@object-ui/runner`. You run it from a checkout of this repository:
 
-## Usage
+```bash
+git clone https://github.com/objectstack-ai/objectui.git
+cd objectui
+pnpm install
 
-### As a Development Tool
+# Start the dev server on http://localhost:5173
+pnpm --filter @object-ui/runner dev
+```
 
-The runner is primarily used for schema development and testing:
+Inside `packages/runner`, the same scripts are available directly:
 
 ```bash
 # Start development server
@@ -33,73 +40,85 @@ pnpm build
 pnpm preview
 ```
 
-### Programmatic Usage
+## Pre-installed Plugins
 
-You can also use the runner as a library in your projects:
+The runner comes with these two plugins pre-configured, registered by the imports in
+`src/App.tsx`:
 
-```typescript
-import { createRunner } from '@object-ui/runner';
+- **@object-ui/plugin-kanban** - Kanban board components
+- **@object-ui/plugin-charts** - Chart visualization components
 
-const runner = createRunner({
-  schema: mySchema,
-  plugins: ['kanban', 'charts'],
-  theme: 'light'
-});
+Adding any other plugin means editing the runner's own sources and rebuilding — a
+dependency in `package.json`, a registration import in `src/App.tsx`, and the
+`vite.config.ts` alias and `src/index.css` `@source` entries the two above have. There
+is no runtime plugin installation.
 
-runner.mount('#app');
-```
+## Metadata Loading
 
-## Pre-installed Plugins
+The runner picks its metadata loader when it mounts, from the `api` query parameter of
+the page URL (`src/App.tsx`). This is its only API base URL setting — it reads no
+environment variables and no config file:
 
-The runner comes with these plugins pre-configured:
+| URL | Loader | Where metadata comes from |
+| --- | --- | --- |
+| `http://localhost:5173/` | `LocalBundleLoader` | JSON bundled from `src/app-data/` at build time |
+| `http://localhost:5173/?api=/api` | `NetworkLoader` | `fetch`ed from the base URL you passed |
 
-- **@object-ui/plugin-kanban** - Kanban board components
-- **@object-ui/plugin-charts** - Chart visualization components
-- **Additional plugins can be added as needed**
+With `?api=<base>`, the value is used verbatim as a base URL and fixed paths are
+appended to it, so a backend only has to serve two kinds of JSON document:
 
-## Schema Loading
+```text
+GET <base>/app.json                 # the app document, loaded once at startup
+GET <base>/pages/index.json         # route "/"
+GET <base>/pages/customers.json     # route "/customers"
+GET <base>/pages/crm/accounts.json  # route "/crm/accounts"
+```
 
-The runner can load schemas from various sources:
+A relative base (`?api=/api`) keeps the requests same-origin; an absolute one needs
+CORS on the backend. `fetch` is called with no options, so no credentials or custom
+headers are sent, and any non-2xx status or network error becomes `null` — which the
+runner renders as a 404 rather than surfacing the status.
 
-```typescript
-// From JSON file
-const schema = await import('./my-schema.json');
+Without the parameter, `LocalBundleLoader` resolves `src/app-data/app.json` and
+`src/app-data/pages/**/*.json` through Vite's `import.meta.glob`. That directory is
+git-ignored and absent from a fresh checkout, so every load returns `null` until you
+copy or symlink your own metadata directory into it.
 
-// From JavaScript/TypeScript
-const schema = {
-  type: 'page',
-  title: 'My App',
-  body: {
-    type: 'card',
-    content: 'Hello World'
-  }
-};
+In-app navigation carries the query string across, so `?api=…` stays in the address
+bar and the URL you copy or reload reaches the same backend.
 
-// From API endpoint
-const schema = await fetch('/api/schema').then(r => r.json());
-```
+Full details — route resolution order and error handling — are in the
+[Metadata Loading](https://www.objectui.org/docs/utilities/runner#metadata-loading)
+section of the docs.
 
 ## Configuration
 
-Create a `runner.config.js` file to customize the runner:
+There is no runner config file and no runner environment variables. The two surfaces
+that do configure it are:
 
-```javascript
-export default {
-  port: 3000,
-  host: 'localhost',
-  plugins: ['kanban', 'charts'],
-  theme: {
-    primaryColor: '#3b82f6',
-    darkMode: true
-  }
-};
-```
+- **`vite.config.ts`** — build options and the workspace alias table that lets the runner
+  boot straight from the monorepo sources. The dev server takes Vite's own defaults
+  (port 5173); change them with Vite's flags, e.g. `pnpm dev --port 3000`.
+- **The `api` query parameter** — the metadata base URL, described under
+  [Metadata Loading](#metadata-loading) above.
 
 ## Development Workflow
 
-1. Create a schema file (JSON or TypeScript)
+1. Author the metadata as JSON — both loaders resolve fixed `.json` paths, and JSON is
+   the only shape either of them can load. Pick one of the two routes described under
+   [Metadata Loading](#metadata-loading):
+   - **Bundled** — create `packages/runner/src/app-data/` and put `app.json` plus one
+     `pages/<route>.json` per route in it (route `/` is `pages/index.json`). That
+     directory is git-ignored, absent from a fresh checkout, and no script in this repo
+     creates it, so making it is a step you do by hand — until it exists, every load
+     returns nothing and the page renders as a 404.
+   - **Served** — run a backend that answers `<base>/app.json` and
+     `<base>/pages/<route>.json`, then open the runner with `?api=<base>`.
 2. Start the runner with `pnpm dev`
-3. Edit the schema - changes reload automatically
+3. Edit the metadata. Under `src/app-data/` the dev server picks the change up without a
+   restart, because that JSON is part of Vite's module graph; behind `?api=` it cannot,
+   because Vite never sees your backend. Reload the page if the view still shows the
+   previous document.
 4. Test your UI in the browser
 5. Build for production with `pnpm build`
 
@@ -146,19 +165,9 @@ export default {
 }
 ```
 
-## API Reference
-
-For detailed documentation, visit the [Object UI Documentation](https://www.objectui.org/docs/runner).
-
-<!-- release-metadata:v3.3.0 -->
-
-## Compatibility
+## Documentation
 
-- **Node.js:** ≥ 18
-- **TypeScript:** ≥ 5.0 (strict mode)
-- **`@objectstack/spec`:** ^3.3.0
-- **`@objectstack/client`:** ^3.3.0
-- **Tailwind CSS:** ≥ 3.4 (for packages with UI)
+For detailed documentation, visit the [Object UI Documentation](https://www.objectui.org/docs/utilities/runner).
 
 ## Links