♻️ Simplify document lexicon id to pub.oxa.document

Simplify the document record NSID from `pub.oxa.document.document` to
`pub.oxa.document`, consistent with the naming convention used by
`site.standard.document` and others. This is possible now that block
type definitions have been moved to their own `pub.oxa.blocks.defs`
namespace.

Co-authored-by: Stencila <47797644+stencila[bot]@users.noreply.github.com>

Author: nokome

docs/atproto-lexicon.md

@@ -23,7 +23,7 @@ The OXA lexicon is organized into three namespaces:
 
 | File                             | NSID                        | Purpose                                                                                 |
 | -------------------------------- | --------------------------- | --------------------------------------------------------------------------------------- |
-| `lexicon/document/document.json` | `pub.oxa.document.document` | The `Document` record type — the root object stored in a PDS                            |
+| `lexicon/document/document.json` | `pub.oxa.document` | The `Document` record type — the root object stored in a PDS                            |
 | `lexicon/blocks/defs.json`       | `pub.oxa.blocks.defs`       | Block-level type definitions (`paragraph`, `heading`, `richText`) and the `block` union |
 | `lexicon/richtext/facet.json`    | `pub.oxa.richtext.facet`    | Facet annotations for inline formatting (`emphasis`, `strong`, `byteSlice`)             |
 
@@ -187,7 +187,7 @@ Produces:
 
 ```json
 {
-  "$type": "pub.oxa.document.document",
+  "$type": "pub.oxa.document",
   "children": [
     {
       "$type": "pub.oxa.blocks.defs#heading",
@@ -249,7 +249,7 @@ The lexicon files are generated from the OXA YAML schema definitions by the code
 2. Classifies each type as inline or block based on the `Inline` and `Block` union definitions.
 3. Maps inline types to facet features in `pub.oxa.richtext.facet` (excluding `Text`, which becomes the plain text string).
 4. Maps block types to object definitions in `pub.oxa.blocks.defs`, replacing their inline `children` arrays with `text` + `facets` pairs.
-5. Emits the `Document` record type in `pub.oxa.document.document`.
+5. Emits the `Document` record type in `pub.oxa.document`.
 
 To regenerate the lexicon after changing the schema:
 

examples/rfc0003.atproto.json

@@ -1,5 +1,5 @@
 {
-  "$type": "pub.oxa.document.document",
+  "$type": "pub.oxa.document",
   "title": {
     "text": "Water Dissociation: H2O → H+ + OH−",
     "facets": [

lexicon/document/document.json

@@ -1,6 +1,6 @@
 {
   "lexicon": 1,
-  "id": "pub.oxa.document.document",
+  "id": "pub.oxa.document",
   "defs": {
     "main": {
       "type": "record",

packages/oxa-core/src/convert.test.ts

@@ -30,7 +30,7 @@ const lexiconFiles = {
     path: resolve(REPO_ROOT, "lexicon/blocks/defs.json"),
   },
   document: {
-    id: "pub.oxa.document.document",
+    id: "pub.oxa.document",
     path: resolve(REPO_ROOT, "lexicon/document/document.json"),
   },
 } as const;
@@ -464,7 +464,7 @@ describe("oxaToAtproto", () => {
     );
 
     await expect(convertDocument(document, { createdAt })).resolves.toEqual({
-      $type: "pub.oxa.document.document",
+      $type: "pub.oxa.document",
       title: {
         text: "Hello, World",
         facets: [],
@@ -505,7 +505,7 @@ describe("oxaToAtproto", () => {
     await expect(
       convertDocument(documentNode([]), { createdAt }),
     ).resolves.toEqual({
-      $type: "pub.oxa.document.document",
+      $type: "pub.oxa.document",
       children: [],
       createdAt,
     });
@@ -539,7 +539,7 @@ describe("oxaToAtproto", () => {
     );
 
     expect(converted).toEqual({
-      $type: "pub.oxa.document.document",
+      $type: "pub.oxa.document",
       metadata,
       children: [
         {

packages/oxa-core/src/convert.ts

@@ -122,7 +122,7 @@ type AtprotoBlock =
   | AtprotoThematicBreak;
 
 type AtprotoDocument = {
-  $type: "pub.oxa.document.document";
+  $type: "pub.oxa.document";
   title?: RichText;
   metadata?: Record<string, unknown>;
   children: AtprotoBlock[];
@@ -414,7 +414,7 @@ export function oxaToAtproto(
   options: OxaToAtprotoOptions = {},
 ): AtprotoDocument {
   return {
-    $type: "pub.oxa.document.document",
+    $type: "pub.oxa.document",
     ...getOptionalDocumentFields(session, document),
     children: mapKnownBlocks(session, document.children),
     createdAt: options.createdAt ?? new Date().toISOString(),

packages/oxa/src/cli.test.ts

@@ -77,7 +77,7 @@ describe("oxa cli", () => {
   describe("convert", () => {
     const createdAt = "2026-03-22T00:00:00.000Z";
     const expectedConverted = {
-      $type: "pub.oxa.document.document",
+      $type: "pub.oxa.document",
       title: {
         text: "CLI Example",
         facets: [],

scripts/lib/generate-lexicon.ts

@@ -66,7 +66,7 @@ export async function generateLexicon(): Promise<void> {
   writeLexiconFile(join(LEXICON_DIR, "richtext", "facet.json"), facetFile);
   writeLexiconFile(join(LEXICON_DIR, "blocks", "defs.json"), blocksDefsFile);
   writeLexiconFile(
-    join(LEXICON_DIR, "document", "document.json"),
+    join(LEXICON_DIR, "document.json"),
     documentFile,
   );
 
@@ -260,7 +260,7 @@ function generateBlocksDefsLexicon(
 }
 
 /**
- * Generate pub.oxa.document.document lexicon.
+ * Generate pub.oxa.document lexicon.
  *
  * The Document type becomes a record (matching Bluesky's app.bsky.feed.post pattern).
  */
@@ -331,7 +331,7 @@ function generateDocumentLexicon(
 
   return {
     lexicon: 1,
-    id: "pub.oxa.document.document",
+    id: "pub.oxa.document",
     defs: {
       main: {
         type: "record",