@praxisui/crud 9.0.17 → 9.0.18

package/README.md

@@ -17,6 +17,48 @@ Use this package to combine `@praxisui/table`, `@praxisui/dynamic-form`, governe
 - Quickstart app: https://github.com/codexrodrigues/praxis-ui-quickstart
 - API quickstart: https://github.com/codexrodrigues/praxis-api-quickstart-public
 
+## Public sandbox status
+
+CRUD supports untrusted public JSON only through the owner-authored
+`public-local-inspect-only` runtime profile. The profile requires
+`metadata.interactionMode: 'inspect-only'`, inline data, volatile table config,
+and a closed presentation-only table shape. The runtime suppresses implicit and
+explicit CRUD actions, resource discovery, routes, dialogs, drawers, surfaces,
+remote refresh, export, plugins, and operational renderers.
+
+```ts
+const inputs = {
+  crudId: 'public-customer-inspection',
+  tableConfigPersistenceStrategy: 'volatile',
+  enableCustomization: false,
+  metadata: {
+    component: 'praxis-crud',
+    interactionMode: 'inspect-only',
+    data: [{ id: 1, name: 'Ada Lovelace', status: 'Ready' }],
+    table: {
+      columns: [
+        { field: 'name', header: 'Name', sortable: true, filterable: true },
+        { field: 'status', header: 'Status' },
+      ],
+      behavior: {
+        localDataMode: { enabled: true },
+        pagination: { enabled: true, pageSize: 10, strategy: 'client' },
+        sorting: { enabled: true, strategy: 'client' },
+        filtering: {
+          enabled: true,
+          strategy: 'client',
+          columnFilters: { enabled: true },
+        },
+      },
+      toolbar: { visible: true, position: 'top', title: 'Local inspection' },
+    },
+  },
+};
+```
+
+See the accepted runtime decision and adversarial proof matrix in
+[`docs/rfc-public-inspect-only-runtime-profile.md`](docs/rfc-public-inspect-only-runtime-profile.md).
+
 ## Install
 
 ```bash

package/ai/component-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
-  "generatedAt": "2026-08-24T20:08:13.959Z",
+  "generatedAt": "2026-08-24T23:27:32.982Z",
   "packageName": "@praxisui/crud",
-  "packageVersion": "9.0.17",
+  "packageVersion": "9.0.18",
   "sourceRegistry": "praxis-component-registry-ingestion",
   "sourceRegistryVersion": "1.0.0",
   "componentCount": 2,
@@ -17,6 +17,13 @@
           "required": false,
           "description": "Metadados de configuração do CRUD (fonte remota via resource.path ou local via metadata.data)."
         },
+        {
+          "name": "metadata.interactionMode",
+          "type": "'interactive' | 'inspect-only'",
+          "required": false,
+          "description": "Decisão canônica de interação. inspect-only exige dados locais e bloqueia ações, resource binding, surfaces e authoring no próprio runtime.",
+          "default": "interactive"
+        },
         {
           "name": "crudId",
           "type": "string",
@@ -7265,9 +7272,9 @@
         {
           "chunkIndex": 0,
           "chunkKind": "summary",
-          "content": "Component ID: praxis-crud\nSelector: praxis-crud\nFriendly Name: Praxis CRUD\nDescription: Tabela com operações de CRUD via metadados.\nLib/Package: @praxisui/crud\nTags: widget, crud, configurable, hasWizard, stable\nInputs:\n  - metadata (CrudMetadata | string)\n  - crudId (string)\n  - componentInstanceId (string)\n  - tableConfigPersistenceStrategy ('local-first' | 'input-first' | 'volatile')\n  - context (Record<string, unknown>)\n  - metadata.queryContext (PraxisDataQueryContext | null)\n  - metadata.resource.schemaPath (string | null)\n  - metadata.resource.title (string | null)\n  - metadata.resource.formTitle (string | null)\n  - metadata.filterCriteria (Record<string, unknown> | null)\n  - metadata.form (FormConfig)\n  - metadata.actions[].form (CrudActionFormContract)\n  - enableCustomization (boolean)\n  - showResourceIdentityKey (boolean)\n  - authoringCapability (string | null)\nOutputs:\n  - afterOpen ({ mode: FormOpenMode; action: string })\n  - afterClose (void)\n  - afterSave ({ id: string | number; data: unknown })\n  - afterDelete ({ id: string | number })\n  - reactiveDeterminationExecuted ({ action: string; event: ReactiveDeterminationExecutionEvent })\n  - reactiveDeterminationPendingChange ({ action: string; pending: boolean })\n  - reactiveDeterminationStabilityChange (CrudReactiveDeterminationStabilityChange)\n  - rowClick ({ row: unknown; index: number })\n  - rowAction (CrudActionRuntimeEvent)\n  - selectionChange (unknown)\n  - resourceEvent (PraxisResourceEvent<unknown>)\n  - error (unknown)\n  - configureRequested (void)\n  - crudAuthoringDocumentApplied (CrudAuthoringWidgetPersistenceEvent)\n  - crudAuthoringDocumentSaved (CrudAuthoringWidgetPersistenceEvent)\n",
+          "content": "Component ID: praxis-crud\nSelector: praxis-crud\nFriendly Name: Praxis CRUD\nDescription: Tabela com operações de CRUD via metadados.\nLib/Package: @praxisui/crud\nTags: widget, crud, configurable, hasWizard, stable\nInputs:\n  - metadata (CrudMetadata | string)\n  - metadata.interactionMode ('interactive' | 'inspect-only')\n  - crudId (string)\n  - componentInstanceId (string)\n  - tableConfigPersistenceStrategy ('local-first' | 'input-first' | 'volatile')\n  - context (Record<string, unknown>)\n  - metadata.queryContext (PraxisDataQueryContext | null)\n  - metadata.resource.schemaPath (string | null)\n  - metadata.resource.title (string | null)\n  - metadata.resource.formTitle (string | null)\n  - metadata.filterCriteria (Record<string, unknown> | null)\n  - metadata.form (FormConfig)\n  - metadata.actions[].form (CrudActionFormContract)\n  - enableCustomization (boolean)\n  - showResourceIdentityKey (boolean)\n  - authoringCapability (string | null)\nOutputs:\n  - afterOpen ({ mode: FormOpenMode; action: string })\n  - afterClose (void)\n  - afterSave ({ id: string | number; data: unknown })\n  - afterDelete ({ id: string | number })\n  - reactiveDeterminationExecuted ({ action: string; event: ReactiveDeterminationExecutionEvent })\n  - reactiveDeterminationPendingChange ({ action: string; pending: boolean })\n  - reactiveDeterminationStabilityChange (CrudReactiveDeterminationStabilityChange)\n  - rowClick ({ row: unknown; index: number })\n  - rowAction (CrudActionRuntimeEvent)\n  - selectionChange (unknown)\n  - resourceEvent (PraxisResourceEvent<unknown>)\n  - error (unknown)\n  - configureRequested (void)\n  - crudAuthoringDocumentApplied (CrudAuthoringWidgetPersistenceEvent)\n  - crudAuthoringDocumentSaved (CrudAuthoringWidgetPersistenceEvent)\n",
           "sourcePointer": "projects/praxis-crud/src/lib/praxis-crud.metadata.ts",
-          "contentHash": "b23b03f710e5ccd9109b534891d97f93780d572005599050d3c9b3ade71d57e2",
+          "contentHash": "d9956416f9b8b3d9cbab9a84a3b979a013a31d5ec46c62ec634d8985676b07d6",
           "sourceKind": "component_definition",
           "sourceId": "praxis-crud",
           "corpusVersion": "1.0.0"

package/fesm2022/praxisui-crud.mjs

@@ -3870,6 +3870,70 @@ function openCrudMetadataEditor(settings, opts) {
     });
 }
 
+const OPERATIONAL_RENDERERS = new Set([
+    'image',
+    'avatar',
+    'link',
+    'button',
+    'menu',
+    'toggle',
+    'html',
+    'compose',
+]);
+/** Materializes the effect-free Table projection owned by inspect-only CRUD. */
+function hardenCrudInspectOnlyTableConfig(config) {
+    const safe = config;
+    safe.behavior = {
+        ...(safe.behavior || {}),
+        localDataMode: { ...(safe.behavior?.localDataMode || {}), enabled: true },
+        expansion: { ...(safe.behavior?.expansion || {}), enabled: false },
+    };
+    safe.toolbar = safe.toolbar
+        ? { ...safe.toolbar, actions: [] }
+        : { visible: false, position: 'top', actions: [] };
+    safe.actions = {
+        ...(safe.actions || {}),
+        row: {
+            position: 'end',
+            display: 'menu',
+            trigger: 'always',
+            ...(safe.actions?.row || {}),
+            enabled: false,
+            actions: [],
+        },
+        bulk: {
+            position: 'toolbar',
+            ...(safe.actions?.bulk || {}),
+            enabled: false,
+            actions: [],
+        },
+    };
+    safe.export = { formats: [], ...(safe.export || {}), enabled: false };
+    safe.ai = {
+        ...(safe.ai || {}),
+        assistant: { ...(safe.ai?.assistant || {}), enabled: false },
+    };
+    safe.columnProjection = undefined;
+    safe.analyticsProjection = undefined;
+    safe.plugins = [];
+    safe.columns = (safe.columns || []).map((column) => {
+        const next = { ...column };
+        if (isOperationalRenderer(next.renderer))
+            next.renderer = undefined;
+        if (Array.isArray(next.conditionalRenderers)) {
+            next.conditionalRenderers = next.conditionalRenderers.map((conditional) => isOperationalRenderer(conditional?.renderer)
+                ? { ...conditional, renderer: undefined }
+                : conditional);
+        }
+        return next;
+    });
+    delete safe.resourcePath;
+    return safe;
+}
+function isOperationalRenderer(renderer) {
+    return OPERATIONAL_RENDERERS.has(String(renderer?.type || '').trim());
+}
+
 class PraxisCrudComponent {
     metadata;
     crudId;
@@ -3970,7 +4034,13 @@ class PraxisCrudComponent {
     collectionCapabilitiesRequestSeq = 0;
     currentAuthoringDocument;
     selectedRow = null;
+    get resolvedTableConfigPersistenceStrategy() {
+        return this.isInspectOnly() ? 'volatile' : this.tableConfigPersistenceStrategy;
+    }
     onTableRowAction(event) {
+        if (this.isInspectOnly()) {
+            return;
+        }
         this.rowAction.emit(event);
         void this.onAction(event.action || '', event.row, event);
     }
@@ -3987,6 +4057,9 @@ class PraxisCrudComponent {
         return assigned ?? (this.surfaceOpenAdapterInstance ??= this.injector.get(ResourceSurfaceOpenAdapterService));
     }
     onResetPreferences() {
+        if (this.isInspectOnly()) {
+            return;
+        }
         try {
             const keyId = this.componentKeyId();
             if (!keyId)
@@ -4011,9 +4084,15 @@ class PraxisCrudComponent {
         this.selectionChange.emit(event);
     }
     onTableResourceEvent(event) {
+        if (this.isInspectOnly()) {
+            return;
+        }
         this.resourceEvent.emit(event);
     }
     async onBulkAction(event) {
+        if (this.isInspectOnly()) {
+            return;
+        }
         const action = String(event?.action || '').trim();
         if (!action) {
             return;
@@ -4025,6 +4104,9 @@ class PraxisCrudComponent {
         await this.onAction(action, row ?? undefined, event);
     }
     async onToolbarAction(event) {
+        if (this.isInspectOnly()) {
+            return;
+        }
         const action = String(event?.action || '').trim();
         if (!action)
             return;
@@ -4045,7 +4127,7 @@ class PraxisCrudComponent {
                 ? JSON.parse(this.metadata)
                 : this.metadata;
             this.resolvedMetadata = parsed;
-            const externalAuthoringSeed = this.context && typeof this.context === 'object'
+            const externalAuthoringSeed = parsed.interactionMode !== 'inspect-only' && this.context && typeof this.context === 'object'
                 ? (this.context['authoringDocument'] ?? this.context['authoringMetadata'])
                 : undefined;
             this.currentAuthoringDocument = externalAuthoringSeed
@@ -4057,6 +4139,7 @@ class PraxisCrudComponent {
             assertCrudMetadata(this.resolvedMetadata, {
                 allowDeferredActionBindings: true,
             });
+            this.emitInspectOnlyDiagnostics(this.resolvedMetadata);
             this.tableQueryContext = this.resolveQueryContext(this.resolvedMetadata);
             this.tableFilterCriteria = this.resolveFilterCriteria(this.resolvedMetadata);
             this.tableCollectionLinks = null;
@@ -4071,6 +4154,9 @@ class PraxisCrudComponent {
         }
     }
     async onAction(action, row, runtimeEvent) {
+        if (this.isInspectOnly()) {
+            return;
+        }
         if (this.openingActionLabel()) {
             return;
         }
@@ -4248,13 +4334,22 @@ class PraxisCrudComponent {
         }
     }
     onTableConfigChange(config) {
+        if (this.isInspectOnly()) {
+            return;
+        }
         this.lastTableRuntimeConfigSnapshot = this.cloneTableConfigSnapshot(config);
         this.emitTableRuntimeConfigSnapshot(this.lastTableRuntimeConfigSnapshot);
     }
     onTableMetadataChange() {
+        if (this.isInspectOnly()) {
+            return;
+        }
         this.emitTableRuntimeConfigSnapshot();
     }
     onTableLoadingStateChange(state) {
+        if (this.isInspectOnly()) {
+            return;
+        }
         if (!state || state.status !== 'success')
             return;
         if (state.phase !== 'render' && state.phase !== 'data' && state.phase !== 'schema') {
@@ -4263,6 +4358,14 @@ class PraxisCrudComponent {
         this.emitTableRuntimeConfigSnapshot();
     }
     onCollectionLinksChange(links) {
+        if (this.isInspectOnly()) {
+            this.tableCollectionLinks = null;
+            this.collectionCapabilities = null;
+            this.collectionCapabilitiesRequestSeq += 1;
+            this.collectionCapabilitiesRequestHref = null;
+            this.collectionCapabilitiesResolvedHref = null;
+            return;
+        }
         this.tableCollectionLinks = links || null;
         const capabilitiesHref = this.resolveCollectionCapabilitiesHref(links);
         if (!capabilitiesHref) {
@@ -4308,6 +4411,9 @@ class PraxisCrudComponent {
         });
     }
     resolveResourcePath(meta) {
+        if (this.isInspectOnly(meta)) {
+            return '';
+        }
         return (meta?.resource?.path ||
             meta?.table?.resourcePath ||
             '').trim();
@@ -4510,6 +4616,9 @@ class PraxisCrudComponent {
             this.resolveResourcePath(this.resolvedMetadata).length === 0);
     }
     resolveMaterializedReadUrl() {
+        if (this.isInspectOnly()) {
+            return '';
+        }
         const materialization = this.context?.['materialization'];
         return String(materialization?.['readUrl'] || '').trim();
     }
@@ -5071,6 +5180,9 @@ class PraxisCrudComponent {
             ? JSON.parse(JSON.stringify(base))
             : createDefaultTableConfig();
         let changed = false;
+        if (this.isInspectOnly(meta)) {
+            return this.buildInspectOnlyTableConfig(cfg);
+        }
         if (nextResourceIdentity !== null &&
             nextResourceIdentity === this.lastAppliedResourceIdentity &&
             (cfg.columns?.length ?? 0) === 0 &&
@@ -5271,6 +5383,9 @@ class PraxisCrudComponent {
     buildTableCrudContext(meta, capabilities) {
         if (!meta)
             return undefined;
+        if (this.isInspectOnly(meta)) {
+            return undefined;
+        }
         const baseActions = this.resolveContextCrudActions(meta, capabilities);
         return {
             tableId: this.crudId || 'default',
@@ -5327,6 +5442,9 @@ class PraxisCrudComponent {
         });
     };
     isCustomizationAvailable() {
+        if (this.isInspectOnly()) {
+            return false;
+        }
         if (!this.enableCustomization) {
             return false;
         }
@@ -5368,6 +5486,9 @@ class PraxisCrudComponent {
         };
     }
     resolveCreateToolbarAction(meta, capabilities) {
+        if (this.isInspectOnly(meta)) {
+            return null;
+        }
         if (capabilities && !this.supportsCreateCapability(capabilities)) {
             return null;
         }
@@ -5378,6 +5499,9 @@ class PraxisCrudComponent {
         return capabilities ? { action: 'create', label: this.getCrudActionLabel('create') } : null;
     }
     resolveContextCrudActions(meta, capabilities) {
+        if (this.isInspectOnly(meta)) {
+            return [];
+        }
         const declaredActions = (meta.actions || []).filter(Boolean);
         if (!capabilities) {
             return declaredActions.length
@@ -5431,6 +5555,38 @@ class PraxisCrudComponent {
         }
         return runtimeActions;
     }
+    isInspectOnly(meta) {
+        return (meta ?? this.resolvedMetadata)?.interactionMode === 'inspect-only';
+    }
+    buildInspectOnlyTableConfig(config) {
+        return hardenCrudInspectOnlyTableConfig(this.cloneTableConfigSnapshot(config));
+    }
+    emitInspectOnlyDiagnostics(meta) {
+        if (!this.isInspectOnly(meta)) {
+            return;
+        }
+        const incompatiblePaths = [];
+        if (String(meta.resource?.path || '').trim())
+            incompatiblePaths.push('metadata.resource.path');
+        if (String(meta.table?.resourcePath || '').trim()) {
+            incompatiblePaths.push('metadata.table.resourcePath');
+        }
+        if (!Array.isArray(meta.data))
+            incompatiblePaths.push('metadata.data');
+        if ((meta.actions?.length || 0) > 0)
+            incompatiblePaths.push('metadata.actions');
+        if (meta.form)
+            incompatiblePaths.push('metadata.form');
+        if (meta.defaults?.openMode)
+            incompatiblePaths.push('metadata.defaults.openMode');
+        if (incompatiblePaths.length) {
+            this.error.emit({
+                code: 'CRUD_INSPECT_ONLY_INCOMPATIBLE_METADATA',
+                interactionMode: 'inspect-only',
+                paths: incompatiblePaths,
+            });
+        }
+    }
     resolveCollectionWorkflowCrudActions(capabilities) {
         if (!capabilities) {
             return [];
@@ -5653,7 +5809,7 @@ class PraxisCrudComponent {
           [queryContext]="tableQueryContext"
           [filterCriteria]="tableFilterCriteria"
           [tableId]="crudId || 'default'"
-          [configPersistenceStrategy]="tableConfigPersistenceStrategy"
+          [configPersistenceStrategy]="resolvedTableConfigPersistenceStrategy"
           [crudContext]="tableCrudContext"
           [enableCustomization]="enableCustomization"
           [authoringCapability]="authoringCapability"
@@ -5703,7 +5859,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.2.14", ngImpo
           [queryContext]="tableQueryContext"
           [filterCriteria]="tableFilterCriteria"
           [tableId]="crudId || 'default'"
-          [configPersistenceStrategy]="tableConfigPersistenceStrategy"
+          [configPersistenceStrategy]="resolvedTableConfigPersistenceStrategy"
           [crudContext]="tableCrudContext"
           [enableCustomization]="enableCustomization"
           [authoringCapability]="authoringCapability"
@@ -6852,6 +7008,153 @@ const PRAXIS_CRUD_COMPONENT_METADATA = {
     friendlyName: 'Praxis CRUD',
     description: 'Tabela com operações de CRUD via metadados.',
     icon: 'table_chart',
+    runtimeProfiles: [
+        {
+            id: 'public-local-inspect-only',
+            audience: 'public-untrusted',
+            description: 'CRUD local somente para inspeção, sem resource binding, persistência, authoring ou ações operacionais.',
+            constraints: [
+                {
+                    path: '$',
+                    operator: 'keys-subset',
+                    values: [
+                        'metadata',
+                        'crudId',
+                        'tableConfigPersistenceStrategy',
+                        'enableCustomization',
+                    ],
+                },
+                { path: 'crudId', operator: 'present' },
+                { path: 'tableConfigPersistenceStrategy', operator: 'equals', value: 'volatile' },
+                { path: 'enableCustomization', operator: 'not-true' },
+                { path: 'metadata.component', operator: 'equals', value: 'praxis-crud' },
+                { path: 'metadata.interactionMode', operator: 'equals', value: 'inspect-only' },
+                { path: 'metadata.data', operator: 'array' },
+                {
+                    path: 'metadata',
+                    operator: 'keys-subset',
+                    values: ['component', 'interactionMode', 'data', 'table'],
+                },
+                { path: 'metadata.resource', operator: 'absent-or-empty' },
+                { path: 'metadata.queryContext', operator: 'absent-or-empty' },
+                { path: 'metadata.filterCriteria', operator: 'absent-or-empty' },
+                { path: 'metadata.form', operator: 'absent-or-empty' },
+                { path: 'metadata.defaults', operator: 'absent-or-empty' },
+                { path: 'metadata.actions', operator: 'empty-array-or-absent' },
+                { path: 'metadata.i18n', operator: 'absent-or-empty' },
+                { path: 'metadata.table.columns', operator: 'array' },
+                {
+                    path: 'metadata.table',
+                    operator: 'keys-subset',
+                    values: ['columns', 'behavior', 'toolbar'],
+                },
+                {
+                    path: 'metadata.table.columns[*]',
+                    operator: 'keys-subset',
+                    values: [
+                        'field',
+                        'header',
+                        'type',
+                        'width',
+                        'visible',
+                        'sortable',
+                        'filterable',
+                        'resizable',
+                        'sticky',
+                        'align',
+                        'order',
+                        'sortField',
+                        'format',
+                        'valueMapping',
+                    ],
+                },
+                { path: 'metadata.table.columns[*].renderer', operator: 'absent-or-empty' },
+                {
+                    path: 'metadata.table.columns[*].conditionalRenderers',
+                    operator: 'absent-or-empty',
+                },
+                {
+                    path: 'metadata.table.behavior',
+                    operator: 'keys-subset',
+                    values: ['localDataMode', 'pagination', 'sorting', 'filtering'],
+                },
+                { path: 'metadata.table.behavior.localDataMode.enabled', operator: 'equals', value: true },
+                {
+                    path: 'metadata.table.behavior.pagination.strategy',
+                    operator: 'none-of',
+                    values: ['server'],
+                },
+                {
+                    path: 'metadata.table.behavior.pagination',
+                    operator: 'keys-subset',
+                    values: [
+                        'enabled',
+                        'pageSize',
+                        'pageSizeOptions',
+                        'showFirstLastButtons',
+                        'showPageNumbers',
+                        'showPageInfo',
+                        'position',
+                        'style',
+                        'totalItems',
+                        'strategy',
+                    ],
+                },
+                { path: 'metadata.table.behavior.pagination.advanced', operator: 'absent-or-empty' },
+                {
+                    path: 'metadata.table.behavior.sorting.strategy',
+                    operator: 'none-of',
+                    values: ['server'],
+                },
+                {
+                    path: 'metadata.table.behavior.sorting',
+                    operator: 'keys-subset',
+                    values: [
+                        'enabled',
+                        'defaultSort',
+                        'multiSort',
+                        'strategy',
+                        'showSortIndicators',
+                        'indicatorPosition',
+                        'allowClearSort',
+                    ],
+                },
+                { path: 'metadata.table.behavior.sorting.advanced', operator: 'absent-or-empty' },
+                {
+                    path: 'metadata.table.behavior.filtering.strategy',
+                    operator: 'none-of',
+                    values: ['server'],
+                },
+                {
+                    path: 'metadata.table.behavior.filtering',
+                    operator: 'keys-subset',
+                    values: ['enabled', 'columnFilters', 'strategy', 'debounceTime'],
+                },
+                {
+                    path: 'metadata.table.behavior.filtering.columnFilters',
+                    operator: 'keys-subset',
+                    values: ['enabled', 'defaultType', 'position'],
+                },
+                {
+                    path: 'metadata.table.behavior.filtering.advancedFilters',
+                    operator: 'absent-or-empty',
+                },
+                {
+                    path: 'metadata.table.toolbar',
+                    operator: 'keys-subset',
+                    values: ['visible', 'position', 'title', 'subtitle', 'icon', 'textAlign'],
+                },
+                { path: 'metadata.table.toolbar.actions', operator: 'empty-array-or-absent' },
+                { path: 'metadata.table.actions', operator: 'absent-or-empty' },
+                { path: 'metadata.table.export', operator: 'absent-or-empty' },
+                { path: 'metadata.table.ai', operator: 'absent-or-empty' },
+                { path: 'metadata.table.columnProjection', operator: 'absent-or-empty' },
+                { path: 'metadata.table.analyticsProjection', operator: 'absent-or-empty' },
+                { path: 'metadata.table.plugins', operator: 'empty-array-or-absent' },
+            ],
+            effects: [],
+        },
+    ],
     authoringManifestRef: {
         componentId: 'praxis-crud',
         source: 'PRAXIS_CRUD_AUTHORING_MANIFEST',
@@ -6866,6 +7169,12 @@ const PRAXIS_CRUD_COMPONENT_METADATA = {
             type: 'CrudMetadata | string',
             description: 'Metadados de configuração do CRUD (fonte remota via resource.path ou local via metadata.data).',
         },
+        {
+            name: 'metadata.interactionMode',
+            type: "'interactive' | 'inspect-only'",
+            default: 'interactive',
+            description: 'Decisão canônica de interação. inspect-only exige dados locais e bloqueia ações, resource binding, surfaces e authoring no próprio runtime.',
+        },
         {
             name: 'crudId',
             type: 'string',

package/package.json

@@ -1,20 +1,20 @@
 {
   "name": "@praxisui/crud",
-  "version": "9.0.17",
+  "version": "9.0.18",
   "description": "CRUD building blocks for Praxis UI: integrates dynamic forms and tables with unified configuration and services.",
   "peerDependencies": {
     "@angular/common": "^21.0.0",
     "@angular/core": "^21.0.0",
-    "@praxisui/dynamic-form": "^9.0.17",
-    "@praxisui/table": "^9.0.17",
-    "@praxisui/core": "^9.0.17",
-    "@praxisui/dynamic-fields": "^9.0.17",
-    "@praxisui/settings-panel": "^9.0.17",
+    "@praxisui/dynamic-form": "^9.0.18",
+    "@praxisui/table": "^9.0.18",
+    "@praxisui/core": "^9.0.18",
+    "@praxisui/dynamic-fields": "^9.0.18",
+    "@praxisui/settings-panel": "^9.0.18",
     "@angular/cdk": "^21.0.0",
     "@angular/forms": "^21.0.0",
     "@angular/material": "^21.0.0",
     "@angular/router": "^21.0.0",
-    "@praxisui/ai": "^9.0.17",
+    "@praxisui/ai": "^9.0.18",
     "rxjs": "~7.8.0"
   },
   "dependencies": {

package/types/praxisui-crud.d.ts

@@ -48,6 +48,7 @@ declare class DialogService {
 }
 
 type FormOpenMode = 'route' | 'modal' | 'drawer';
+type CrudInteractionMode = 'interactive' | 'inspect-only';
 type CrudReactiveDeterminationStabilityStatus = 'pending' | 'settled-satisfied' | 'settled-unsatisfied';
 /** Value-free stability evidence for the Dynamic Form opened by one CRUD action. */
 interface CrudFormReactiveDeterminationStabilityChange {
@@ -101,6 +102,12 @@ interface CrudResource {
 }
 interface CrudMetadata {
     component: 'praxis-crud';
+    /**
+     * Governs whether the CRUD may materialize operational actions.
+     * `interactive` preserves the historical behavior; `inspect-only` is
+     * fail-closed and only materializes local, non-operational inspection.
+     */
+    interactionMode?: CrudInteractionMode;
     resource?: CrudResource;
     data?: any[] | null;
     table: TableConfig;
@@ -270,6 +277,7 @@ declare class PraxisCrudComponent implements OnChanges {
     private collectionCapabilitiesRequestSeq;
     private currentAuthoringDocument?;
     selectedRow: Record<string, unknown> | null;
+    get resolvedTableConfigPersistenceStrategy(): TableConfigPersistenceStrategy;
     onTableRowAction(event: CrudActionRuntimeEvent): void;
     private getResourceDiscovery;
     private getActionOpenAdapter;
@@ -359,6 +367,9 @@ declare class PraxisCrudComponent implements OnChanges {
     private buildWidgetPersistencePayload;
     private resolveCreateToolbarAction;
     private resolveContextCrudActions;
+    private isInspectOnly;
+    private buildInspectOnlyTableConfig;
+    private emitInspectOnlyDiagnostics;
     private resolveCollectionWorkflowCrudActions;
     private resolveCollectionWorkflowToolbarActions;
     private supportsCreateCapability;
@@ -851,4 +862,4 @@ type OpenCrudMetadataEditorOptions = {
 declare function openCrudMetadataEditor(settings: SettingsPanelService, opts?: OpenCrudMetadataEditorOptions): _praxisui_settings_panel.SettingsPanelRef;
 
 export { CRUD_AI_CAPABILITIES, CrudLauncherService, CrudMetadataEditorComponent, CrudPageHeaderComponent, DialogService, DynamicFormDialogHostComponent, PRAXIS_CRUD_AUTHORING_MANIFEST, PRAXIS_CRUD_COMPONENT_METADATA, PraxisCrudComponent, PraxisCrudWidgetConfigEditor, assertCrudMetadata, createCrudAuthoringDocument, findCrudAction, normalizeCrudAuthoringDocument, openCrudMetadataEditor, parseLegacyOrCrudDocument, providePraxisCrudMetadata, serializeCrudAuthoringDocument, validateCrudAuthoringDocument };
-export type { Capability, CapabilityCatalog, CapabilityCategory, CrudAction, CrudActionFormContract, CrudActionResolutionMode, CrudAuthoringDocument, CrudAuthoringWidgetPersistenceEvent, CrudDefaults, CrudEditorDiagnostic, CrudFormReactiveDeterminationStabilityChange, CrudHeaderConfig, CrudHeaderVariant, CrudMetadata, CrudMetadataAssertionOptions, CrudParamMapping, CrudReactiveDeterminationStabilityChange, CrudReactiveDeterminationStabilityStatus, CrudResource, CrudValidationContext, DialogConfig, DialogRef, FormOpenMode, OpenCrudMetadataEditorOptions, PraxisCrudWidgetEditorInputs, PraxisCrudWidgetEditorValue, ValueKind };
+export type { Capability, CapabilityCatalog, CapabilityCategory, CrudAction, CrudActionFormContract, CrudActionResolutionMode, CrudAuthoringDocument, CrudAuthoringWidgetPersistenceEvent, CrudDefaults, CrudEditorDiagnostic, CrudFormReactiveDeterminationStabilityChange, CrudHeaderConfig, CrudHeaderVariant, CrudInteractionMode, CrudMetadata, CrudMetadataAssertionOptions, CrudParamMapping, CrudReactiveDeterminationStabilityChange, CrudReactiveDeterminationStabilityStatus, CrudResource, CrudValidationContext, DialogConfig, DialogRef, FormOpenMode, OpenCrudMetadataEditorOptions, PraxisCrudWidgetEditorInputs, PraxisCrudWidgetEditorValue, ValueKind };