Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -98,6 +98,7 @@ packages/comark/
│ ├── frontmatter.ts # parseFrontmatter and renderFrontmatter
│ ├── heading-id.ts # Slug generation shared by parser and stringifier
│ ├── inline-code-lang.ts # Inline code `{lang="..."}` fragment highlighting
│ ├── list-item.ts # List item content columns, shared by the component fence scan and auto-close
│ ├── sanitize.ts # Prop, URL, and frontmatter validation
│ ├── shiki.ts # Shared Shiki runtime
│ ├── yaml.ts # YAML parsing and serialization helpers
Expand Down Expand Up @@ -261,7 +262,8 @@ Block component children may be indented under `::` or outdented; both round-tri

- **Parse (`src/internal/parse/indent.ts`)**: Dedent children rather than raising the floor. Each child line shifts left by `min(markerIndent, lineIndent)` and tokenizes against a zero floor. Lines inside a fenced code block all take the opening fence's shift so fence and body move together. If a tab would have to be split across columns, the shift aborts and keeps the marker floor.
- **Stringify (`indent()` in `src/utils/index.ts`)**: Nested components indent their rendered block by 2 spaces per level across every line, including fenced code bodies, reaching a fixed point on re-parse.
- Spec fixtures: `SPEC/COMARK/component-nested-*-outdented.md`, `SPEC/COMARK/component-nested-codeblock-indented.md`, `SPEC/COMARK/codeblock-indented-content.md`.
- **Closing fences (`comark_block` in `src/plugins/components.ts`)**: The scan for the closing `::` skips code fences. A closing fence may sit at most 3 columns right of its container: the innermost component or list item open at the opening fence, or the opening fence itself when that is further left. Deeper fence lines are code content, so a `::` after one does not close the component. A line 4+ columns right of its container is indented code and opens no fence, list item, or nested component. `- - item` opens two list items, and a thematic break such as `- - -` opens none. A fence inside a list item ends when the list item does, even without a closer. Tabs count to the next multiple of 4 columns. The `#slot` scan reads fences by the same rules. `autoCloseMarkdown` follows them too; it and `comark_block` use `pushListItems()` (`src/internal/list-item.ts`).
- Spec fixtures: `SPEC/COMARK/component-nested-*-outdented.md`, `SPEC/COMARK/component-nested-codeblock-indented.md`, `SPEC/COMARK/codeblock-indented-content.md`, and for closing fences `SPEC/COMARK/component-*codeblock-indented-fence.md`, `SPEC/COMARK/component-codeblock-closing-fence-indent.md`, `SPEC/COMARK/component-codeblock-indented-opener.md`, `SPEC/COMARK/component-indented-code-fence.md`, `SPEC/COMARK/component-codeblock-invalid-nested-name.md`, `SPEC/COMARK/component-list-marker-indent.md`, `SPEC/COMARK/component-slot-indented-fence.md`.

### Embedded HTML

Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,168 @@
## Input

```md
::box
```js
a
```
```js
b
```
```js
c
```
:::inner
```js
d
```
:::
::

After
```

## AST

```json
{
"frontmatter": {},
"meta": {},
"nodes": [
[
"box",
{},
[
"pre",
{
"language": "js"
},
[
"code",
{
"class": "language-js"
},
"a"
]
],
[
"pre",
{
"language": "js"
},
[
"code",
{
"class": "language-js"
},
"b"
]
],
[
"pre",
{
"language": "js"
},
[
"code",
{
"class": "language-js"
},
"c"
]
],
[
"inner",
{},
[
"pre",
{
"language": "js"
},
[
"code",
{
"class": "language-js"
},
"d"
]
]
]
],
[
"p",
{},
"After"
]
]
}
```

## HTML

```html
<box>
<pre data-language="js"><code class="language-js">a</code></pre>
<pre data-language="js"><code class="language-js">b</code></pre>
<pre data-language="js"><code class="language-js">c</code></pre>
<inner>
<pre data-language="js"><code class="language-js">d</code></pre>
</inner>
</box>
<p>After</p>
```

## Markdown

```md
::box
```js
a
```

```js
b
```

```js
c
```

:::inner
```js
d
```
:::
::

After
```

## Markdown HTML

```md
<box>

```js
a
```

```js
b
```

```js
c
```

<inner>

```js
d
```

</inner>

</box>

After
```
Original file line number Diff line number Diff line change
@@ -0,0 +1,95 @@
## Input

```md
::box
```mdc
::a
```js
x
```
::
```
::

After
```

## AST

```json
{
"frontmatter": {},
"meta": {},
"nodes": [
[
"box",
{},
[
"pre",
{
"language": "mdc"
},
[
"code",
{
"class": "language-mdc"
},
"::a\n ```js\n x\n ```\n::"
]
]
],
[
"p",
{},
"After"
]
]
}
```

## HTML

```html
<box>
<pre data-language="mdc"><code class="language-mdc">::a
```js
x
```
::</code></pre>
</box>
<p>After</p>
```

## Markdown

```md
::box
```mdc
::a
```js
x
```
::
```
::

After
```

## Markdown HTML

```md
<box>

```mdc
::a
```js
x
```
::
```

</box>

After
```
Original file line number Diff line number Diff line change
@@ -0,0 +1,91 @@
## Input

```md
::box
```md
- item
```js
x
```
```
::

After
```

## AST

```json
{
"frontmatter": {},
"meta": {},
"nodes": [
[
"box",
{},
[
"pre",
{
"language": "md"
},
[
"code",
{
"class": "language-md"
},
"- item\n ```js\n x\n ```"
]
]
],
[
"p",
{},
"After"
]
]
}
```

## HTML

```html
<box>
<pre data-language="md"><code class="language-md">- item
```js
x
```</code></pre>
</box>
<p>After</p>
```

## Markdown

```md
::box
~~~md
- item
```js
x
```
~~~
::

After
```

## Markdown HTML

```md
<box>

~~~md
- item
```js
x
```
~~~

</box>

After
```
Loading
Loading