@incursa/ui-kit 1.5.0 → 1.7.0

package/dist/mcp/specs/control-conventions.json

@@ -0,0 +1,21 @@
+{
+  "uri": "ui-kit://specs/control-conventions",
+  "title": "Control conventions",
+  "kind": "spec",
+  "searchKind": "spec",
+  "summary": "Shared control conventions and modifier grammar.",
+  "body": "---\nartifact_id: SPEC-UIK-CNV\nartifact_type: specification\ntitle: Control Surface Conventions\ndomain: ui-kit\ncapability: control-surface-conventions\nstatus: draft\nowner: ui-kit-maintainers\ntags:\n- ui-kit\n- controls\n- conventions\n- modifiers\n---\n\nSPEC-UIK-CNV - Control Surface Conventions\n\nPurpose\n\nDefine the shared class, modifier, and state conventions used by interactive and entry controls.\n\nScope\n\nThis specification covers layered base classes, shared density suffixes, inline-growth modifiers, and visual state hooks used across shipped control surfaces. It does not define the button, text-entry, select, or group surfaces themselves.\n\nContext\n\nThe SCSS keeps action buttons, text-entry controls, selects, input groups, and refresh toggles aligned by reusing the same modifier grammar instead of inventing a separate convention for each surface.\n\nREQ-UIK-CNV-0001 Keep control surfaces layered\nPublic control surfaces MUST express a stable base class plus explicit modifier classes for semantic, density, layout, or state changes instead of replacing the base class name.\n\nTrace:\n- Code Refs:\n- src/inc-design-language.scss\n- reference.html\n- demo.html\n- forms-and-validation.html\n- overlay-workflows.html\n- states.html\n- work-queue.html\n- record-detail.html\n- data-grid-advanced.html\n- native-patterns.html\n- Verified By:\n- VER-UIK-0001\n\nREQ-UIK-CNV-0002 Reuse density modifier names\nPublic control surfaces that ship compact sizes MUST reuse the --sm, --lg, and --micro modifier names across related controls.\n\nNotes:\n- The repo intentionally allows --micro on supported control surfaces instead of reserving it for a touch-only tier.\n\nTrace:\n- Code Refs:\n- src/inc-design-language.scss\n- reference.html\n- demo.html\n- forms-and-validation.html\n- overlay-workflows.html\n- states.html\n- work-queue.html\n- record-detail.html\n- data-grid-advanced.html\n- Verified By:\n- VER-UIK-0001\n\nREQ-UIK-CNV-0003 Reuse inline expansion modifiers\nPublic control surfaces that need to grow inside inline compositions MUST reuse --expand as the flex-growth modifier.\n\nTrace:\n- Code Refs:\n- src/inc-design-language.scss\n- reference.html\n- demo.html\n- forms-and-validation.html\n- overlay-workflows.html\n- work-queue.html\n- data-grid-advanced.html\n- Verified By:\n- VER-UIK-0001\n\nREQ-UIK-CNV-0004 Keep visual state hooks separate from native semantics\nVisual state hooks such as is-loading, is-valid, is-invalid, and is-paused MUST change presentation without changing the underlying native role, label association, or focus target.\n\nTrace:\n- Code Refs:\n- src/inc-design-language.scss\n- reference.html\n- demo.html\n- forms-and-validation.html\n- overlay-workflows.html\n- states.html\n- work-queue.html\n- data-grid-advanced.html\n- Verified By:\n- VER-UIK-0001\n\nREQ-UIK-CNV-0005 Express control emphasis as modifiers\nThe UI kit MUST express public control emphasis such as primary, secondary, warning, error, or outline treatment as explicit modifiers on the control surface rather than by changing the base block or the native element meaning.\n\nTrace:\n- Code Refs:\n- src/inc-design-language.scss\n- reference.html\n- demo.html\n- forms-and-validation.html\n- overlay-workflows.html\n- states.html\n- work-queue.html\n- data-grid-advanced.html\n- native-patterns.html\n- Verified By:\n- VER-UIK-0001\n\nREQ-UIK-CNV-0006 Allow mixed public surfaces\nPublic surfaces MAY share a DOM node when the combined classes each remain independently meaningful.\n\nTrace:\n- Code Refs:\n- src/inc-design-language.scss\n- reference.html\n- demo.html\n- forms-and-validation.html\n- native-patterns.html\n- overlay-workflows.html\n- states.html\n- work-queue.html\n- data-grid-advanced.html\n- Verified By:\n- VER-UIK-0001",
+  "sourcePaths": [
+    "specs/requirements/ui-kit/SPEC-UIK-CNV.md"
+  ],
+  "mimeType": "text/markdown; charset=utf-8",
+  "aliases": [
+    "cnv",
+    "conventions"
+  ],
+  "relatedUris": [],
+  "group": "specs",
+  "priority": 88,
+  "includeInSearch": true,
+  "searchText": "Control conventions\nShared control conventions and modifier grammar.\n---\nartifact_id: SPEC-UIK-CNV\nartifact_type: specification\ntitle: Control Surface Conventions\ndomain: ui-kit\ncapability: control-surface-conventions\nstatus: draft\nowner: ui-kit-maintainers\ntags:\n- ui-kit\n- controls\n- conventions\n- modifiers\n---\n\nSPEC-UIK-CNV - Control Surface Conventions\n\nPurpose\n\nDefine the shared class, modifier, and state conventions used by interactive and entry controls.\n\nScope\n\nThis specification covers layered base classes, shared density suffixes, inline-growth modifiers, and visual state hooks used across shipped control surfaces. It does not define the button, text-entry, select, or group surfaces themselves.\n\nContext\n\nThe SCSS keeps action buttons, text-entry controls, selects, input groups, and refresh toggles aligned by reusing the same modifier grammar instead of inventing a separate convention for each surface.\n\nREQ-UIK-CNV-0001 Keep control surfaces layered\nPublic control surfaces MUST express a stable base class plus explicit modifier classes for semantic, density, layout, or state changes instead of replacing the base class name.\n\nTrace:\n- Code Refs:\n- src/inc-design-language.scss\n- reference.html\n- demo.html\n- forms-and-validation.html\n- overlay-workflows.html\n- states.html\n- work-queue.html\n- record-detail.html\n- data-grid-advanced.html\n- native-patterns.html\n- Verified By:\n- VER-UIK-0001\n\nREQ-UIK-CNV-0002 Reuse density modifier names\nPublic control surfaces that ship compact sizes MUST reuse the --sm, --lg, and --micro modifier names across related controls.\n\nNotes:\n- The repo intentionally allows --micro on supported control surfaces instead of reserving it for a touch-only tier.\n\nTrace:\n- Code Refs:\n- src/inc-design-language.scss\n- reference.html\n- demo.html\n- forms-and-validation.html\n- overlay-workflows.html\n- states.html\n- work-queue.html\n- record-detail.html\n- data-grid-advanced.html\n- Verified By:\n- VER-UIK-0001\n\nREQ-UIK-CNV-0003 Reuse inline expansion modifiers\nPublic control surfaces that need to grow inside inline compositions MUST reuse --expand as the flex-growth modifier.\n\nTrace:\n- Code Refs:\n- src/inc-design-language.scss\n- reference.html\n- demo.html\n- forms-and-validation.html\n- overlay-workflows.html\n- work-queue.html\n- data-grid-advanced.html\n- Verified By:\n- VER-UIK-0001\n\nREQ-UIK-CNV-0004 Keep visual state hooks separate from native semantics\nVisual state hooks such as is-loading, is-valid, is-invalid, and is-paused MUST change presentation without changing the underlying native role, label association, or focus target.\n\nTrace:\n- Code Refs:\n- src/inc-design-language.scss\n- reference.html\n- demo.html\n- forms-and-validation.html\n- overlay-workflows.html\n- states.html\n- work-queue.html\n- data-grid-advanced.html\n- Verified By:\n- VER-UIK-0001\n\nREQ-UIK-CNV-0005 Express control emphasis as modifiers\nThe UI kit MUST express public control emphasis such as primary, secondary, warning, error, or outline treatment as explicit modifiers on the control surface rather than by changing the base block or the native element meaning.\n\nTrace:\n- Code Refs:\n- src/inc-design-language.scss\n- reference.html\n- demo.html\n- forms-and-validation.html\n- overlay-workflows.html\n- states.html\n- work-queue.html\n- data-grid-advanced.html\n- native-patterns.html\n- Verified By:\n- VER-UIK-0001\n\nREQ-UIK-CNV-0006 Allow mixed public surfaces\nPublic surfaces MAY share a DOM node when the combined classes each remain independently meaningful.\n\nTrace:\n- Code Refs:\n- src/inc-design-language.scss\n- reference.html\n- demo.html\n- forms-and-validation.html\n- native-patterns.html\n- overlay-workflows.html\n- states.html\n- work-queue.html\n- data-grid-advanced.html\n- Verified By:\n- VER-UIK-0001\ncnv\nconventions\nspecs/requirements/ui-kit/SPEC-UIK-CNV.md"
+}

package/dist/mcp/specs/public-surface.json

@@ -0,0 +1,21 @@
+{
+  "uri": "ui-kit://specs/public-surface",
+  "title": "Public surface",
+  "kind": "spec",
+  "searchKind": "spec",
+  "summary": "Public surface standards and accessible interaction behavior.",
+  "body": "---\nartifact_id: SPEC-UIK-STD\nartifact_type: specification\ntitle: Public Surface Standards\ndomain: ui-kit\ncapability: public-surface-standards\nstatus: draft\nowner: ui-kit-maintainers\ntags:\n- ui-kit\n- standards\n- naming\n---\n\nSPEC-UIK-STD - Public Surface Standards\n\nPurpose\n\nDefine the naming baseline that applies to every public inc-* surface in the UI kit.\n\nScope\n\nThis specification covers public class naming, BEM structure, compatibility aliases, and the reserved utility prefix. It does not define component-specific visuals or layouts.\n\nContext\n\nThe component specs stay more useful when they inherit one explicit baseline for naming instead of repeating the same assumptions in every file.\n\nREQ-UIK-STD-0001 Use stable public naming\nThe UI kit MUST use the inc- prefix for all public CSS classes and BEM-style naming with __ for elements and -- for modifiers.\n\nTrace:\n- Code Refs:\n- src/inc-design-language.scss\n- README.md\n- LLMS.txt\n- reference.html\n- demo.html\n- forms-and-validation.html\n- data-grid-advanced.html\n- overlay-workflows.html\n- native-patterns.html\n- work-queue.html\n- record-detail.html\n- states.html\n- Verified By:\n- VER-UIK-0001\n\nREQ-UIK-STD-0002 Allow compatibility aliases\nCompatibility aliases MAY remain when they map to an existing canonical public surface and do not introduce a second contract.\n\nTrace:\n- Code Refs:\n- src/inc-design-language.scss\n- reference.html\n- demo.html\n- Verified By:\n- VER-UIK-0001\n\nREQ-UIK-STD-0003 Reserve the utility prefix\nAtomic utility classes MUST use the inc-u- prefix.\n\nTrace:\n- Code Refs:\n- src/inc-design-language.scss\n- reference.html\n- demo.html\n- AI-AGENT-INSTRUCTIONS.md\n- states.html\n- Verified By:\n- VER-UIK-0001\n\nREQ-UIK-STD-0004 Forbid element-of-element names\nPublic BEM element names MUST NOT use nested element separators such as inc-block__element__child.\n\nTrace:\n- Code Refs:\n- src/inc-design-language.scss\n- reference.html\n- forms-and-validation.html\n- LLMS.txt\n- Verified By:\n- VER-UIK-0001",
+  "sourcePaths": [
+    "specs/requirements/ui-kit/SPEC-UIK-STD.md"
+  ],
+  "mimeType": "text/markdown; charset=utf-8",
+  "aliases": [
+    "std",
+    "surface standards"
+  ],
+  "relatedUris": [],
+  "group": "specs",
+  "priority": 88,
+  "includeInSearch": true,
+  "searchText": "Public surface\nPublic surface standards and accessible interaction behavior.\n---\nartifact_id: SPEC-UIK-STD\nartifact_type: specification\ntitle: Public Surface Standards\ndomain: ui-kit\ncapability: public-surface-standards\nstatus: draft\nowner: ui-kit-maintainers\ntags:\n- ui-kit\n- standards\n- naming\n---\n\nSPEC-UIK-STD - Public Surface Standards\n\nPurpose\n\nDefine the naming baseline that applies to every public inc-* surface in the UI kit.\n\nScope\n\nThis specification covers public class naming, BEM structure, compatibility aliases, and the reserved utility prefix. It does not define component-specific visuals or layouts.\n\nContext\n\nThe component specs stay more useful when they inherit one explicit baseline for naming instead of repeating the same assumptions in every file.\n\nREQ-UIK-STD-0001 Use stable public naming\nThe UI kit MUST use the inc- prefix for all public CSS classes and BEM-style naming with __ for elements and -- for modifiers.\n\nTrace:\n- Code Refs:\n- src/inc-design-language.scss\n- README.md\n- LLMS.txt\n- reference.html\n- demo.html\n- forms-and-validation.html\n- data-grid-advanced.html\n- overlay-workflows.html\n- native-patterns.html\n- work-queue.html\n- record-detail.html\n- states.html\n- Verified By:\n- VER-UIK-0001\n\nREQ-UIK-STD-0002 Allow compatibility aliases\nCompatibility aliases MAY remain when they map to an existing canonical public surface and do not introduce a second contract.\n\nTrace:\n- Code Refs:\n- src/inc-design-language.scss\n- reference.html\n- demo.html\n- Verified By:\n- VER-UIK-0001\n\nREQ-UIK-STD-0003 Reserve the utility prefix\nAtomic utility classes MUST use the inc-u- prefix.\n\nTrace:\n- Code Refs:\n- src/inc-design-language.scss\n- reference.html\n- demo.html\n- AI-AGENT-INSTRUCTIONS.md\n- states.html\n- Verified By:\n- VER-UIK-0001\n\nREQ-UIK-STD-0004 Forbid element-of-element names\nPublic BEM element names MUST NOT use nested element separators such as inc-block__element__child.\n\nTrace:\n- Code Refs:\n- src/inc-design-language.scss\n- reference.html\n- forms-and-validation.html\n- LLMS.txt\n- Verified By:\n- VER-UIK-0001\nstd\nsurface standards\nspecs/requirements/ui-kit/SPEC-UIK-STD.md"
+}

package/dist/mcp/specs/requirements-index.json

@@ -0,0 +1,21 @@
+{
+  "uri": "ui-kit://specs/requirements-index",
+  "title": "Requirements index",
+  "kind": "spec",
+  "searchKind": "spec",
+  "summary": "Index for the UI kit requirement specs and gap tracker.",
+  "body": "UI Kit Spec Suite\n\nThis folder contains the current Spec Trace pass for the Incursa UI kit.\n\nThe suite is organized by shared foundations first, then by stable UI concern rather than by page example:\n\n- SPEC-UIK-STD - public surface standards\n- SPEC-UIK-TOK - theme tokens and value contract\n- SPEC-UIK-A11Y - accessibility baseline and semantic behavior\n- SPEC-UIK-CNV - control surface conventions and shared modifiers\n- SPEC-UIK-WC - optional Web Component layer scope and parity\n- SPEC-UIK-LAY - layout primitives and shell\n- SPEC-UIK-BTN - button and action controls\n- SPEC-UIK-TXT - typography and text helpers\n- SPEC-UIK-FRM - form layout and grouping\n- SPEC-UIK-INP - editable form controls\n- SPEC-UIK-SEL - select controls\n- SPEC-UIK-GRP - input group composition\n- SPEC-UIK-RO - read-only field display\n- SPEC-UIK-CHO - binary choice controls\n- SPEC-UIK-VAL - validation and error feedback\n- SPEC-UIK-FLT - filter and bulk action bars\n- SPEC-UIK-CARD - card and section surfaces\n- SPEC-UIK-LIST - list and collection rows\n- SPEC-UIK-TBL - tables and data grids\n- SPEC-UIK-UTL - public utility and helper classes\n- SPEC-UIK-NAV - navigation shell and menus\n- SPEC-UIK-FDBK - feedback and operational states\n- SPEC-UIK-OVL - overlays and disclosures\n- SPEC-UIK-MET - metrics and status surfaces\n- SPEC-UIK-FILE - file review surfaces\n- SPEC-UIK-INT - interaction helper contract\n\nOpen issues and follow-up questions live in REQUIREMENT-GAPS.\n\nUI Kit Requirement Gaps\n\nThis file tracks unresolved questions and assumptions after the shared-foundation split and the current source/dist alignment pass.\n\n| Gap ID | Affected Specs | Question or ambiguity | Current assumption |\n| --- | --- | --- | --- |\n| GAP-UIK-0002 | SPEC-UIK-OVL, SPEC-UIK-INT | Should inc-modal and inc-offcanvas remain in the public surface as compatibility shells once native dialog and disclosure workflows cover more products? | This pass keeps them as compatibility surfaces while preferring native <dialog> and <details> where possible. |\n| GAP-UIK-0003 | SPEC-UIK-UTL, SPEC-UIK-TXT | Should additional public utility families be split into separate specs if the shipped class set grows further? | This pass keeps layout utilities in SPEC-UIK-UTL and public text helpers in SPEC-UIK-TXT, and leaves the future family split question open until there is a clear usage need. |\n| GAP-UIK-0005 | All verified specs | Should the verification layer stay source-review only, or should future passes add executable browser or visual verification? | This pass records a source-review verification baseline in VER-UIK-0001, adds a repo-local smoke gate in VER-UIK-0002, and still leaves runtime browser or visual automation as a future option. |\n\nIf you want the next pass to split or merge any of the current family-level specs, record that here before changing the file set so the trace history stays explicit.",
+  "sourcePaths": [
+    "specs/requirements/ui-kit/_index.md"
+  ],
+  "mimeType": "text/markdown; charset=utf-8",
+  "aliases": [
+    "requirements",
+    "specs index"
+  ],
+  "relatedUris": [],
+  "group": "specs",
+  "priority": 88,
+  "includeInSearch": true,
+  "searchText": "Requirements index\nIndex for the UI kit requirement specs and gap tracker.\nUI Kit Spec Suite\n\nThis folder contains the current Spec Trace pass for the Incursa UI kit.\n\nThe suite is organized by shared foundations first, then by stable UI concern rather than by page example:\n\n- SPEC-UIK-STD - public surface standards\n- SPEC-UIK-TOK - theme tokens and value contract\n- SPEC-UIK-A11Y - accessibility baseline and semantic behavior\n- SPEC-UIK-CNV - control surface conventions and shared modifiers\n- SPEC-UIK-WC - optional Web Component layer scope and parity\n- SPEC-UIK-LAY - layout primitives and shell\n- SPEC-UIK-BTN - button and action controls\n- SPEC-UIK-TXT - typography and text helpers\n- SPEC-UIK-FRM - form layout and grouping\n- SPEC-UIK-INP - editable form controls\n- SPEC-UIK-SEL - select controls\n- SPEC-UIK-GRP - input group composition\n- SPEC-UIK-RO - read-only field display\n- SPEC-UIK-CHO - binary choice controls\n- SPEC-UIK-VAL - validation and error feedback\n- SPEC-UIK-FLT - filter and bulk action bars\n- SPEC-UIK-CARD - card and section surfaces\n- SPEC-UIK-LIST - list and collection rows\n- SPEC-UIK-TBL - tables and data grids\n- SPEC-UIK-UTL - public utility and helper classes\n- SPEC-UIK-NAV - navigation shell and menus\n- SPEC-UIK-FDBK - feedback and operational states\n- SPEC-UIK-OVL - overlays and disclosures\n- SPEC-UIK-MET - metrics and status surfaces\n- SPEC-UIK-FILE - file review surfaces\n- SPEC-UIK-INT - interaction helper contract\n\nOpen issues and follow-up questions live in REQUIREMENT-GAPS.\n\nUI Kit Requirement Gaps\n\nThis file tracks unresolved questions and assumptions after the shared-foundation split and the current source/dist alignment pass.\n\n| Gap ID | Affected Specs | Question or ambiguity | Current assumption |\n| --- | --- | --- | --- |\n| GAP-UIK-0002 | SPEC-UIK-OVL, SPEC-UIK-INT | Should inc-modal and inc-offcanvas remain in the public surface as compatibility shells once native dialog and disclosure workflows cover more products? | This pass keeps them as compatibility surfaces while preferring native <dialog> and <details> where possible. |\n| GAP-UIK-0003 | SPEC-UIK-UTL, SPEC-UIK-TXT | Should additional public utility families be split into separate specs if the shipped class set grows further? | This pass keeps layout utilities in SPEC-UIK-UTL and public text helpers in SPEC-UIK-TXT, and leaves the future family split question open until there is a clear usage need. |\n| GAP-UIK-0005 | All verified specs | Should the verification layer stay source-review only, or should future passes add executable browser or visual verification? | This pass records a source-review verification baseline in VER-UIK-0001, adds a repo-local smoke gate in VER-UIK-0002, and still leaves runtime browser or visual automation as a future option. |\n\nIf you want the next pass to split or merge any of the current family-level specs, record that here before changing the file set so the trace history stays explicit.\nrequirements\nspecs index\nspecs/requirements/ui-kit/_index.md"
+}

package/dist/mcp/specs/verification-index.json

@@ -0,0 +1,21 @@
+{
+  "uri": "ui-kit://specs/verification-index",
+  "title": "Verification index",
+  "kind": "spec",
+  "searchKind": "spec",
+  "summary": "Auditable verification baseline for the spec suite.",
+  "body": "UI Kit Verification Index\n\nThis folder contains the auditable verification layer for the Incursa UI kit spec suite, including the shared foundation specs and the component conformance baseline.\n\n- VER-UIK-0001 - source-review baseline for the revised public UI kit surface\n- VER-UIK-0002 - repo-local smoke validation for the packaged public surface\n- VER-UIK-0003 - browser automation baseline for the existing helper-managed surface\n- VER-UIK-0004 - browser automation coverage for the Web Component layer",
+  "sourcePaths": [
+    "specs/verification/ui-kit/_index.md"
+  ],
+  "mimeType": "text/markdown; charset=utf-8",
+  "aliases": [
+    "verification",
+    "ver index"
+  ],
+  "relatedUris": [],
+  "group": "specs",
+  "priority": 88,
+  "includeInSearch": true,
+  "searchText": "Verification index\nAuditable verification baseline for the spec suite.\nUI Kit Verification Index\n\nThis folder contains the auditable verification layer for the Incursa UI kit spec suite, including the shared foundation specs and the component conformance baseline.\n\n- VER-UIK-0001 - source-review baseline for the revised public UI kit surface\n- VER-UIK-0002 - repo-local smoke validation for the packaged public surface\n- VER-UIK-0003 - browser automation baseline for the existing helper-managed surface\n- VER-UIK-0004 - browser automation coverage for the Web Component layer\nverification\nver index\nspecs/verification/ui-kit/_index.md"
+}

package/dist/mcp/update.json

@@ -0,0 +1,24 @@
+{
+  "title": "Update",
+  "summary": "Package-manager update commands and release-review guidance.",
+  "packageName": "@incursa/ui-kit",
+  "version": "1.7.0",
+  "commands": {
+    "npm": "npm install @incursa/ui-kit@latest",
+    "pnpm": "pnpm up @incursa/ui-kit",
+    "yarn": "yarn upgrade @incursa/ui-kit"
+  },
+  "verifyCommands": {
+    "npm": "npm run verify",
+    "packageVersion": "node -p \"require('./package.json').version\""
+  },
+  "notes": [
+    "Review the changelog and regenerated MCP manifests after each upgrade.",
+    "Verify that the compiled CSS, JS helper, and web-components entrypoints still match the package contract."
+  ],
+  "latestReleaseNotes": "- Made the file workflow examples functional with shared browse, drag-drop, and removable file-row behavior.\n- Added dismissible and timeout-driven alert behavior, fixed close-button rendering, and tightened the auto-refresh controls and loading-button examples.\n- Improved dark-mode contrast across filter chips, review-grid row states, and related showcase surfaces, with expanded browser coverage and refreshed generated assets.",
+  "relatedUris": [
+    "ui-kit://release-notes/latest",
+    "ui-kit://package-metadata"
+  ]
+}