@imj_media/ui 1.11.5 → 1.12.0

package/CHANGELOG.md

@@ -7,6 +7,22 @@ y este proyecto adhiere a [Semantic Versioning](https://semver.org/lang/es/).
 
 ## [Unreleased]
 
+## [1.12.0] - 2026-07-02
+
+### Added
+
+- **Catálogo semántico Forge:** `semantic-catalog.json` (y esquema asociado) para mapeo entidad Forge → componentes UI; generado con el flujo de catálogo del paquete.
+- **Integración `@imj_media/ds-mcp` (capa semántica):** herramientas MCP `list_components`, `resolve_entity_ui` y `validate_entity_mapping` para descubrir componentes y validar mapeos entidad→UI desde Forge.
+
+### Fixed
+
+- **`Modal`:** apilado correcto de modales anidados (`modalStack`).
+- **`DatePicker`:** posicionamiento del portal dentro del viewport (`computePortalPosition`).
+
+### Documentation
+
+- Especificación **`docs/specs/ds-mcp-semantic-forge-v1.md`** (contrato Forge ↔ catálogo semántico y flujo ds-mcp).
+
 ## [1.11.5] - 2026-07-01
 
 ### Added

package/README.md

@@ -4,7 +4,7 @@
 
 Biblioteca de componentes UI moderna y accesible para React, construida con TypeScript y Tailwind CSS.
 
-> **Versión publicada:** `1.11.5` — actualizar este número y `CHANGELOG.md` antes de cada release (orden y scripts: regla **`imj-ui-obligations-release`**; atajo `npm run publish:patch|minor|major` o pasos `bump:*` → `release:git` → `release:publish`).
+> **Versión publicada:** `1.12.0` — actualizar este número y `CHANGELOG.md` antes de cada release (orden y scripts: regla **`imj-ui-obligations-release`**; atajo `npm run publish:patch|minor|major` o pasos `bump:*` → `release:git` → `release:publish`).
 
 ## 📦 Instalación
 

package/catalog/design-index.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
   "package": "@imj_media/ui",
-  "version": "1.11.5",
-  "indexedAt": "2026-07-01T19:14:31.935Z",
+  "version": "1.12.0",
+  "indexedAt": "2026-07-02T19:01:02.102Z",
   "orbitTokensVersion": "1.3.1",
   "modules": [
     {

package/catalog/install-registry.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": "1.0.0",
   "consumerRoot": "../../ds-mcp/src/indexer/consumer",
-  "generatedAt": "2026-07-01T19:14:32.010Z",
-  "uiVersion": "1.11.5",
+  "generatedAt": "2026-07-02T19:01:02.192Z",
+  "uiVersion": "1.12.0",
   "entries": {
     "accordion": {
       "name": "Accordion",
@@ -1129,6 +1129,11 @@
           "source": "DatePicker/types/index.ts",
           "sourceKind": "module"
         },
+        {
+          "target": "modules/DatePicker/utils/computePortalPosition.ts",
+          "source": "DatePicker/utils/computePortalPosition.ts",
+          "sourceKind": "module"
+        },
         {
           "target": "modules/DatePicker/utils/datetimeFormat.ts",
           "source": "DatePicker/utils/datetimeFormat.ts",

package/catalog/semantic-catalog.json

@@ -0,0 +1,187 @@
+{
+  "schemaVersion": "1.0.0",
+  "entries": [
+    {
+      "id": "table-data-registry",
+      "moduleId": "Table",
+      "exportName": "Table",
+      "displayName": "Table",
+      "importPath": "@imj_media/ui",
+      "importSymbol": "Table",
+      "replacesGeneric": ["DataTable", "ReferenceTable", "OrbitDataGrid"],
+      "semantic": {
+        "classification": ["DataRegistry", "Configuration", "AuditLog"],
+        "capabilities": ["search", "pagination", "advancedFilter", "export", "selection"]
+      },
+      "dataBinding": {
+        "kind": "rest",
+        "rowsProp": "rows",
+        "columnsProp": "columns",
+        "toolbarSearchProp": "toolbar.showSearch",
+        "paginationProp": "pagination"
+      },
+      "entityHints": {
+        "preferredKeyFields": ["id", "name", "created_at", "status"],
+        "statusFieldCandidates": ["status", "state", "estado"]
+      }
+    },
+    {
+      "id": "table-workflow-fallback",
+      "moduleId": "Table",
+      "exportName": "Table",
+      "displayName": "Table",
+      "importPath": "@imj_media/ui",
+      "importSymbol": "Table",
+      "replacesGeneric": ["KanbanBoard", "KanbanOrderBoard", "OrbitKanban"],
+      "semantic": {
+        "classification": ["WorkflowProcess"],
+        "capabilities": ["stateTracking", "search", "pagination"]
+      },
+      "dataBinding": {
+        "kind": "stateMachine",
+        "rowsProp": "rows",
+        "columnsProp": "columns",
+        "stateField": "status",
+        "lifecycleToColumn": true
+      },
+      "entityHints": {
+        "preferredKeyFields": ["id", "status", "name", "updated_at"],
+        "statusFieldCandidates": ["status", "state", "estado"]
+      },
+      "limitations": ["no_native_drag_drop", "use_table_with_status_column"]
+    },
+    {
+      "id": "ghantt-timeline",
+      "moduleId": "Ghantt",
+      "exportName": "Ghantt",
+      "displayName": "Ghantt",
+      "importPath": "@imj_media/ui",
+      "importSymbol": "Ghantt",
+      "replacesGeneric": ["GanttChart", "TimelineBoard"],
+      "semantic": {
+        "classification": ["TimelineEntity"],
+        "capabilities": ["timeline", "search", "pagination"]
+      },
+      "dataBinding": {
+        "kind": "rest",
+        "rowsProp": "rows",
+        "columnsProp": "columns"
+      },
+      "entityHints": {
+        "preferredKeyFields": ["id", "start_date", "end_date", "name"]
+      }
+    },
+    {
+      "id": "lists-master",
+      "moduleId": "Lists",
+      "exportName": "Lists",
+      "displayName": "Lists",
+      "importPath": "@imj_media/ui",
+      "importSymbol": "Lists",
+      "replacesGeneric": ["ListView", "MasterListView"],
+      "semantic": {
+        "classification": ["MasterList"],
+        "capabilities": ["search", "selection"]
+      },
+      "dataBinding": {
+        "kind": "rest",
+        "itemsProp": "list.items"
+      },
+      "entityHints": {
+        "preferredKeyFields": ["id", "title", "name"]
+      }
+    },
+    {
+      "id": "lists-notification-feed",
+      "moduleId": "Lists",
+      "exportName": "Lists",
+      "displayName": "Lists",
+      "importPath": "@imj_media/ui",
+      "importSymbol": "Lists",
+      "replacesGeneric": ["FeedList", "NotificationList"],
+      "semantic": {
+        "classification": ["NotificationFeed"],
+        "capabilities": ["notification", "search"]
+      },
+      "dataBinding": {
+        "kind": "rest",
+        "itemsProp": "list.items"
+      },
+      "entityHints": {
+        "preferredKeyFields": ["id", "message", "created_at", "read"]
+      }
+    },
+    {
+      "id": "filters-bar",
+      "moduleId": "Filters",
+      "exportName": "Filters",
+      "displayName": "Filters",
+      "importPath": "@imj_media/ui",
+      "importSymbol": "Filters",
+      "replacesGeneric": ["SearchBar", "FilterPanel"],
+      "semantic": {
+        "classification": ["FilterBar"],
+        "capabilities": ["advancedFilter", "search"]
+      },
+      "dataBinding": {
+        "kind": "static",
+        "filtersProp": "filters"
+      }
+    },
+    {
+      "id": "header-filter-bar",
+      "moduleId": "Header",
+      "exportName": "Header",
+      "displayName": "Header",
+      "importPath": "@imj_media/ui",
+      "importSymbol": "Header",
+      "replacesGeneric": ["PageHeader", "FilterHeader"],
+      "semantic": {
+        "classification": ["FilterBar"],
+        "capabilities": ["advancedFilter", "search"]
+      },
+      "dataBinding": {
+        "kind": "static",
+        "filtersProp": "filters"
+      }
+    },
+    {
+      "id": "form-entity-stack",
+      "moduleId": "Modal",
+      "exportName": "Modal",
+      "displayName": "Modal",
+      "importPath": "@imj_media/ui",
+      "importSymbol": "Modal",
+      "replacesGeneric": ["EntityForm", "EditDialog"],
+      "semantic": {
+        "classification": ["FormEntity"],
+        "capabilities": ["formFields"]
+      },
+      "dataBinding": {
+        "kind": "composition",
+        "compositionModules": ["Modal", "Input", "Dropdown", "Button"]
+      },
+      "limitations": ["compose_modal_with_input_dropdown_button"]
+    },
+    {
+      "id": "datepicker-form-field",
+      "moduleId": "DatePicker",
+      "exportName": "DatePicker",
+      "displayName": "DatePicker",
+      "importPath": "@imj_media/ui",
+      "importSymbol": "DatePicker",
+      "replacesGeneric": ["DateInput", "DateRangePicker"],
+      "semantic": {
+        "classification": ["FormEntity", "DateField"],
+        "capabilities": ["formFields", "dateRange"]
+      },
+      "dataBinding": {
+        "kind": "static",
+        "valueProp": "selectedDate"
+      },
+      "entityHints": {
+        "preferredKeyFields": ["date", "start_date", "end_date"]
+      }
+    }
+  ]
+}

package/catalog/semantic-catalog.schema.json

@@ -0,0 +1,130 @@
+{
+  "title": "IMJ UI Semantic Catalog",
+  "type": "object",
+  "required": ["schemaVersion", "entries"],
+  "additionalProperties": false,
+  "properties": {
+    "schemaVersion": { "type": "string", "pattern": "^\\d+\\.\\d+\\.\\d+$" },
+    "entries": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/semanticEntry" }
+    }
+  },
+  "$defs": {
+    "classification": {
+      "type": "string",
+      "enum": [
+        "DataRegistry",
+        "Configuration",
+        "AuditLog",
+        "WorkflowProcess",
+        "TimelineEntity",
+        "MasterList",
+        "NotificationFeed",
+        "FilterBar",
+        "FormEntity",
+        "DateField"
+      ]
+    },
+    "capability": {
+      "type": "string",
+      "enum": [
+        "search",
+        "pagination",
+        "advancedFilter",
+        "export",
+        "selection",
+        "stateTracking",
+        "timeline",
+        "dragDrop",
+        "formFields",
+        "dateRange",
+        "notification"
+      ]
+    },
+    "dataBinding": {
+      "type": "object",
+      "required": ["kind"],
+      "properties": {
+        "kind": { "type": "string", "enum": ["rest", "stateMachine", "static", "composition"] },
+        "rowsProp": { "type": "string" },
+        "columnsProp": { "type": "string" },
+        "toolbarSearchProp": { "type": "string" },
+        "paginationProp": { "type": "string" },
+        "stateField": { "type": ["string", "null"] },
+        "lifecycleToColumn": { "type": "boolean" },
+        "valueProp": { "type": "string" },
+        "itemsProp": { "type": "string" },
+        "filtersProp": { "type": "string" },
+        "compositionModules": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      },
+      "additionalProperties": false
+    },
+    "entityHints": {
+      "type": "object",
+      "properties": {
+        "preferredKeyFields": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "statusFieldCandidates": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      },
+      "additionalProperties": false
+    },
+    "semanticEntry": {
+      "type": "object",
+      "required": [
+        "id",
+        "moduleId",
+        "exportName",
+        "displayName",
+        "importPath",
+        "importSymbol",
+        "semantic",
+        "dataBinding"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "moduleId": { "type": "string", "minLength": 1 },
+        "exportName": { "type": "string", "minLength": 1 },
+        "displayName": { "type": "string", "minLength": 1 },
+        "importPath": { "type": "string", "const": "@imj_media/ui" },
+        "importSymbol": { "type": "string", "minLength": 1 },
+        "replacesGeneric": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "semantic": {
+          "type": "object",
+          "required": ["classification", "capabilities"],
+          "properties": {
+            "classification": {
+              "type": "array",
+              "items": { "$ref": "#/$defs/classification" },
+              "minItems": 1
+            },
+            "capabilities": {
+              "type": "array",
+              "items": { "$ref": "#/$defs/capability" }
+            }
+          },
+          "additionalProperties": false
+        },
+        "dataBinding": { "$ref": "#/$defs/dataBinding" },
+        "entityHints": { "$ref": "#/$defs/entityHints" },
+        "limitations": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    }
+  }
+}