@stroc/compose 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2026 Got Choices Foundation
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,3 +1,17 @@
-# Temporary Holding Version
+# @stroc/compose
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Fetches a document and everything it includes, verifies each against its CID, and composes them:
+numbering, references resolved, parameters gathered. Includes an HTTP resolver for the IPFS
+trustless-gateway layout (`/ipfs/<cid>`), catalog reading and author-domain checks.
+
+```js
+import { compose, HttpResolver, MemoryStore, firstOf } from '@stroc/compose'
+
+const resolver = firstOf(localStore, new HttpResolver('https://mychips.org'))
+const composed = await compose(cid, resolver)
+```
+
+Part of [Stroc](https://github.com/gotchoices/stroc), a format for structured legal documents
+identified by content (IPLD CIDs). The format is specified in
+[docs/Specification.md](https://github.com/gotchoices/stroc/blob/main/docs/Specification.md).
+MIT license.

package/dist/src/http.d.ts

@@ -0,0 +1,57 @@
+import type { CID } from 'multiformats/cid';
+import { type StrocDocument } from '@stroc/core';
+import type { Resolver } from './index.js';
+type Fetch = typeof globalThis.fetch;
+export declare class HttpResolver implements Resolver {
+    readonly base: string;
+    private readonly fetchFn;
+    constructor(base: string, options?: {
+        fetch?: Fetch;
+    });
+    get(cid: CID): Promise<Uint8Array | undefined>;
+}
+export declare const CATALOG_PATH = "/.well-known/stroc/catalog.json";
+export type CatalogRole = 'author' | 'endorse' | 'mirror';
+export type CatalogStatus = 'current' | 'superseded' | 'withdrawn';
+export interface CatalogEntry {
+    cid: string;
+    title?: string;
+    role: CatalogRole;
+    status: CatalogStatus;
+    published?: string;
+    replaces?: string[];
+}
+export interface Catalog {
+    'stroc-catalog': string;
+    domain: string;
+    entries: CatalogEntry[];
+}
+export declare function parseCatalog(value: unknown): {
+    catalog?: Catalog;
+    error?: string;
+};
+export type AuthorCheckStatus = 'confirmed' | 'endorsed' | 'mirrored' | 'not-listed' | 'unreachable' | 'not-a-domain';
+export interface AuthorCheck {
+    status: AuthorCheckStatus;
+    author?: string;
+    domain?: string;
+    entry?: CatalogEntry;
+    reason?: string;
+    checked: string;
+}
+export interface AuthorCheckOptions {
+    fetch?: Fetch;
+    catalogUrl?: (domain: string) => string;
+    now?: () => Date;
+}
+export declare class AuthorChecker {
+    private readonly fetchFn;
+    private readonly catalogUrl;
+    private readonly now;
+    private readonly catalogs;
+    constructor(options?: AuthorCheckOptions);
+    private catalog;
+    check(document: StrocDocument, cid: CID | string): Promise<AuthorCheck>;
+}
+export {};
+//# sourceMappingURL=http.d.ts.map

package/dist/src/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/http.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAY,KAAK,aAAa,EAAE,MAAM,aAAa,CAAA;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAE1C,KAAK,KAAK,GAAG,OAAO,UAAU,CAAC,KAAK,CAAA;AAKpC,qBAAa,YAAa,YAAW,QAAQ;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAO;gBAEnB,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,KAAK,CAAA;KAAO;IAKnD,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;CAWrD;AAKD,eAAO,MAAM,YAAY,oCAAoC,CAAA;AAE7D,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAA;AACzD,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,CAAA;AAElE,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,WAAW,CAAA;IACjB,MAAM,EAAE,aAAa,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,eAAe,EAAE,MAAM,CAAA;IACvB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,YAAY,EAAE,CAAA;CACxB;AAMD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAYlF;AAKD,MAAM,MAAM,iBAAiB,GACzB,WAAW,GACX,UAAU,GACV,UAAU,GACV,YAAY,GACZ,aAAa,GACb,cAAc,CAAA;AAElB,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,iBAAiB,CAAA;IACzB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,YAAY,CAAA;IACpB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,KAAK,CAAA;IAGb,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAA;IACvC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;CACjB;AAGD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAO;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4B;IACvD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoE;gBAEjF,OAAO,GAAE,kBAAuB;IAM5C,OAAO,CAAC,OAAO;IAqBT,KAAK,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG,EAAE,GAAG,GAAG,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAW9E"}

package/dist/src/http.js

@@ -0,0 +1,97 @@
+// HTTP access to published documents (Specification: Published Sets and Catalogs).
+//
+// Uses only the standard `fetch`, so it runs in browsers, Node and React Native. Nothing fetched is
+// trusted: documents are verified against their CIDs by `compose`, and catalogs only ever confirm
+// claims about a domain they were fetched from.
+import { isDomain } from '@stroc/core';
+// Reads documents from a Stroc server, a static host or an IPFS gateway, using the trustless
+// gateway convention: GET <base>/ipfs/<cid>?format=raw. Returns undefined for anything other than
+// a successful response (the caller reports the document as missing).
+export class HttpResolver {
+    constructor(base, options = {}) {
+        this.base = base.replace(/\/+$/, '');
+        this.fetchFn = options.fetch ?? globalThis.fetch.bind(globalThis);
+    }
+    async get(cid) {
+        try {
+            const res = await this.fetchFn(`${this.base}/ipfs/${cid}?format=raw`, {
+                headers: { Accept: 'application/vnd.ipld.raw, application/vnd.ipld.dag-json;q=0.9, */*;q=0.1' },
+            });
+            if (!res.ok)
+                return undefined;
+            return new Uint8Array(await res.arrayBuffer());
+        }
+        catch {
+            return undefined;
+        }
+    }
+}
+// ---------------------------------------------------------------------------------------------
+// Catalogs
+export const CATALOG_PATH = '/.well-known/stroc/catalog.json';
+const ROLES = new Set(['author', 'endorse', 'mirror']);
+const STATUSES = new Set(['current', 'superseded', 'withdrawn']);
+// Check the shape of a fetched catalog. Returns undefined (with a reason) if it is not one.
+export function parseCatalog(value) {
+    if (typeof value !== 'object' || value === null)
+        return { error: 'not a JSON object' };
+    const c = value;
+    if (typeof c['stroc-catalog'] !== 'string')
+        return { error: 'missing "stroc-catalog" version' };
+    if (typeof c.domain !== 'string')
+        return { error: 'missing "domain"' };
+    if (!Array.isArray(c.entries))
+        return { error: '"entries" must be an array' };
+    for (const e of c.entries) {
+        if (typeof e?.cid !== 'string' || !ROLES.has(e.role) || !STATUSES.has(e.status)) {
+            return { error: 'an entry lacks a valid cid, role or status' };
+        }
+    }
+    return { catalog: value };
+}
+// Checks documents' `author` claims, fetching each domain's catalog once.
+export class AuthorChecker {
+    constructor(options = {}) {
+        this.catalogs = new Map();
+        this.fetchFn = options.fetch ?? globalThis.fetch.bind(globalThis);
+        this.catalogUrl = options.catalogUrl ?? (d => `https://${d}${CATALOG_PATH}`);
+        this.now = options.now ?? (() => new Date());
+    }
+    catalog(domain) {
+        let pending = this.catalogs.get(domain);
+        if (!pending) {
+            pending = (async () => {
+                try {
+                    const res = await this.fetchFn(this.catalogUrl(domain), { headers: { Accept: 'application/json' } });
+                    if (!res.ok)
+                        return { error: `HTTP ${res.status}` };
+                    const parsed = parseCatalog(await res.json());
+                    if (parsed.catalog && parsed.catalog.domain !== domain) {
+                        return { error: `the catalog speaks for "${parsed.catalog.domain}", not "${domain}"` };
+                    }
+                    return parsed;
+                }
+                catch (err) {
+                    return { error: err.message };
+                }
+            })();
+            this.catalogs.set(domain, pending);
+        }
+        return pending;
+    }
+    async check(document, cid) {
+        const checked = this.now().toISOString();
+        const author = document.author;
+        if (!author || !isDomain(author))
+            return { status: 'not-a-domain', ...(author ? { author } : {}), checked };
+        const { catalog, error } = await this.catalog(author);
+        if (!catalog)
+            return { status: 'unreachable', author, domain: author, reason: error, checked };
+        const entry = catalog.entries.find(e => e.cid === cid.toString());
+        if (!entry)
+            return { status: 'not-listed', author, domain: author, checked };
+        const status = entry.role === 'author' ? 'confirmed' : entry.role === 'endorse' ? 'endorsed' : 'mirrored';
+        return { status, author, domain: author, entry, checked };
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/src/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/http.ts"],"names":[],"mappings":"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"}

package/dist/src/index.d.ts

@@ -0,0 +1,63 @@
+import { CID } from 'multiformats/cid';
+import { type Problem, type StrocDocument, type Parameter } from '@stroc/core';
+export interface Resolver {
+    get(cid: CID): Promise<Uint8Array | undefined>;
+}
+export declare class MemoryStore implements Resolver {
+    private blocks;
+    get(cid: CID): Promise<Uint8Array | undefined>;
+    has(cid: CID): boolean;
+    put(bytes: Uint8Array): Promise<CID>;
+    putDocument(doc: unknown): Promise<CID>;
+    get size(): number;
+}
+export declare function firstOf(...resolvers: Resolver[]): Resolver;
+export declare function findMissing(root: CID, resolver: Resolver): Promise<CID[]>;
+export type ComposedInline = {
+    type: 'text';
+    value: string;
+} | {
+    type: 'emphasis';
+    tag: 'b' | 'i' | 'u';
+    children: ComposedInline[];
+} | {
+    type: 'ref';
+    path: string[];
+    target?: number[];
+} | {
+    type: 'param';
+    path: string;
+};
+export interface ComposedSection {
+    number: number[];
+    id?: string;
+    title?: string;
+    text?: ComposedInline[];
+    sections: ComposedSection[];
+    include?: {
+        cid: CID;
+        document: StrocDocument;
+    };
+}
+export interface ParameterGroup {
+    section?: {
+        number: number[];
+        title: string;
+    };
+    prefix: string[];
+    parameters: Parameter[];
+}
+export interface Composed {
+    cid: CID;
+    document?: StrocDocument;
+    title: string;
+    language: string;
+    text?: ComposedInline[];
+    sections: ComposedSection[];
+    parameters: ParameterGroup[];
+    problems: Problem[];
+}
+export declare function compose(root: CID | string, resolver: Resolver): Promise<Composed>;
+export declare function formatNumber(number: number[]): string;
+export * from './http.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACtC,OAAO,EAEY,KAAK,OAAO,EAAE,KAAK,aAAa,EAAqB,KAAK,SAAS,EACrF,MAAM,aAAa,CAAA;AAKpB,MAAM,WAAW,QAAQ;IAEvB,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAA;CAC/C;AAGD,qBAAa,WAAY,YAAW,QAAQ;IAC1C,OAAO,CAAC,MAAM,CAAgC;IAExC,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IAIpD,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO;IAKhB,GAAG,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC;IAOpC,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC;IAI7C,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAGD,wBAAgB,OAAO,CAAC,GAAG,SAAS,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAU1D;AAID,wBAAsB,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAa/E;AAeD,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAAC,QAAQ,EAAE,cAAc,EAAE,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEnC,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,cAAc,EAAE,CAAA;IACvB,QAAQ,EAAE,eAAe,EAAE,CAAA;IAC3B,OAAO,CAAC,EAAE;QACR,GAAG,EAAE,GAAG,CAAA;QACR,QAAQ,EAAE,aAAa,CAAA;KACxB,CAAA;CACF;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;IAC7C,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,UAAU,EAAE,SAAS,EAAE,CAAA;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,GAAG,CAAA;IACR,QAAQ,CAAC,EAAE,aAAa,CAAA;IACxB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,cAAc,EAAE,CAAA;IACvB,QAAQ,EAAE,eAAe,EAAE,CAAA;IAC3B,UAAU,EAAE,cAAc,EAAE,CAAA;IAC5B,QAAQ,EAAE,OAAO,EAAE,CAAA;CACpB;AAiBD,wBAAsB,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CA4FvF;AA4BD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAErD;AAED,cAAc,WAAW,CAAA"}

package/dist/src/index.js

@@ -0,0 +1,215 @@
+// Composition: fetch and verify a document and everything it includes, number the whole tree,
+// resolve cross-references and gather parameters (Specification: Composition, Cross-References,
+// Parameters, Document Resolution and Verification).
+//
+// Where bytes come from is the app's business: it supplies a Resolver. Every fetched document is
+// verified against its CID before use.
+import { CID } from 'multiformats/cid';
+import { verifyDocument, computeCid, encodeDagJson, parseMarkup, } from '@stroc/core';
+// An in-memory content-addressed store. Documents are keyed by the CID of their bytes.
+export class MemoryStore {
+    constructor() {
+        this.blocks = new Map();
+    }
+    async get(cid) {
+        return this.blocks.get(cid.toString());
+    }
+    has(cid) {
+        return this.blocks.has(cid.toString());
+    }
+    // Store bytes under their CID and return it. (Bytes are verified when read, not here.)
+    async put(bytes) {
+        const cid = await computeCid(bytes);
+        this.blocks.set(cid.toString(), bytes);
+        return cid;
+    }
+    // Store a document from the data model in its canonical encoding.
+    async putDocument(doc) {
+        return this.put(encodeDagJson(doc));
+    }
+    get size() {
+        return this.blocks.size;
+    }
+}
+// Try several resolvers in order (for example a local store, then a peer, then a publisher).
+export function firstOf(...resolvers) {
+    return {
+        async get(cid) {
+            for (const r of resolvers) {
+                const bytes = await r.get(cid);
+                if (bytes)
+                    return bytes;
+            }
+            return undefined;
+        },
+    };
+}
+// The CIDs reachable from root that the resolver cannot supply. Documents that are present are
+// verified and followed; an empty result means the whole composition is available.
+export async function findMissing(root, resolver) {
+    const missing = [];
+    const seen = new Set();
+    const visit = async (cid) => {
+        if (seen.has(cid.toString()))
+            return;
+        seen.add(cid.toString());
+        const bytes = await resolver.get(cid);
+        if (!bytes) {
+            missing.push(cid);
+            return;
+        }
+        const v = await verifyDocument(bytes, cid);
+        if (v.document)
+            for (const link of includeLinks(v.document.sections))
+                await visit(link);
+    };
+    await visit(root);
+    return missing;
+}
+function includeLinks(sections) {
+    const out = [];
+    for (const s of sections ?? []) {
+        if ('source' in s)
+            out.push(s.source);
+        else
+            out.push(...includeLinks(s.sections));
+    }
+    return out;
+}
+const MAX_DEPTH = 64;
+// Compose a document by CID. Never throws: anything missing, invalid or unresolved is reported in
+// `problems`, and the parts that could not be composed are left out.
+export async function compose(root, resolver) {
+    const rootCid = typeof root === 'string' ? CID.parse(root) : root;
+    const problems = [];
+    const pending = [];
+    const parameters = [];
+    const cache = new Map();
+    const load = async (cid, at) => {
+        const key = cid.toString();
+        if (cache.has(key))
+            return cache.get(key) ?? undefined;
+        const bytes = await resolver.get(cid);
+        if (!bytes) {
+            problems.push({ path: [], code: 'missing-document', message: `${at}: document ${key} is not available` });
+            cache.set(key, null);
+            return undefined;
+        }
+        const v = await verifyDocument(bytes, cid);
+        if (!v.ok || !v.document) {
+            const why = v.problems.map(p => `${p.path.join('.') || 'document'}: ${p.message}`).join('; ');
+            problems.push({ path: [], code: 'invalid-document', message: `${at}: document ${key} failed verification: ${why}` });
+            cache.set(key, null);
+            return undefined;
+        }
+        cache.set(key, v.document);
+        return v.document;
+    };
+    const convertText = (text, scope, at, prefix) => {
+        const convert = (nodes) => nodes.map(n => n.type === 'text' ? { type: 'text', value: n.value } :
+            n.type === 'ref' ? { type: 'ref', path: n.path } :
+                n.type === 'param' ? { type: 'param', path: [...prefix, n.key].join('/') } :
+                    { type: 'emphasis', tag: n.tag, children: convert(n.children) });
+        const nodes = convert(parseMarkup(text).nodes);
+        pending.push({ nodes, scope, at });
+        return nodes;
+    };
+    // Compose a document's sections under a parent number, in the document's own id scope.
+    const composeSections = async (sections, parent, scope, prefix, depth, at) => {
+        const out = [];
+        let n = 0;
+        for (const sec of sections ?? []) {
+            n++;
+            const number = [...parent, n];
+            if ('source' in sec) {
+                const placeholder = { number, id: sec.id, sections: [] };
+                scope.ids.set(sec.id, placeholder);
+                out.push(placeholder);
+                if (depth >= MAX_DEPTH) {
+                    problems.push({ path: [], code: 'too-deep', message: `${at}: includes nested more than ${MAX_DEPTH} deep` });
+                    continue;
+                }
+                const doc = await load(sec.source, `${at} > ${sec.id}`);
+                if (!doc)
+                    continue;
+                const inner = { ids: new Map(), includes: new Map() };
+                scope.includes.set(sec.id, inner);
+                const innerPrefix = [...prefix, sec.id];
+                placeholder.title = doc.title;
+                placeholder.include = { cid: sec.source, document: doc };
+                if (doc.parameters)
+                    parameters.push({ section: { number, title: doc.title }, prefix: innerPrefix, parameters: doc.parameters });
+                if (doc.text)
+                    placeholder.text = convertText(doc.text, inner, `${at} > ${sec.id}`, innerPrefix);
+                placeholder.sections = await composeSections(doc.sections, number, inner, innerPrefix, depth + 1, `${at} > ${sec.id}`);
+            }
+            else {
+                const section = { number, sections: [] };
+                if (sec.id) {
+                    section.id = sec.id;
+                    scope.ids.set(sec.id, section);
+                }
+                if (sec.title)
+                    section.title = sec.title;
+                if (sec.text)
+                    section.text = convertText(sec.text, scope, at, prefix);
+                section.sections = await composeSections(sec.sections, number, scope, prefix, depth, at);
+                out.push(section);
+            }
+        }
+        return out;
+    };
+    const document = await load(rootCid, 'root');
+    if (!document) {
+        return { cid: rootCid, title: '', language: '', sections: [], parameters: [], problems };
+    }
+    const rootScope = { ids: new Map(), includes: new Map() };
+    if (document.parameters)
+        parameters.unshift({ prefix: [], parameters: document.parameters });
+    const text = document.text ? convertText(document.text, rootScope, 'root', []) : undefined;
+    const sections = await composeSections(document.sections, [], rootScope, [], 0, 'root');
+    // Root parameters first, then included documents' in document order.
+    parameters.sort((a, b) => compareNumbers(a.section?.number ?? [], b.section?.number ?? []));
+    // Resolve references now that every scope is complete.
+    for (const p of pending)
+        resolveRefs(p.nodes, p.scope, p.at, problems);
+    return { cid: rootCid, document, title: document.title, language: document.language, text, sections, parameters, problems };
+}
+function resolveRefs(nodes, scope, at, problems) {
+    for (const node of nodes) {
+        if (node.type === 'emphasis')
+            resolveRefs(node.children, scope, at, problems);
+        if (node.type !== 'ref')
+            continue;
+        let current = scope;
+        let target;
+        for (let i = 0; i < node.path.length && current; i++) {
+            target = current.ids.get(node.path[i]);
+            if (!target)
+                break;
+            current = i < node.path.length - 1 ? current.includes.get(node.path[i]) : undefined;
+            if (i < node.path.length - 1 && !current) {
+                target = undefined;
+                break;
+            }
+        }
+        if (target)
+            node.target = target.number;
+        else
+            problems.push({ path: [], code: 'unresolved-ref', message: `${at}: <ref:${node.path.join('/')}> does not resolve in the composed document` });
+    }
+}
+function compareNumbers(a, b) {
+    for (let i = 0; i < Math.max(a.length, b.length); i++) {
+        const d = (a[i] ?? 0) - (b[i] ?? 0);
+        if (d)
+            return d;
+    }
+    return 0;
+}
+// "3.1" for [3, 1].
+export function formatNumber(number) {
+    return number.join('.');
+}
+export * from './http.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,51 @@
 {
   "name": "@stroc/compose",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Fetch, verify and compose Stroc documents and their includes; HTTP resolver and catalogs",
+  "keywords": [
+    "stroc",
+    "structured-documents",
+    "ipfs",
+    "trustless-gateway"
+  ],
+  "license": "MIT",
+  "author": "Got Choices Foundation",
+  "homepage": "https://github.com/gotchoices/stroc/tree/main/packages/compose#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gotchoices/stroc.git",
+    "directory": "packages/compose"
+  },
+  "bugs": "https://github.com/gotchoices/stroc/issues",
+  "engines": {
+    "node": ">=20.19"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    }
+  },
+  "files": [
+    "dist/src/**/*"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@stroc/core": "0.1.0",
+    "multiformats": "^13.4 || ^14"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "vitest": "^3"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
 }