@dr-ishaan/remake-blocks 1.5.0 → 1.5.1

package/README.md

@@ -1,6 +1,6 @@
 # @dr-ishaan/remake-blocks
 
-Astro 6 + remark plugin for rendering GitHub-style callouts (admonitions), enhanced blockquotes, and disclosure widgets in Markdown content — **27 first-class types + 4 themes + inline callouts + directive syntax + safe-by-default HTML escaping + Lucide/emoji icon sets**.
+Astro 6 + remark plugin for rendering GitHub-style callouts (admonitions), enhanced blockquotes, disclosure widgets, pull quotes, and epigraphs in Markdown content — **27 first-class types + 4 themes + inline callouts + directive syntax + safe-by-default HTML escaping + Lucide/emoji icon sets**.
 
 Each directive maps 1:1 to its own unique visual identity, SVG icon, color palette, and CSS class. No alias resolution.
 
@@ -16,6 +16,9 @@ Each directive maps 1:1 to its own unique visual identity, SVG icon, color palet
 - **Custom titles** — `> [!WARNING] Deprecated API`
 - **Collapsible callouts** — `> [!FAQ]-` (collapsed) and `> [!TIP]+` (expanded)
 - **Disclosure widgets** — `> [!] Title` creates a plain collapsible block
+- **Pull quotes** — `> [!PULL]` creates a large, centered, italic display quote with auto-detected `<cite>` attribution
+- **Epigraphs** — `> [!EPIGRAPH]` creates a small, centered, bold italic quote with `<cite>` attribution
+- **Attribution auto-detection** — `— Author` or `-- Author` at end of body is auto-detected and rendered as `<cite>`
 - **Accordion grouping** — consecutive `[!]` blocks auto-group into an accordion
 - **Tree view** — nested `[!]` blocks get depth indicators
 - **Custom callout types** — define your own with icon, color, and CSS class
@@ -165,6 +168,15 @@ Each of these is its **own distinct type** with unique colors, not an alias:
 
 Consecutive `[!]` blocks are automatically grouped into an accordion. Nested `[!]` blocks get tree-view styling.
 
+### Pull Quotes & Epigraphs
+
+| Directive | Description | CSS Class |
+|-----------|-------------|-----------|
+| `[!PULL]` | Large, centered, italic display quote. Auto-detects `— Author` → `<cite>`. Supports `{inline}` for floating. | `.pull-quote` |
+| `[!EPIGRAPH]` | Small, centered, bold italic quote. Auto-detects `— Author` → `<cite>`. Max-width 70%. | `.epigraph` |
+
+**Attribution auto-detection**: If the last line of the body starts with `—` (em dash) or `--` (double hyphen), it's automatically extracted and rendered as a `<cite>` element. If no attribution is found, the entire body is the quote text.
+
 ---
 
 ## Syntax
@@ -252,6 +264,32 @@ Use `{key=value}` syntax after the directive:
 > Content visible by default.
 ```
 
+### Pull quotes
+
+```markdown
+> [!PULL]
+> The best way to predict the future is to invent it.
+> — Alan Kay
+
+> [!PULL]{inline}
+> A floated pull quote with text wrapping around it.
+> — Someone
+
+> [!PULL]
+> A pull quote with no attribution.
+```
+
+### Epigraphs
+
+```markdown
+> [!EPIGRAPH]
+> The fog comes on little cat feet.
+> — Carl Sandburg
+
+> [!EPIGRAPH]
+> An epigraph with no attribution.
+```
+
 ---
 
 ## Configuration
@@ -534,6 +572,24 @@ Collapsible callouts use `<details>`/`<summary>`:
 </details>
 ```
 
+Pull quotes render as:
+
+```html
+<aside class="pull-quote" dir="auto">
+  <p class="pull-quote-text">The best way to predict the future is to invent it.</p>
+  <p class="pull-quote-attribution">— <cite>Alan Kay</cite></p>
+</aside>
+```
+
+Epigraphs render as:
+
+```html
+<aside class="epigraph" dir="auto">
+  <p class="epigraph-text">The fog comes on little cat feet.</p>
+  <p class="epigraph-attribution">— <cite>Carl Sandburg</cite></p>
+</aside>
+```
+
 ---
 
 ## Exported Helpers
@@ -616,9 +672,13 @@ The plugin processes markdown through 4 passes. Each syntax is detected at a dif
 | `[3]` | Custom title text | `Breaking Change` | Override default title |
 | `[4]` | Overrides block | `{icon=false appearance=minimal}` | Parsed by `parseOverrides()` + `parseDirectiveAttrs()` |
 
-### Disclosure widget detection
+### Disclosure, Pull Quote & Epigraph detection
+
+The `[!]`, `[!PULL]`, and `[!EPIGRAPH]` syntaxes are all detected in the **same blockquote pass** as regular callouts. The key difference is what's added to the regex alternatives:
 
-The `[!]` syntax is detected in the **same blockquote pass** as regular callouts. The key difference is an **empty string** added to the regex alternatives:
+- `[!]` → empty string `""` added to regex (when `enableDisclosures: true`)
+- `[!PULL]` → `"PULL"` always added to regex
+- `[!EPIGRAPH]` → `"EPIGRAPH"` always added to regex
 
 | Aspect | Regular callout (`> [!NOTE]`) | Disclosure (`> [!]`) |
 |--------|------------------------------|---------------------|
@@ -672,11 +732,13 @@ All 3 syntaxes produce the same `ParsedCallout` object, which is passed to `buil
 
 | Field | Type | Source | Description |
 |-------|------|--------|-------------|
-| `type` | `string` | Regex group [1] | Callout type (lowercased) or `"disclosure"` |
+| `type` | `string` | Regex group [1] | Callout type (lowercased), `"disclosure"`, `"pull"`, or `"epigraph"` |
 | `customTitle` | `string \| undefined` | Regex group [3] or `[Title]` or `"Title"` | User-provided title (overrides default) |
 | `collapsible` | `boolean` | Fold marker or `???`/`???+` | Whether callout is collapsible |
 | `collapsibleOpen` | `boolean` | `+` marker or `???+` or no marker (disclosures) | Whether collapsible starts expanded |
 | `isDisclosure` | `boolean` | Empty type match | True for `[!]` syntax |
+| `isPullQuote` | `boolean` | Type = `"pull"` | True for `[!PULL]` syntax |
+| `isEpigraph` | `boolean` | Type = `"epigraph"` | True for `[!EPIGRAPH]` syntax |
 | `overrides` | `object \| undefined` | `{overrides}` block via `parseOverrides()` | Per-callout icon/appearance/inline overrides |
 | `directiveAttrs` | `object \| undefined` | `{attrs}` block via `parseDirectiveAttrs()` | Per-callout id/class/HTML attributes |
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dr-ishaan/remake-blocks",
-  "version": "1.5.0",
+  "version": "1.5.1",
   "description": "Astro 6 + remark plugin — 27 callout types, 4 themes, disclosure widgets, inline callouts, directive syntax, MkDocs syntax, i18n labels, safe-by-default XSS escaping, WCAG accessibility, Lucide/emoji icons",
   "type": "module",
   "main": "dist/index.js",