@codama/spec 1.6.0-rc.2 → 1.6.0-rc.3

package/dist/types/api/primitives.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../../src/api/primitives.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAMlG,0BAA0B;AAC1B,wBAAgB,MAAM,IAAI,QAAQ,CAEjC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,QAAQ,CAE3C;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,IAAI,QAAQ,CAExC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,QAAQ,CAExC;AAQD,eAAO,MAAM,EAAE,QAAO,QAAyB,CAAC;AAChD,eAAO,MAAM,GAAG,QAAO,QAA0B,CAAC;AAClD,eAAO,MAAM,GAAG,QAAO,QAA0B,CAAC;AAClD,eAAO,MAAM,GAAG,QAAO,QAA0B,CAAC;AAClD,eAAO,MAAM,IAAI,QAAO,QAA2B,CAAC;AACpD,eAAO,MAAM,EAAE,QAAO,QAAyB,CAAC;AAChD,eAAO,MAAM,GAAG,QAAO,QAA0B,CAAC;AAClD,eAAO,MAAM,GAAG,QAAO,QAA0B,CAAC;AAClD,eAAO,MAAM,GAAG,QAAO,QAA0B,CAAC;AAClD,eAAO,MAAM,IAAI,QAAO,QAA2B,CAAC;AAQpD,eAAO,MAAM,GAAG,QAAO,QAAwB,CAAC;AAChD,eAAO,MAAM,GAAG,QAAO,QAAwB,CAAC;AAMhD,wBAAgB,OAAO,IAAI,QAAQ,CAElC;AAED,gDAAgD;AAChD,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,QAAQ,CAErD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,MAAM,EAAE,YAAY,EAAE,GAAG,QAAQ,CAYhE;AAMD,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAElD;AAED,2DAA2D;AAC3D,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAE3C;AAED,6DAA6D;AAC7D,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAE5C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAErD;AAGD,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,QAAQ,EAAE,CAAC"}
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../../src/api/primitives.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAIlG,0BAA0B;AAC1B,wBAAgB,MAAM,IAAI,QAAQ,CAEjC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,QAAQ,CAE3C;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,IAAI,QAAQ,CAExC;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,QAAQ,CAExC;AAMD,eAAO,MAAM,EAAE,QAAO,QAAyB,CAAC;AAChD,eAAO,MAAM,GAAG,QAAO,QAA0B,CAAC;AAClD,eAAO,MAAM,GAAG,QAAO,QAA0B,CAAC;AAClD,eAAO,MAAM,GAAG,QAAO,QAA0B,CAAC;AAClD,eAAO,MAAM,IAAI,QAAO,QAA2B,CAAC;AACpD,eAAO,MAAM,EAAE,QAAO,QAAyB,CAAC;AAChD,eAAO,MAAM,GAAG,QAAO,QAA0B,CAAC;AAClD,eAAO,MAAM,GAAG,QAAO,QAA0B,CAAC;AAClD,eAAO,MAAM,GAAG,QAAO,QAA0B,CAAC;AAClD,eAAO,MAAM,IAAI,QAAO,QAA2B,CAAC;AAMpD,eAAO,MAAM,GAAG,QAAO,QAAwB,CAAC;AAChD,eAAO,MAAM,GAAG,QAAO,QAAwB,CAAC;AAIhD,wBAAgB,OAAO,IAAI,QAAQ,CAElC;AAED,gDAAgD;AAChD,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,QAAQ,CAErD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,MAAM,EAAE,YAAY,EAAE,GAAG,QAAQ,CAYhE;AAID,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAElD;AAED,2DAA2D;AAC3D,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAE3C;AAED,6DAA6D;AAC7D,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAE5C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAErD;AAGD,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,QAAQ,EAAE,CAAC"}

package/dist/types/api/semanticAliases.d.ts

@@ -1,11 +1,16 @@
 /**
- * Author-side semantic aliases over integer primitives. They desugar at call
- * time so the encoded spec only ever shows the underlying primitive (e.g.
- * `{ kind: "integer", width: "u64" }` for both `u64()` and `byteSize()`).
+ * Author-side semantic aliases.
  *
- * Each language's codegen may further specialise rendering for these widths
- * (e.g. Rust may render `u64` as `usize` for byte-size fields if it wants).
- * Those are codegen policies — not spec content.
+ * Most aliases desugar at call time so the encoded spec only ever shows
+ * the underlying primitive (e.g. `{ kind: "integer", width: "u64" }` for
+ * both `u64()` and `byteSize()`). Each language's codegen may further
+ * specialise rendering for these widths (e.g. Rust may render `u64` as
+ * `usize` for byte-size fields if it wants). Those are codegen policies
+ * — not spec content.
+ *
+ * `docs()` is the exception: it returns its own `'docs'` `TypeExpr` kind
+ * so the documentation intent survives in the encoded spec rather than
+ * collapsing to `array(string())`.
  */
 import type { TypeExpr } from './types';
 /** Number of bytes; non-negative. Encoded as `u64`. */
@@ -14,6 +19,11 @@ export declare function byteSize(): TypeExpr;
 export declare function byteOffset(): TypeExpr;
 /** Count of items in a collection; non-negative. Encoded as `u32`. */
 export declare function count(): TypeExpr;
-/** Documentation for a node — an array of paragraph strings. */
+/**
+ * Documentation for a node — semantically a list of paragraph strings,
+ * but rendered per language at codegen time (e.g. `Array<string>` in
+ * TypeScript, `Vec<String>` in Rust). Returns its own `'docs'` kind so
+ * the intent isn't lost in the encoded spec.
+ */
 export declare function docs(): TypeExpr;
 //# sourceMappingURL=semanticAliases.d.ts.map

package/dist/types/api/semanticAliases.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"semanticAliases.d.ts","sourceRoot":"","sources":["../../../src/api/semanticAliases.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,uDAAuD;AACvD,wBAAgB,QAAQ,IAAI,QAAQ,CAEnC;AAED,4CAA4C;AAC5C,wBAAgB,UAAU,IAAI,QAAQ,CAErC;AAED,sEAAsE;AACtE,wBAAgB,KAAK,IAAI,QAAQ,CAEhC;AAED,gEAAgE;AAChE,wBAAgB,IAAI,IAAI,QAAQ,CAE/B"}
+{"version":3,"file":"semanticAliases.d.ts","sourceRoot":"","sources":["../../../src/api/semanticAliases.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,uDAAuD;AACvD,wBAAgB,QAAQ,IAAI,QAAQ,CAEnC;AAED,4CAA4C;AAC5C,wBAAgB,UAAU,IAAI,QAAQ,CAErC;AAED,sEAAsE;AACtE,wBAAgB,KAAK,IAAI,QAAQ,CAEhC;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,IAAI,QAAQ,CAE/B"}

package/dist/types/api/types.d.ts

@@ -3,7 +3,9 @@
  *
  * These types are version-agnostic — the same shape describes a Codama v1
  * spec, a v2 spec, etc. Versioned content (concrete nodes, enumerations,
- * unions) lives under `spec/src/v<n>/`.
+ * unions) lives under `spec/src/v<n>/`. The first half of this file
+ * declares the type-expression vocabulary; the second half declares the
+ * spec-content shape (attributes, nodes, unions, enumerations).
  */
 export type IntegerWidth = 'i8' | 'i16' | 'i32' | 'i64' | 'i128' | 'u8' | 'u16' | 'u32' | 'u64' | 'u128';
 export type FloatWidth = 'f32' | 'f64';
@@ -21,8 +23,8 @@ export type LiteralValue = boolean | number | string;
  * Constituents are listed alphabetically by `kind` to satisfy the lint
  * rule; logical grouping lives in the doc comments below.
  *
- * Leaf primitives:    boolean, float, integer, literal, literalUnion, string.
- * Named references:   enumeration, nestedTypeNode, node, union.
+ * Leaf primitives:    boolean, docs, float, integer, literal, literalUnion, string.
+ * Named references:   codamaVersion, enumeration, nestedTypeNode, node, union.
  * Compounds:          array, tuple.
  */
 export type TypeExpr = {
@@ -38,6 +40,16 @@ export type TypeExpr = {
  */
  | {
     readonly kind: 'codamaVersion';
+}
+/**
+ * Documentation for a node — semantically a list of paragraph strings,
+ * but rendered per language at codegen time (e.g. `Array<string>` in
+ * TypeScript, `Vec<String>` in Rust). Carrying the intent as its own
+ * kind preserves "this is documentation" through the encoded spec
+ * rather than collapsing to `array(string())`.
+ */
+ | {
+    readonly kind: 'docs';
 } | {
     readonly kind: 'enumeration';
     readonly name: string;

package/dist/types/api/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/api/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,MAAM,YAAY,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;AAEzG,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,KAAK,CAAC;AAEvC,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,SAAS,CAAC;AAExD,gEAAgE;AAChE,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AAErD;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,QAAQ,GACd;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAA;CAAE,GACjD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE;AAC9B;;;;GAIG;GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;CAAE,GAClC;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GAC1D;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAA;CAAE;AAC5D;;;;GAIG;GACD;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAA;CAAE,GAC3E;IAAE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAA;CAAE,GACnE;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAA;CAAE,GAC/D;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAMxD,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,sDAAsD;IACtD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,uEAAuE;AACvE,MAAM,WAAW,QAAQ;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAC;IAC9C,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;CACzC;AAED,6EAA6E;AAC7E,MAAM,MAAM,WAAW,GACjB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAExD,mEAAmE;AACnE,MAAM,WAAW,SAAS;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IACzC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,0CAA0C;AAC1C,MAAM,WAAW,sBAAsB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,4DAA4D;AAC5D,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,SAAS,sBAAsB,EAAE,CAAC;IACrD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,8DAA8D;AAC9D,MAAM,WAAW,IAAI;IACjB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,SAAS,eAAe,EAAE,CAAC;IAClD,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;IACtC;;;;;OAKG;IACH,QAAQ,CAAC,sBAAsB,EAAE,SAAS,MAAM,EAAE,CAAC;CACtD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/api/types.ts"],"names":[],"mappings":"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"}

package/dist/types/api/validate.d.ts

@@ -8,6 +8,9 @@
 import type { Spec, TypeExpr } from './types';
 export declare function validate(spec: Spec): string[];
 /**
+ * Child-detection helper used by codegen, docs, and visitor-table
+ * generators.
+ *
  * A "child" attribute is one whose value contains another node. Specifically,
  * any attribute whose type tree includes a `node`, `nestedTypeNode`, or
  * `union` is treated as a child. Optionality (the `optional` flag on the

package/dist/types/api/validate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/api/validate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAI9C,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,CA6E7C;AAiED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAaxD"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../../src/api/validate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAI9C,wBAAgB,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,EAAE,CAwE7C;AAyDD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAaxD"}

package/dist/v1.browser.cjs

@@ -129,7 +129,7 @@ function byteSize() {
   return u64();
 }
 function docs() {
-  return array(string());
+  return Object.freeze({ kind: "docs" });
 }
 
 // src/api/validate.ts