@object-ui/providers 16.1.0 → 17.2.0

package/CHANGELOG.md

@@ -1,5 +1,136 @@
 # @object-ui/providers — Changelog
 
+## 17.2.0
+
+### Minor Changes
+
+- 4a51e77: Stop declaring 14 symbols across ten packages under names `@objectstack/spec`
+  owns (objectui#3161, objectstack#4115 batch 7 — the long tail, one or two
+  entries per package). All ten packages leave the ledger, which drops from 17
+  collisions across 11 packages to 3 across 1.
+
+  **Renamed exports** — in every case the spec exports the same name for a
+  _different_ thing, so the old name was a mis-description rather than a dialect:
+
+  | package                    | was                                | now                                                  | what the spec's same-named export is                                                                                                       |
+  | :------------------------- | :--------------------------------- | :--------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------- |
+  | `@object-ui/fields`        | `FieldWidgetProps`                 | `FieldWidgetComponentProps`                          | the DECLARED field-widget plugin props contract (a zod object; `field.type` is the `FieldType` enum, `readonly`/`required` carry defaults) |
+  | `@object-ui/layout`        | `PageHeaderProps`                  | `PageHeaderComponentProps`                           | the authored `page:header` node — a zod schema of `title`, `subtitle`, an icon NAME, `breadcrumb`, `actions: string[]`                     |
+  | `@object-ui/layout`        | `Page`                             | `PageNodeRenderer`                                   | the authored page metadata DOCUMENT (`name`, `label`, `type`, `regions`)                                                                   |
+  | `@object-ui/plugin-detail` | `ObjectFieldLike`                  | `ObjectDefFieldLike`                                 | the i18n duck type `translateObject` walks (`help`/`description`, plus `[key: string]: any`)                                               |
+  | `@object-ui/plugin-grid`   | `ColumnSummaryConfig`              | `ColumnSummarySetting`                               | the OBJECT form of `ListColumn.summary` **only** — the local one was the whole union, shorthand included                                   |
+  | `@object-ui/plugin-grid`   | `isMultiValueField`                | `hasMultiValueShape`                                 | the spec's classifier, which requires a def with a `type`; the local one is called with `undefined`                                        |
+  | `@object-ui/collaboration` | `RealtimeConfig`                   | `RealtimeSubscriptionConfig`                         | the app's realtime DECLARATION (`enabled`, `transport`, `subscriptions[]`)                                                                 |
+  | `@object-ui/plugin-charts` | `ChartConfig`                      | `ChartContainerConfig`                               | the authored chart document (`type`, `xAxis`, `series`, `showLegend`, …)                                                                   |
+  | `@object-ui/plugin-form`   | `FormSection` / `FormSectionProps` | `FormSectionContainer` / `FormSectionContainerProps` | the authored form-section metadata (`name`, `pane`, `visibleWhen`, `fields`)                                                               |
+  | `@object-ui/providers`     | `Theme`                            | `ThemePreference`                                    | a whole theme DOCUMENT (`name`, `label`, `colors`, `typography`)                                                                           |
+  | `@object-ui/runner`        | `App` (default export)             | `RunnerApp`                                          | the authored application metadata type **and** the `App.create()` builder                                                                  |
+  | `@object-ui/sdui-parser`   | `ValidationResult`                 | `ManifestValidationResult`                           | plugin-manifest validation (`{ valid, errors?, warnings? }`), exported from both `kernel` and `contracts`                                  |
+
+  `ManifestValidationResult` follows the `<what was validated>Validation<Error|Result>`
+  convention registered on objectstack#4115 (`@object-ui/core` took
+  `SchemaNodeValidationResult` in batch 4). `PageHeaderComponentProps` deliberately
+  reuses the name `@object-ui/app-shell` already chose for its own header props in
+  batch 3, so one concept does not acquire two dialect names one package apart.
+
+  **Now derived from the spec instead of hand-written:**
+
+  - `@object-ui/fields` — `isFileIdToken` is re-exported from
+    `@objectstack/spec/data`. The local copy was character-for-character identical
+    to the spec's function while its comment said it "mirrors" it, so every
+    behaviour test passed and only reference identity could tell the two apart.
+    The regex is a wire decision: widening it server-side while a copy here kept
+    the old bound would make every new id read as "not a reference", and the
+    widget would submit the legacy inline blob to a backend expecting a reference.
+  - `@object-ui/plugin-detail` — `FeedFilterMode` is re-exported from
+    `@objectstack/spec/data`, in a file that already imported the sibling
+    `FeedItemType` from the spec.
+  - `@object-ui/plugin-grid` — the eleven-member aggregation union is now the
+    spec's `ColumnSummary` enum, so the total `Record<ColumnSummaryType, string>`
+    label map turns a member the spec adds into a compile error instead of a
+    blank footer cell. `ColumnSummarySetting` is `NonNullable<ListColumn['summary']>`,
+    i.e. whatever forms the spec itself accepts. `hasMultiValueShape` delegates to
+    the spec's `isMultiValueField` rather than re-deriving it from
+    `MULTI_OPTION_TYPES` / `MULTI_CAPABLE_TYPES`.
+  - `@object-ui/providers` — `ThemePreference` is the spec's `ThemeMode` union
+    plus the one legacy `'system'` spelling this provider still honours for stored
+    preferences, read off the schema's own `_zod` carrier so the package takes no
+    zod dependency.
+
+  `@objectstack/spec` moves from `devDependencies` to `dependencies` in
+  `@object-ui/fields` (it re-exports a runtime function) and `@object-ui/providers`
+  (its public `.d.ts` now references the spec).
+
+  Scored `minor`, not `major`, per this repo's fixed-group rule — objectui's major
+  tracks `@objectstack`, so breaking changes of our own ship as minor with the
+  semantics spelled out above (see AGENTS.md §版本号策略). A `major` here would carry
+  all 39 packages of the fixed group to `18.0.0` and off objectstack's 17.x line.
+
+### Patch Changes
+
+- Updated dependencies [4ae0ac4]
+- Updated dependencies [696e3c1]
+- Updated dependencies [4bf612c]
+- Updated dependencies [cb82705]
+- Updated dependencies [f572849]
+- Updated dependencies [444457c]
+- Updated dependencies [022e4c3]
+- Updated dependencies [009e25d]
+- Updated dependencies [726b89c]
+  - @object-ui/types@17.2.0
+
+## 17.1.0
+
+### Patch Changes
+
+- Updated dependencies [9e7349e]
+- Updated dependencies [8864971]
+- Updated dependencies [b41f401]
+- Updated dependencies [19e9fa0]
+- Updated dependencies [38ca8be]
+- Updated dependencies [4952edf]
+- Updated dependencies [7f0252e]
+- Updated dependencies [7639a61]
+- Updated dependencies [94e63ef]
+- Updated dependencies [c4db402]
+- Updated dependencies [5319bf1]
+- Updated dependencies [49e5671]
+- Updated dependencies [b5b97e2]
+- Updated dependencies [f59f2c1]
+- Updated dependencies [4874117]
+- Updated dependencies [ce08d55]
+- Updated dependencies [2374a49]
+- Updated dependencies [ea7f477]
+- Updated dependencies [7f23cd0]
+- Updated dependencies [24e0e0a]
+- Updated dependencies [3a6cf24]
+- Updated dependencies [aa35561]
+- Updated dependencies [03bd53b]
+- Updated dependencies [3c1f321]
+- Updated dependencies [a045a32]
+- Updated dependencies [912496d]
+- Updated dependencies [9867281]
+  - @object-ui/types@17.1.0
+
+## 17.0.0
+
+### Patch Changes
+
+- Updated dependencies [1767124]
+- Updated dependencies [8ecf5a6]
+- Updated dependencies [dfd3705]
+- Updated dependencies [6dee2cb]
+- Updated dependencies [c7cff19]
+- Updated dependencies [cd09a7b]
+- Updated dependencies [f1abf0e]
+- Updated dependencies [f05b84e]
+- Updated dependencies [662bdf9]
+- Updated dependencies [059a052]
+- Updated dependencies [53642d4]
+- Updated dependencies [8aae006]
+- Updated dependencies [d147a13]
+  - @object-ui/types@17.0.0
+
 ## 16.1.0
 
 ### Patch Changes

package/dist/ThemeProvider.d.ts

@@ -1,7 +1,7 @@
-import type { Theme, ThemeProviderProps } from './types';
+import type { ThemePreference, ThemeProviderProps } from './types';
 interface ThemeContextValue {
-    theme: Theme;
-    setTheme: (theme: Theme) => void;
+    theme: ThemePreference;
+    setTheme: (theme: ThemePreference) => void;
 }
 /**
  * ThemeProvider - Theme management

package/dist/ThemeProvider.js

@@ -17,7 +17,11 @@ export function ThemeProvider({ defaultTheme = 'system', storageKey = 'ui-theme'
     useEffect(() => {
         const root = window.document.documentElement;
         root.classList.remove('light', 'dark');
-        if (theme === 'system') {
+        // The spec's OS-following mode is `auto` (ThemeModeSchema, ui/theme.zod.ts);
+        // `system` is this provider's pre-spec spelling, kept for stored values.
+        // Branching on `system` alone sent `auto` into `classList.add('auto')` —
+        // a class no Tailwind variant matches, locking the light theme (#2942).
+        if (theme === 'auto' || theme === 'system') {
             const systemTheme = window.matchMedia('(prefers-color-scheme: dark)')
                 .matches
                 ? 'dark'

package/dist/index.d.ts

@@ -7,5 +7,5 @@ export { DataSourceProvider, useDataSource } from './DataSourceProvider';
 export { MetadataProvider, useMetadata } from './MetadataProvider';
 export { ThemeProvider, useTheme } from './ThemeProvider';
 export { UploadProvider, useUpload, createObjectUrlAdapter, createS3Adapter, createAzureBlobAdapter, createObjectStackUploadAdapter, } from './UploadProvider';
-export type { DataSourceProviderProps, MetadataProviderProps, ThemeProviderProps, Theme, } from './types';
+export type { DataSourceProviderProps, MetadataProviderProps, ThemeProviderProps, ThemePreference, } from './types';
 export type { UploadAdapter, UploadOptions, UploadResult, UploadProviderProps, S3AdapterOptions, AzureBlobAdapterOptions, ObjectStackUploadAdapterOptions, } from './UploadProvider';

package/dist/types.d.ts

@@ -1,4 +1,5 @@
 import type { ReactNode } from 'react';
+import type { ThemeModeSchema } from '@objectstack/spec/ui';
 export interface DataSourceProviderProps {
     dataSource: any;
     children: ReactNode;
@@ -7,9 +8,34 @@ export interface MetadataProviderProps {
     metadata?: any;
     children: ReactNode;
 }
-export type Theme = 'light' | 'dark' | 'system';
+/**
+ * The theme MODE this provider stores and applies: the spec's `ThemeMode`
+ * vocabulary (`auto | light | dark`) plus the one legacy spelling this package
+ * still accepts.
+ *
+ * Named `ThemePreference`, not `Theme` (objectui#3161, objectstack#4115 ledger
+ * batch 7). `@objectstack/spec/ui` owns `Theme` for a whole theme DOCUMENT —
+ * `{ name, label, mode, colors: { primary, background, … }, typography, … }` —
+ * so the local declaration was not a drifted copy of the spec's `Theme` at all;
+ * it was the spec's `Theme['mode']` under the spec's `Theme` name, which is the
+ * more misleading of the two failures: a session reading `Theme` here would
+ * conclude an ObjectStack theme is a string. The spec's own name for this
+ * concept, `ThemeMode`, is exported too, so THAT name could not be taken either
+ * (the "run the new name past the guard first" rule from objectui#3169 — it
+ * would have traded one collision for another); and it would be wrong anyway,
+ * because of `'system'`.
+ *
+ * The three real modes are now the spec enum rather than a hand copy of it, so
+ * a mode the spec adds arrives here and `ThemeProvider`'s branch must handle
+ * it. `'system'` stays as an explicit local union member: it is the pre-spec
+ * spelling of `auto`, still sitting in users' `localStorage`, and the provider
+ * treats the two identically (#2942, pinned in `theme-mode-spec-parity`).
+ * Reached through the schema's `_zod` carrier so this package takes no zod
+ * dependency — same technique as `packages/react/src/spec-input.ts`.
+ */
+export type ThemePreference = (typeof ThemeModeSchema)['_zod']['input'] | 'system';
 export interface ThemeProviderProps {
-    defaultTheme?: Theme;
+    defaultTheme?: ThemePreference;
     storageKey?: string;
     children: ReactNode;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@object-ui/providers",
-  "version": "16.1.0",
+  "version": "17.2.0",
   "type": "module",
   "license": "MIT",
   "description": "Reusable context providers for ObjectUI applications",
@@ -24,7 +24,8 @@
     }
   },
   "dependencies": {
-    "@object-ui/types": "16.1.0"
+    "@objectstack/spec": "^17.0.0-rc.1",
+    "@object-ui/types": "17.2.0"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",
@@ -61,7 +62,7 @@
   "scripts": {
     "build": "tsc",
     "test": "vitest run",
-    "type-check": "tsc --noEmit",
+    "type-check": "tsc --noEmit && tsc -p tsconfig.test.json",
     "lint": "eslint ."
   }
 }