@rebasepro/plugin-data-enhancement 0.0.1-canary.eae7889 → 0.1.0

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

@@ -1,4 +1,4 @@
-import React from "react";
+import type { ComponentRef } from "./component_ref";
 import type { EntityReference, EntityRelation, EntityValues, GeoPoint, Entity } from "./entities";
 import type { Relation, JoinStep, OnAction } from "./relations";
 import type { EntityCollection, FilterValues } from "./collections";
@@ -36,6 +36,14 @@ export type Property = StringProperty | NumberProperty | BooleanProperty | DateP
 export type Properties = {
     [key: string]: Property;
 };
+export type PostgresProperty = Exclude<Property, ReferenceProperty>;
+export type PostgresProperties = {
+    [key: string]: PostgresProperty;
+};
+export type FirebaseProperty = Exclude<Property, RelationProperty>;
+export type FirebaseProperties = {
+    [key: string]: FirebaseProperty;
+};
 /**
  * A helper type to infer the underlying data type from a Property definition.
  * This is the core of the type inference system.
@@ -89,7 +97,18 @@ export type InferEntityType<P extends Properties> = {
  * Interface including all common properties of a CMS property.
  * @group Entity properties
  */
+export interface BaseUIConfig<CustomProps = unknown> {
+    columnWidth?: number;
+    hideFromCollection?: boolean;
+    readOnly?: boolean;
+    disabled?: boolean | PropertyDisabledConfig;
+    widthPercentage?: number;
+    customProps?: CustomProps;
+    Field?: ComponentRef<any>;
+    Preview?: ComponentRef<any>;
+}
 export interface BaseProperty<CustomProps = unknown> {
+    ui?: BaseUIConfig<CustomProps>;
     /**
      * Property name (e.g. Product)
      */
@@ -106,27 +125,17 @@ export interface BaseProperty<CustomProps = unknown> {
      */
     propertyConfig?: string;
     /**
-     * Width in pixels of this column in the collection view. If not set
-     * the width is inferred based on the other configurations
-     */
-    columnWidth?: number;
-    /**
-     * Do not show this property in the collection view
-     */
-    hideFromCollection?: boolean;
-    /**
-     * Is this a read only property. When set to true, it gets rendered as a
-     * preview.
-     */
-    readOnly?: boolean;
-    /**
-     * Is this field disabled.
-     * When set to true, it gets rendered as a
-     * disabled field. You can also specify a configuration for defining the
-     * behaviour of disabled properties (including custom messages, clear value on
-     * disabled or hide the field completely)
+     * Explicit database column name. When set, this value is used as-is
+     * for the SQL column name, bypassing any snake_case conversion of
+     * the property key.
+     *
+     * This is automatically populated by `rebase schema introspect`
+     * to guarantee an exact match with the live database schema.
+     *
+     * For manually-authored collections you can omit this — the framework
+     * will derive the column name from the property key via `toSnakeCase()`.
      */
-    disabled?: boolean | PropertyDisabledConfig;
+    columnName?: string;
     /**
      * Rules for validating this property
      */
@@ -135,16 +144,6 @@ export interface BaseProperty<CustomProps = unknown> {
      * This value will be set by default for new entities.
      */
     defaultValue?: unknown;
-    /**
-     * A number between 0 and 100 that indicates the width of the field in the form view.
-     * It defaults to 100, but you can set it to 50 to have two fields in the same row.
-     */
-    widthPercentage?: number;
-    /**
-     * Additional props that are passed to the components defined in `field`
-     * or in `preview`.
-     */
-    customProps?: CustomProps;
     /**
      * Use this to define dynamic properties that change based on certain conditions
      * or on the entity's values. For example, you can make a field read-only if
@@ -168,21 +167,19 @@ export interface BaseProperty<CustomProps = unknown> {
      * Callbacks/Hooks for this property field to transform and sanitize data during its lifecycle.
      */
     callbacks?: PropertyCallbacks;
-    /**
-     * Custom field component to render this property in forms.
-     * Used by the CMS layer.
-     */
-    Field?: React.ComponentType<any>;
-    /**
-     * Custom preview component to render this property in previews/tables.
-     * Used by the CMS layer.
-     */
-    Preview?: React.ComponentType<any>;
 }
 /**
  * @group Entity properties
  */
+export interface StringUIConfig extends BaseUIConfig {
+    multiline?: boolean;
+    markdown?: boolean;
+    previewAsTag?: boolean;
+    clearable?: boolean;
+    url?: boolean | PreviewType;
+}
 export interface StringProperty extends BaseProperty {
+    ui?: StringUIConfig;
     type: "string";
     /**
      * Optional database column type. If not set, it defaults to `varchar` or `uuid` depending on `isId` configuration.
@@ -257,10 +254,6 @@ export interface StringProperty extends BaseProperty {
      * Should this string be rendered as a tag instead of just text.
      */
     previewAsTag?: boolean;
-    /**
-     * Add an icon to clear the value and set it to `null`. Defaults to `false`
-     */
-    clearable?: boolean;
     /**
      * You can use this property (a string) to behave as a reference to another
      * collection. The stored value is the ID of the entity in the
@@ -272,7 +265,11 @@ export interface StringProperty extends BaseProperty {
 /**
  * @group Entity properties
  */
+export interface NumberUIConfig extends BaseUIConfig {
+    clearable?: boolean;
+}
 export interface NumberProperty extends BaseProperty {
+    ui?: NumberUIConfig;
     type: "number";
     /**
      * Optional database column type. Allows specifying exact database numeric types.
@@ -300,15 +297,12 @@ export interface NumberProperty extends BaseProperty {
      * displayed in the dropdown.
      */
     enum?: EnumValues;
-    /**
-     * Add an icon to clear the value and set it to `null`. Defaults to `false`
-     */
-    clearable?: boolean;
 }
 /**
  * @group Entity properties
  */
 export interface BooleanProperty extends BaseProperty {
+    ui?: BaseUIConfig;
     type: "boolean";
     /**
      * Rules for validating this property
@@ -318,7 +312,11 @@ export interface BooleanProperty extends BaseProperty {
 /**
  * @group Entity properties
  */
+export interface DateUIConfig extends BaseUIConfig {
+    clearable?: boolean;
+}
 export interface DateProperty extends BaseProperty {
+    ui?: DateUIConfig;
     type: "date";
     /**
      * Optional database column type. If not set, defaults to `timestamp` with timezone.
@@ -354,6 +352,7 @@ export interface DateProperty extends BaseProperty {
  * @group Entity properties
  */
 export interface GeopointProperty extends BaseProperty {
+    ui?: BaseUIConfig;
     type: "geopoint";
     /**
      * Rules for validating this property
@@ -363,7 +362,11 @@ export interface GeopointProperty extends BaseProperty {
 /**
  * @group Entity properties
  */
+export interface ReferenceUIConfig extends BaseUIConfig {
+    previewProperties?: string[];
+}
 export interface ReferenceProperty extends BaseProperty {
+    ui?: ReferenceUIConfig;
     type: "reference";
     /**
      * Marks this field as a Primary Key / Unique Identifier.
@@ -384,15 +387,9 @@ export interface ReferenceProperty extends BaseProperty {
     path?: string;
     /**
      * Allow selection of entities that pass the given filter only.
-     * e.g. `forceFilter: { age: [">=", 18] }`
+     * e.g. `fixedFilter: { age: [">=", 18] }`
      */
-    forceFilter?: FilterValues<string>;
-    /**
-     * Properties that need to be rendered when displaying a preview of this
-     * reference. If not specified the first 3 are used. Only the first 3
-     * specified values are considered.
-     */
-    previewProperties?: string[];
+    fixedFilter?: FilterValues<string>;
     /**
      * Should the reference include the ID of the entity. Defaults to `true`
      */
@@ -405,7 +402,12 @@ export interface ReferenceProperty extends BaseProperty {
 /**
  * @group Entity properties
  */
+export interface RelationUIConfig extends BaseUIConfig {
+    previewProperties?: string[];
+    widget?: "select" | "dialog";
+}
 export interface RelationProperty extends BaseProperty {
+    ui?: RelationUIConfig;
     type: "relation";
     /**
      * Marks this field as a Primary Key / Unique Identifier.
@@ -492,15 +494,9 @@ export interface RelationProperty extends BaseProperty {
     relation?: Relation;
     /**
      * Allow selection of entities that pass the given filter only.
-     * e.g. `forceFilter: { age: [">=", 18] }`
+     * e.g. `fixedFilter: { age: [">=", 18] }`
      */
-    forceFilter?: FilterValues<string>;
-    /**
-     * Properties that need to be rendered when displaying a preview of this
-     * reference. If not specified the first 3 are used. Only the first 3
-     * specified values are considered.
-     */
-    previewProperties?: string[];
+    fixedFilter?: FilterValues<string>;
     /**
      * Should the reference include the ID of the entity. Defaults to `true`
      */
@@ -518,7 +514,12 @@ export interface RelationProperty extends BaseProperty {
 /**
  * @group Entity properties
  */
+export interface ArrayUIConfig extends BaseUIConfig {
+    expanded?: boolean;
+    minimalistView?: boolean;
+}
 export interface ArrayProperty extends BaseProperty {
+    ui?: ArrayUIConfig;
     type: "array";
     /**
      * Optional database column type. Defaults to `jsonb`.
@@ -573,15 +574,6 @@ export interface ArrayProperty extends BaseProperty {
      * Rules for validating this property
      */
     validation?: ArrayPropertyValidationSchema;
-    /**
-     * Should the field be initially expanded. Defaults to `true`
-     */
-    expanded?: boolean;
-    /**
-     * Display the child properties directly, without being wrapped in an
-     * extendable panel.
-     */
-    minimalistView?: boolean;
     /**
      * Can the elements in this array be reordered. Defaults to `true`.
      * This prop has no effect if `disabled` is set to true.
@@ -596,7 +588,13 @@ export interface ArrayProperty extends BaseProperty {
 /**
  * @group Entity properties
  */
+export interface MapUIConfig extends BaseUIConfig {
+    expanded?: boolean;
+    minimalistView?: boolean;
+    spreadChildren?: boolean;
+}
 export interface MapProperty extends BaseProperty {
+    ui?: MapUIConfig;
     type: "map";
     /**
      * Optional database column type. Defaults to `jsonb`.
@@ -630,20 +628,6 @@ export interface MapProperty extends BaseProperty {
      * needed
      */
     pickOnlySomeKeys?: boolean;
-    /**
-     * Display the child properties as independent columns in the collection
-     * view
-     */
-    spreadChildren?: boolean;
-    /**
-     * Display the child properties directly, without being wrapped in an
-     * extendable panel. Note that this will also hide the title of this property.
-     */
-    minimalistView?: boolean;
-    /**
-     * Should the field be initially expanded. Defaults to `true`
-     */
-    expanded?: boolean;
     /**
      * Render this map as a key-value table that allows to use
      * arbitrary keys. You don't need to define the properties in this case.

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

@@ -100,7 +100,8 @@ export interface NavigationSlotProps {
 export interface CollectionToolbarProps {
     path: string;
     collection: EntityCollection;
-    parentCollectionIds: string[];
+    parentCollectionSlugs: string[];
+    parentEntityIds: string[];
     tableController: EntityTableController;
     selectionController: SelectionController;
 }
@@ -111,7 +112,8 @@ export interface CollectionToolbarProps {
 export interface CollectionEmptyStateProps {
     path: string;
     collection: EntityCollection;
-    parentCollectionIds: string[];
+    parentCollectionSlugs: string[];
+    parentEntityIds: string[];
     canCreate: boolean;
     onNewClick?: () => void;
 }
@@ -123,7 +125,8 @@ export interface CollectionHeaderActionProps {
     property: Property;
     propertyKey: string;
     path: string;
-    parentCollectionIds: string[];
+    parentCollectionSlugs: string[];
+    parentEntityIds: string[];
     onHover: boolean;
     collection: EntityCollection;
     tableController: EntityTableController;
@@ -134,7 +137,8 @@ export interface CollectionHeaderActionProps {
  */
 export interface CollectionAddColumnProps {
     path: string;
-    parentCollectionIds: string[];
+    parentCollectionSlugs: string[];
+    parentEntityIds: string[];
     collection: EntityCollection;
     tableController: EntityTableController;
 }
@@ -145,7 +149,8 @@ export interface CollectionAddColumnProps {
 export interface CollectionErrorProps {
     path: string;
     collection: EntityCollection;
-    parentCollectionIds?: string[];
+    parentCollectionSlugs?: string[];
+    parentEntityIds?: string[];
     error: Error;
 }
 /**
@@ -155,7 +160,8 @@ export interface CollectionErrorProps {
 export interface KanbanSetupProps {
     collection: EntityCollection;
     fullPath: string;
-    parentCollectionIds: string[];
+    parentCollectionSlugs: string[];
+    parentEntityIds: string[];
 }
 /**
  * Props for the `kanban.add-column` slot.
@@ -164,7 +170,8 @@ export interface KanbanSetupProps {
 export interface KanbanAddColumnProps {
     collection: EntityCollection;
     fullPath: string;
-    parentCollectionIds: string[];
+    parentCollectionSlugs: string[];
+    parentEntityIds: string[];
     columnProperty: string;
 }
 /**
@@ -177,7 +184,8 @@ export interface EntityRowActionsProps {
     entityId: string;
     path: string;
     collection: EntityCollection;
-    parentCollectionIds: string[];
+    parentCollectionSlugs: string[];
+    parentEntityIds: string[];
     selectionController: SelectionController;
     context: RebaseContext;
 }
@@ -202,7 +210,8 @@ export interface EntityFieldSlotProps {
 export interface CollectionFilterPanelProps {
     path: string;
     collection: EntityCollection;
-    parentCollectionIds: string[];
+    parentCollectionSlugs: string[];
+    parentEntityIds: string[];
     tableController: EntityTableController;
     context: RebaseContext;
 }
@@ -238,7 +247,8 @@ export interface ShellToolbarProps {
 export interface CollectionInsightsSlotProps {
     path: string;
     collection: EntityCollection;
-    parentCollectionIds: string[];
+    parentCollectionSlugs: string[];
+    parentEntityIds: string[];
 }
 /**
  * Props for `home.card.insight` slot.

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

@@ -51,6 +51,8 @@ export interface RebaseTranslations {
     all_entries_loaded: string;
     create_your_first_entry: string;
     no_results_filter_sort: string;
+    /** Shown when a text search yields no results. Supports `{{search}}` interpolation. */
+    no_results_search?: string;
     add: string;
     remove: string;
     copy_id: string;
@@ -461,6 +463,10 @@ export interface RebaseTranslations {
     reset_password_success?: string;
     reset_password_confirmation?: string;
     error_resetting_password?: string;
+    /** Permission-denied empty states */
+    no_permission_to_view_users?: string;
+    no_permission_to_view_roles?: string;
+    no_permission_description?: string;
     /** Editor table-bubble */
     add_row_before: string;
     add_row_after: string;

package/dist/ui/src/components/FileUpload.d.ts

@@ -9,7 +9,7 @@ export type OnFileUploadRejected = (fileRejections: {
 }[], event: object) => void;
 export type OnFilesUploadAdded = (files: File[]) => void;
 export type FileUploadProps = {
-    accept: Record<string, string[]>;
+    accept?: Record<string, string[]>;
     onFilesAdded: OnFilesUploadAdded;
     onFilesRejected?: OnFileUploadRejected;
     maxSize?: number;

package/dist/ui/src/components/SearchBar.d.ts

@@ -17,6 +17,10 @@ interface SearchBarProps {
     disabled?: boolean;
     loading?: boolean;
     inputRef?: React.Ref<HTMLInputElement>;
+    /**
+     * Optional initial value for the search input, e.g. from URL params.
+     */
+    initialValue?: string;
 }
-export declare function SearchBar({ onClick, onTextSearch, placeholder, expandable, size, innerClassName, className, autoFocus, disabled, loading, inputRef }: SearchBarProps): import("react/jsx-runtime").JSX.Element;
+export declare function SearchBar({ onClick, onTextSearch, placeholder, expandable, size, innerClassName, className, autoFocus, disabled, loading, inputRef, initialValue }: SearchBarProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/ui/src/styles.d.ts

@@ -7,6 +7,6 @@ export declare const fieldBackgroundDisabledMixin = "dark:bg-surface-900 bg-opac
 export declare const fieldBackgroundHoverMixin = "hover:bg-opacity-70 dark:hover:bg-surface-700 dark:hover:bg-opacity-40 hover:bg-surface-accent-200/70 hover:dark:bg-surface-700/40";
 export declare const defaultBorderMixin = "border-surface-200/60 dark:border-surface-700/60 ";
 export declare const paperMixin = "bg-white rounded-md dark:bg-surface-800 border border-surface-200/60 dark:border-surface-700/60";
-export declare const cardMixin = "bg-white dark:bg-surface-800 rounded-md border border-surface-200/60 dark:border-surface-700/60 m-1 -p-1";
-export declare const cardClickableMixin = "hover:bg-surface-accent-100 dark:hover:bg-surface-800 hover:ring-2 hover:ring-primary cursor-pointer hover:bg-primary/20 dark:hover:bg-primary/10 ";
+export declare const cardMixin = "bg-white dark:bg-surface-900 rounded-md border border-surface-200/60 dark:border-surface-700/60 m-1 -p-1";
+export declare const cardClickableMixin = "hover:bg-surface-accent-100 dark:hover:bg-surface-800 hover:ring-1 hover:ring-primary/50 hover:shadow-sm cursor-pointer hover:bg-primary/10 dark:hover:bg-primary/10 transition-all duration-150";
 export declare const cardSelectedMixin = "bg-primary-bg/30 dark:bg-primary-bg/10 ring-1 ring-primary/75";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@rebasepro/plugin-data-enhancement",
   "type": "module",
-  "version": "0.0.1-canary.eae7889",
+  "version": "0.1.0",
   "main": "./dist/index.umd.js",
   "module": "./dist/index.es.js",
   "types": "./dist/index.d.ts",
@@ -17,18 +17,18 @@
   },
   "dependencies": {
     "react-compiler-runtime": "1.0.0",
-    "@rebasepro/admin": "0.0.1-canary.eae7889",
-    "@rebasepro/common": "0.0.1-canary.eae7889",
-    "@rebasepro/types": "0.0.1-canary.eae7889",
-    "@rebasepro/core": "0.0.1-canary.eae7889",
-    "@rebasepro/ui": "0.0.1-canary.eae7889",
-    "@rebasepro/utils": "0.0.1-canary.eae7889"
+    "@rebasepro/admin": "0.1.0",
+    "@rebasepro/types": "0.1.0",
+    "@rebasepro/utils": "0.1.0",
+    "@rebasepro/common": "0.1.0",
+    "@rebasepro/ui": "0.1.0",
+    "@rebasepro/core": "0.1.0"
   },
   "peerDependencies": {
     "react": ">=19.0.0",
     "react-dom": ">=19.0.0",
-    "react-router": "^6.28.0",
-    "react-router-dom": "^6.28.0"
+    "react-router": ">=6.28.0",
+    "react-router-dom": ">=6.28.0"
   },
   "browserslist": {
     "production": [

package/src/components/DataEnhancementControllerProvider.tsx

@@ -149,7 +149,7 @@ export function DataEnhancementControllerProvider({
             const value = getValueInPath(currentValues, propertyKey);
             const property = getPropertyFromKey(properties, propertyKey);
 
-            if (!property || suggestion === null || property.disabled) {
+            if (!property || suggestion === null || property?.disabled) {
                 return;
             }
 

package/src/components/FormEnhanceAction.tsx

@@ -31,13 +31,11 @@ export function FormEnhanceAction({
     const [samplePrompts, setSamplePrompts] = React.useState<SamplePrompt[] | undefined>(undefined);
     const [instructions, setInstructions] = React.useState<string>("");
 
-    const {
-        suggestions,
-        getSamplePrompts
-    } = dataEnhancementController;
+    const getSamplePrompts = dataEnhancementController?.getSamplePrompts;
 
     const loadingPrompts = useRef(false);
     const updateSuggestedPrompts = useCallback(async function updateSuggestedPrompts(instructions?: string) {
+        if (!getSamplePrompts) return;
         if (loadingPrompts.current) return;
         loadingPrompts.current = true;
         const prompts = status === "new"
@@ -55,18 +53,20 @@ export function FormEnhanceAction({
     // const enoughData = countStringCharacters(deferredValues, collection.properties) > 20;
 
     useEffect(() => {
+        if (!dataEnhancementController) return;
         if (!samplePrompts) {
             setSamplePrompts(getRecentPromptsFromStorage(storageKey));
             updateSuggestedPrompts().then();
         }
-    }, [samplePrompts, storageKey, updateSuggestedPrompts, instructions, status]);
+    }, [dataEnhancementController, samplePrompts, storageKey, updateSuggestedPrompts, instructions, status]);
 
     useEffect(() => {
+        if (!dataEnhancementController) return;
         updateSuggestedPrompts().then();
-    }, [status]);
+    }, [dataEnhancementController, status]);
 
     const enhance = (prompt?: string) => {
-        if (!formContext?.values) return;
+        if (!dataEnhancementController || !formContext?.values) return;
         setLoading(true);
         if (prompt) {
             addRecentPrompt(storageKey, prompt);
@@ -88,6 +88,7 @@ export function FormEnhanceAction({
     if (!dataEnhancementController?.enabled)
         return null;
 
+    const suggestions = dataEnhancementController.suggestions;
     const hasSuggestions = Object.values(suggestions).filter(Boolean).length > 0;
 
     const disabledSuggestionActions = !hasSuggestions;
@@ -222,7 +223,7 @@ function getPromptsForExistingEntities(properties: Properties): SamplePrompt[] {
         if (isPropertyBuilder(p)) {
             return false;
         }
-        return p.type === "string" && (p.markdown || p.multiline);
+        return p.type === "string" && (p.ui?.markdown || p.ui?.multiline);
     });
 
     const multilinePrompt: Property | undefined = multilineProperties.length > 0

package/src/utils/properties.ts

@@ -31,7 +31,7 @@ function getSimpleProperty(property: Property): InputProperty {
         enum: "enum" in property && property.enum
             ? getSimpleEnumValues(property.enum)
             : undefined,
-        disabled: Boolean(property.disabled || property.readOnly)
+        disabled: Boolean(property.ui?.disabled || property.ui?.readOnly)
     };
 }
 
@@ -45,7 +45,7 @@ function getSimplifiedProperty(property: Property, path: string, value?: any): R
                 description: property.description,
                 type: property.type,
                 fieldConfigId: "repeat",
-                disabled: Boolean(property.disabled || property.readOnly),
+                disabled: Boolean(property.ui?.disabled || property.ui?.readOnly),
                 of: getSimpleProperty(property.of as Property)
             };
 
@@ -77,7 +77,7 @@ function getSimplifiedProperty(property: Property, path: string, value?: any): R
                 description: property.description,
                 type: property.type,
                 fieldConfigId: "block",
-                disabled: Boolean(property.disabled || property.readOnly),
+                disabled: Boolean(property.ui?.disabled || property.ui?.readOnly),
                 oneOf: {
                     typeField: property.oneOf.typeField,
                     valueField: property.oneOf.valueField,
@@ -128,7 +128,7 @@ function getSimplifiedProperty(property: Property, path: string, value?: any): R
                 description: property.description,
                 type: property.type,
                 fieldConfigId: "group",
-                disabled: Boolean(property.disabled || property.readOnly)
+                disabled: Boolean(property.ui?.disabled || property.ui?.readOnly)
             };
             return {
                 [path]: mapParentProperty,

package/src/utils/strings_counter.ts

@@ -7,7 +7,7 @@ export function countStringCharacters(values: EntityValues<any>, properties: Pro
         const value = values[key];
         const property: Property = properties[key];
 
-        if (property && !property.disabled) {
+        if (property && !property.ui?.disabled) {
             if (property.type === "string" || property.type === "number") {
                 count += String(value).length;
             } else if (property.type === "array" && Array.isArray(value) && property.of && !Array.isArray(property.of) && property.of.type === "string") {