# app.bulleted.node

> Published by [ngerakines.me](https://lexicon.garden/identity/did:plc:cbkjy5n7bk3ax2wplmtjofq2)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:cbkjy5n7bk3ax2wplmtjofq2/app.bulleted.node)
- [Documentation](https://lexicon.garden/lexicon/did:plc:cbkjy5n7bk3ax2wplmtjofq2/app.bulleted.node/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:cbkjy5n7bk3ax2wplmtjofq2/app.bulleted.node/examples)

## Definitions

### `app.bulleted.node`

**Type**: `record`

A single bullet in an outline. Parentage is expressed only by a child pointing up at its parent; there is no children array.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `text` | `string` | Yes | The bullet's content. |
| `facets` | `array` | No | Rich text annotations over text. |
| `layout` | `string` | No | How the bullet renders. Defaults to bullet. An open set, so values added by later versions do not fail validation. |
| `parent` | `string` (at-uri) | No | The parent node. Absent means top level. A bare AT-URI rather than a strongRef, because a strongRef pins a CID and the parent's CID changes on every edit to its text. |
| `sortKey` | `string` | Yes | Fractional index ordering this node among its siblings. Kept separate from the record key because record keys are TIDs, which sort by creation time and cannot change without recreating the record and breaking every inbound reference. |
| `createdAt` | `string` (datetime) | Yes | When the bullet was created. |
| `completedAt` | `string` (datetime) | No | Presence means completed; there is no separate boolean. Only meaningful for todo layout. |

## Raw Schema

```json
{
  "id": "app.bulleted.node",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "text",
          "sortKey",
          "createdAt"
        ],
        "properties": {
          "text": {
            "type": "string",
            "maxLength": 10000,
            "description": "The bullet's content.",
            "maxGraphemes": 2000
          },
          "facets": {
            "type": "array",
            "items": {
              "ref": "app.bsky.richtext.facet",
              "type": "ref"
            },
            "description": "Rich text annotations over text."
          },
          "layout": {
            "type": "string",
            "description": "How the bullet renders. Defaults to bullet. An open set, so values added by later versions do not fail validation.",
            "knownValues": [
              "bullet",
              "todo",
              "h1",
              "h2",
              "h3",
              "codeBlock",
              "quoteBlock"
            ]
          },
          "parent": {
            "type": "string",
            "format": "at-uri",
            "description": "The parent node. Absent means top level. A bare AT-URI rather than a strongRef, because a strongRef pins a CID and the parent's CID changes on every edit to its text."
          },
          "sortKey": {
            "type": "string",
            "maxLength": 512,
            "description": "Fractional index ordering this node among its siblings. Kept separate from the record key because record keys are TIDs, which sort by creation time and cannot change without recreating the record and breaking every inbound reference."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "When the bullet was created."
          },
          "completedAt": {
            "type": "string",
            "format": "datetime",
            "description": "Presence means completed; there is no separate boolean. Only meaningful for todo layout."
          }
        }
      },
      "description": "A single bullet in an outline. Parentage is expressed only by a child pointing up at its parent; there is no children array."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```