@declarion/react 0.1.0

package/dist-lib/lib/actions.d.ts

@@ -0,0 +1,43 @@
+import type { Action, ActionCondition, Schema } from "@/types/schema";
+/**
+ * Evaluates action conditions against row data.
+ * Returns true if the action is available (all conditions pass).
+ * An action with no conditions is always available.
+ */
+export declare function evaluateConditions(conditions: ActionCondition[] | undefined, row: Record<string, unknown>): boolean;
+/**
+ * Returns actions from an entity that match a given visibility placement.
+ */
+export declare function getActionsByVisibility(actions: Record<string, Action> | undefined, visibility: string): Array<{
+    code: string;
+    action: Action;
+}>;
+/**
+ * Returns actions bound to a screen. When the screen defines explicit action/row_action
+ * codes, only those are returned (resolved from entity.actions first, then global actions).
+ * When no screen binding exists, falls back to visibility-based filtering.
+ */
+export declare function getScreenActions(entityActions: Record<string, Action> | undefined, screenActionCodes: string[] | undefined, fallbackVisibility: string, globalActions?: Record<string, Action>): Array<{
+    code: string;
+    action: Action;
+}>;
+/**
+ * Checks if an action has parameters that need user input.
+ */
+export declare function actionHasParams(action: Action): boolean;
+/**
+ * Builds the full dot-qualified action code for API calls.
+ */
+export declare function fullActionCode(entityCode: string | undefined, actionCode: string): string;
+/**
+ * Checks if an action is an association navigation action.
+ */
+export declare function isAssociationAction(action: Action): boolean;
+/**
+ * Finds the list screen route for a given entity code.
+ * Returns the screen route and display info, or undefined if no list screen exists.
+ */
+export declare function findListScreenForEntity(schema: Schema | undefined, entityCode: string): {
+    route: string;
+    icon: string;
+} | undefined;

package/dist-lib/lib/child-config.d.ts

@@ -0,0 +1,23 @@
+import type { ChildDisplayMode, ChildQuickAdd, ChildRelation, CardsConfig, Entity, LayoutNode, LocalizedString, TimelineConfig } from "@/types/schema";
+export interface ResolvedChildConfig {
+    entity: string;
+    foreign_key: string | string[];
+    name: LocalizedString;
+    icon: string;
+    mode: ChildDisplayMode;
+    columns: string[];
+    sort: string;
+    limit: number;
+    timeline?: TimelineConfig;
+    cards?: CardsConfig;
+    quick_add?: ChildQuickAdd;
+    editable: boolean;
+    position_field?: string;
+}
+export declare function resolveChildConfig(relation: ChildRelation, childEntity: Entity, screenNode?: LayoutNode): ResolvedChildConfig;
+export declare function inferSort(entity: Entity): string;
+export declare function inferColumns(entity: Entity, fk: string | string[]): string[];
+export declare function inferTimelineFields(tc: TimelineConfig, entity: Entity): TimelineConfig;
+export declare function findPrimaryKey(entity: Entity): string | undefined;
+export declare function findPrimaryKeys(entity: Entity): string[];
+export declare function findChildRelation(parentEntity: Entity, childCode: string): ChildRelation | undefined;

package/dist-lib/lib/children-validation.d.ts

@@ -0,0 +1,3 @@
+import type { Schema } from "@/types/schema";
+import type { PendingChildRow } from "@/components/detail-layout/LayoutRenderer";
+export declare function validatePendingChildren(pendingChildren: Record<string, PendingChildRow[]> | undefined, schema: Schema | undefined): Record<string, Record<string, string[]>>;

package/dist-lib/lib/filters.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Filter system types and utilities.
+ * One JSON format everywhere: API, URL, DB, frontend state.
+ */
+/** A single node in the recursive filter tree. */
+export interface FilterNode {
+    /** Field condition */
+    field?: string;
+    op?: FilterOp;
+    value?: unknown;
+    /** OR group: each inner array is AND-ed, groups are OR-ed */
+    or?: FilterNode[][];
+    /** Explicit AND group (rarely needed, top-level is implicit AND) */
+    and?: FilterNode[];
+}
+/** All supported filter operator codes. */
+export type FilterOp = "eq" | "not_eq" | "gt" | "gte" | "lt" | "lte" | "in" | "not_in" | "between" | "contains" | "starts_with" | "is_empty" | "is_not_empty" | "today" | "this_week" | "this_month" | "last_7_days" | "last_30_days" | "last_hour" | "last_24_hours";
+/** Operators that don't take a value. */
+export declare const NO_VALUE_OPS: Set<FilterOp>;
+/** Human-friendly display names for operators. */
+export declare const OP_LABELS: Record<FilterOp, string>;
+/** Parse filters from URL search params (JSON `filters` param). */
+export declare function parseFiltersFromURL(searchParams: URLSearchParams): FilterNode[];
+/** Write filters to URL search params. */
+export declare function setFiltersInURL(filters: FilterNode[], searchParams: URLSearchParams): void;
+/**
+ * Convert FilterNode array to API query params.
+ * Uses the JSON `filters` param for the API request.
+ */
+export declare function filtersToApiParams(filters: FilterNode[]): URLSearchParams;
+/** Check if the filter tree has any OR groups (needs Level 2 UI). */
+export declare function hasOrGroups(nodes: FilterNode[]): boolean;
+/** Extract flat field conditions from a FilterNode array (ignoring OR/AND structure). */
+export declare function flatFieldConditions(nodes: FilterNode[]): FilterNode[];
+/** Count active field conditions in the filter tree. */
+export declare function countActiveFilters(nodes: FilterNode[]): number;
+/** Format a filter node for chip display. */
+export declare function formatFilterChip(node: FilterNode): string;
+/** Create a simple equality filter node. */
+export declare function eqFilter(field: string, value: string): FilterNode;
+/** Remove a filter node by field name, recursing into OR/AND groups. */
+export declare function removeFilter(nodes: FilterNode[], field: string): FilterNode[];

package/dist-lib/lib/quick-add.d.ts

@@ -0,0 +1,2 @@
+export declare function buildQuickAddPayload(fieldValues: Record<string, unknown>, defaults: Record<string, unknown> | undefined, foreignKey: string | string[], parentId: string | string[]): Record<string, unknown>;
+export declare function isQuickAddReady(fieldValues: Record<string, unknown>, requiredFields: string[]): boolean;

package/dist-lib/lib/size-value.d.ts

@@ -0,0 +1,16 @@
+import type { SizeValue } from "@/types/schema";
+export type ParsedSizeValue = {
+    kind: "weight";
+    value: number;
+} | {
+    kind: "px";
+    value: number;
+} | {
+    kind: "auto";
+} | {
+    kind: "fill";
+};
+export declare function parseSizeValue(raw: SizeValue | undefined): ParsedSizeValue | null;
+export declare function isValidSizeValue(raw: SizeValue | undefined): boolean;
+export declare function sizeValueToCSS(parsed: ParsedSizeValue): string;
+export declare function normalizeSizeValue(raw: SizeValue | undefined, defaultValue: ParsedSizeValue): ParsedSizeValue;

package/dist-lib/lib/theme-utils.d.ts

@@ -0,0 +1,3 @@
+import type { ThemeDef } from "@/types/schema";
+export declare const THEME_TOKENS: string[];
+export declare function themeDefToTokens(def: ThemeDef): Record<string, string>;

package/dist-lib/lib/timestamp.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Format an offset-aware timestamp string (e.g. "2026-03-27T14:30:00+03:00")
+ * for display WITHOUT browser-local timezone conversion. The server returns
+ * timestamps already converted to the target timezone - we display as-is.
+ *
+ * Falls back to browser-local formatting for bare datetime strings.
+ */
+export declare function formatOffsetTimestamp(raw: string): string;

package/dist-lib/lib/utils.d.ts

@@ -0,0 +1,2 @@
+import { type ClassValue } from "clsx";
+export declare function cn(...inputs: ClassValue[]): string;

package/dist-lib/main.d.ts

@@ -0,0 +1 @@
+import "./globals.css";

package/dist-lib/stores/auth.d.ts

@@ -0,0 +1,15 @@
+import type { AuthUser, Tenant } from "@/types/api";
+interface AuthState {
+    user: AuthUser | null;
+    isAuthenticated: boolean;
+    isLoading: boolean;
+    activeTenant: Tenant | null;
+    tenants: Tenant[];
+    initialize: () => Promise<void>;
+    setUser: (user: AuthUser, tenant?: Tenant) => void;
+    setTenants: (tenants: Tenant[]) => void;
+    setActiveTenant: (tenant: Tenant) => void;
+    logout: () => Promise<void>;
+}
+export declare const useAuthStore: import("zustand").UseBoundStore<import("zustand").StoreApi<AuthState>>;
+export {};

package/dist-lib/stores/screen-registry.d.ts

@@ -0,0 +1,3 @@
+import type { ComponentType } from "react";
+export declare function registerScreen(code: string, component: ComponentType): void;
+export declare function getRegisteredScreen(code: string): ComponentType | undefined;

package/dist-lib/stores/tabs.d.ts

@@ -0,0 +1,21 @@
+export interface TabItem {
+    id: string;
+    pathname: string;
+    search: string;
+    title: string;
+    icon?: string;
+    closable: boolean;
+}
+interface TabState {
+    tabs: TabItem[];
+    activeTabId: string | null;
+    openTab: (tab: Omit<TabItem, "id">) => string;
+    closeTab: (id: string) => void;
+    switchTab: (id: string) => void;
+    reorderTabs: (activeId: string, overId: string) => void;
+    findTabByPathname: (pathname: string) => TabItem | undefined;
+    updateTabTitle: (id: string, title: string) => void;
+    updateTabSearch: (id: string, search: string) => void;
+}
+export declare const useTabStore: import("zustand").UseBoundStore<import("zustand").StoreApi<TabState>>;
+export {};

package/dist-lib/stores/theme.d.ts

@@ -0,0 +1,10 @@
+type ThemeTokens = Record<string, string>;
+interface ThemeState {
+    selectedTheme: string;
+    effectiveTheme: string;
+    availableThemes: Record<string, ThemeTokens>;
+    setTheme: (name: string) => void;
+    setAvailableThemes: (themes: Record<string, ThemeTokens>) => void;
+}
+export declare const useThemeStore: import("zustand").UseBoundStore<import("zustand").StoreApi<ThemeState>>;
+export {};

package/dist-lib/types/api.d.ts

@@ -0,0 +1,178 @@
+import type { LocalizedString } from "./schema";
+export interface ListMeta {
+    total: number;
+    page: number;
+    per_page: number;
+    total_pages: number;
+}
+export interface ListResponse<T = Record<string, unknown>> {
+    data: T[];
+    meta: ListMeta;
+    $refs?: Record<string, Record<string, Record<string, unknown>>>;
+}
+export interface DataResponse<T = Record<string, unknown>> {
+    data: T;
+}
+export interface ApiErrorBody {
+    error: {
+        message: string;
+        code: string;
+        field?: string;
+    };
+    /** Bulk operation item index (present on validation errors for array requests). */
+    index?: number;
+}
+export declare class ApiError extends Error {
+    status: number;
+    code: string;
+    /** Bulk operation item index (present on validation errors for array requests). */
+    index?: number;
+    constructor(status: number, message: string, code: string, index?: number);
+}
+export interface Tenant {
+    id: string;
+    code: string;
+    name: string;
+    role: string;
+}
+export interface AuthUser {
+    id: string;
+    email: string;
+    display_name: string;
+    is_active: boolean;
+    roles: string[];
+    permissions?: string[];
+    tenant?: Tenant;
+    created_at: string;
+    updated_at: string;
+}
+export interface LoginResponse {
+    expires_at: string;
+    user: AuthUser;
+    tenant?: Tenant;
+}
+export interface CheckSetupResponse {
+    needs_setup: boolean;
+}
+export interface StatusInfo {
+    group_code: string;
+    status_code: string;
+    status_name: LocalizedString;
+    color?: string;
+    set_by?: string;
+    set_at: string;
+    note?: string;
+}
+export interface PropertyValue {
+    property_code: string;
+    name: LocalizedString;
+    type: string;
+    value: unknown;
+}
+export interface PublicParam {
+    code: string;
+    name: LocalizedString;
+    type: string;
+    category: string;
+    description?: LocalizedString;
+    value: unknown;
+}
+export interface ResolvedParam {
+    code: string;
+    name: LocalizedString;
+    type: string;
+    category?: string;
+    description?: LocalizedString;
+    value: unknown;
+    source: "object" | "user" | "role" | "tenant" | "env" | "yaml" | "none";
+}
+export interface ParamOverride {
+    param_code: string;
+    value: unknown;
+}
+export interface SSOProvider {
+    name: string;
+    slug: string;
+}
+export interface ListParams {
+    page?: number;
+    per_page?: number;
+    sort?: string;
+    search?: string;
+    /** JSON filter nodes (recursive AND/OR tree). */
+    filters?: FilterNodeParam[];
+    include_deleted?: boolean;
+    expand?: string[];
+    screen?: string;
+}
+/** Minimal filter node type for API params (matches backend FilterNode). */
+export interface FilterNodeParam {
+    field?: string;
+    op?: string;
+    value?: unknown;
+    or?: FilterNodeParam[][];
+    and?: FilterNodeParam[];
+}
+/** Cursor-based pagination metadata returned by v2 List. */
+export interface V2Meta {
+    total: number;
+    limit: number;
+    has_more: boolean;
+    cursor?: string;
+}
+/**
+ * Refs map: keyed by entity code (or $-prefixed virtual entity code),
+ * then by record ID, then field values.
+ * Example: { company: { "uuid-1": { id: "uuid-1", name: "Acme" } } }
+ */
+export type Refs = Record<string, Record<string, Record<string, unknown>>>;
+/** Per-row status instance. */
+export interface V2StatusInstance {
+    group_code: string;
+    status_code: string;
+    status_name?: Record<string, string>;
+    color?: string;
+    set_at?: string;
+    set_by?: string;
+    note?: string;
+}
+/** Per-row property instance. */
+export interface V2PropertyInstance {
+    property_code: string;
+    value: unknown;
+    updated_at?: string;
+    updated_by?: string;
+}
+/** Per-row parameter override. */
+export interface V2ParamInstance {
+    param_code: string;
+    value: unknown;
+}
+/** v2 List response with cursor pagination and response-level $refs. */
+export interface V2ListResponse<T = Record<string, unknown>> {
+    data: T[];
+    meta: V2Meta;
+    $refs?: Refs;
+}
+/** v2 List query parameters. */
+export interface V2ListParams {
+    select?: string[];
+    expand?: string[];
+    sort?: string;
+    search?: string;
+    filters?: FilterNodeParam[];
+    limit?: number;
+    after?: string;
+    include_deleted?: boolean;
+}
+/** Per-field resolved display unit codes. */
+export type Units = Record<string, string>;
+/** A row enriched with $-prefixed sub-resources (as returned by Get or write responses). */
+export interface EnrichedRow extends Record<string, unknown> {
+    $refs?: Refs;
+    $statuses?: V2StatusInstance[];
+    $properties?: V2PropertyInstance[];
+    $params?: V2ParamInstance[];
+    $children?: Record<string, Record<string, unknown>[]>;
+    $units?: Units;
+}