@maxal_studio/kratosjs-react 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,106 @@
+export { FormRenderer } from './FormRenderer';
+export { FieldRenderer } from './FieldRenderer';
+export { definePluginClient, mergePluginClients } from './plugin';
+export type { KratosPluginClient, MergedPluginRegistries } from './plugin';
+export { mountAdminPanel } from './app';
+export type { MountAdminPanelOptions } from './app';
+export { FieldRegistryProvider, FieldRegistryContext, useFieldRegistry } from './contexts/FieldRegistryContext';
+export type { FieldRegistryProviderProps } from './contexts/FieldRegistryContext';
+export { useValidation } from './hooks/useValidation';
+export { getFieldError } from './utils/fieldErrors';
+export { ApiError, apiFetch, apiGet, apiPost } from './api/http';
+export { TableApiClient } from './api/tableApi';
+export type { QueryParams, QueryResult, PaginationMeta } from './api/tableApi';
+export { executeAction, executeBulkAction } from './api/actionsApi';
+export type { ActionResult } from './api/actionsApi';
+export * as resourceApi from './api/resourceApi';
+export { authenticatedFetch } from './api/authenticatedFetch';
+export { deriveApiBaseUrl, resourceSlugFromUrl } from './api/urls';
+export { evaluateCondition, evaluateConditionAst } from './runtime/conditions';
+export type { Condition, ConditionAst, ConditionOperator } from './runtime/conditions';
+export { executeSerializedFunction, compileSerializedFunction } from './runtime/serializedFunctions';
+export { Button, IconButton, Input, Textarea, Select, Label, Badge, Card, Spinner, EmptyState, ErrorAlert, ToastProvider, useToast, ConfirmProvider, useConfirm, } from './components/ui';
+export type { ButtonProps, IconButtonProps, ButtonVariant, ButtonSize, InputProps, TextareaProps, SelectProps, LabelProps, BadgeProps, BadgeVariant, CardProps, SpinnerProps, EmptyStateProps, ErrorAlertProps, ToastApi, ToastOptions, ToastVariant, ConfirmOptions, } from './components/ui';
+export { ErrorBoundary } from './components/errors/ErrorBoundary';
+export type { ErrorBoundaryProps } from './components/errors/ErrorBoundary';
+export { QueryBuilderFilterComponent } from './components/filters/QueryBuilderFilterComponent';
+export { CustomFilterComponent } from './components/filters/CustomFilterComponent';
+export type { FieldProps, FieldComponent, FieldRegistry, FormRendererProps, FieldRendererProps, RHFValidationRules, SerializedRelation, } from './types';
+export { TextInputField } from './components/TextInputField';
+export { SelectField } from './components/SelectField';
+export { TextareaField } from './components/TextareaField';
+export { CheckboxField } from './components/CheckboxField';
+export { ToggleField } from './components/ToggleField';
+export { RadioField } from './components/RadioField';
+export { DateTimePickerField } from './components/DateTimePickerField';
+export { ColorPickerField } from './components/ColorPickerField';
+export { RepeaterField } from './components/RepeaterField';
+export { HiddenField } from './components/HiddenField';
+export { FileUploadField } from './components/FileUploadField';
+export { RichEditorField } from './components/RichEditorField';
+export { SectionField } from './components/SectionField';
+export { GroupField } from './components/GroupField';
+export { HintDisplay } from './components/utils/HintDisplay';
+export type { HintDisplayProps } from './components/utils/HintDisplay';
+export { ViewFieldWrapper } from './components/utils/ViewFieldWrapper';
+export type { ViewFieldWrapperProps } from './components/utils/ViewFieldWrapper';
+export { cn } from './utils/classNames';
+export { Icon } from './components/utils/Icon';
+export type { IconName, IconProps } from './components/utils/Icon';
+export * from 'lucide-react';
+export { TableRenderer } from './TableRenderer';
+export type { TableRendererProps } from './TableRenderer';
+export { useTableContext } from './table/TableContext';
+export type { TableContextValue } from './table/TableContext';
+export { ViewModal } from './components/ViewModal';
+export { ResourceFormModal } from './components/modals/ResourceFormModal';
+export type { ResourceFormModalProps } from './components/modals/ResourceFormModal';
+export { RelationCreateModal } from './components/modals/RelationCreateModal';
+export { ActionFormModal } from './components/ActionFormModal';
+export { ModalDrawer } from './components/ModalDrawer';
+export { useResourceForm } from './components/modals/useResourceForm';
+export type { UseResourceFormOptions, ResourceFormApi, ResourceFormMode } from './components/modals/useResourceForm';
+export { ColumnRegistryProvider, useColumnRegistry } from './contexts/ColumnRegistryContext';
+export type { ColumnRegistry, ColumnComponent } from './contexts/ColumnRegistryContext';
+export { ResourceModalProvider, useResourceModal } from './contexts/ResourceModalContext';
+export type { ModalState } from './contexts/ResourceModalContext';
+export { PanelMetadataProvider, usePanelMetadata } from './contexts/PanelMetadataContext';
+export type { PageMetadata } from './contexts/PanelMetadataContext';
+export { TextColumnComponent } from './components/columns/TextColumnComponent';
+export type { ColumnProps } from './components/columns/TextColumnComponent';
+export { IconColumnComponent } from './components/columns/IconColumnComponent';
+export { ImageColumnComponent } from './components/columns/ImageColumnComponent';
+export { VideoColumnComponent } from './components/columns/VideoColumnComponent';
+export { MediaColumnComponent } from './components/columns/MediaColumnComponent';
+export { ColorColumnComponent } from './components/columns/ColorColumnComponent';
+export { TagsColumnComponent } from './components/columns/TagsColumnComponent';
+export { ViewColumnComponent } from './components/columns/ViewColumnComponent';
+export { CheckboxColumnComponent } from './components/columns/CheckboxColumnComponent';
+export { ToggleColumnComponent } from './components/columns/ToggleColumnComponent';
+export { SelectColumnComponent } from './components/columns/SelectColumnComponent';
+export { TextInputColumnComponent } from './components/columns/TextInputColumnComponent';
+export { AdminPanel } from './components/AdminPanel';
+export type { AdminPanelProps, BlockRegistry } from './types';
+export { I18nProvider, useI18nContext, useTranslation, useLocale, useFormatter, LocaleSwitcher, getActiveLocale, translate, buildClientI18n, } from './i18n';
+export type { I18nContextValue, I18nProviderProps, ClientI18nConfig, ClientTranslations, LocaleSwitcherProps, } from './i18n';
+export { AuthProvider, useAuth } from './auth/AuthContext';
+export { LoginPage } from './auth/LoginPage';
+export { ProtectedRoute } from './auth/ProtectedRoute';
+export { AuthApiClient } from './auth/authApiClient';
+export type { AuthUser, AuthProvider as AuthProviderType, AuthTokens, LoginCredentials, LoginResult, PendingChallenge, AuthChallengeProps, AuthChallengeComponent, } from './auth/types';
+export { AuthChallengeRegistryProvider, AuthChallengeRegistryContext, useAuthChallengeRegistry, } from './contexts/AuthChallengeRegistryContext';
+export type { AuthChallengeRegistry } from './contexts/AuthChallengeRegistryContext';
+export { WidgetRegistryProvider, useWidgetRegistry } from './contexts/WidgetRegistryContext';
+export { StatsWidget } from './components/widgets/StatsWidget';
+export { ChartWidget } from './components/widgets/ChartWidget';
+export { WidgetRenderer } from './components/widgets/WidgetRenderer';
+export type { WidgetComponentProps } from './contexts/WidgetRegistryContext';
+export type { StatsWidgetProps } from './components/widgets/StatsWidget';
+export type { ChartWidgetProps } from './components/widgets/ChartWidget';
+export type { WidgetRendererProps } from './components/widgets/WidgetRenderer';
+export { Slot, SlotCluster, renderSlot, SLOT_NAMES } from './slots';
+export type { SlotProps, SlotClusterProps, SlotName, BuiltInSlotName, SlotContext, SlotRender, SlotContribution, SlotMap, ResolvedSlots, } from './slots';
+export { SlotRegistryProvider, SlotRegistryContext, useSlot, useSlotRegistry } from './contexts/SlotRegistryContext';
+export type { SlotRegistryProviderProps } from './contexts/SlotRegistryContext';
+export { BlockRegistryProvider, useBlockRegistry } from './contexts/BlockRegistryContext';
+export type { CustomBlockComponentProps, CustomBlockComponent, BlockRegistry as BlockRegistryType, } from './contexts/BlockRegistryContext';

package/dist/index.js

@@ -0,0 +1,101 @@
+// Main exports
+export { FormRenderer } from './FormRenderer';
+export { FieldRenderer } from './FieldRenderer';
+// Plugin-author API
+export { definePluginClient, mergePluginClients } from './plugin';
+// App entry (mount the admin SPA)
+export { mountAdminPanel } from './app';
+// Field registry
+export { FieldRegistryProvider, FieldRegistryContext, useFieldRegistry } from './contexts/FieldRegistryContext';
+// Hooks
+export { useValidation } from './hooks/useValidation';
+// Field utilities (for custom field components)
+export { getFieldError } from './utils/fieldErrors';
+// HTTP / API layer
+export { ApiError, apiFetch, apiGet, apiPost } from './api/http';
+export { TableApiClient } from './api/tableApi';
+export { executeAction, executeBulkAction } from './api/actionsApi';
+export * as resourceApi from './api/resourceApi';
+export { authenticatedFetch } from './api/authenticatedFetch';
+export { deriveApiBaseUrl, resourceSlugFromUrl } from './api/urls';
+// Condition / serialized-function runtime
+export { evaluateCondition, evaluateConditionAst } from './runtime/conditions';
+export { executeSerializedFunction, compileSerializedFunction } from './runtime/serializedFunctions';
+// UI primitives (stable styling contract for plugin authors)
+export { Button, IconButton, Input, Textarea, Select, Label, Badge, Card, Spinner, EmptyState, ErrorAlert, ToastProvider, useToast, ConfirmProvider, useConfirm, } from './components/ui';
+export { ErrorBoundary } from './components/errors/ErrorBoundary';
+// Filter Components
+export { QueryBuilderFilterComponent } from './components/filters/QueryBuilderFilterComponent';
+export { CustomFilterComponent } from './components/filters/CustomFilterComponent';
+// Built-in field components (for custom rendering or extending)
+export { TextInputField } from './components/TextInputField';
+export { SelectField } from './components/SelectField';
+export { TextareaField } from './components/TextareaField';
+export { CheckboxField } from './components/CheckboxField';
+export { ToggleField } from './components/ToggleField';
+export { RadioField } from './components/RadioField';
+export { DateTimePickerField } from './components/DateTimePickerField';
+export { ColorPickerField } from './components/ColorPickerField';
+export { RepeaterField } from './components/RepeaterField';
+export { HiddenField } from './components/HiddenField';
+export { FileUploadField } from './components/FileUploadField';
+export { RichEditorField } from './components/RichEditorField';
+export { SectionField } from './components/SectionField';
+export { GroupField } from './components/GroupField';
+export { HintDisplay } from './components/utils/HintDisplay';
+export { ViewFieldWrapper } from './components/utils/ViewFieldWrapper';
+// Utilities
+export { cn } from './utils/classNames';
+// Icon component and types
+export { Icon } from './components/utils/Icon';
+// Re-export all Lucide icons for convenience
+export * from 'lucide-react';
+// Table
+export { TableRenderer } from './TableRenderer';
+export { useTableContext } from './table/TableContext';
+// Modals
+export { ViewModal } from './components/ViewModal';
+export { ResourceFormModal } from './components/modals/ResourceFormModal';
+export { RelationCreateModal } from './components/modals/RelationCreateModal';
+export { ActionFormModal } from './components/ActionFormModal';
+export { ModalDrawer } from './components/ModalDrawer';
+export { useResourceForm } from './components/modals/useResourceForm';
+// Table context
+export { ColumnRegistryProvider, useColumnRegistry } from './contexts/ColumnRegistryContext';
+// Modal context
+export { ResourceModalProvider, useResourceModal } from './contexts/ResourceModalContext';
+// Panel metadata context
+export { PanelMetadataProvider, usePanelMetadata } from './contexts/PanelMetadataContext';
+// Table column components (for custom rendering or extending)
+export { TextColumnComponent } from './components/columns/TextColumnComponent';
+export { IconColumnComponent } from './components/columns/IconColumnComponent';
+export { ImageColumnComponent } from './components/columns/ImageColumnComponent';
+export { VideoColumnComponent } from './components/columns/VideoColumnComponent';
+export { MediaColumnComponent } from './components/columns/MediaColumnComponent';
+export { ColorColumnComponent } from './components/columns/ColorColumnComponent';
+export { TagsColumnComponent } from './components/columns/TagsColumnComponent';
+export { ViewColumnComponent } from './components/columns/ViewColumnComponent';
+export { CheckboxColumnComponent } from './components/columns/CheckboxColumnComponent';
+export { ToggleColumnComponent } from './components/columns/ToggleColumnComponent';
+export { SelectColumnComponent } from './components/columns/SelectColumnComponent';
+export { TextInputColumnComponent } from './components/columns/TextInputColumnComponent';
+// AdminPanel component
+export { AdminPanel } from './components/AdminPanel';
+// Internationalization (i18n)
+export { I18nProvider, useI18nContext, useTranslation, useLocale, useFormatter, LocaleSwitcher, getActiveLocale, translate, buildClientI18n, } from './i18n';
+// Auth components
+export { AuthProvider, useAuth } from './auth/AuthContext';
+export { LoginPage } from './auth/LoginPage';
+export { ProtectedRoute } from './auth/ProtectedRoute';
+export { AuthApiClient } from './auth/authApiClient';
+export { AuthChallengeRegistryProvider, AuthChallengeRegistryContext, useAuthChallengeRegistry, } from './contexts/AuthChallengeRegistryContext';
+// Widget exports
+export { WidgetRegistryProvider, useWidgetRegistry } from './contexts/WidgetRegistryContext';
+export { StatsWidget } from './components/widgets/StatsWidget';
+export { ChartWidget } from './components/widgets/ChartWidget';
+export { WidgetRenderer } from './components/widgets/WidgetRenderer';
+// Slots (additive UI injection points)
+export { Slot, SlotCluster, renderSlot, SLOT_NAMES } from './slots';
+export { SlotRegistryProvider, SlotRegistryContext, useSlot, useSlotRegistry } from './contexts/SlotRegistryContext';
+// Block registry (custom blocks)
+export { BlockRegistryProvider, useBlockRegistry } from './contexts/BlockRegistryContext';

package/dist/pages/ResourceListPage.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+export interface ResourceListPageProps {
+    apiBaseUrl: string;
+    resourceSlug: string;
+    resourceName: string;
+    pluralLabel: string;
+}
+export declare function ResourceListPage({ apiBaseUrl, resourceSlug, resourceName, pluralLabel }: ResourceListPageProps): React.JSX.Element;

package/dist/pages/ResourceListPage.js

@@ -0,0 +1,139 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useState, useEffect } from 'react';
+import { useNavigate, useLocation } from 'react-router-dom';
+import { Loader2 } from 'lucide-react';
+import { TableRenderer } from '../TableRenderer';
+import { authenticatedFetch } from '../api/authenticatedFetch';
+import { useResourceModal } from '../contexts/ResourceModalContext';
+import { useTableRefresh } from '../contexts/TableRefreshContext';
+import { PillButton } from '../components/ui/PillButton';
+import { translate } from '../i18n/activeLocale';
+export function ResourceListPage({ apiBaseUrl, resourceSlug, resourceName, pluralLabel }) {
+    const navigate = useNavigate();
+    const location = useLocation();
+    const { openModal, closeAllModals, clearModalsForResource } = useResourceModal();
+    const [tableSchema, setTableSchema] = useState(null);
+    // Track which resource the current tableSchema belongs to, to avoid mismatches on navigation
+    const [tableSchemaResource, setTableSchemaResource] = useState(null);
+    const [canCreate, setCanCreate] = useState(true);
+    const [canEdit, setCanEdit] = useState(true);
+    const [canDelete, setCanDelete] = useState(true);
+    const [canView, setCanView] = useState(true);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const [refreshKey, setRefreshKey] = useState(0);
+    const { registerRefresh } = useTableRefresh();
+    // Register refresh callback for this resource
+    useEffect(() => {
+        const unregister = registerRefresh(resourceSlug, () => {
+            setRefreshKey(prev => prev + 1);
+        });
+        return unregister;
+    }, [resourceSlug, registerRefresh]);
+    // Parse route to determine which modal to show via context
+    // This only manages modals for THIS resource (URL-based modals)
+    useEffect(() => {
+        const pathParts = location.pathname.split('/').filter(Boolean);
+        const resourceIndex = pathParts.indexOf(resourceSlug);
+        if (resourceIndex === -1) {
+            // Not on this resource page anymore, clear only this resource's modals
+            clearModalsForResource(resourceSlug);
+            return;
+        }
+        const nextPart = pathParts[resourceIndex + 1];
+        const thirdPart = pathParts[resourceIndex + 2];
+        // Check for edit route: /resourceSlug/:id/edit
+        if (nextPart && thirdPart === 'edit') {
+            if (canEdit) {
+                openModal(resourceSlug, 'edit', nextPart);
+            }
+        }
+        else if (nextPart === 'create') {
+            // Check for create route: /resourceSlug/create
+            if (canCreate) {
+                openModal(resourceSlug, 'create');
+            }
+        }
+        else if (nextPart && nextPart !== 'create' && nextPart !== 'edit') {
+            // It's an ID for view: /resourceSlug/:id
+            if (canView) {
+                openModal(resourceSlug, 'view', nextPart);
+            }
+        }
+        else {
+            // Just the resource slug, no modals in URL: /resourceSlug
+            // Clear only this resource's URL-based modals (keeps cross-resource modals open)
+            clearModalsForResource(resourceSlug);
+        }
+        // location.key is included so the effect re-fires even when the pathname
+        // hasn't changed from React Router's perspective — this happens after a
+        // replaceState (back/breadcrumb) when the user clicks the same row again.
+        // navigate() always produces a new location.key, replaceState never does.
+    }, [location.pathname, location.key, resourceSlug, canCreate, canEdit, canView, openModal, clearModalsForResource]);
+    // Fetch table schema
+    useEffect(() => {
+        const fetchTableSchema = async () => {
+            setError(null);
+            try {
+                const response = await authenticatedFetch(`${apiBaseUrl}/${resourceSlug}/schema/table`, {
+                    headers: {
+                        'Content-Type': 'application/json',
+                    },
+                }, apiBaseUrl);
+                if (!response.ok) {
+                    if (response.status === 401) {
+                        throw new Error('Unauthorized - Please login again');
+                    }
+                    const error = await response.json();
+                    throw new Error(`Failed to fetch table schema: ${error.message || response.statusText}`);
+                }
+                const data = await response.json();
+                setTableSchema(data.schema);
+                setTableSchemaResource(resourceSlug);
+                // Extract canCreate, canEdit, canDelete, and canView from API response
+                setCanCreate(data.canCreate !== false); // Default to true if undefined
+                setCanEdit(data.canEdit !== false); // Default to true if undefined
+                setCanDelete(data.canDelete !== false); // Default to true if undefined
+                setCanView(data.canView !== false); // Default to true if undefined
+            }
+            catch (err) {
+                setError(err instanceof Error ? err.message : translate('core:error.load_schema'));
+            }
+            finally {
+                setLoading(false);
+            }
+        };
+        if (resourceSlug) {
+            // Set loading and clear schema together to prevent race conditions
+            // This prevents TableRenderer from rendering with mismatched schema/resourceKey
+            setLoading(true);
+            setTableSchema(null);
+            setTableSchemaResource(null);
+            fetchTableSchema();
+        }
+    }, [apiBaseUrl, resourceSlug]);
+    // Handlers for table actions - navigate to update URL (these are always same-resource)
+    const handleCreateClick = () => {
+        navigate(`/${resourceSlug}/create`);
+    };
+    const handleViewClick = (rowId) => {
+        navigate(`/${resourceSlug}/${rowId}`);
+    };
+    const handleEditClick = (rowId) => {
+        navigate(`/${resourceSlug}/${rowId}/edit`);
+    };
+    // Guard against rendering a schema that belongs to a previous resource
+    if (tableSchema && tableSchemaResource !== resourceSlug) {
+        return (_jsxs("div", { className: "flex items-center justify-center py-12", children: [_jsx(Loader2, { className: "w-8 h-8 text-accent animate-spin" }), _jsx("span", { className: "ml-3 text-fg-secondary", children: translate('core:common.loading_ellipsis') })] }));
+    }
+    if (loading) {
+        return (_jsxs("div", { className: "flex items-center justify-center py-12", children: [_jsx(Loader2, { className: "w-8 h-8 text-accent animate-spin" }), _jsx("span", { className: "ml-3 text-fg-secondary", children: translate('core:common.loading_ellipsis') })] }));
+    }
+    if (error) {
+        return (_jsx("div", { className: "", children: _jsxs("div", { className: "text-center py-12", children: [_jsx("p", { className: "text-red-600 mb-4", children: error }), _jsx(PillButton, { variant: "primary", onClick: () => window.location.reload(), children: translate('core:common.retry') })] }) }));
+    }
+    if (!tableSchema) {
+        return (_jsx("div", { className: "", children: _jsx("div", { className: "text-center py-12 text-fg-secondary", children: translate('core:state.no_table_schema') }) }));
+    }
+    return (_jsx(_Fragment, { children: _jsx("div", { className: "w-full max-w-7xl mx-auto", children: _jsx("div", { className: "w-full", children: _jsx(TableRenderer, { isResource: true, schema: tableSchema, apiUrl: `${apiBaseUrl}/${resourceSlug}`, apiBaseUrl: apiBaseUrl, onCreateClick: canCreate ? handleCreateClick : undefined, onEditClick: canEdit ? handleEditClick : undefined, onViewClick: canView ? handleViewClick : undefined, canCreate: canCreate, canEdit: canEdit, canDelete: canDelete, canView: canView, refreshKey: refreshKey }) }) }) }));
+}

package/dist/plugin.d.ts

@@ -0,0 +1,79 @@
+import type { FieldRegistry, WidgetRegistry, BlockRegistry } from './types';
+import type { ColumnRegistry } from './contexts/ColumnRegistryContext';
+import type { AuthChallengeRegistry } from './contexts/AuthChallengeRegistryContext';
+import type { RuleDefinition } from '@maxal_studio/kratosjs';
+import type { SlotMap, ResolvedSlots } from './slots/types';
+/**
+ * Client-side manifest of a KratosJs plugin.
+ *
+ * Plugins export this from their `/client` entry. Components are statically
+ * imported, so the app's bundler (Vite) bundles them with a single shared
+ * React instance — no runtime transformation or dynamic URL loading.
+ *
+ * @example
+ * ```typescript
+ * // my-plugin/src/client/index.ts
+ * import { definePluginClient } from '@maxal_studio/kratosjs-react';
+ * import StarRatingField from './StarRatingField';
+ *
+ * export default definePluginClient({
+ *   name: 'star-rating',
+ *   fields: { 'star-rating': StarRatingField },
+ * });
+ * ```
+ */
+export interface KratosPluginClient {
+    /** Optional plugin name (for debugging) */
+    name?: string;
+    /** Custom field components keyed by field type (e.g. 'star-rating') */
+    fields?: FieldRegistry;
+    /** Custom column components keyed by column type */
+    columns?: ColumnRegistry;
+    /** Custom widget components keyed by widget type */
+    widgets?: WidgetRegistry;
+    /** Custom page block components keyed by block type */
+    blocks?: BlockRegistry;
+    /**
+     * Challenge UI components keyed by challenge `type` (e.g. '2fa-totp'). Rendered on the
+     * login screen when the server returns a matching pending challenge. Pairs with the
+     * plugin's server-side `panel.registerAuthChallenge(...)`.
+     */
+    authChallenges?: AuthChallengeRegistry;
+    /**
+     * Custom validation rules keyed by rule name (e.g. 'phone'). Authored once as
+     * a `RuleDefinition` and referenced from both the plugin's server `register()`
+     * (via `panel.registerValidationRule`) and this client manifest, so the rule
+     * behaves identically on both sides.
+     */
+    rules?: Record<string, RuleDefinition>;
+    /**
+     * UI slot contributions keyed by slot name (e.g. `'header.right'`). Unlike the
+     * component registries above (which are 1:1 and override-based), slots are
+     * 1:many — every plugin and the app can stack elements into the same slot.
+     * A value is a single `SlotContribution` or an array of them.
+     *
+     * @example
+     * slots: {
+     *   'header.right': { id: 'docs-link', render: () => <a href="/docs">Docs</a> },
+     * }
+     */
+    slots?: SlotMap;
+}
+/**
+ * Identity helper that provides type inference for plugin client manifests.
+ */
+export declare function definePluginClient(client: KratosPluginClient): KratosPluginClient;
+export interface MergedPluginRegistries {
+    fields: FieldRegistry;
+    columns: ColumnRegistry;
+    widgets: WidgetRegistry;
+    blocks: BlockRegistry;
+    authChallenges: AuthChallengeRegistry;
+    rules: Record<string, RuleDefinition>;
+    slots: ResolvedSlots;
+}
+/**
+ * Merge multiple plugin client manifests into flat component registries.
+ * Later plugins win on name collisions.
+ */
+export declare function mergePluginClients(plugins?: KratosPluginClient[]): MergedPluginRegistries;

package/dist/plugin.js

@@ -0,0 +1,34 @@
+import { appendSlots, sortSlots } from './slots/mergeSlots';
+/**
+ * Identity helper that provides type inference for plugin client manifests.
+ */
+export function definePluginClient(client) {
+    return client;
+}
+/**
+ * Merge multiple plugin client manifests into flat component registries.
+ * Later plugins win on name collisions.
+ */
+export function mergePluginClients(plugins = []) {
+    const merged = {
+        fields: {},
+        columns: {},
+        widgets: {},
+        blocks: {},
+        authChallenges: {},
+        rules: {},
+        slots: {},
+    };
+    for (const plugin of plugins) {
+        Object.assign(merged.fields, plugin.fields ?? {});
+        Object.assign(merged.columns, plugin.columns ?? {});
+        Object.assign(merged.widgets, plugin.widgets ?? {});
+        Object.assign(merged.blocks, plugin.blocks ?? {});
+        Object.assign(merged.authChallenges, plugin.authChallenges ?? {});
+        Object.assign(merged.rules, plugin.rules ?? {});
+        // Slots stack (1:many) rather than override; later plugins append after earlier ones.
+        appendSlots(merged.slots, plugin.slots);
+    }
+    sortSlots(merged.slots);
+    return merged;
+}

package/dist/runtime/conditions.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Conditional visibility / disabled-state evaluation.
+ *
+ * Three condition forms are supported, in priority order:
+ *  1. `boolean` — static.
+ *  2. Structured condition object (preferred) — a small declarative AST that
+ *     is interpreted without executing any code, so it works under a strict
+ *     CSP and cannot do anything besides read form values.
+ *  3. Serialized function string — `({ get, operation }) => boolean`,
+ *     compiled via the serialized-function runtime (see its trust-boundary
+ *     notes).
+ */
+export type ConditionOperator = 'eq' | 'ne' | 'in' | 'nin' | 'truthy' | 'falsy' | 'gt' | 'gte' | 'lt' | 'lte' | 'operation';
+export type ConditionAst = {
+    all: ConditionAst[];
+} | {
+    any: ConditionAst[];
+} | {
+    not: ConditionAst;
+} | {
+    op: ConditionOperator;
+    field?: string;
+    value?: any;
+};
+export type Condition = boolean | string | ConditionAst | undefined;
+export type FormOperation = 'create' | 'edit' | 'view';
+/**
+ * Pure interpreter for structured conditions — no code execution.
+ */
+export declare function evaluateConditionAst(ast: ConditionAst, formState: Record<string, any>, operation?: FormOperation): boolean;
+/**
+ * Evaluate a hidden/disabled condition against the current form state.
+ * Returns false (not hidden / not disabled) for undefined or invalid input.
+ */
+export declare function evaluateCondition(condition: Condition, formState: Record<string, any>, operation?: FormOperation): boolean;

package/dist/runtime/conditions.js

@@ -0,0 +1,97 @@
+import { compileSerializedFunction } from './serializedFunctions';
+/** Read a (possibly dot-separated) field path from the form state. */
+function getFieldValue(formState, fieldName) {
+    let value = formState;
+    for (const key of fieldName.split('.')) {
+        if (value === undefined || value === null) {
+            return undefined;
+        }
+        value = value[key];
+    }
+    return value;
+}
+function isConditionAst(condition) {
+    if (!condition || typeof condition !== 'object' || Array.isArray(condition)) {
+        return false;
+    }
+    const c = condition;
+    return Array.isArray(c.all) || Array.isArray(c.any) || typeof c.not === 'object' || typeof c.op === 'string';
+}
+/**
+ * Pure interpreter for structured conditions — no code execution.
+ */
+export function evaluateConditionAst(ast, formState, operation) {
+    if ('all' in ast && Array.isArray(ast.all)) {
+        return ast.all.every(child => evaluateConditionAst(child, formState, operation));
+    }
+    if ('any' in ast && Array.isArray(ast.any)) {
+        return ast.any.some(child => evaluateConditionAst(child, formState, operation));
+    }
+    if ('not' in ast && ast.not) {
+        return !evaluateConditionAst(ast.not, formState, operation);
+    }
+    const { op, field, value } = ast;
+    const actual = op === 'operation' ? operation : field !== undefined ? getFieldValue(formState, field) : undefined;
+    switch (op) {
+        case 'eq':
+            return actual === value;
+        case 'ne':
+            return actual !== value;
+        case 'in':
+            return Array.isArray(value) && value.includes(actual);
+        case 'nin':
+            return Array.isArray(value) && !value.includes(actual);
+        case 'truthy':
+            return Boolean(actual);
+        case 'falsy':
+            return !actual;
+        case 'gt':
+            return actual > value;
+        case 'gte':
+            return actual >= value;
+        case 'lt':
+            return actual < value;
+        case 'lte':
+            return actual <= value;
+        case 'operation':
+            return operation === value;
+        default:
+            console.warn('Unknown condition operator:', op);
+            return false;
+    }
+}
+/**
+ * Evaluate a hidden/disabled condition against the current form state.
+ * Returns false (not hidden / not disabled) for undefined or invalid input.
+ */
+export function evaluateCondition(condition, formState, operation) {
+    if (condition === undefined || condition === null) {
+        return false;
+    }
+    if (typeof condition === 'boolean') {
+        return condition;
+    }
+    if (isConditionAst(condition)) {
+        try {
+            return evaluateConditionAst(condition, formState, operation);
+        }
+        catch (error) {
+            console.error('Error evaluating condition AST:', condition, error);
+            return false;
+        }
+    }
+    if (typeof condition === 'string') {
+        try {
+            const fn = compileSerializedFunction(condition);
+            if (!fn)
+                return false;
+            const get = (fieldName) => getFieldValue(formState, fieldName);
+            return Boolean(fn({ get, operation }));
+        }
+        catch (error) {
+            console.error('Error evaluating condition:', condition, error);
+            return false;
+        }
+    }
+    return false;
+}

package/dist/runtime/formTraversal.d.ts

@@ -0,0 +1,25 @@
+import { SerializedComponent } from '@maxal_studio/kratosjs';
+/**
+ * Frontend implementation of the declarative children contract (mirrors
+ * `src/utils/formSchemaTraversal`). The core package's
+ * barrel pulls Node-only deps, so we share the *contract* (the serialized
+ * shape), not the module:
+ *   - children live under `schema`
+ *   - `isLayout` marks pure layout containers (no value of their own)
+ *   - `childScope: 'array'` marks item-template containers (Repeater)
+ *
+ * Any component (core or plugin) that follows the contract is traversed
+ * correctly with no type-specific code.
+ */
+/** Direct child components of a node. */
+export declare function getChildComponents(node: SerializedComponent): SerializedComponent[];
+/** A pure layout container (inherits parent value scope, holds no value of its own). */
+export declare function isLayout(node: SerializedComponent): boolean;
+/** Children form an item template whose value lives under the node's own name (Repeater). */
+export declare function isArrayScope(node: SerializedComponent): boolean;
+/**
+ * Depth-first predicate over a node and all of its descendants. Recursion stops
+ * descending past array-scope containers (their item template is a separate
+ * value scope) — the predicate still sees the container node itself.
+ */
+export declare function someComponent(node: SerializedComponent, predicate: (node: SerializedComponent) => boolean): boolean;