@rebasepro/app 0.17.3 → 0.18.0

package/src/collections/summary-property.ts

@@ -1,114 +0,0 @@
-import type { Property } from "@rebasepro/types";
-
-/**
- * Whether a property can stand in for a record in *one line*.
- *
- * Preview surfaces — the reference card, a list row, a board card — have a
- * single line per property and no way to grow. That is a constraint on the
- * *value*, not on the property's importance: a Markdown biography is the most
- * interesting column on an author, and it is still the wrong thing to paste
- * into a 44px card. Ranking it here means the picker can skip it without
- * anyone having to configure their way out of a broken card.
- *
- * Kept beside {@link getTitlePropertyCandidates} because the two answer
- * neighbouring questions — "what is this record called" and "what else can be
- * said about it in a line" — from the same property schema.
- *
- * @group Collections
- */
-export const SUMMARY_RANK = {
-    /**
-     * No single-line form exists. A map renders as a key/value table and an
-     * array of maps as a stack of them; there is no first line to take.
-     */
-    UNUSABLE: 0,
-    /**
-     * Readable in one line, but only as an excerpt — the property holds a
-     * document, and the line is its opening. Worth showing when nothing better
-     * is available, never in preference to a value that fits whole.
-     */
-    EXCERPT: 1,
-    /** Short and self-contained: the line *is* the value. */
-    DIRECT: 2
-} as const;
-
-/** One of the three summary ranks. */
-export type SummaryRank = typeof SUMMARY_RANK[keyof typeof SUMMARY_RANK];
-
-/**
- * File-storage backed content (single image, array of images, generic upload…).
- * Preview surfaces give these their own image slot, so they are never also a
- * text line.
- *
- * @group Collections
- */
-export function isStorageProperty(property: Property | undefined): boolean {
-    if (!property) return false;
-    if (property.type === "string" && (property.storage || property.admin?.urlPreview === "image")) return true;
-    if (property.type === "array" && property.of && !Array.isArray(property.of)) {
-        const inner = property.of;
-        if (inner.type === "string" && (inner.storage || inner.admin?.urlPreview === "image")) return true;
-    }
-    return false;
-}
-
-/**
- * True when the property holds free text long enough to be a document rather
- * than a value — Markdown, or an explicitly multi-line string.
- *
- * @group Collections
- */
-export function isLongTextProperty(property: Property | undefined): boolean {
-    if (!property || property.type !== "string") return false;
-    return Boolean(property.admin?.markdown || property.admin?.multiline);
-}
-
-/**
- * How well a property reads as one line of a preview. See {@link SUMMARY_RANK}.
- *
- * Decided from the property *schema* only: no values are consulted, so the
- * answer is stable for a collection and can be memoised per collection rather
- * than per row.
- *
- * @group Collections
- */
-export function rankSummaryProperty(property: Property | undefined): SummaryRank {
-    if (!property) return SUMMARY_RANK.UNUSABLE;
-
-    // Rendered by the image slot, not as text.
-    if (isStorageProperty(property)) return SUMMARY_RANK.UNUSABLE;
-
-    // A map is a table of its own, whether it declares its properties (a row
-    // per sub-property) or not (a key/value dump). Neither has a first line.
-    if (property.type === "map") return SUMMARY_RANK.UNUSABLE;
-
-    if (property.type === "array") {
-        // A tuple: several properties side by side, so there is nothing single
-        // about the line it would produce.
-        if (Array.isArray(property.of)) return SUMMARY_RANK.UNUSABLE;
-        if (!property.of) return property.oneOf ? SUMMARY_RANK.UNUSABLE : SUMMARY_RANK.DIRECT;
-        // Arrays of block-shaped things inherit the block shape.
-        const innerRank = rankSummaryProperty(property.of);
-        if (innerRank === SUMMARY_RANK.UNUSABLE) return SUMMARY_RANK.UNUSABLE;
-        // An array of documents is a stack of excerpts — worse than one
-        // excerpt, and never what a card should lead with.
-        if (innerRank === SUMMARY_RANK.EXCERPT) return SUMMARY_RANK.UNUSABLE;
-        // Short values render as a run of chips, which fits a line.
-        return SUMMARY_RANK.DIRECT;
-    }
-
-    if (isLongTextProperty(property)) return SUMMARY_RANK.EXCERPT;
-
-    // Numbers, dates, booleans, enums, plain strings, and single references or
-    // relations (which collapse to one linked line) all fit as they are.
-    return SUMMARY_RANK.DIRECT;
-}
-
-/**
- * True when the property has any single-line form at all.
- *
- * @group Collections
- */
-export function canSummariseProperty(property: Property | undefined): boolean {
-    return rankSummaryProperty(property) !== SUMMARY_RANK.UNUSABLE;
-}

package/src/collections/title-property.ts

@@ -1,312 +0,0 @@
-import { isRelationalCollectionConfig, type Property, type Relation } from "@rebasepro/types";
-import { generateForeignKeyName } from "@rebasepro/utils";
-import type { AdminCollection } from "@rebasepro/cms-types";
-import { getPrimaryKeys, isPropertyBuilder } from "@rebasepro/common";
-import { getPropertyInPath } from "./property-path";
-import { getDisplayPropertyKey, hasDeclaredDisplay } from "./entity-display";
-import { isStorageProperty } from "./summary-property";
-
-/**
- * How good a property is as the human-readable title of an entity.
- * Higher wins; ties are broken by declaration order.
- * `DISQUALIFIED` means the property can never be a title.
- */
-const SCORE = {
-    DISQUALIFIED: -1,
-    /**
-     * Points at another entity. Only readable once the target resolves, and it
-     * renders as the raw key until then — last resort, for collections (like
-     * junction tables) that hold no text of their own.
-     */
-    REFERENCE: 5,
-    RELATION: 10,
-    /** A user picker: resolves to a person's name, like a relation does */
-    USER: 10,
-    /** Long form text — readable, but a description, not a name */
-    LONG_TEXT: 20,
-    /** A closed set of values: shared by many rows, so it identifies nothing */
-    ENUM: 30,
-    /** Identifying, but PII and usually secondary to a name */
-    EMAIL: 45,
-    /** Any plain, short, free text field */
-    PLAIN_TEXT: 60,
-    /** Free text whose name says it holds the entity's label */
-    NAMED: 100
-} as const;
-
-/**
- * Keys whose name states outright that the property is the entity label.
- * This is a *bonus* on top of the structural rules — never a requirement, and
- * never the mechanism that keeps identifiers out of the title slot.
- */
-const TITLE_LIKE_KEYS = new Set([
-    "name",
-    "fullname",
-    "displayname",
-    "title",
-    "label",
-    "heading",
-    "subject",
-    "username",
-    "nickname"
-]);
-
-function normalizeKey(key: string): string {
-    return key.toLowerCase().replace(/[^a-z0-9]/g, "");
-}
-
-function isHidden(property: Property): boolean {
-    return Boolean(property.admin?.hideFromCollection);
-}
-
-/**
- * Every column on this collection that stores a foreign key: the `localKey` of
- * each owning relation (declared inline on a property or in `relations[]`), the
- * source column of a junction, and the key a many-to-many joins on.
- *
- * These hold another entity's id, so they must never fill the title slot even
- * though they are declared as plain strings.
- */
-function getForeignKeyColumns<M extends Record<string, unknown>>(collection: AdminCollection<M>): Set<string> {
-    const keys = new Set<string>();
-
-    const addRelationKeys = (relation: Relation) => {
-        switch (relation.kind) {
-            case "belongsTo":
-                // Left to be inferred, the column still takes the conventional
-                // `<relation>_id` name.
-                keys.add(relation.localKey ?? generateForeignKeyName(relation.relationName ?? ""));
-                break;
-            case "manyToMany":
-                if (relation.through?.sourceColumn) keys.add(relation.through.sourceColumn);
-                break;
-            case "via": {
-                // Only the first hop starts on this collection's table.
-                const from = relation.joinPath?.[0]?.on?.from;
-                for (const column of Array.isArray(from) ? from : [from]) {
-                    if (column) keys.add(column);
-                }
-                break;
-            }
-            default:
-                // hasOne / hasMany put their column on the *target*.
-                break;
-        }
-    };
-
-    for (const relation of (isRelationalCollectionConfig(collection) ? collection.relations : undefined) ?? []) {
-        addRelationKeys(relation);
-    }
-
-    for (const [key, propertyRaw] of Object.entries(collection.properties ?? {})) {
-        const property = propertyRaw as Property | undefined;
-        if (!property || isPropertyBuilder(property) || property.type !== "relation") continue;
-        if (property.relation) {
-            addRelationKeys({ ...property.relation,
-relationName: property.relation.relationName ?? key });
-        }
-    }
-
-    return keys;
-}
-
-/**
- * True when the property is declared to hold an opaque identifier rather than
- * something a person reads: a primary key, a foreign key, a UUID column, or a
- * picker bound to an auth user id. Decided from the property *schema*, never
- * from the key name.
- */
-function isIdentifierProperty(property: Property, key: string, idKeys: Set<string>, foreignKeys: Set<string>): boolean {
-    if (idKeys.has(key)) return true;
-    if (foreignKeys.has(key)) return true;
-    if ("isId" in property && property.isId) return true;
-    if (property.type === "string" && property.columnType === "uuid") return true;
-    return false;
-}
-
-function scoreTitleCandidate(property: Property, key: string, idKeys: Set<string>, foreignKeys: Set<string>): number {
-    if (isHidden(property)) return SCORE.DISQUALIFIED;
-    if (isIdentifierProperty(property, key, idKeys, foreignKeys)) return SCORE.DISQUALIFIED;
-    if (isStorageProperty(property)) return SCORE.DISQUALIFIED;
-
-    if (property.type === "relation") {
-        const isMany = property.resolvedRelation
-            ? property.resolvedRelation.cardinality === "many"
-            : property.relation?.kind === "hasMany" || property.relation?.kind === "manyToMany";
-        return isMany ? SCORE.DISQUALIFIED : SCORE.RELATION;
-    }
-    if (property.type === "reference") {
-        return SCORE.REFERENCE;
-    }
-    if (property.type !== "string") {
-        // Numbers, dates, booleans, maps and arrays never read as a title.
-        return SCORE.DISQUALIFIED;
-    }
-
-    // A user picker stores an auth user id but renders the person behind it, so
-    // it ranks with relations: usable as a title, but only as a last resort.
-    if (property.userSelect) return SCORE.USER;
-    if (property.enum) return SCORE.ENUM;
-    if (property.admin?.multiline || property.admin?.markdown) return SCORE.LONG_TEXT;
-    if (property.email) return SCORE.EMAIL;
-    if (TITLE_LIKE_KEYS.has(normalizeKey(key))) return SCORE.NAMED;
-    return SCORE.PLAIN_TEXT;
-}
-
-/**
- * All properties that could serve as the entity title, best first.
- *
- * Candidates are ranked from the property *schema* — identifiers (primary
- * keys, foreign keys, UUID columns, user pickers), images and hidden fields are
- * excluded structurally, so a collection whose id column is called something
- * other than `id` is handled the same as one where it isn't.
- *
- * When the collection declares `propertiesOrder` the developer has already
- * stated what comes first, so qualifying candidates keep that order; otherwise
- * they are ranked (a name beats a description beats a relation).
- *
- * @group Collections
- */
-export function getTitlePropertyCandidates<M extends Record<string, unknown>>(
-    collection: AdminCollection<M>
-): string[] {
-    if (!collection.properties) return [];
-
-    // `getPropertyInPath`, not `properties[key]`: a declared title on a nested
-    // field — `profile.display_name` — was looked up flat, found nothing, and
-    // silently fell through to the derived ranking. The dotted form has been
-    // documented as valid the whole time.
-    const declared = getDisplayPropertyKey(collection, "title");
-    if (declared && getPropertyInPath(collection.properties, declared)) {
-        return [declared];
-    }
-
-    const idKeys = new Set<string>(getPrimaryKeys(collection) as string[]);
-    const foreignKeys = getForeignKeyColumns(collection);
-    const explicitOrder = collection.propertiesOrder as string[] | undefined;
-    const order = explicitOrder ?? Object.keys(collection.properties);
-
-    const scored: { key: string; score: number; index: number }[] = [];
-    order.forEach((key, index) => {
-        const property = collection.properties[key];
-        if (!property || isPropertyBuilder(property)) return;
-        const score = scoreTitleCandidate(property as Property, key, idKeys, foreignKeys);
-        if (score === SCORE.DISQUALIFIED) return;
-        scored.push({ key,
-score,
-index });
-    });
-
-    // An explicit `propertiesOrder` is a statement of what matters first, so it
-    // wins over the ranking — the ranking only decides between properties the
-    // developer never ordered.
-    if (!explicitOrder) {
-        scored.sort((a, b) => (b.score - a.score) || (a.index - b.index));
-    }
-
-    return scored.map(candidate => candidate.key);
-}
-
-/**
- * The relation a collection *leads* with, if it leads with one.
- *
- * A junction-shaped collection — a pipeline entry, a membership, a booking —
- * holds no label of its own: it is "this candidate, for that vacancy". The
- * general ranking puts relations last (they only read once the target
- * resolves), so the title slot would otherwise fall to whatever free text
- * happens to follow: a note, a comment. Preview surfaces that render one row
- * per entity (list, cards, board) prefer the leading relation instead.
- *
- * The decision is structural — the first property that could be a title, in the
- * order the developer declared (or ordered) them. Declaration order is a
- * statement about what the collection is about; property *names* are not
- * consulted here.
- *
- * Returns `undefined` when that first property is anything but a
- * single-cardinality relation, or when the collection states its own
- * `display.title`.
- *
- * @group Collections
- */
-export function getLeadingRelationTitleKey<M extends Record<string, unknown>>(
-    collection: AdminCollection<M>
-): string | undefined {
-    if (!collection.properties) return undefined;
-    // The collection states what it is called, in one form or the other; either
-    // way it is not asking for the leading-relation heuristic.
-    if (hasDeclaredDisplay(collection, "title")) return undefined;
-
-    const idKeys = new Set<string>(getPrimaryKeys(collection) as string[]);
-    const foreignKeys = getForeignKeyColumns(collection);
-    const order = (collection.propertiesOrder as string[] | undefined) ?? Object.keys(collection.properties);
-
-    for (const key of order) {
-        const property = collection.properties[key];
-        if (!property || isPropertyBuilder(property)) continue;
-        if (scoreTitleCandidate(property as Property, key, idKeys, foreignKeys) === SCORE.DISQUALIFIED) continue;
-        return (property as Property).type === "relation" ? key : undefined;
-    }
-
-    return undefined;
-}
-
-/**
- * The property that should fill the title slot for a collection, ignoring any
- * concrete values. Prefer {@link getTitlePropertyKeyForValues} when an entity
- * is at hand — it can skip candidates that happen to be empty or to hold an id.
- *
- * @group Collections
- */
-export function getTitlePropertyKey<M extends Record<string, unknown>>(
-    collection: AdminCollection<M>
-): string | undefined {
-    return getTitlePropertyCandidates(collection)[0];
-}
-
-const UUID_REGEX = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-const LONG_HEX_REGEX = /^[0-9a-f]{24,}$/i;
-const CUID_REGEX = /^c[a-z0-9]{20,}$/i;
-
-/**
- * True when a value reads as a machine identifier (UUID, ObjectId/long hex,
- * cuid) rather than as something worth showing to a person.
- *
- * @group Collections
- */
-export function looksLikeIdentifierValue(value: unknown): boolean {
-    if (typeof value !== "string") return false;
-    const trimmed = value.trim();
-    return UUID_REGEX.test(trimmed) || LONG_HEX_REGEX.test(trimmed) || CUID_REGEX.test(trimmed);
-}
-
-/**
- * The title property for a concrete entity: the best-ranked candidate that
- * actually carries a readable value. Candidates that are empty, that repeat the
- * entity id, or that hold an opaque identifier are skipped, so a free-text
- * column that happens to store UUIDs never ends up as the title.
- *
- * Returns the top-ranked candidate when none of them has a usable value, so
- * callers can still render a placeholder for that property.
- *
- * @group Collections
- */
-export function getTitlePropertyKeyForValues<M extends Record<string, unknown>>(
-    collection: AdminCollection<M>,
-    values: Record<string, unknown> | undefined,
-    entityId?: string | number
-): string | undefined {
-    const candidates = getTitlePropertyCandidates(collection);
-    if (!values || candidates.length === 0) return candidates[0];
-
-    for (const key of candidates) {
-        const value = values[key];
-        if (value === undefined || value === null || value === "") continue;
-        if (typeof value === "string") {
-            if (looksLikeIdentifierValue(value)) continue;
-            if (entityId !== undefined && value === String(entityId)) continue;
-        }
-        return key;
-    }
-
-    return candidates[0];
-}

package/src/components/AIIcon.tsx

@@ -1,47 +0,0 @@
-import { Wand2Icon } from "@rebasepro/ui";
-import React from "react";
-
-export interface AIIconProps {
-    size?: "smallest" | "small" | "medium" | "large";
-    className?: string;
-}
-
-/**
- * AI-styled AutoAwesome icon with gradient coloring.
- * Used consistently across AI features for visual identification.
- */
-export function AIIcon({ size = "small", className }: AIIconProps) {
-    const sizeMap: Record<string, number> = {
-        smallest: 16,
-        small: 20,
-        medium: 24,
-        large: 28
-    };
-    const numericSize = typeof size === "string" ? sizeMap[size] || 20 : size;
-
-    return (
-        <Wand2Icon
-            size={numericSize}
-            className={className}
-            style={{
-                background: "linear-gradient(to right, var(--color-primary), var(--color-secondary))",
-                WebkitBackgroundClip: "text",
-                WebkitTextFillColor: "transparent",
-                backgroundClip: "text"
-            }}
-        />
-    );
-}
-
-/**
- * Small animated dot indicator for AI-modified elements.
- * Shows a pulsing gradient dot.
- */
-export function AIModifiedIndicator({ className }: { className?: string }) {
-    return (
-        <div
-            className={`w-2 h-2 rounded-full bg-gradient-to-r from-primary to-secondary animate-pulse ${className ?? ""}`}
-            title="AI modified"
-        />
-    );
-}

package/src/components/ConfirmationDialog.tsx

@@ -1,48 +0,0 @@
-import React from "react";
-
-import { Button, Dialog, DialogActions, DialogContent, DialogTitle, LoadingButton } from "@rebasepro/ui";
-import { useTranslation } from "../hooks";
-
-export function ConfirmationDialog({
-    open,
-    onAccept,
-    onCancel,
-    title,
-    loading,
-    body
-}: {
-    open: boolean,
-    onAccept: () => void,
-    onCancel: () => void,
-    loading?: boolean,
-    title: React.ReactNode,
-    body?: React.ReactNode,
-}) {
-    const { t } = useTranslation();
-    return (
-        <Dialog
-            open={open}
-            onOpenChange={(open) => !open ? onCancel() : undefined}
-        >
-            <DialogTitle variant={"h6"} className={"mb-2"}>{title}</DialogTitle>
-            <DialogContent>
-                {body}
-            </DialogContent>
-
-            <DialogActions>
-                <Button
-                    variant={"text"}
-                    onClick={onCancel}
-                    autoFocus>{t("cancel")}</Button>
-
-                <LoadingButton
-                    type="submit"
-                    loading={loading}
-                    onClick={onAccept}
-                    autoFocus>
-                    {t("ok")}
-                </LoadingButton>
-            </DialogActions>
-        </Dialog>
-    );
-}