react-blockkit 0.3.3 → 0.4.0

package/dist/validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AA8CA,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EAEb,eAAe,EACf,eAAe,EAChB,MAAM,YAAY,CAAC;AAuIpB,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,IAAI,GAAE,MAAe,EACrB,GAAG,GAAE,MAA8B,GAClC,IAAI,CAEN;AA6CD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,GAAE,MAAkB,GAAG,IAAI,CAErF;AAgLD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,GAAE,MAAkB,GAAG,IAAI,CAE3F;AAmJD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,GAAE,MAAgB,GAAG,IAAI,CAEpF;AA4sBD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,eAA2B,EACpC,IAAI,GAAE,MAAgB,GACrB,OAAO,CAAC,KAAK,IAAI,eAAe,CAkFlC;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,eAAe,CAAC,MAAM,CAAC,EACjC,OAAO,GAAE,eAA2B,EACpC,IAAI,GAAE,MAAgB,GACrB,IAAI,CAGN;AAWD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,eAA2B,EACpC,IAAI,GAAE,MAAe,GACpB,OAAO,CAAC,KAAK,IAAI,YAAY,CA+D/B;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,EACpB,OAAO,GAAE,eAA2B,GACnC,YAAY,CAcd;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,eAAe,EAAE,CAEvE"}
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AA8CA,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EAEb,eAAe,EACf,eAAe,EAChB,MAAM,YAAY,CAAC;AAuIpB,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,IAAI,GAAE,MAAe,EACrB,GAAG,GAAE,MAA8B,GAClC,IAAI,CAEN;AA6CD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,GAAE,MAAkB,GAAG,IAAI,CAErF;AAgLD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,GAAE,MAAkB,GAAG,IAAI,CAE3F;AAmJD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,GAAE,MAAgB,GAAG,IAAI,CAEpF;AAktBD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,eAA2B,EACpC,IAAI,GAAE,MAAgB,GACrB,OAAO,CAAC,KAAK,IAAI,eAAe,CAkFlC;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,eAAe,CAAC,MAAM,CAAC,EACjC,OAAO,GAAE,eAA2B,EACpC,IAAI,GAAE,MAAgB,GACrB,IAAI,CAGN;AAWD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,eAA2B,EACpC,IAAI,GAAE,MAAe,GACpB,OAAO,CAAC,KAAK,IAAI,YAAY,CA+D/B;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,EACpB,OAAO,GAAE,eAA2B,GACnC,YAAY,CAcd;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,eAAe,EAAE,CAEvE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-blockkit",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "React components that render Slack Block Kit JSON exactly as Slack does.",
   "keywords": [
     "block kit",
@@ -23,7 +23,7 @@
   "style": "./dist/styles.css",
   "files": [
     "dist",
-    "docs",
+    "docs/slack-style-baseline.md",
     "LICENSE",
     "README.md"
   ],
@@ -66,7 +66,7 @@
     "react-dom": "^19.2.7",
     "vite": "^8.1.5",
     "vitest": "^4.1.7",
-    "slackmark": "0.6.0"
+    "slackmark": "0.6.1"
   },
   "peerDependencies": {
     "react": ">=18.2.0 <20",

package/docs/coverage-matrix.md

@@ -1,80 +0,0 @@
-# react-blockkit coverage matrix
-
-Audited against `slackmark`'s `packages/core/src/blocks/types.ts`,
-`@slack/types` 3.0.0, and the `react-blockkit` implementation on July 20, 2026.
-“Fallback” means the renderer keeps a visible DOM node and human-readable
-label; it never silently drops the value or stringifies an object.
-
-## Blocks
-
-| Block | `slackmark` emits | Before | After |
-| --- | --- | --- | --- |
-| `rich_text` | Yes | Partial | Full containers and inline inventory; unknown descendants render a fallback |
-| `header` + `level` | Yes | Levels 1–4; other numbers threw | Semantic `h1`–`h4`; out-of-range levels clamp safely |
-| `divider` | Yes | Full | Full |
-| `section` + `fields` + `accessory` | Yes (`accessory` is accepted from Slack payloads) | Full for known elements | Full; unknown accessories render a fallback |
-| `image` + `slack_file` | Yes | URL images and an alt-labelled placeholder for file IDs | Same deliberate placeholder; never drops `alt_text` |
-| `context` | Yes | Full | Full; unknown or text-less elements render a fallback |
-| `markdown` | Yes | Full for the existing minimal Markdown subset | Same feature scope, hardened rendering |
-| `table` (`raw_text`, `raw_number`, `rich_text`, alignment, wrapping) | Yes | Cells, alignment, and wrapping; first row used data cells | First row uses column-header semantics; unknown cells render a fallback |
-| `data_table` | Yes | Header/row semantics and paging; empty rows or zero page size threw | Safe empty state, real `caption`, bounded page size, header/row semantics |
-| `data_visualization` (`pie`, `bar`, `area`, `line`) | Yes | All chart types; an empty/zero-total pie failed | All chart types plus a labelled no-data fallback; unknown chart types render a fallback |
-| `container` + collapsible state | Yes | Legal Slack child subset only | Legal Slack child subset, collapsible state, and visible illegal/future-child fallback |
-| `actions` | No | Full for current element inventory | Same, plus unknown-element fallback |
-| `alert` | No | Full | Full |
-| `card` | No | Full | Full |
-| `carousel` | No | Full | Full |
-| `context_actions` | No | Full | Full |
-| `file` | No | Full | Full |
-| `input` | No | Full | Full |
-| `plan` | No | Full | Full |
-| `task_card` | No | Full | Full |
-| `video` | No | Full | Full |
-| Unknown future discriminator | Possible in retrieved Slack data | Threw `unsupported_block` | Visible `data-block-type` fallback |
-
-## Rich-text containers
-
-| Element | Before | After |
-| --- | --- | --- |
-| `rich_text_section` | Rendered inline values | Same, with unknown-inline fallback and multiline preservation |
-| `rich_text_list` | Real list and ordered `offset`; every indent used the same marker; indent over 8 threw | Real `ul`/`ol`, ordered offset, per-indent marker cycle, indent bounded to 0–8, `border` honored |
-| `rich_text_preformatted` | Language exposed; `border` ignored | Language and `border` honored; empty content is safe |
-| `rich_text_quote` | Always drew a border; payload `border` ignored | Payload `border: 0 \| 1` controls the inline border |
-| Unknown future container | Threw `unsupported_element` | Visible fallback |
-
-## Rich-text inline elements and styles
-
-| Element/style | Before | After |
-| --- | --- | --- |
-| `text` | Bold, italic, strike, underline, and code as combined CSS | Deterministically nested semantic elements; multiline text preserved |
-| `link` | Safe protocols and labels | Same, with nested inline styles |
-| `emoji` | Resolver, explicit Unicode, then `:shortcode:` | Resolver, explicit Unicode, core’s emitted shortcode set, then custom shortcode fallback |
-| `user`, `channel`, `usergroup`, `team`, `broadcast` | Resolved mentions; inline style was lost | Resolved mentions with inline styles preserved |
-| `date` | Resolver or fallback/ISO date; ignored format tokens and URL | Resolver or deterministic UTC Slack-token formatter; fallback on relative/unknown tokens; safe URL |
-| `color` | Swatch and value | Same, with inline styles preserved |
-| `citation` and Slack reference mentions | Compact textual fallback | Same documented fallback |
-| Unknown future inline discriminator | Threw `unsupported_element` | Visible text/reference fallback |
-
-## Mrkdwn basics
-
-| Behavior | Before | After |
-| --- | --- | --- |
-| `&`, `<`, `>` | Decoded in ordinary text only | Also decoded in links, labels, and code |
-| Bold/italic/strike/code nesting | Parsed recursively | Parsed recursively and snapshot-covered |
-| `<url\|label>` | Rendered, but entities remained encoded in URL/label | Rendered with decoded entities and protocol guard |
-| Date tokens | Fallback or ISO date only | Deterministic UTC token formatting with Slack fallback |
-| Emoji shortcodes | Left as colon text | Core-known shortcodes render glyphs; custom names stay readable |
-
-## Deliberate fallbacks
-
-- A `slack_file.id` has no renderable URL, so it remains an alt-labelled image
-  placeholder. A resolver would require new public API and is outside this
-  correctness pass.
-- Workspace-specific names and custom emoji still require existing resolvers;
-  IDs/shortcodes remain visible when no resolver is supplied.
-- Unknown future blocks/elements use a neutral fallback rather than guessed
-  Slack UI.
-- Malformed JSON still throws `BlockKitInvariantError`. The never-throw
-  guarantee applies after JSON has a valid block-shaped structure.
-- Pixel parity for unharvested Slack Builder permutations remains separate
-  style-harvest work; this pass does not guess or redesign those styles.