1. Purpose

This document demonstrates how SIDECAR can extend a clean TEXTv1.2 source without mixing visual or rich-document details into the narrative text.

The source text stays simple. The richer behavior is delegated to the sidecar layer.

1.1 Supported Concept

The sidecar layer can inject richer elements into selected sections while the text source keeps only sections, paragraphs, and simple lists.

The same mechanism can also reclassify a block range into another document object when that is more expressive than plain narrative paragraphs.

1.2 Supported Selector Families

This section summarizes the selector families used by the current injector design.

Selectors are attached to a target section and then place or transform richer content relative to paragraphs, lists, notes, or block ranges.

2. Example Injection Targets

This chapter contains deliberately simple source text so the rendered example can visibly show what comes from TEXT and what comes from SIDECAR.

2.1 Admonition After Paragraph

The first paragraph is plain source text.

The second paragraph is also plain source text and acts as a stable anchor for a note inserted after paragraph two.

2.2 Figure, Code, and Table

This paragraph introduces a figure example.

Simple SIDECAR placeholder figure
A local SVG asset injected after the first paragraph of section 2.2.

This paragraph introduces a code block example.

injections:
  - id: example
    type: figure
    target:
      section: "2.2"
      after_paragraph: 0

This paragraph introduces a table example.

Capability examples
CapabilityExample
Admonitionafter_paragraph
Figureafter_paragraph
Code blockafter_paragraph
Tableafter_paragraph
Reclassifystart_block + end_block

2.3 Reclassification Example

This last paragraph stays outside the wrapped range and should remain a normal paragraph.

3. Notes

The best way to understand SIDECAR is to compare the clean source with the rendered result.

A good demo keeps the text source readable while the sidecar shows how richer structure can be added around it.