@object-ui/core 17.2.0 → 17.5.0

package/dist/protocols/KeyboardProtocol.d.ts

@@ -15,7 +15,37 @@
  * @module protocols/KeyboardProtocol
  * @packageDocumentation
  */
-import type { KeyboardNavigationConfig, KeyboardShortcut, FocusTrapConfig } from '@object-ui/types';
+/** A single keyboard shortcut binding. */
+export interface KeyboardShortcut {
+    key: string;
+    action: string;
+    description?: string;
+    scope: 'global' | 'form' | 'modal' | 'view' | 'list';
+}
+/** Focus trap declaration for a modal-like region. */
+export interface FocusTrapConfig {
+    enabled: boolean;
+    initialFocus?: string;
+    returnFocus: boolean;
+    escapeDeactivates: boolean;
+}
+/** Focus management declaration. */
+export interface FocusManagement {
+    tabOrder: 'manual' | 'auto';
+    skipLinks: boolean;
+    focusVisible: boolean;
+    focusTrap?: FocusTrapConfig;
+    arrowNavigation: boolean;
+}
+/** Top-level keyboard navigation configuration. */
+export interface KeyboardNavigationConfig {
+    shortcuts?: KeyboardShortcut[];
+    focusManagement?: FocusManagement;
+    rovingTabindex: boolean;
+    ariaLabel?: string;
+    ariaDescribedBy?: string;
+    role?: string;
+}
 /** Fully resolved keyboard navigation configuration. */
 export interface ResolvedKeyboardConfig {
     shortcuts: KeyboardShortcut[];

package/dist/protocols/SharingProtocol.d.ts

@@ -15,7 +15,17 @@
  * @module protocols/SharingProtocol
  * @packageDocumentation
  */
-import type { SharingConfig, EmbedConfig } from '@object-ui/types';
+import type { SharingConfig } from '@object-ui/types';
+/** An iframe embed declaration. */
+export interface EmbedConfig {
+    enabled: boolean;
+    allowedOrigins?: string[];
+    width?: string;
+    height?: string;
+    showHeader?: boolean;
+    showNavigation?: boolean;
+    responsive?: boolean;
+}
 /** Fully resolved sharing configuration. */
 export interface ResolvedSharingConfig {
     enabled: boolean;

package/dist/protocols/index.d.ts

@@ -7,6 +7,5 @@
  */
 export * from './DndProtocol.js';
 export * from './KeyboardProtocol.js';
-export * from './NotificationProtocol.js';
 export * from './ResponsiveProtocol.js';
 export * from './SharingProtocol.js';

package/dist/protocols/index.js

@@ -7,6 +7,13 @@
  */
 export * from './DndProtocol.js';
 export * from './KeyboardProtocol.js';
-export * from './NotificationProtocol.js';
+// `NotificationProtocol` removed in the 17.0.0-rc.2 uptake: it bridged
+// `@objectstack/spec/ui`'s `Notification` / `NotificationConfig`, which
+// objectstack#4610 deleted with no successor. The bridge had zero consumers in
+// this repo — the live notification config resolution is
+// `resolveNotificationConfig` in `@object-ui/react`'s `NotificationContext`,
+// which declares its own `NotificationSystemConfig` and is what every surface
+// reads. Re-typing the bridge would have meant re-declaring a vocabulary the
+// spec had just retired (AGENTS.md #0.1).
 export * from './ResponsiveProtocol.js';
 export * from './SharingProtocol.js';

package/dist/registry/Registry.d.ts

@@ -43,6 +43,30 @@ export type ComponentMeta = {
      * registry.register('form', FormView, { namespace: 'view', skipFallback: true });
      */
     skipFallback?: boolean;
+    /**
+     * How a HOST must associate its own visible label with what this component
+     * renders (objectui#3961). Read by the form renderer; absent ⇒ `'control'`.
+     *
+     * - `'control'` — the component's outermost rendered element is a LABELABLE
+     *   HTML element (`input` / `textarea` / `select` / `button` / …), so the host
+     *   associates its label the plain way: `<label for>` → the id the host handed
+     *   down. This is the default and covers every single-control widget.
+     * - `'group'` — it is NOT labelable: either a real composite (several inputs
+     *   under one container, e.g. `address`) or a single control that is not a
+     *   labelable element (a `div[role="button"]` dropzone, e.g. `file`). A
+     *   `<label for>` pointing at such an element is inert in HTML — it activates
+     *   nothing and contributes no accessible name (`HTMLLabelElement.control` is
+     *   `null`) — so the host must instead give its label an `id` and hand the
+     *   component `aria-labelledby`, which associates by IDREF and works on any
+     *   element.
+     *
+     * This is a DECLARATION, not a guess: the host cannot infer it from the DOM a
+     * widget happens to render, and a widget that fails to declare it falls back
+     * to the `'control'` path where the dangling/inert `for` is caught by the
+     * label-association tests (objectui#3952) instead of silently producing an
+     * unlabelled group.
+     */
+    labelling?: 'control' | 'group';
     inputs?: ComponentInput[];
     defaultProps?: Record<string, any>;
     defaultChildren?: SchemaNode[];

package/dist/theme/ThemeEngine.d.ts

@@ -43,14 +43,6 @@ export declare function generateBorderRadiusVars(borderRadius: NonNullable<Theme
  * Generate CSS custom properties from a Theme's shadow config.
  */
 export declare function generateShadowVars(shadows: NonNullable<Theme['shadows']>): Record<string, string>;
-/**
- * Generate CSS custom properties from a Theme's animation config.
- */
-export declare function generateAnimationVars(animation: NonNullable<Theme['animation']>): Record<string, string>;
-/**
- * Generate CSS custom properties from a Theme's z-index config.
- */
-export declare function generateZIndexVars(zIndex: NonNullable<Theme['zIndex']>): Record<string, string>;
 /**
  * Generate ALL CSS custom properties from a complete Theme.
  * This is the main entry point for theme → CSS conversion.

package/dist/theme/ThemeEngine.js

@@ -116,41 +116,33 @@ export function generateColorVars(colors) {
 /**
  * Generate CSS custom properties from a Theme's typography config.
  */
+// ----------------------------------------------------------------------------
+// RETIRED THEME BLOCKS — @objectstack/spec 17.0.0-rc.3 (objectstack#5021 option
+// 2, PR objectstack#5289), objectui#3361.
+//
+// `theme.animation`, `theme.zIndex` and five typography groups
+// (`fontSize` / `fontWeight` / `lineHeight` / `letterSpacing`, plus
+// `fontFamily.heading` / `fontFamily.mono`) became TOMBSTONES: the schema now
+// rejects them by name and their prescription points at `theme.customVars`, the
+// declared — and since #5021 the only — door for a custom property. A
+// `--z-modal` or a `--duration-fast` is authored there now, emitted verbatim as
+// `--<key>: <value>`.
+//
+// The emission code below them was therefore structurally dead: no author can
+// produce the input that would reach it. It is removed rather than left behind
+// a cast, because the tombstoned keys type as `never` and any cast that made
+// them compile would fossilize a shape the contract has withdrawn (AGENTS.md
+// #0.1). LIVE emission — `colors`, `borderRadius`, `shadows`,
+// `typography.fontFamily.base` (→ `--font-sans`) and `customVars` — is
+// untouched, byte for byte.
+// ----------------------------------------------------------------------------
 export function generateTypographyVars(typography) {
     const vars = {};
+    // `fontFamily.base` is the only surviving typography input — see the RETIRED
+    // THEME BLOCKS note above for where the other five groups went.
     if (typography.fontFamily?.base) {
         vars['--font-sans'] = typography.fontFamily.base;
     }
-    if (typography.fontFamily?.heading) {
-        vars['--font-heading'] = typography.fontFamily.heading;
-    }
-    if (typography.fontFamily?.mono) {
-        vars['--font-mono'] = typography.fontFamily.mono;
-    }
-    if (typography.fontSize) {
-        for (const [key, value] of Object.entries(typography.fontSize)) {
-            if (value)
-                vars[`--font-size-${key}`] = value;
-        }
-    }
-    if (typography.fontWeight) {
-        for (const [key, value] of Object.entries(typography.fontWeight)) {
-            if (value != null)
-                vars[`--font-weight-${key}`] = String(value);
-        }
-    }
-    if (typography.lineHeight) {
-        for (const [key, value] of Object.entries(typography.lineHeight)) {
-            if (value)
-                vars[`--line-height-${key}`] = value;
-        }
-    }
-    if (typography.letterSpacing) {
-        for (const [key, value] of Object.entries(typography.letterSpacing)) {
-            if (value)
-                vars[`--letter-spacing-${key}`] = value;
-        }
-    }
     return vars;
 }
 /**
@@ -197,36 +189,6 @@ export function generateShadowVars(shadows) {
     }
     return vars;
 }
-/**
- * Generate CSS custom properties from a Theme's animation config.
- */
-export function generateAnimationVars(animation) {
-    const vars = {};
-    if (animation.duration) {
-        for (const [key, value] of Object.entries(animation.duration)) {
-            if (value)
-                vars[`--duration-${key}`] = value;
-        }
-    }
-    if (animation.timing) {
-        for (const [key, value] of Object.entries(animation.timing)) {
-            if (value)
-                vars[`--timing-${key}`] = value;
-        }
-    }
-    return vars;
-}
-/**
- * Generate CSS custom properties from a Theme's z-index config.
- */
-export function generateZIndexVars(zIndex) {
-    const vars = {};
-    for (const [key, value] of Object.entries(zIndex)) {
-        if (value != null)
-            vars[`--z-${key}`] = String(value);
-    }
-    return vars;
-}
 /**
  * Generate ALL CSS custom properties from a complete Theme.
  * This is the main entry point for theme → CSS conversion.
@@ -247,14 +209,6 @@ export function generateThemeVars(theme) {
     if (theme.shadows) {
         Object.assign(vars, generateShadowVars(theme.shadows));
     }
-    // Animation
-    if (theme.animation) {
-        Object.assign(vars, generateAnimationVars(theme.animation));
-    }
-    // Z-Index
-    if (theme.zIndex) {
-        Object.assign(vars, generateZIndexVars(theme.zIndex));
-    }
     // Custom CSS variables (passthrough)
     if (theme.customVars) {
         for (const [key, value] of Object.entries(theme.customVars)) {
@@ -290,22 +244,6 @@ export function mergeThemes(parent, child) {
                     ...parent.typography?.fontFamily,
                     ...child.typography?.fontFamily,
                 },
-                fontSize: {
-                    ...parent.typography?.fontSize,
-                    ...child.typography?.fontSize,
-                },
-                fontWeight: {
-                    ...parent.typography?.fontWeight,
-                    ...child.typography?.fontWeight,
-                },
-                lineHeight: {
-                    ...parent.typography?.lineHeight,
-                    ...child.typography?.lineHeight,
-                },
-                letterSpacing: {
-                    ...parent.typography?.letterSpacing,
-                    ...child.typography?.letterSpacing,
-                },
             }
             : undefined,
         // Deep-merge border radius
@@ -316,25 +254,6 @@ export function mergeThemes(parent, child) {
         shadows: child.shadows || parent.shadows
             ? { ...parent.shadows, ...child.shadows }
             : undefined,
-        // Deep-merge animation
-        animation: child.animation || parent.animation
-            ? {
-                ...parent.animation,
-                ...child.animation,
-                duration: {
-                    ...parent.animation?.duration,
-                    ...child.animation?.duration,
-                },
-                timing: {
-                    ...parent.animation?.timing,
-                    ...child.animation?.timing,
-                },
-            }
-            : undefined,
-        // Deep-merge zIndex
-        zIndex: child.zIndex || parent.zIndex
-            ? { ...parent.zIndex, ...child.zIndex }
-            : undefined,
         // Deep-merge customVars
         customVars: child.customVars || parent.customVars
             ? { ...parent.customVars, ...child.customVars }

package/dist/theme/index.d.ts

@@ -5,4 +5,4 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-export { hexToHSL, toCSSColor, generateColorVars, generateTypographyVars, generateBorderRadiusVars, generateShadowVars, generateAnimationVars, generateZIndexVars, generateThemeVars, mergeThemes, resolveThemeInheritance, resolveMode, contrastRatio, meetsContrastLevel, } from './ThemeEngine';
+export { hexToHSL, toCSSColor, generateColorVars, generateTypographyVars, generateBorderRadiusVars, generateShadowVars, generateThemeVars, mergeThemes, resolveThemeInheritance, resolveMode, contrastRatio, meetsContrastLevel, } from './ThemeEngine';

package/dist/theme/index.js

@@ -5,4 +5,10 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-export { hexToHSL, toCSSColor, generateColorVars, generateTypographyVars, generateBorderRadiusVars, generateShadowVars, generateAnimationVars, generateZIndexVars, generateThemeVars, mergeThemes, resolveThemeInheritance, resolveMode, contrastRatio, meetsContrastLevel, } from './ThemeEngine';
+export { hexToHSL, toCSSColor, generateColorVars, generateTypographyVars, generateBorderRadiusVars, generateShadowVars, 
+// `generateAnimationVars` / `generateZIndexVars` removed with the
+// `theme.animation` / `theme.zIndex` tombstones in @objectstack/spec
+// 17.0.0-rc.3 (objectstack#5021) — see ThemeEngine's RETIRED THEME BLOCKS
+// note. `theme.customVars` is the declared door for a `--duration-*` or
+// `--z-*` now.
+generateThemeVars, mergeThemes, resolveThemeInheritance, resolveMode, contrastRatio, meetsContrastLevel, } from './ThemeEngine';

package/dist/types/index.d.ts

@@ -5,14 +5,48 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-export interface SchemaNode {
-    type: string;
-    id?: string;
-    className?: string;
-    data?: any;
-    body?: SchemaNode | SchemaNode[];
-    [key: string]: any;
-}
+/**
+ * One `SchemaNode` (objectui#4580).
+ *
+ * This package used to hand-declare `interface SchemaNode { type: string; …
+ * [key: string]: any }` here, while `@object-ui/types` exported
+ * `type SchemaNode = BaseSchema | string | number | boolean | null | undefined`
+ * — two different types under one name, from two packages the same consumers
+ * import together. Which declaration a call site got depended on which package
+ * it happened to import from, and #4548's option-A canary measured **19 of 35**
+ * errors as exactly that collision:
+ *
+ * ```
+ * Type 'import(".../packages/types/dist/base").SchemaNode' is not assignable to
+ * type 'import(".../packages/core/dist/types/index").SchemaNode'
+ * ```
+ *
+ * PR #4578 sidestepped it — `SchemaRenderer` states its own component-level
+ * union rather than picking a side — and left the reconciliation to this card.
+ *
+ * **`@object-ui/types`' union wins**, per #4580's ruling 1: it is the spec of
+ * record (its own doc comment names `'Plain string'` a valid node), and it is
+ * the side the measured collisions resolve toward. The declaration is RE-EXPORTED
+ * rather than restated, so there is exactly one declaration left to disagree
+ * with — a structural copy would reproduce the defect the moment either side
+ * moved. This package already depends on `@object-ui/types`, so the edge exists
+ * and adds no cycle, and core's own entry surface is unchanged (`dist/index.d.ts`
+ * is byte-identical across the change — measured, both rounds).
+ *
+ * The collision is only observable from a package that resolves BOTH through
+ * `node_modules`; the pin therefore lives in `@object-ui/react`
+ * (`src/__tests__/SchemaNode.reconciliation.test.ts`), not here.
+ */
+export type { SchemaNode } from '@object-ui/types';
+import type { SchemaNode } from '@object-ui/types';
+/**
+ * ⛔ Deliberately NOT reconciled with `@object-ui/types`' `ComponentRendererProps`
+ * (objectui#4594). The two declarations differ — types' is generic
+ * (`< TSchema extends BaseSchema = BaseSchema >`), this one is not — but that
+ * card measured **zero consumers** of this declaration, so reconciling it here
+ * would be an unmeasured change riding a card that was scoped to `SchemaNode`.
+ * It stays dual-declared until #4594 is dispatched on its own evidence.
+ */
 export interface ComponentRendererProps {
     schema: SchemaNode;
     [key: string]: any;