feat(schema): add Emphasis node type

.changeset/fair-snails-occur.md

@@ -0,0 +1,5 @@
+---
+"oxa-types": minor
+---
+
+Add Emphasis node type

docs/schema/emphasis.md

@@ -0,0 +1,28 @@
+(oxa:emphasis)=
+
+## Emphasis
+
+
+Emphasized content (typically italicized).
+
+
+__type__: _string_, ("Emphasis")
+
+: The type discriminator for Emphasis nodes.
+
+__id__: __string__
+
+: A unique identifier for the node.
+
+__classes__: __array__ ("string")
+
+: A list of class names for styling or semantics.
+
+__data__: __object__
+
+: Arbitrary key-value data attached to the node.
+
+__children__: __array__ ("Inline")
+
+: The inline content to emphasize.
+: See @oxa:inline

docs/schema/inline.md

@@ -6,4 +6,4 @@
 Union of all inline content types.
 
 
-Union of: @oxa:text, @oxa:strong
+Union of: @oxa:text, @oxa:emphasis, @oxa:strong

packages/oxa-types-py/src/oxa_types/__init__.py

@@ -36,6 +36,24 @@ class Document(BaseModel):
     children: list["Block"] = Field(description="The block content of the document.")
 
 
+class Emphasis(BaseModel):
+    """Emphasized content (typically italicized)."""
+
+    model_config = ConfigDict(strict=True)
+
+    type: Literal["Emphasis"] = "Emphasis"
+    id: str | None = Field(
+        default=None, description="A unique identifier for the node."
+    )
+    classes: list[str] | None = Field(
+        default=None, description="A list of class names for styling or semantics."
+    )
+    data: dict[str, Any] | None = Field(
+        default=None, description="Arbitrary key-value data attached to the node."
+    )
+    children: list["Inline"] = Field(description="The inline content to emphasize.")
+
+
 class Heading(BaseModel):
     """A heading with a level and inline content."""
 
@@ -114,11 +132,12 @@ class Text(BaseModel):
 
 
 # Union of all inline content types.
-Inline = Annotated[Union[Text, Strong], Field(discriminator="type")]
+Inline = Annotated[Union[Text, Emphasis, Strong], Field(discriminator="type")]
 
 
 # Rebuild models to resolve forward references
 Document.model_rebuild()
+Emphasis.model_rebuild()
 Heading.model_rebuild()
 Paragraph.model_rebuild()
 Strong.model_rebuild()
@@ -128,6 +147,7 @@ class Text(BaseModel):
 __all__ = [
     "Block",
     "Document",
+    "Emphasis",
     "Heading",
     "Inline",
     "Paragraph",

packages/oxa-types-rs/src/lib.rs

@@ -33,6 +33,24 @@ pub struct Document {
     pub children: Vec<Block>,
 }
 
+/// Emphasized content (typically italicized).
+#[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
+pub struct Emphasis {
+    /// The type discriminator for Emphasis nodes.
+    pub r#type: MustBe!("Emphasis"),
+    /// A unique identifier for the node.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub id: Option<String>,
+    /// A list of class names for styling or semantics.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub classes: Option<Vec<String>>,
+    /// Arbitrary key-value data attached to the node.
+    #[serde(skip_serializing_if = "Option::is_none")]
+    pub data: Option<serde_json::Value>,
+    /// The inline content to emphasize.
+    pub children: Vec<Inline>,
+}
+
 /// A heading with a level and inline content.
 #[derive(Debug, Clone, PartialEq, Serialize, Deserialize)]
 pub struct Heading {
@@ -120,5 +138,6 @@ pub enum Block {
 #[serde(untagged)]
 pub enum Inline {
     Text(Text),
+    Emphasis(Emphasis),
     Strong(Strong),
 }

packages/oxa-types-ts/src/index.ts

@@ -39,6 +39,32 @@ export interface Document {
   children: Block[];
 }
 
+/**
+ * Emphasized content (typically italicized).
+ */
+export interface Emphasis {
+  /**
+   * The type discriminator for Emphasis nodes.
+   */
+  type: "Emphasis";
+  /**
+   * A unique identifier for the node.
+   */
+  id?: string;
+  /**
+   * A list of class names for styling or semantics.
+   */
+  classes?: string[];
+  /**
+   * Arbitrary key-value data attached to the node.
+   */
+  data?: Record<string, unknown>;
+  /**
+   * The inline content to emphasize.
+   */
+  children: Inline[];
+}
+
 /**
  * A heading with a level and inline content.
  */
@@ -155,4 +181,4 @@ export type Block = Heading | Paragraph;
 /**
  * Union of all inline content types.
  */
-export type Inline = Text | Strong;
+export type Inline = Text | Emphasis | Strong;

schema/Emphasis.yaml

@@ -0,0 +1,29 @@
+$schema: "http://json-schema.org/draft-07/schema#"
+$id: Emphasis
+title: Emphasis
+description: Emphasized content (typically italicized).
+type: object
+properties:
+  type:
+    description: The type discriminator for Emphasis nodes.
+    enum: [Emphasis]
+  id:
+    description: A unique identifier for the node.
+    type: string
+  classes:
+    description: A list of class names for styling or semantics.
+    type: array
+    items:
+      type: string
+  data:
+    description: Arbitrary key-value data attached to the node.
+    type: object
+    additionalProperties: true
+  children:
+    description: The inline content to emphasize.
+    type: array
+    items:
+      $ref: "./Inline.yaml"
+required:
+  - type
+  - children

schema/Inline.yaml

@@ -4,4 +4,5 @@ title: Inline
 description: Union of all inline content types.
 anyOf:
   - $ref: "./Text.yaml"
+  - $ref: "./Emphasis.yaml"
   - $ref: "./Strong.yaml"

schema/schema.json

@@ -64,6 +64,41 @@
       },
       "required": ["type", "children"]
     },
+    "Emphasis": {
+      "title": "Emphasis",
+      "description": "Emphasized content (typically italicized).",
+      "type": "object",
+      "properties": {
+        "type": {
+          "description": "The type discriminator for Emphasis nodes.",
+          "enum": ["Emphasis"]
+        },
+        "id": {
+          "description": "A unique identifier for the node.",
+          "type": "string"
+        },
+        "classes": {
+          "description": "A list of class names for styling or semantics.",
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "data": {
+          "description": "Arbitrary key-value data attached to the node.",
+          "type": "object",
+          "additionalProperties": true
+        },
+        "children": {
+          "description": "The inline content to emphasize.",
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/Inline"
+          }
+        }
+      },
+      "required": ["type", "children"]
+    },
     "Heading": {
       "title": "Heading",
       "description": "A heading with a level and inline content.",
@@ -112,6 +147,9 @@
         {
           "$ref": "#/definitions/Text"
         },
+        {
+          "$ref": "#/definitions/Emphasis"
+        },
         {
           "$ref": "#/definitions/Strong"
         }