@portabletext/plugin-typography 8.0.21 → 8.0.23

package/README.md

@@ -10,6 +10,12 @@ Automatically handles smart undo with <kbd>Backspace</kbd> right after insertion
 
 ![Smart undo with Backspace](./assets/smart-undo-with-backspace.gif)
 
+## Installation
+
+```sh
+npm install @portabletext/plugin-typography
+```
+
 ## Usage
 
 Import the `TypographyPlugin` React component and place it inside the `EditorProvider`:
@@ -40,7 +46,7 @@ function App() {
 }
 ```
 
-## Rules Included
+## Rules included
 
 The plugin includes the following typographic transformation rules:
 
@@ -76,11 +82,11 @@ The plugin includes the following typographic transformation rules:
 | `oneQuarter`       | `1/4` → `¼`                      |
 | `threeQuarters`    | `3/4` → `¾`                      |
 
-## Configuring Rules
+## Configuring rules
 
 The plugin supports flexible configuration through `preset`, `enable`, and `disable` props:
 
-### Using Presets
+### Using presets
 
 The `preset` prop provides quick configuration:
 
@@ -99,7 +105,7 @@ The `preset` prop provides quick configuration:
 <TypographyPlugin preset="none" enable={['emDash', 'ellipsis']} />
 ```
 
-### Enabling Additional Rules
+### Enabling additional rules
 
 Use `enable` to add rules beyond the preset:
 
@@ -111,7 +117,7 @@ Use `enable` to add rules beyond the preset:
 <TypographyPlugin preset="all" disable={['emDash', 'ellipsis']} />
 ```
 
-### Disabling Rules
+### Disabling rules
 
 Use `disable` to remove rules from the preset:
 
@@ -127,7 +133,7 @@ Use `disable` to remove rules from the preset:
 />
 ```
 
-### Combining Options
+### Combining options
 
 All three props work together. The order of operations is:
 
@@ -149,11 +155,11 @@ All three props work together. The order of operations is:
 />
 ```
 
-## Controlling when Text Transformations Run
+## Controlling when text transformations run
 
 The `TypographyPlugin` has an optional `guard` prop that accepts any type of `BehaviorGuard`. Here, you'll have access to the current `EditorSnapshot` as well as information about the current rule being matched.
 
-Because disallowing text transformations inside code is a common use case, this plugin ships a built-in `createDecoratorGuard` function. use that to create a `guard` that only allows text transformations inside certain decorators:
+Because disallowing text transformations inside code is a common use case, this plugin ships a built-in `createDecoratorGuard` function. Use that to create a `guard` that only allows text transformations inside certain decorators:
 
 ```tsx
 import {
@@ -173,9 +179,18 @@ return (
 )
 ```
 
-## Using Individual Rules with `InputRulePlugin`
+The `decorators` callback derives its allowed list from `context.schema`
+rather than hardcoding decorator names, so the guard tracks whatever the
+schema actually declares instead of a fixed list that can drift from it.
+Because `context.schema` is resolved at the caret, it also follows
+[containers](../schema/README.md#containers-and-sub-schemas): inside a code
+block the guard sees that container's sub-schema rather than the top-level
+one, which is what lets a guard keyed on the `code` decorator suppress
+transformations inside a code block whose sub-schema defines `code`.
+
+## Using individual rules with `InputRulePlugin`
 
-All included typographic rules are exported from the plugin. To use them in your own abstraction, import them from this from plugin and use them with the `InputRulePlugin`:
+All included typographic rules are exported from the plugin. To use them in your own abstraction, import them from this plugin and use them with the `InputRulePlugin`:
 
 ```tsx
 import {InputRulePlugin} from '@portabletext/plugin-input-rule'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@portabletext/plugin-typography",
-  "version": "8.0.21",
+  "version": "8.0.23",
   "description": "Automatically transform text to typographic variants",
   "keywords": [
     "portabletext",
@@ -30,29 +30,29 @@
     "dist"
   ],
   "dependencies": {
-    "@portabletext/plugin-input-rule": "^5.0.21"
+    "@portabletext/plugin-input-rule": "^5.0.23"
   },
   "devDependencies": {
     "@sanity/pkg-utils": "^10.2.1",
     "@sanity/tsconfig": "^2.1.0",
-    "@types/react": "^19.2.14",
+    "@types/react": "^19.2.17",
     "@vitejs/plugin-react": "^5.2.0",
-    "@vitest/browser": "^4.1.8",
-    "@vitest/browser-playwright": "^4.1.8",
+    "@vitest/browser": "^4.1.9",
+    "@vitest/browser-playwright": "^4.1.9",
     "babel-plugin-react-compiler": "^1.0.0",
     "eslint": "^9.39.1",
     "eslint-formatter-gha": "^1.6.0",
     "eslint-plugin-react-hooks": "^7.1.1",
-    "react": "^19.2.5",
+    "react": "^19.2.7",
     "typescript": "5.9.3",
     "typescript-eslint": "^8.48.0",
-    "vitest": "^4.1.8",
-    "@portabletext/editor": "^7.6.2",
-    "@portabletext/schema": "^2.2.1",
-    "racejar": "2.0.8"
+    "vitest": "^4.1.9",
+    "@portabletext/editor": "^7.8.0",
+    "@portabletext/schema": "^2.2.2",
+    "racejar": "2.0.9"
   },
   "peerDependencies": {
-    "@portabletext/editor": "^7.6.2",
+    "@portabletext/editor": "^7.8.0",
     "react": "^19.2"
   },
   "engines": {