@rebasepro/server-core 0.0.1-canary.4d4fb3e → 0.0.1-canary.ca2cb6e

package/dist/types/src/types/entity_actions.d.ts

@@ -1,10 +1,10 @@
 import React from "react";
-import { Entity } from "./entities";
-import { EntityCollection, SelectionController } from "./collections";
-import { FormContext } from "./entity_views";
-import { User } from "../users";
-import { RebaseContext } from "../rebase_context";
-import { SideEntityController } from "../controllers";
+import type { Entity } from "./entities";
+import type { EntityCollection, SelectionController } from "./collections";
+import type { FormContext } from "./entity_views";
+import type { User } from "../users";
+import type { RebaseContext } from "../rebase_context";
+import type { SideEntityController } from "../controllers/side_entity_controller";
 /**
  * An entity action is a custom action that can be performed on an entity.
  * They are displayed in the entity view and in the collection view.
@@ -55,7 +55,7 @@ export type EntityActionClickProps<M extends Record<string, unknown>, USER exten
     entity?: Entity<M>;
     context: RebaseContext<USER>;
     path?: string;
-    collection?: EntityCollection<Record<string, unknown>, any>;
+    collection?: EntityCollection<M>;
     /**
      * Optional form context, present if the action is being called from a form.
      * This allows you to access the form state and methods, including modifying the form values.
@@ -72,7 +72,7 @@ export type EntityActionClickProps<M extends Record<string, unknown>, USER exten
     /**
      * If the action is rendered in the form, is it open in a side panel or full screen?
      */
-    openEntityMode: "side_panel" | "full_screen";
+    openEntityMode: "side_panel" | "full_screen" | "split";
     /**
      * Optional selection controller, present if the action is being called from a collection view
      */

package/dist/types/src/types/entity_callbacks.d.ts

@@ -1,14 +1,14 @@
-import { EntityCollection } from "./collections";
-import { Entity, EntityStatus, EntityValues } from "./entities";
-import { User } from "../users";
-import { RebaseCallContext } from "../rebase_context";
+import type { EntityCollection } from "./collections";
+import type { Entity, EntityStatus, EntityValues } from "./entities";
+import type { User } from "../users";
+import type { RebaseCallContext } from "../rebase_context";
 /**
  * This interface defines all the callbacks that can be used when an entity
  * is being created, updated or deleted.
  * Useful for adding your own logic or blocking the execution of the operation.
  * @group Models
  */
-export type EntityCallbacks<M extends Record<string, any> = any, USER extends User = User> = {
+export type EntityCallbacks<M extends Record<string, unknown> = Record<string, unknown>, USER extends User = User> = {
     /**
      * Callback used after fetching data
      * @param props
@@ -51,11 +51,11 @@ export type EntityCallbacks<M extends Record<string, any> = any, USER extends Us
  * Parameters passed to hooks when an entity is fetched
  * @group Models
  */
-export interface EntityAfterReadProps<M extends Record<string, any> = any, USER extends User = User> {
+export interface EntityAfterReadProps<M extends Record<string, unknown> = Record<string, unknown>, USER extends User = User> {
     /**
      * Collection of the entity
      */
-    collection: EntityCollection<Record<string, unknown>, any>;
+    collection: EntityCollection<M>;
     /**
      * Full path of the CMS where this collection is being fetched.
      * Might contain unresolved aliases.
@@ -74,25 +74,25 @@ export interface EntityAfterReadProps<M extends Record<string, any> = any, USER
  * Parameters passed to hooks before an entity is saved
  * @group Models
  */
-export type EntityBeforeSaveProps<M extends Record<string, any> = any, USER extends User = User> = Omit<EntityAfterSaveProps<M, USER>, "entityId"> & {
+export type EntityBeforeSaveProps<M extends Record<string, unknown> = Record<string, unknown>, USER extends User = User> = Omit<EntityAfterSaveProps<M, USER>, "entityId"> & {
     entityId?: string | number;
 };
 /**
  * Parameters passed to hooks before an entity is saved
  * @group Models
  */
-export type EntityAfterSaveErrorProps<M extends Record<string, any> = any, USER extends User = User> = Omit<EntityAfterSaveProps<M, USER>, "entityId"> & {
+export type EntityAfterSaveErrorProps<M extends Record<string, unknown> = Record<string, unknown>, USER extends User = User> = Omit<EntityAfterSaveProps<M, USER>, "entityId"> & {
     entityId?: string | number;
 };
 /**
  * Parameters passed to hooks when an entity is saved
  * @group Models
  */
-export interface EntityAfterSaveProps<M extends Record<string, any> = any, USER extends User = User> {
+export interface EntityAfterSaveProps<M extends Record<string, unknown> = Record<string, unknown>, USER extends User = User> {
     /**
      * Resolved collection of the entity
      */
-    collection: EntityCollection<Record<string, unknown>, any>;
+    collection: EntityCollection<M>;
     /**
      * Full path of the CMS where this entity is being saved.
      * Might contain unresolved aliases.
@@ -123,11 +123,11 @@ export interface EntityAfterSaveProps<M extends Record<string, any> = any, USER
  * Parameters passed to hooks when an entity is deleted
  * @group Models
  */
-export interface EntityBeforeDeleteProps<M extends Record<string, any> = any, USER extends User = User> {
+export interface EntityBeforeDeleteProps<M extends Record<string, unknown> = Record<string, unknown>, USER extends User = User> {
     /**
      * collection of the entity being deleted
      */
-    collection: EntityCollection<Record<string, unknown>, any>;
+    collection: EntityCollection<M>;
     /**
      * Path of the parent collection
      */
@@ -149,11 +149,11 @@ export interface EntityBeforeDeleteProps<M extends Record<string, any> = any, US
  * Parameters passed to hooks after an entity is deleted
  * @group Models
  */
-export interface EntityAfterDeleteProps<M extends Record<string, any> = any, USER extends User = User> {
+export interface EntityAfterDeleteProps<M extends Record<string, unknown> = Record<string, unknown>, USER extends User = User> {
     /**
      * collection of the entity being deleted
      */
-    collection: EntityCollection<Record<string, unknown>, any>;
+    collection: EntityCollection<M>;
     /**
      * Path of the parent collection
      */

package/dist/types/src/types/entity_link_builder.d.ts

@@ -2,6 +2,6 @@ import { Entity } from "./entities";
 /**
  * @group Models
  */
-export type EntityLinkBuilder<M extends Record<string, any> = any> = ({ entity }: {
+export type EntityLinkBuilder<M extends Record<string, unknown> = Record<string, unknown>> = ({ entity }: {
     entity: Entity<M>;
 }) => string;

package/dist/types/src/types/entity_overrides.d.ts

@@ -1,4 +1,5 @@
-import { DataDriver, StorageSource } from "../controllers";
+import type { DataDriver } from "../controllers/data_driver";
+import type { StorageSource } from "../controllers/storage";
 export type EntityOverrides = {
     /**
      * Internal driver override for this collection.

package/dist/types/src/types/entity_views.d.ts

@@ -1,13 +1,13 @@
 import React from "react";
-import { Entity, EntityValues } from "./entities";
-import { EntityCollection } from "./collections";
+import type { Entity, EntityValues } from "./entities";
+import type { EntityCollection } from "./collections";
 /**
  * Context passed to custom fields and entity views.
- * This is the base definition — `@rebasepro/cms` re-exports a
+ * This is the base definition — `@rebasepro/admin` re-exports a
  * fully-typed version that narrows the `formex` field.
  * @group Form custom fields
  */
-export interface FormContext<M extends Record<string, any> = any> {
+export interface FormContext<M extends Record<string, unknown> = Record<string, unknown>> {
     /**
      * Current values of the entity
      */
@@ -35,16 +35,16 @@ export interface FormContext<M extends Record<string, any> = any> {
     status: "new" | "existing" | "copy";
     entity?: Entity<M>;
     savingError?: Error;
-    openEntityMode: "side_panel" | "full_screen";
+    openEntityMode: "side_panel" | "full_screen" | "split";
     /**
      * The underlying formex controller that powers the form.
-     * Prefer importing `FormContext` from `@rebasepro/cms` for the
+     * Prefer importing `FormContext` from `@rebasepro/admin` for the
      * fully-typed `FormexController<M>` version.
      */
     formex: Record<string, unknown>;
     disabled: boolean;
 }
-export type EntityCustomView<M extends Record<string, any> = any> = {
+export type EntityCustomView<M extends Record<string, unknown> = Record<string, unknown>> = {
     key: string;
     name: string;
     tabComponent?: React.ReactNode;
@@ -52,7 +52,7 @@ export type EntityCustomView<M extends Record<string, any> = any> = {
     Builder?: React.ComponentType<EntityCustomViewParams<M>>;
     position?: "start" | "end";
 };
-export interface EntityCustomViewParams<M extends Record<string, any> = any> {
+export interface EntityCustomViewParams<M extends Record<string, unknown> = Record<string, unknown>> {
     collection: EntityCollection<M>;
     entity?: Entity<M>;
     modifiedValues?: EntityValues<M>;

package/dist/types/src/types/export_import.d.ts

@@ -1,6 +1,6 @@
-import { Entity } from "./entities";
-import { User } from "../users";
-import { RebaseContext } from "../rebase_context";
+import type { Entity } from "./entities";
+import type { User } from "../users";
+import type { RebaseContext } from "../rebase_context";
 /**
  * You can use this configuration to add additional fields to the data
  * exports

package/dist/types/src/types/index.d.ts

@@ -20,3 +20,4 @@ export * from "./entity_actions";
 export * from "./property_config";
 export * from "./entity_views";
 export * from "./data_source";
+export * from "./cron";

package/dist/types/src/types/plugins.d.ts

@@ -1,14 +1,68 @@
-import React from "react";
-import { EntityCollection } from "./collections";
-import { EntityStatus } from "./entities";
-import { Property } from "./properties";
-import { FormContext } from "./entity_views";
-import { RebaseContext } from "../rebase_context";
-import { NavigationGroupMapping, AppView } from "../controllers";
-import { UserManagementDelegate } from "./user_management_delegate";
-import { User } from "../users";
-import { SlotContribution } from "./slots";
-export type FieldProps<T = any, CustomProps = any, M extends Record<string, any> = any> = any;
+import React, { PropsWithChildren } from "react";
+import type { EntityCollection } from "./collections";
+import type { EntityStatus } from "./entities";
+import type { InferPropertyType, Property } from "./properties";
+import type { FormContext } from "./entity_views";
+import type { RebaseContext } from "../rebase_context";
+import type { NavigationGroupMapping, AppView } from "../controllers/navigation";
+import type { UserManagementDelegate } from "./user_management_delegate";
+import type { User } from "../users";
+import type { SlotContribution } from "./slots";
+/**
+ * Props interface for custom field components.
+ *
+ * The `@rebasepro/admin` package re-exports a narrower version of this
+ * interface that adds `formex` and layout-specific fields. This base
+ * definition captures the core contract that every field renderer must
+ * satisfy, regardless of where it is rendered.
+ *
+ * @typeParam P - The property type this field is bound to
+ * @typeParam CustomProps - Extra props injected via the property's `customProps`
+ * @typeParam M - The entity model type
+ * @group Form custom fields
+ */
+export interface FieldProps<P extends Property = Property, CustomProps = unknown, M extends Record<string, unknown> = Record<string, unknown>> {
+    /** Key of the property (e.g. "user.name" for a nested path) */
+    propertyKey: string;
+    /** Current value of this field */
+    value: InferPropertyType<P> | null;
+    /** Set value of field directly */
+    setValue: (value: InferPropertyType<P> | null, shouldValidate?: boolean) => void;
+    /** Set value of a different field directly */
+    setFieldValue: (propertyKey: string, value: unknown, shouldValidate?: boolean) => void;
+    /** Is the form currently submitting */
+    isSubmitting?: boolean;
+    /** Should this field show the error indicator */
+    showError?: boolean;
+    /** Error message for this field, or undefined if valid */
+    error?: string;
+    /** Has this field been touched */
+    touched?: boolean;
+    /** Property related to this field */
+    property: P;
+    /** Should this field include a description */
+    includeDescription?: boolean;
+    /** Flag to indicate that the underlying value has been updated in the driver */
+    underlyingValueHasChanged?: boolean;
+    /** Is this field part of an array */
+    partOfArray?: boolean;
+    /** Is this field part of a block */
+    partOfBlock?: boolean;
+    /** Display the child properties directly, without being wrapped in an extendable panel */
+    minimalistView?: boolean;
+    /** Should this field autofocus on mount */
+    autoFocus?: boolean;
+    /** Additional properties set by the developer */
+    customProps?: CustomProps;
+    /** Additional values related to the state of the form or the entity */
+    context: FormContext<M>;
+    /** Flag to indicate if this field should be disabled */
+    disabled?: boolean;
+    /** Size of the field */
+    size?: "small" | "medium" | "large";
+    /** Callback when internal property state changes (e.g. panel expansion) */
+    onPropertyChange?: (property: Partial<Property>) => void;
+}
 /**
  * Interface used to define plugins for Rebase.
  * Plugins contribute UI via **slots**, wrap subtrees with **providers**,
@@ -72,11 +126,11 @@ export interface PluginProvider {
      * Typed loosely because extra props are passed via the `props` field;
      * strict signatures cause contravariance issues.
      */
-    Component: React.ComponentType<any>;
+    Component: React.ComponentType<PropsWithChildren<Record<string, unknown>>>;
     /**
      * Additional props passed to the Component.
      */
-    props?: Record<string, any>;
+    props?: Record<string, unknown>;
 }
 /**
  * Behavioral hooks that a plugin can provide.
@@ -155,7 +209,7 @@ export interface PluginLifecycle {
      * Called when a collection's visible entities change.
      * Useful for analytics, caching, or cross-plugin coordination.
      */
-    onCollectionChange?: (slug: string, entities: any[]) => void;
+    onCollectionChange?: (slug: string, entities: unknown[]) => void;
 }
 /**
  * Configuration for wrapping form field components.
@@ -165,7 +219,7 @@ export interface FieldBuilderConfig {
     /**
      * Returns a wrapped field component, or null to skip wrapping.
      */
-    wrap: <T>(params: PluginFieldBuilderParams) => React.ComponentType<FieldProps<any>> | null;
+    wrap: <T>(params: PluginFieldBuilderParams) => React.ComponentType<FieldProps<Property>> | null;
     /**
      * Optional guard — return false to skip wrapping for this field.
      */
@@ -175,7 +229,7 @@ export interface FieldBuilderConfig {
  * Props passed to home page collection card action components.
  * @group Models
  */
-export interface PluginHomePageActionsProps<EP extends object = object, M extends Record<string, any> = any, USER extends User = User, EC extends EntityCollection<M> = EntityCollection<M>> {
+export interface PluginHomePageActionsProps<EP extends object = object, M extends Record<string, unknown> = Record<string, unknown>, USER extends User = User, EC extends EntityCollection<M> = EntityCollection<M>> {
     slug: string;
     collection: EC;
     context: RebaseContext<USER>;
@@ -193,13 +247,13 @@ export interface PluginFormActionProps<USER extends User = User, EC extends Enti
     disabled: boolean;
     formContext?: FormContext;
     context: RebaseContext<USER>;
-    openEntityMode: "side_panel" | "full_screen";
+    openEntityMode: "side_panel" | "full_screen" | "split";
 }
 /**
  * Parameters passed to the field builder wrap function.
  * @group Models
  */
-export type PluginFieldBuilderParams<M extends Record<string, any> = any, EC extends EntityCollection<M> = EntityCollection<M>> = {
+export type PluginFieldBuilderParams<M extends Record<string, unknown> = Record<string, unknown>, EC extends EntityCollection<M> = EntityCollection<M>> = {
     fieldConfigId: string;
     propertyKey: string;
     property: Property;

package/dist/types/src/types/properties.d.ts

@@ -1,11 +1,11 @@
 import React from "react";
-import { EntityReference, EntityRelation, EntityValues, GeoPoint, Entity } from "./entities";
-import { FilterValues } from "./collections";
-import { ColorKey, ColorScheme } from "./chips";
-import { AuthController } from "../controllers";
-import { Relation } from "./relations";
-import { EntityAfterReadProps, EntityBeforeSaveProps } from "./entity_callbacks";
-import { User } from "../users";
+import type { EntityReference, EntityRelation, EntityValues, GeoPoint, Entity } from "./entities";
+import type { Relation, JoinStep, OnAction } from "./relations";
+import type { EntityCollection, FilterValues } from "./collections";
+import type { ColorKey, ColorScheme } from "./chips";
+import type { AuthController } from "../controllers/auth";
+import type { EntityAfterReadProps, EntityBeforeSaveProps } from "./entity_callbacks";
+import type { User } from "../users";
 /**
  * Callbacks/Hooks for individual property fields
  * @group Entity properties
@@ -14,7 +14,7 @@ export type PropertyCallbacks<T = unknown, M extends Record<string, unknown> = R
     /**
      * Callback used after fetching data, to transform the value before rendering
      */
-    afterRead?(props: Omit<EntityAfterReadProps<M, USER>, 'entity'> & {
+    afterRead?(props: Omit<EntityAfterReadProps<M, USER>, "entity"> & {
         value: T;
         entity: Entity<M> | undefined;
     }): Promise<T> | T;
@@ -22,7 +22,7 @@ export type PropertyCallbacks<T = unknown, M extends Record<string, unknown> = R
      * Callback used before saving, after validation.
      * You can modify the value before it's saved.
      */
-    beforeSave?(props: Omit<EntityBeforeSaveProps<M, USER>, 'values'> & {
+    beforeSave?(props: Omit<EntityBeforeSaveProps<M, USER>, "values"> & {
         value: T;
         previousValue: T | undefined;
         values: Partial<M>;
@@ -41,30 +41,49 @@ export type Properties = {
  * This is the core of the type inference system.
  */
 export type InferPropertyType<P extends Property> = P extends StringProperty ? string : P extends NumberProperty ? number : P extends BooleanProperty ? boolean : P extends DateProperty ? Date : P extends GeopointProperty ? GeoPoint : P extends ReferenceProperty ? EntityReference : P extends RelationProperty ? EntityRelation | EntityRelation[] : P extends ArrayProperty ? (P["of"] extends Property ? InferPropertyType<P["of"]>[] : unknown[]) : P extends MapProperty ? (P["properties"] extends Properties ? InferEntityType<P["properties"]> : Record<string, unknown>) : never;
+/**
+ * Helper type that determines whether a property is required.
+ * Uses direct structural matching against `{ validation: { required: true } }`
+ * (without the optional marker on `validation`), which correctly narrows
+ * literal `true` while treating widened `boolean` as not-required.
+ */
+type IsRequired<P extends Property> = P extends {
+    validation: {
+        required: true;
+    };
+} ? true : false;
+/**
+ * Extract keys from Properties where the property is required.
+ */
+type RequiredPropertyKeys<P extends Properties> = {
+    [K in keyof P]: IsRequired<P[K]> extends true ? K : never;
+}[keyof P];
+/**
+ * Extract keys from Properties where the property is optional.
+ */
+type OptionalPropertyKeys<P extends Properties> = {
+    [K in keyof P]: IsRequired<P[K]> extends true ? never : K;
+}[keyof P];
 /**
  * A generic type that converts a `Properties` schema definition into a corresponding
  * TypeScript entity type. It correctly handles required and optional properties.
  *
+ * A property is considered required when it has `validation: { required: true }`.
+ * The `true` must be a literal type — if `required` is typed as `boolean`,
+ * the property will be treated as optional (use `as const` for literal inference).
+ *
  * @example
  * const productSchema = {
- * name: { type: 'string', validation: { required: true } },
- * price: { type: 'number' }
- * };
+ *   name: { type: 'string', validation: { required: true } },
+ *   price: { type: 'number' }
+ * } as const satisfies Properties;
  * type Product = InferEntityType<typeof productSchema>;
  * // Result: { name: string; price?: number; }
  */
 export type InferEntityType<P extends Properties> = {
-    -readonly [K in keyof P as P[K] extends {
-        validation?: {
-            required: true;
-        };
-    } ? K : never]: InferPropertyType<P[K]>;
+    -readonly [K in RequiredPropertyKeys<P>]: InferPropertyType<P[K]>;
 } & {
-    -readonly [K in keyof P as P[K] extends {
-        validation?: {
-            required: true;
-        };
-    } ? never : K]?: InferPropertyType<P[K]>;
+    -readonly [K in OptionalPropertyKeys<P>]?: InferPropertyType<P[K]>;
 };
 /**
  * Interface including all common properties of a CMS property.
@@ -396,14 +415,79 @@ export interface RelationProperty extends BaseProperty {
      */
     isId?: boolean;
     /**
-     * The name of the relation this property refers to. This name must match
-     * one of the `relationName`s defined in the top-level `relations` array
-     * of the collection.
+     * The target collection this relation points to.
+     * When set, the framework treats this property as a self-contained relation
+     * definition and no separate `relations[]` entry is needed.
+     */
+    target?: () => EntityCollection;
+    /**
+     * Whether this property references one or many records.
+     * Defaults to `"one"`.
+     */
+    cardinality?: "one" | "many";
+    /**
+     * Which side owns the persistence for this relationship.
+     * - `"owning"`: The foreign key (for one-to-one) or junction table (for many-to-many) is on this collection.
+     * - `"inverse"`: The foreign key is on the target collection's table.
+     * Defaults to `"owning"`.
+     */
+    direction?: "owning" | "inverse";
+    /**
+     * The name of the corresponding relation on the target collection.
+     * Used for inverse relations to locate the owning side.
+     */
+    inverseRelationName?: string;
+    /**
+     * Column on THIS table that stores the foreign key to the target.
+     * Required when `direction` is `"owning"` and `cardinality` is `"one"`.
+     * Auto-inferred if not set.
+     * @example "author_id"
+     */
+    localKey?: string;
+    /**
+     * Column on the TARGET table that stores the foreign key back to this entity.
+     * Required when `direction` is `"inverse"`.
+     * Auto-inferred if not set.
+     * @example "post_id"
+     */
+    foreignKeyOnTarget?: string;
+    /**
+     * Junction table configuration for many-to-many relationships.
+     * Required when `cardinality` is `"many"` and `direction` is `"owning"`.
+     * Auto-inferred if not set.
+     */
+    through?: {
+        table: string;
+        sourceColumn: string;
+        targetColumn: string;
+    };
+    /**
+     * Explicit, ordered join path for advanced multi-hop relations.
+     * When set, overrides `localKey`, `foreignKeyOnTarget`, and `through`.
+     */
+    joinPath?: JoinStep[];
+    /**
+     * Cascade action on update.
+     */
+    onUpdate?: OnAction;
+    /**
+     * Cascade action on delete.
+     */
+    onDelete?: OnAction;
+    /**
+     * Overrides applied to the target collection when rendered as a subcollection tab.
+     */
+    overrides?: Partial<EntityCollection>;
+    /**
+     * Optional name for this relation. Defaults to the property key at runtime.
+     * Only needed when the relation name should differ from the property key,
+     * or for backward compatibility with existing `relations[]` entries.
      */
-    relationName: string;
+    relationName?: string;
     /**
-     * The resolved relation object.
-     * This is set by the framework
+     * The resolved relation object, populated by the framework at normalization time.
+     * **Do not set manually** — it is computed from the inline fields above
+     * or looked up from the collection's `relations[]` array.
      */
     relation?: Relation;
     /**
@@ -765,7 +849,7 @@ export type StorageConfig = {
      * When set to true, this flag indicates that the bucket name will be
      * included in the saved storage path.
      *
-     * E.g. `gs://my-bucket/path/to/file.png` instead of just `path/to/file.png`
+     * E.g. `s3://my-bucket/path/to/file.png` instead of just `path/to/file.png`
      *
      * Defaults to false.
      */
@@ -860,7 +944,7 @@ export interface ImageResize {
      * - `contain`: Scale down to fit within bounds, preserving aspect ratio (default)
      * - `cover`: Scale to fill bounds, preserving aspect ratio (may crop)
      */
-    mode?: 'contain' | 'cover';
+    mode?: "contain" | "cover";
     /**
      * Output format for the resized image.
      * - `original`: Keep the original format (default)
@@ -868,7 +952,7 @@ export interface ImageResize {
      * - `png`: Convert to PNG
      * - `webp`: Convert to WebP
      */
-    format?: 'original' | 'jpeg' | 'png' | 'webp';
+    format?: "original" | "jpeg" | "png" | "webp";
     /**
      * Quality for lossy formats (JPEG, WebP). Number between 0 and 100.
      * Higher is better quality but larger file size. Defaults to 80.
@@ -1048,11 +1132,11 @@ export interface ConditionContext {
      * Current form/entity values.
      * Date values are converted to Unix timestamps (milliseconds).
      */
-    values: Record<string, any>;
+    values: Record<string, unknown>;
     /**
      * Previous values before the current edit session.
      */
-    previousValues: Record<string, any>;
+    previousValues: Record<string, unknown>;
     /**
      * Current value of this property specifically.
      */
@@ -1089,3 +1173,4 @@ export interface ConditionContext {
      */
     now: number;
 }
+export {};

package/dist/types/src/types/relations.d.ts

@@ -1,4 +1,4 @@
-import { EntityCollection } from "./collections";
+import type { EntityCollection } from "./collections";
 /**
  * @group Models
  */

package/dist/types/src/types/slots.d.ts

@@ -1,9 +1,9 @@
 import React from "react";
-import { CollectionActionsProps, EntityTableController, SelectionController, EntityCollection } from "./collections";
-import { Entity } from "./entities";
-import { PluginFormActionProps, PluginGenericProps, PluginHomePageActionsProps, PluginHomePageAdditionalCardsProps } from "./plugins";
-import { Property } from "./properties";
-import { RebaseContext } from "../rebase_context";
+import type { CollectionActionsProps, EntityTableController, SelectionController, EntityCollection } from "./collections";
+import type { Entity } from "./entities";
+import type { PluginFormActionProps, PluginGenericProps, PluginHomePageActionsProps, PluginHomePageAdditionalCardsProps } from "./plugins";
+import type { Property } from "./properties";
+import type { RebaseContext } from "../rebase_context";
 /**
  * Registry mapping slot names to their component prop types.
  * Each key represents a UI extension point in the CMS.
@@ -14,6 +14,8 @@ export interface SlotRegistry {
     "home.cards": PluginHomePageAdditionalCardsProps;
     "home.children.start": PluginGenericProps;
     "home.children.end": PluginGenericProps;
+    /** Compact insight widget rendered inline in a home page collection card. */
+    "home.card.insight": HomeCardInsightSlotProps;
     "home.collection.actions": PluginHomePageActionsProps;
     /** Rendered below the logo in the sidebar drawer. */
     "navigation.header": NavigationSlotProps;
@@ -28,6 +30,8 @@ export interface SlotRegistry {
     "collection.toolbar": CollectionToolbarProps;
     /** Custom empty-state component when a collection has no data. */
     "collection.empty-state": CollectionEmptyStateProps;
+    /** Insight widgets rendered above the collection table. */
+    "collection.insights": CollectionInsightsSlotProps;
     "form.actions": PluginFormActionProps;
     "form.actions.top": PluginFormActionProps;
     /** Rendered before the form title / field list. */
@@ -74,7 +78,7 @@ export interface SlotContribution<K extends SlotName = SlotName> {
     /**
      * Additional props to merge into the slot props before rendering.
      */
-    props?: Record<string, any>;
+    props?: Record<string, unknown>;
     /**
      * Ordering hint. Lower values render first. Defaults to 50.
      */
@@ -226,3 +230,23 @@ export interface GlobalSearchProps {
 export interface ShellToolbarProps {
     context: RebaseContext;
 }
+/**
+ * Props for `collection.insights` slot.
+ * Insight widgets rendered above the collection table.
+ * @group Plugins
+ */
+export interface CollectionInsightsSlotProps {
+    path: string;
+    collection: EntityCollection;
+    parentCollectionIds: string[];
+}
+/**
+ * Props for `home.card.insight` slot.
+ * Compact insight rendered inline in a home page collection card.
+ * @group Plugins
+ */
+export interface HomeCardInsightSlotProps {
+    slug: string;
+    collection: EntityCollection;
+    context: RebaseContext;
+}