@oods/component-contracts 0.4.1 → 0.4.2

package/README.md

@@ -29,4 +29,4 @@ Use matching versions of the OODS packages. These packages are separate from the
 
 ## License
 
-Apache License 2.0. See [LICENSE](https://cdn.jsdelivr.net/npm/@oods/component-contracts@0.4.1/LICENSE) and [NOTICE](https://cdn.jsdelivr.net/npm/@oods/component-contracts@0.4.1/NOTICE). Generated output belongs to its user; installed package dependencies retain their own licenses.
+Apache License 2.0. See [LICENSE](https://cdn.jsdelivr.net/npm/@oods/component-contracts@0.4.2/LICENSE) and [NOTICE](https://cdn.jsdelivr.net/npm/@oods/component-contracts@0.4.2/NOTICE). Generated output belongs to its user; installed package dependencies retain their own licenses.

package/dist/index.cjs

@@ -15867,13 +15867,13 @@ var authoredContracts = {
   ArchiveSummary: {
     id: "ArchiveSummary",
     version: COMPONENT_CONTRACT_VERSION,
-    props: ["title", "label", "heading", "name", "isArchived", "archived", "status", "archivedAt", "reason", "archiveReason", "summary", "text", "description"],
+    props: ["title", "label", "heading", "name", "isArchived", "archived", "status", "archivedAt", "reason", "archiveReason", "summary", "text", "description", "hideWhenDefault"],
     slots: ["default"],
     events: [],
     states: ["populated", "fallback", "empty"],
     tokenRoles: ["summary.background", "summary.border", "summary.text", "summary.label"],
     accessibility: ["false renders No in its named term", "archive date and reason remain associated terms"],
-    compatibility: "Mirrors renderArchiveSummary: h3 heading and Archived (isArchived/archived/status), Archived At (archivedAt), Reason (reason/archiveReason) description-list terms. A nullable archivedAt omits its date term; boolean summary terms render No and Yes; an absent flag remains absent. summary/text/description fallback and authored body override preserve the heading. archivedField, archivedAtField and reasonField lower to their runtime keys. restoredAtField, archivedByField, metadataField, retainHistoryParameter, restoreWindowParameter and allowPartialRestoreParameter are consumed unbound: HTML has no restore, actor or archive metadata term or action. Noninteractive."
+    compatibility: 'Mirrors renderArchiveSummary: h3 heading and Archived (isArchived/archived/status), Archived At (archivedAt), Reason (reason/archiveReason) description-list terms. A nullable archivedAt omits its date term; boolean summary terms render No and Yes; an absent flag remains absent. summary/text/description fallback and authored body override preserve the heading. archivedField, archivedAtField and reasonField lower to their runtime keys. restoredAtField, archivedByField, metadataField, retainHistoryParameter, restoreWindowParameter and allowPartialRestoreParameter are consumed unbound: HTML has no restore, actor or archive metadata term or action. With hideWhenDefault the card renders nothing while it would only state the default: a false flag with no archive date, reason or authored content (s224-m01: a detail page does not state "Archived: No" as content); an archived record, or one with a date or reason, keeps its card. Noninteractive.'
   },
   ArchivedRowOverlay: {
     id: "ArchivedRowOverlay",
@@ -16023,14 +16023,14 @@ var authoredContracts = {
   CancellationSummary: {
     id: "CancellationSummary",
     version: COMPONENT_CONTRACT_VERSION,
-    props: ["title", "label", "cancelAtPeriodEnd", "requestedAt", "reason", "code"],
+    props: ["title", "label", "cancelAtPeriodEnd", "requestedAt", "reason", "code", "hideWhenDefault"],
     directives: ["field", "cancelAtPeriodEndField", "requestedAtField", "reasonField", "codeField"],
     slots: ["default"],
     events: [],
     states: ["scheduled", "not-scheduled"],
     tokenRoles: ["summary.background", "summary.border", "summary.text", "summary.label"],
     accessibility: ["Summary terms and values preserve description-list relationships"],
-    compatibility: "Boolean cancellation state renders a declared label, never a raw boolean literal."
+    compatibility: 'Boolean cancellation state renders a declared label, never a raw boolean literal. With hideWhenDefault the card renders nothing while it would only state the default: cancelAtPeriodEnd false with no request time, reason, code or authored content (s224-m01: a detail page does not state "Cancel at period end: No" as content); a scheduled or recorded cancellation keeps its card.'
   },
   Card: {
     id: "Card",
@@ -16931,7 +16931,7 @@ var authoredScenarios = [
   { id: "address-summary-badge-role", oodsComponentId: "AddressSummaryBadge", props: { label: "Billing address", role: "billing" }, slots: {}, initialState: { status: "billing" }, renderExpectation: { name: "render", trigger: "mount", expected: "visible Billing address label with data-badge-status billing and the address variant" }, assertions: ["label is visible text", "data-badge-status is billing", "data-badge-variant is address", "badge is noninteractive"] },
   { id: "address-validation-timeline-events", oodsComponentId: "AddressValidationTimeline", props: { title: "Address checks", validations: [{ label: "Postal code verified", timestamp: "2026-09-05T12:00:00Z", detail: "Matched carrier database" }, "Geocoded"] }, slots: {}, initialState: { events: 2 }, renderExpectation: { name: "render", trigger: "mount", expected: "a log region titled Address checks with two ordered events, the first timestamped and detailed" }, assertions: ["region has role log and an h2 title", "events are ordered list items", "the timestamp is a time element", "scalar entries render as text"] },
   { id: "archive-pill-false", oodsComponentId: "ArchivePill", props: { "isArchived": false }, slots: {}, initialState: { content: "populated" }, renderExpectation: { name: "render", trigger: "mount", expected: "Not archived remains visible; machine status remains false; archive is the badge variant; with hideWhenFalse a false flag renders nothing and a true flag reads Archived" }, assertions: ["Not archived remains visible; machine status remains false", "archive is the badge variant", "hideWhenFalse hides only the default"] },
-  { id: "archive-summary-false-and-reason", oodsComponentId: "ArchiveSummary", props: { "isArchived": false, "archivedAt": "2026-09-05T12:00:00Z", "reason": "Retention policy" }, slots: {}, initialState: { content: "populated" }, renderExpectation: { name: "render", trigger: "mount", expected: "No remains visible in its named term; archive date and reason remain associated terms" }, assertions: ["No remains visible in its named term", "archive date and reason remain associated terms"] },
+  { id: "archive-summary-false-and-reason", oodsComponentId: "ArchiveSummary", props: { "isArchived": false, "archivedAt": "2026-09-05T12:00:00Z", "reason": "Retention policy" }, slots: {}, initialState: { content: "populated" }, renderExpectation: { name: "render", trigger: "mount", expected: "No remains visible in its named term; archive date and reason remain associated terms; with hideWhenDefault this record keeps its card, and a false flag with no date or reason renders nothing" }, assertions: ["No remains visible in its named term", "archive date and reason remain associated terms", "hideWhenDefault hides only the default"] },
   { id: "archived-row-presentation", oodsComponentId: "ArchivedRowOverlay", props: { "isArchived": true, "showBadge": true, "separateTab": true, "tabLabel": "Archived", "label": "Team subscription" }, slots: {}, initialState: {}, renderExpectation: { name: "render", trigger: "mount", expected: "Archived row stays accessible and its badge and tab label agree" }, assertions: ["Archived row stays accessible and its badge and tab label agree"] },
   { id: "audit-event-type-and-timestamp", oodsComponentId: "AuditEvent", props: { event: "user.updated", timestamp: "2026-09-05T12:00:00Z", detail: "Display name changed" }, slots: {}, initialState: { timestamped: true }, renderExpectation: { name: "render", trigger: "mount", expected: "one audit article with a machine-readable time, the event label and the detail" }, assertions: ["article carries data-event-type audit", "time element has a datetime", "label and detail are visible text"] },
   {
@@ -16958,8 +16958,8 @@ var authoredScenarios = [
     props: { cancelAtPeriodEnd: true, requestedAt: "2026-09-05T12:00:00Z", reason: "Customer request" },
     slots: {},
     initialState: { cancelAtPeriodEnd: true },
-    renderExpectation: { name: "render", trigger: "mount", expected: "scheduled cancellation label is visible" },
-    assertions: ["boolean state is not rendered as literal true", "terms name their values"]
+    renderExpectation: { name: "render", trigger: "mount", expected: "scheduled cancellation label is visible; with hideWhenDefault a scheduled or recorded cancellation keeps its card, and a false flag with nothing recorded renders nothing" },
+    assertions: ["boolean state is not rendered as literal true", "terms name their values", "hideWhenDefault hides only the default"]
   },
   { id: "card-elevated-content", oodsComponentId: "Card", props: { elevated: true }, slots: { default: "Account summary" }, initialState: { elevated: true }, renderExpectation: { name: "render", trigger: "mount", expected: "semantic container with visible content" }, assertions: ["content is not empty", "elevated state is exposed"] },
   { id: "card-header-supporting-text", oodsComponentId: "CardHeader", props: { title: "Account summary", supportingText: "Current subscription" }, slots: {}, initialState: { heading: "h2" }, renderExpectation: { name: "render", trigger: "mount", expected: "h2 heading and visible supporting text" }, assertions: ["title is a real h2 heading", "supporting text is visible"] },

package/dist/index.js

@@ -15865,13 +15865,13 @@ var authoredContracts = {
   ArchiveSummary: {
     id: "ArchiveSummary",
     version: COMPONENT_CONTRACT_VERSION,
-    props: ["title", "label", "heading", "name", "isArchived", "archived", "status", "archivedAt", "reason", "archiveReason", "summary", "text", "description"],
+    props: ["title", "label", "heading", "name", "isArchived", "archived", "status", "archivedAt", "reason", "archiveReason", "summary", "text", "description", "hideWhenDefault"],
     slots: ["default"],
     events: [],
     states: ["populated", "fallback", "empty"],
     tokenRoles: ["summary.background", "summary.border", "summary.text", "summary.label"],
     accessibility: ["false renders No in its named term", "archive date and reason remain associated terms"],
-    compatibility: "Mirrors renderArchiveSummary: h3 heading and Archived (isArchived/archived/status), Archived At (archivedAt), Reason (reason/archiveReason) description-list terms. A nullable archivedAt omits its date term; boolean summary terms render No and Yes; an absent flag remains absent. summary/text/description fallback and authored body override preserve the heading. archivedField, archivedAtField and reasonField lower to their runtime keys. restoredAtField, archivedByField, metadataField, retainHistoryParameter, restoreWindowParameter and allowPartialRestoreParameter are consumed unbound: HTML has no restore, actor or archive metadata term or action. Noninteractive."
+    compatibility: 'Mirrors renderArchiveSummary: h3 heading and Archived (isArchived/archived/status), Archived At (archivedAt), Reason (reason/archiveReason) description-list terms. A nullable archivedAt omits its date term; boolean summary terms render No and Yes; an absent flag remains absent. summary/text/description fallback and authored body override preserve the heading. archivedField, archivedAtField and reasonField lower to their runtime keys. restoredAtField, archivedByField, metadataField, retainHistoryParameter, restoreWindowParameter and allowPartialRestoreParameter are consumed unbound: HTML has no restore, actor or archive metadata term or action. With hideWhenDefault the card renders nothing while it would only state the default: a false flag with no archive date, reason or authored content (s224-m01: a detail page does not state "Archived: No" as content); an archived record, or one with a date or reason, keeps its card. Noninteractive.'
   },
   ArchivedRowOverlay: {
     id: "ArchivedRowOverlay",
@@ -16021,14 +16021,14 @@ var authoredContracts = {
   CancellationSummary: {
     id: "CancellationSummary",
     version: COMPONENT_CONTRACT_VERSION,
-    props: ["title", "label", "cancelAtPeriodEnd", "requestedAt", "reason", "code"],
+    props: ["title", "label", "cancelAtPeriodEnd", "requestedAt", "reason", "code", "hideWhenDefault"],
     directives: ["field", "cancelAtPeriodEndField", "requestedAtField", "reasonField", "codeField"],
     slots: ["default"],
     events: [],
     states: ["scheduled", "not-scheduled"],
     tokenRoles: ["summary.background", "summary.border", "summary.text", "summary.label"],
     accessibility: ["Summary terms and values preserve description-list relationships"],
-    compatibility: "Boolean cancellation state renders a declared label, never a raw boolean literal."
+    compatibility: 'Boolean cancellation state renders a declared label, never a raw boolean literal. With hideWhenDefault the card renders nothing while it would only state the default: cancelAtPeriodEnd false with no request time, reason, code or authored content (s224-m01: a detail page does not state "Cancel at period end: No" as content); a scheduled or recorded cancellation keeps its card.'
   },
   Card: {
     id: "Card",
@@ -16929,7 +16929,7 @@ var authoredScenarios = [
   { id: "address-summary-badge-role", oodsComponentId: "AddressSummaryBadge", props: { label: "Billing address", role: "billing" }, slots: {}, initialState: { status: "billing" }, renderExpectation: { name: "render", trigger: "mount", expected: "visible Billing address label with data-badge-status billing and the address variant" }, assertions: ["label is visible text", "data-badge-status is billing", "data-badge-variant is address", "badge is noninteractive"] },
   { id: "address-validation-timeline-events", oodsComponentId: "AddressValidationTimeline", props: { title: "Address checks", validations: [{ label: "Postal code verified", timestamp: "2026-09-05T12:00:00Z", detail: "Matched carrier database" }, "Geocoded"] }, slots: {}, initialState: { events: 2 }, renderExpectation: { name: "render", trigger: "mount", expected: "a log region titled Address checks with two ordered events, the first timestamped and detailed" }, assertions: ["region has role log and an h2 title", "events are ordered list items", "the timestamp is a time element", "scalar entries render as text"] },
   { id: "archive-pill-false", oodsComponentId: "ArchivePill", props: { "isArchived": false }, slots: {}, initialState: { content: "populated" }, renderExpectation: { name: "render", trigger: "mount", expected: "Not archived remains visible; machine status remains false; archive is the badge variant; with hideWhenFalse a false flag renders nothing and a true flag reads Archived" }, assertions: ["Not archived remains visible; machine status remains false", "archive is the badge variant", "hideWhenFalse hides only the default"] },
-  { id: "archive-summary-false-and-reason", oodsComponentId: "ArchiveSummary", props: { "isArchived": false, "archivedAt": "2026-09-05T12:00:00Z", "reason": "Retention policy" }, slots: {}, initialState: { content: "populated" }, renderExpectation: { name: "render", trigger: "mount", expected: "No remains visible in its named term; archive date and reason remain associated terms" }, assertions: ["No remains visible in its named term", "archive date and reason remain associated terms"] },
+  { id: "archive-summary-false-and-reason", oodsComponentId: "ArchiveSummary", props: { "isArchived": false, "archivedAt": "2026-09-05T12:00:00Z", "reason": "Retention policy" }, slots: {}, initialState: { content: "populated" }, renderExpectation: { name: "render", trigger: "mount", expected: "No remains visible in its named term; archive date and reason remain associated terms; with hideWhenDefault this record keeps its card, and a false flag with no date or reason renders nothing" }, assertions: ["No remains visible in its named term", "archive date and reason remain associated terms", "hideWhenDefault hides only the default"] },
   { id: "archived-row-presentation", oodsComponentId: "ArchivedRowOverlay", props: { "isArchived": true, "showBadge": true, "separateTab": true, "tabLabel": "Archived", "label": "Team subscription" }, slots: {}, initialState: {}, renderExpectation: { name: "render", trigger: "mount", expected: "Archived row stays accessible and its badge and tab label agree" }, assertions: ["Archived row stays accessible and its badge and tab label agree"] },
   { id: "audit-event-type-and-timestamp", oodsComponentId: "AuditEvent", props: { event: "user.updated", timestamp: "2026-09-05T12:00:00Z", detail: "Display name changed" }, slots: {}, initialState: { timestamped: true }, renderExpectation: { name: "render", trigger: "mount", expected: "one audit article with a machine-readable time, the event label and the detail" }, assertions: ["article carries data-event-type audit", "time element has a datetime", "label and detail are visible text"] },
   {
@@ -16956,8 +16956,8 @@ var authoredScenarios = [
     props: { cancelAtPeriodEnd: true, requestedAt: "2026-09-05T12:00:00Z", reason: "Customer request" },
     slots: {},
     initialState: { cancelAtPeriodEnd: true },
-    renderExpectation: { name: "render", trigger: "mount", expected: "scheduled cancellation label is visible" },
-    assertions: ["boolean state is not rendered as literal true", "terms name their values"]
+    renderExpectation: { name: "render", trigger: "mount", expected: "scheduled cancellation label is visible; with hideWhenDefault a scheduled or recorded cancellation keeps its card, and a false flag with nothing recorded renders nothing" },
+    assertions: ["boolean state is not rendered as literal true", "terms name their values", "hideWhenDefault hides only the default"]
   },
   { id: "card-elevated-content", oodsComponentId: "Card", props: { elevated: true }, slots: { default: "Account summary" }, initialState: { elevated: true }, renderExpectation: { name: "render", trigger: "mount", expected: "semantic container with visible content" }, assertions: ["content is not empty", "elevated state is exposed"] },
   { id: "card-header-supporting-text", oodsComponentId: "CardHeader", props: { title: "Account summary", supportingText: "Current subscription" }, slots: {}, initialState: { heading: "h2" }, renderExpectation: { name: "render", trigger: "mount", expected: "h2 heading and visible supporting text" }, assertions: ["title is a real h2 heading", "supporting text is visible"] },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oods/component-contracts",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Component contracts for OODS Foundry: each component's identity, props, events, states, token roles and accessibility obligations, with shared formatting helpers.",
   "homepage": "https://oods-foundry.com/",
   "bugs": {