@carbonenginejs/runtime-resource 0.9.0 → 0.9.1

package/dist/formats/yaml/CjsYamlFormat.js

@@ -2,6 +2,12 @@ import { CjsYamlReader } from './core/CjsYamlReader.js';
 import { DEFAULT_VALUES, normalizeValues, toJsonGraph, OUTPUT_RAW, OUTPUT_DOCUMENT, OUTPUT_PAYLOAD, OUTPUT_JSON, TAG_PRESERVE, TAG_REJECT, TAG_HANDLE } from './core/helpers.js';
 
 const FORMAT_NAME = "CjsYamlFormat";
+
+/**
+ * YAML format profile that parses YAML text into payload, JSON-graph, raw,
+ * or document output with configurable tag policies, alias limits, and
+ * identity/reference markers.
+ */
 class CjsYamlFormat {
   #values = DEFAULT_VALUES;
   constructor(options = {}) {

package/dist/formats/yaml/CjsYamlFormat.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsYamlFormat.js","sources":["../../../../src/formats/yaml/CjsYamlFormat.js"],"sourcesContent":["import { CjsYamlReader } from \"./core/CjsYamlReader.js\";\nimport {\n    DEFAULT_VALUES,\n    OUTPUT_DOCUMENT,\n    OUTPUT_JSON,\n    OUTPUT_PAYLOAD,\n    OUTPUT_RAW,\n    TAG_HANDLE,\n    TAG_PRESERVE,\n    TAG_REJECT,\n    normalizeValues,\n    toJsonGraph\n} from \"./core/helpers.js\";\n\nconst FORMAT_NAME = \"CjsYamlFormat\";\n\nexport class CjsYamlFormat\n{\n    #values = DEFAULT_VALUES;\n\n    constructor(options = {})\n    {\n        this.SetValues(options);\n    }\n\n    SetValues(options = {})\n    {\n        this.#values = normalizeValues(this.#values, options, FORMAT_NAME);\n        return this;\n    }\n\n    GetValues(options = {})\n    {\n        return normalizeValues(this.#values, options, FORMAT_NAME);\n    }\n\n    Read(input, options = {})\n    {\n        return CjsYamlFormat.read(input, this.GetValues(options));\n    }\n\n    ReadPayload(input, options = {})\n    {\n        return CjsYamlFormat.readPayload(input, this.GetValues(options));\n    }\n\n    ReadRaw(input, options = {})\n    {\n        return CjsYamlFormat.readRaw(input, this.GetValues(options));\n    }\n\n    ReadDocument(input, options = {})\n    {\n        return CjsYamlFormat.readDocument(input, this.GetValues(options));\n    }\n\n    Inspect(input, options = {})\n    {\n        return CjsYamlFormat.inspect(input, this.GetValues(options));\n    }\n\n    ToJSON(value, options = {})\n    {\n        return toJsonGraph(value, this.GetValues(options));\n    }\n\n    static read(input, options = {})\n    {\n        const values = normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME);\n        if (values.emit === OUTPUT_RAW) return new CjsYamlReader(input, values).ReadRaw();\n        if (values.emit === OUTPUT_DOCUMENT) return new CjsYamlReader(input, values).ReadDocument();\n        return new CjsYamlReader(input, values).ReadPayload();\n    }\n\n    static readPayload(input, options = {})\n    {\n        const values = normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME);\n        return new CjsYamlReader(input, values).ReadPayload();\n    }\n\n    static readRaw(input, options = {})\n    {\n        const values = normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME);\n        return new CjsYamlReader(input, values).ReadRaw();\n    }\n\n    static readDocument(input, options = {})\n    {\n        const values = normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME);\n        return new CjsYamlReader(input, values).ReadDocument();\n    }\n\n    static inspect(input, options = {})\n    {\n        const values = normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME);\n        return new CjsYamlReader(input, values).Inspect();\n    }\n\n    static toJSON(value, options = {})\n    {\n        return toJsonGraph(value, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Emit targets for this format (canonical frozen enum).\n     */\n    static Output = Object.freeze({\n        JSON: OUTPUT_JSON,\n        PAYLOAD: OUTPUT_PAYLOAD,\n        RAW: OUTPUT_RAW,\n        DOCUMENT: OUTPUT_DOCUMENT\n    });\n    static TAG_PRESERVE = TAG_PRESERVE;\n    static TAG_REJECT = TAG_REJECT;\n    static TAG_HANDLE = TAG_HANDLE;\n    static id = \"yaml\";\n    static extensions = Object.freeze([ \".yaml\", \".yml\" ]);\n    static type = Object.freeze([ \"data\" ]);\n    static mediaTypes = Object.freeze([ \"data\" ]);\n    static inputTypes = Object.freeze([ \"yaml\" ]);\n    static outputTypes = Object.freeze([ OUTPUT_JSON, OUTPUT_PAYLOAD ]);\n    static debugOutputTypes = Object.freeze([ OUTPUT_RAW, OUTPUT_DOCUMENT ]);\n}\n\nexport default CjsYamlFormat;\n"],"names":["FORMAT_NAME","CjsYamlFormat","DEFAULT_VALUES","constructor","options","SetValues","normalizeValues","GetValues","Read","input","read","ReadPayload","readPayload","ReadRaw","readRaw","ReadDocument","readDocument","Inspect","inspect","ToJSON","value","toJsonGraph","values","emit","OUTPUT_RAW","CjsYamlReader","OUTPUT_DOCUMENT","toJSON","Output","Object","freeze","JSON","OUTPUT_JSON","PAYLOAD","OUTPUT_PAYLOAD","RAW","DOCUMENT","TAG_PRESERVE","TAG_REJECT","TAG_HANDLE","id","extensions","type","mediaTypes","inputTypes","outputTypes","debugOutputTypes"],"mappings":"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"}
+{"version":3,"file":"CjsYamlFormat.js","sources":["../../../../src/formats/yaml/CjsYamlFormat.js"],"sourcesContent":["import { CjsYamlReader } from \"./core/CjsYamlReader.js\";\nimport {\n    DEFAULT_VALUES,\n    OUTPUT_DOCUMENT,\n    OUTPUT_JSON,\n    OUTPUT_PAYLOAD,\n    OUTPUT_RAW,\n    TAG_HANDLE,\n    TAG_PRESERVE,\n    TAG_REJECT,\n    normalizeValues,\n    toJsonGraph\n} from \"./core/helpers.js\";\n\nconst FORMAT_NAME = \"CjsYamlFormat\";\n\n/**\n * YAML format profile that parses YAML text into payload, JSON-graph, raw,\n * or document output with configurable tag policies, alias limits, and\n * identity/reference markers.\n */\nexport class CjsYamlFormat\n{\n    #values = DEFAULT_VALUES;\n\n    constructor(options = {})\n    {\n        this.SetValues(options);\n    }\n\n    SetValues(options = {})\n    {\n        this.#values = normalizeValues(this.#values, options, FORMAT_NAME);\n        return this;\n    }\n\n    GetValues(options = {})\n    {\n        return normalizeValues(this.#values, options, FORMAT_NAME);\n    }\n\n    Read(input, options = {})\n    {\n        return CjsYamlFormat.read(input, this.GetValues(options));\n    }\n\n    ReadPayload(input, options = {})\n    {\n        return CjsYamlFormat.readPayload(input, this.GetValues(options));\n    }\n\n    ReadRaw(input, options = {})\n    {\n        return CjsYamlFormat.readRaw(input, this.GetValues(options));\n    }\n\n    ReadDocument(input, options = {})\n    {\n        return CjsYamlFormat.readDocument(input, this.GetValues(options));\n    }\n\n    Inspect(input, options = {})\n    {\n        return CjsYamlFormat.inspect(input, this.GetValues(options));\n    }\n\n    ToJSON(value, options = {})\n    {\n        return toJsonGraph(value, this.GetValues(options));\n    }\n\n    static read(input, options = {})\n    {\n        const values = normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME);\n        if (values.emit === OUTPUT_RAW) return new CjsYamlReader(input, values).ReadRaw();\n        if (values.emit === OUTPUT_DOCUMENT) return new CjsYamlReader(input, values).ReadDocument();\n        return new CjsYamlReader(input, values).ReadPayload();\n    }\n\n    static readPayload(input, options = {})\n    {\n        const values = normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME);\n        return new CjsYamlReader(input, values).ReadPayload();\n    }\n\n    static readRaw(input, options = {})\n    {\n        const values = normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME);\n        return new CjsYamlReader(input, values).ReadRaw();\n    }\n\n    static readDocument(input, options = {})\n    {\n        const values = normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME);\n        return new CjsYamlReader(input, values).ReadDocument();\n    }\n\n    static inspect(input, options = {})\n    {\n        const values = normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME);\n        return new CjsYamlReader(input, values).Inspect();\n    }\n\n    static toJSON(value, options = {})\n    {\n        return toJsonGraph(value, normalizeValues(DEFAULT_VALUES, options, FORMAT_NAME));\n    }\n\n    /**\n     * Emit targets for this format (canonical frozen enum).\n     */\n    static Output = Object.freeze({\n        JSON: OUTPUT_JSON,\n        PAYLOAD: OUTPUT_PAYLOAD,\n        RAW: OUTPUT_RAW,\n        DOCUMENT: OUTPUT_DOCUMENT\n    });\n    static TAG_PRESERVE = TAG_PRESERVE;\n    static TAG_REJECT = TAG_REJECT;\n    static TAG_HANDLE = TAG_HANDLE;\n    static id = \"yaml\";\n    static extensions = Object.freeze([ \".yaml\", \".yml\" ]);\n    static type = Object.freeze([ \"data\" ]);\n    static mediaTypes = Object.freeze([ \"data\" ]);\n    static inputTypes = Object.freeze([ \"yaml\" ]);\n    static outputTypes = Object.freeze([ OUTPUT_JSON, OUTPUT_PAYLOAD ]);\n    static debugOutputTypes = Object.freeze([ OUTPUT_RAW, OUTPUT_DOCUMENT ]);\n}\n\nexport default CjsYamlFormat;\n"],"names":["FORMAT_NAME","CjsYamlFormat","DEFAULT_VALUES","constructor","options","SetValues","normalizeValues","GetValues","Read","input","read","ReadPayload","readPayload","ReadRaw","readRaw","ReadDocument","readDocument","Inspect","inspect","ToJSON","value","toJsonGraph","values","emit","OUTPUT_RAW","CjsYamlReader","OUTPUT_DOCUMENT","toJSON","Output","Object","freeze","JSON","OUTPUT_JSON","PAYLOAD","OUTPUT_PAYLOAD","RAW","DOCUMENT","TAG_PRESERVE","TAG_REJECT","TAG_HANDLE","id","extensions","type","mediaTypes","inputTypes","outputTypes","debugOutputTypes"],"mappings":"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"}

package/dist/formats/yaml/core/CjsYamlReader.js

@@ -24,6 +24,12 @@ function defineMappingValue(target, key, value) {
     writable: true
   });
 }
+
+/**
+ * Construction-bound reader that parses one YAML source with the `yaml`
+ * library and produces the format's payload, raw, or document graphs while
+ * enforcing tag policy and alias limits.
+ */
 class CjsYamlReader extends CjsReader {
   constructor(input, options = {}) {
     super(options);

package/dist/formats/yaml/core/CjsYamlReader.js.map

@@ -1 +1 @@
-{"version":3,"file":"CjsYamlReader.js","sources":["../../../../../src/formats/yaml/core/CjsYamlReader.js"],"sourcesContent":["import {\n    LineCounter,\n    isAlias,\n    isMap,\n    isScalar,\n    isSeq,\n    parseDocument,\n    visit\n} from \"yaml\";\n\nimport { CjsReader } from \"../../../format/CjsReader.js\";\nimport { TAG_HANDLE, TAG_PRESERVE, TAG_REJECT, toJsonGraph } from \"./helpers.js\";\n\nconst TAG_PREFIX = \"tag:yaml.org,2002:\";\nconst PYTHON_TUPLE = `${TAG_PREFIX}python/tuple`;\nconst PYTHON_UNICODE = `${TAG_PREFIX}python/unicode`;\nconst PYTHON_PROJECTED_DECAL = `${TAG_PREFIX}python/object:paperDoll.ProjectedDecal`;\nconst PYTHON_PART_METADATA = `${TAG_PREFIX}python/object:paperDoll.AvatarPartMetaData`;\n\nconst STANDARD_TAGS = new Set([\n    \"binary\", \"bool\", \"float\", \"int\", \"map\", \"merge\", \"null\", \"omap\",\n    \"pairs\", \"seq\", \"set\", \"str\", \"timestamp\"\n].map(name => `${TAG_PREFIX}${name}`));\n\nfunction canonicalTag(tag)\n{\n    if (typeof tag !== \"string\") return tag;\n    if (tag.startsWith(\"!!\")) return `${TAG_PREFIX}${tag.slice(2)}`;\n    return tag;\n}\n\nfunction displayMessage(error)\n{\n    return String(error && error.message ? error.message : error).trim();\n}\n\nfunction defineMappingValue(target, key, value)\n{\n    Object.defineProperty(target, key, {\n        value,\n        enumerable: true,\n        configurable: true,\n        writable: true\n    });\n}\n\nexport class CjsYamlReader extends CjsReader\n{\n    constructor(input, options = {})\n    {\n        super(options);\n\n        if (typeof input !== \"string\")\n        {\n            throw new TypeError(\"CjsYamlFormat input must be a YAML string\");\n        }\n\n        this.source = input;\n        this.lineCounter = new LineCounter();\n        this.document = parseDocument(input, {\n            keepSourceTokens: true,\n            lineCounter: this.lineCounter,\n            prettyErrors: true,\n            strict: true,\n            uniqueKeys: this.options.uniqueKeys\n        });\n        this.inventory = this.BuildInventory();\n    }\n\n    Read()\n    {\n        return this.ReadPayload();\n    }\n\n    ReadPayload()\n    {\n        return toJsonGraph(this.ReadRaw(), this.options);\n    }\n\n    ReadRaw()\n    {\n        this.AssertSyntax();\n        this.AssertAliasLimit();\n        return this.Convert(this.document.contents, new Map());\n    }\n\n    ReadDocument()\n    {\n        let value = null;\n        const errors = this.inventory.errors.slice();\n\n        if (!errors.length)\n        {\n            try\n            {\n                this.AssertAliasLimit();\n                value = this.Convert(this.document.contents, new Map());\n            }\n            catch (error)\n            {\n                errors.push(this.DescribeError(error));\n            }\n        }\n\n        return {\n            format: { id: \"yaml\" },\n            source: { name: this.options.sourceName, length: this.source.length },\n            root: { kind: this.RootKind() },\n            value,\n            tags: this.inventory.tags,\n            anchors: this.inventory.anchors,\n            aliases: this.inventory.aliases,\n            warnings: this.inventory.warnings,\n            errors\n        };\n    }\n\n    Inspect()\n    {\n        return {\n            format: { id: \"yaml\" },\n            source: { name: this.options.sourceName, length: this.source.length },\n            root: { kind: this.RootKind() },\n            tags: this.inventory.tags,\n            anchors: this.inventory.anchors,\n            aliases: this.inventory.aliases,\n            warnings: this.inventory.warnings,\n            errors: this.inventory.errors\n        };\n    }\n\n    RootKind()\n    {\n        const node = this.document.contents;\n        if (node === null) return \"null\";\n        if (isMap(node)) return \"mapping\";\n        if (isSeq(node)) return \"sequence\";\n        if (isScalar(node)) return \"scalar\";\n        if (isAlias(node)) return \"alias\";\n        return \"unknown\";\n    }\n\n    AssertSyntax()\n    {\n        if (!this.document.errors.length) return;\n        const first = this.document.errors[0];\n        const source = this.options.sourceName ? ` in ${this.options.sourceName}` : \"\";\n        throw new SyntaxError(`CjsYamlFormat${source}: ${displayMessage(first)}`);\n    }\n\n    AssertAliasLimit()\n    {\n        if (this.inventory.aliases.length <= this.options.maxAliasCount) return;\n        const source = this.options.sourceName ? ` in ${this.options.sourceName}` : \"\";\n        throw new RangeError(`CjsYamlFormat${source}: alias count ${this.inventory.aliases.length} exceeds maxAliasCount ${this.options.maxAliasCount}`);\n    }\n\n    Convert(node, memo)\n    {\n        if (node === null || node === undefined) return null;\n\n        if (isAlias(node))\n        {\n            const source = node.resolve(this.document);\n            if (!source) throw this.NodeError(node, `unresolved alias \"${node.source}\"`);\n            return this.Convert(source, memo);\n        }\n\n        if (memo.has(node)) return memo.get(node);\n\n        const tag = this.CustomTag(node);\n        if (tag)\n        {\n            this.AssertTagAllowed(tag, node);\n            const handler = this.FindTagHandler(tag);\n\n            if (handler)\n            {\n                const value = this.ConvertBase(node, memo, true);\n                const handled = handler(value, this.TagContext(tag, node));\n                memo.set(node, handled);\n                return handled;\n            }\n\n            if (tag === PYTHON_TUPLE)\n            {\n                if (!isSeq(node)) throw this.NodeError(node, `${tag} must decorate a sequence`);\n                return this.ConvertBase(node, memo, true);\n            }\n\n            if (tag === PYTHON_UNICODE)\n            {\n                if (!isScalar(node) || typeof node.value !== \"string\")\n                {\n                    throw this.NodeError(node, `${tag} must decorate a string scalar`);\n                }\n                return node.value;\n            }\n\n            if (this.options.tagPolicy === TAG_REJECT)\n            {\n                throw this.NodeError(node, `custom tag \"${tag}\" is rejected by tagPolicy`);\n            }\n\n            if (this.options.tagPolicy === TAG_HANDLE)\n            {\n                throw this.NodeError(node, `custom tag \"${tag}\" has no explicit handler`);\n            }\n\n            if (this.options.tagPolicy === TAG_PRESERVE || tag === PYTHON_PROJECTED_DECAL || tag === PYTHON_PART_METADATA)\n            {\n                const wrapper = { [this.options.tagField]: tag };\n                memo.set(node, wrapper);\n                wrapper[this.options.valueField] = this.ConvertBase(node, memo, false);\n                return wrapper;\n            }\n        }\n\n        return this.ConvertBase(node, memo, true);\n    }\n\n    ConvertBase(node, memo, memoize)\n    {\n        if (isScalar(node)) return node.value;\n\n        if (isSeq(node))\n        {\n            const out = [];\n            if (memoize) memo.set(node, out);\n            for (const item of node.items) out.push(this.Convert(item, memo));\n            return out;\n        }\n\n        if (isMap(node))\n        {\n            const out = {};\n            if (memoize) memo.set(node, out);\n            for (const pair of node.items)\n            {\n                const key = this.MapKey(pair.key);\n                if (this.options.uniqueKeys && Object.prototype.hasOwnProperty.call(out, key))\n                {\n                    throw this.NodeError(pair.key, `duplicate mapping key \"${key}\"`);\n                }\n                // Defining the property prevents keys such as \"__proto__\" from\n                // mutating the result object's prototype.\n                defineMappingValue(out, key, this.Convert(pair.value, memo));\n            }\n            return out;\n        }\n\n        throw this.NodeError(node, \"unsupported YAML node\");\n    }\n\n    MapKey(node)\n    {\n        if (!isScalar(node)) throw this.NodeError(node, \"mapping keys must be scalar values\");\n        return String(node.value);\n    }\n\n    CustomTag(node)\n    {\n        const tag = canonicalTag(node.tag);\n        return tag && !STANDARD_TAGS.has(tag) ? tag : null;\n    }\n\n    AssertTagAllowed(tag, node)\n    {\n        if (!this.options.allowedTags) return;\n        const allowed = new Set(this.options.allowedTags.map(canonicalTag));\n        if (!allowed.has(tag)) throw this.NodeError(node, `custom tag \"${tag}\" is not in allowedTags`);\n    }\n\n    FindTagHandler(tag)\n    {\n        const handlers = this.options.tagHandlers;\n        const short = tag.startsWith(TAG_PREFIX) ? `!!${tag.slice(TAG_PREFIX.length)}` : tag;\n        if (handlers instanceof Map) return handlers.get(tag) || handlers.get(short) || null;\n        return handlers[tag] || handlers[short] || null;\n    }\n\n    TagContext(tag, node)\n    {\n        return {\n            tag,\n            sourceName: this.options.sourceName,\n            location: this.TagLocation(node)\n        };\n    }\n\n    NodeError(node, message)\n    {\n        const at = node && node.tag ? this.TagLocation(node) : this.Location(node);\n        const source = this.options.sourceName ? `${this.options.sourceName}:` : \"\";\n        const where = at ? `${source}${at.line}:${at.column}` : (this.options.sourceName || \"YAML input\");\n        const error = new Error(`CjsYamlFormat ${where}: ${message}`);\n        error.code = \"YAML_TAG_POLICY\";\n        error.location = at;\n        return error;\n    }\n\n    Location(node)\n    {\n        if (!node || !Array.isArray(node.range)) return null;\n        const pos = this.lineCounter.linePos(node.range[0]);\n        return { offset: node.range[0], line: pos.line, column: pos.col };\n    }\n\n    TagLocation(node)\n    {\n        const fallback = this.Location(node);\n        if (!fallback || !node.tag) return fallback;\n\n        const lineStart = this.source.lastIndexOf(\"\\n\", node.range[0] - 1) + 1;\n        const prefix = this.source.slice(lineStart, node.range[0]);\n        const tags = [ ...prefix.matchAll(/!<[^>]+>|!!?[^\\s[\\]{},]+/g) ];\n        const match = tags[tags.length - 1];\n        if (!match) return fallback;\n\n        const offset = lineStart + match.index;\n        const pos = this.lineCounter.linePos(offset);\n        return { offset, line: pos.line, column: pos.col };\n    }\n\n    DescribeError(error)\n    {\n        const linePos = error && error.linePos && error.linePos[0];\n        return {\n            code: error && error.code ? error.code : \"YAML_ERROR\",\n            message: displayMessage(error),\n            location: error && error.location ? error.location : (linePos ? {\n                line: linePos.line,\n                column: linePos.col\n            } : null)\n        };\n    }\n\n    BuildInventory()\n    {\n        const tags = [];\n        const anchors = [];\n        const aliases = [];\n\n        visit(this.document, (_key, node) =>\n        {\n            if (!node || typeof node !== \"object\") return;\n            const tag = this.CustomTag(node);\n            const location = tag ? this.TagLocation(node) : this.Location(node);\n            if (tag) tags.push({ tag, kind: this.NodeKind(node), location });\n            if (node.anchor) anchors.push({ name: node.anchor, kind: this.NodeKind(node), location });\n            if (isAlias(node)) aliases.push({ name: node.source, location });\n        });\n\n        return {\n            tags,\n            anchors,\n            aliases,\n            warnings: this.document.warnings.map(error => this.DescribeError(error)),\n            errors: this.document.errors.map(error => this.DescribeError(error))\n        };\n    }\n\n    NodeKind(node)\n    {\n        if (isMap(node)) return \"mapping\";\n        if (isSeq(node)) return \"sequence\";\n        if (isScalar(node)) return \"scalar\";\n        if (isAlias(node)) return \"alias\";\n        return \"unknown\";\n    }\n}\n\nexport default CjsYamlReader;\n"],"names":["TAG_PREFIX","PYTHON_TUPLE","PYTHON_UNICODE","PYTHON_PROJECTED_DECAL","PYTHON_PART_METADATA","STANDARD_TAGS","Set","map","name","canonicalTag","tag","startsWith","slice","displayMessage","error","String","message","trim","defineMappingValue","target","key","value","Object","defineProperty","enumerable","configurable","writable","CjsYamlReader","CjsReader","constructor","input","options","TypeError","source","lineCounter","LineCounter","document","parseDocument","keepSourceTokens","prettyErrors","strict","uniqueKeys","inventory","BuildInventory","Read","ReadPayload","toJsonGraph","ReadRaw","AssertSyntax","AssertAliasLimit","Convert","contents","Map","ReadDocument","errors","length","push","DescribeError","format","id","sourceName","root","kind","RootKind","tags","anchors","aliases","warnings","Inspect","node","isMap","isSeq","isScalar","isAlias","first","SyntaxError","maxAliasCount","RangeError","memo","undefined","resolve","NodeError","has","get","CustomTag","AssertTagAllowed","handler","FindTagHandler","ConvertBase","handled","TagContext","set","tagPolicy","TAG_REJECT","TAG_HANDLE","TAG_PRESERVE","wrapper","tagField","valueField","memoize","out","item","items","pair","MapKey","prototype","hasOwnProperty","call","allowedTags","allowed","handlers","tagHandlers","short","location","TagLocation","at","Location","where","line","column","Error","code","Array","isArray","range","pos","linePos","offset","col","fallback","lineStart","lastIndexOf","prefix","matchAll","match","index","visit","_key","NodeKind","anchor"],"mappings":"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"}
+{"version":3,"file":"CjsYamlReader.js","sources":["../../../../../src/formats/yaml/core/CjsYamlReader.js"],"sourcesContent":["import {\n    LineCounter,\n    isAlias,\n    isMap,\n    isScalar,\n    isSeq,\n    parseDocument,\n    visit\n} from \"yaml\";\n\nimport { CjsReader } from \"../../../format/CjsReader.js\";\nimport { TAG_HANDLE, TAG_PRESERVE, TAG_REJECT, toJsonGraph } from \"./helpers.js\";\n\nconst TAG_PREFIX = \"tag:yaml.org,2002:\";\nconst PYTHON_TUPLE = `${TAG_PREFIX}python/tuple`;\nconst PYTHON_UNICODE = `${TAG_PREFIX}python/unicode`;\nconst PYTHON_PROJECTED_DECAL = `${TAG_PREFIX}python/object:paperDoll.ProjectedDecal`;\nconst PYTHON_PART_METADATA = `${TAG_PREFIX}python/object:paperDoll.AvatarPartMetaData`;\n\nconst STANDARD_TAGS = new Set([\n    \"binary\", \"bool\", \"float\", \"int\", \"map\", \"merge\", \"null\", \"omap\",\n    \"pairs\", \"seq\", \"set\", \"str\", \"timestamp\"\n].map(name => `${TAG_PREFIX}${name}`));\n\nfunction canonicalTag(tag)\n{\n    if (typeof tag !== \"string\") return tag;\n    if (tag.startsWith(\"!!\")) return `${TAG_PREFIX}${tag.slice(2)}`;\n    return tag;\n}\n\nfunction displayMessage(error)\n{\n    return String(error && error.message ? error.message : error).trim();\n}\n\nfunction defineMappingValue(target, key, value)\n{\n    Object.defineProperty(target, key, {\n        value,\n        enumerable: true,\n        configurable: true,\n        writable: true\n    });\n}\n\n/**\n * Construction-bound reader that parses one YAML source with the `yaml`\n * library and produces the format's payload, raw, or document graphs while\n * enforcing tag policy and alias limits.\n */\nexport class CjsYamlReader extends CjsReader\n{\n    constructor(input, options = {})\n    {\n        super(options);\n\n        if (typeof input !== \"string\")\n        {\n            throw new TypeError(\"CjsYamlFormat input must be a YAML string\");\n        }\n\n        this.source = input;\n        this.lineCounter = new LineCounter();\n        this.document = parseDocument(input, {\n            keepSourceTokens: true,\n            lineCounter: this.lineCounter,\n            prettyErrors: true,\n            strict: true,\n            uniqueKeys: this.options.uniqueKeys\n        });\n        this.inventory = this.BuildInventory();\n    }\n\n    Read()\n    {\n        return this.ReadPayload();\n    }\n\n    ReadPayload()\n    {\n        return toJsonGraph(this.ReadRaw(), this.options);\n    }\n\n    ReadRaw()\n    {\n        this.AssertSyntax();\n        this.AssertAliasLimit();\n        return this.Convert(this.document.contents, new Map());\n    }\n\n    ReadDocument()\n    {\n        let value = null;\n        const errors = this.inventory.errors.slice();\n\n        if (!errors.length)\n        {\n            try\n            {\n                this.AssertAliasLimit();\n                value = this.Convert(this.document.contents, new Map());\n            }\n            catch (error)\n            {\n                errors.push(this.DescribeError(error));\n            }\n        }\n\n        return {\n            format: { id: \"yaml\" },\n            source: { name: this.options.sourceName, length: this.source.length },\n            root: { kind: this.RootKind() },\n            value,\n            tags: this.inventory.tags,\n            anchors: this.inventory.anchors,\n            aliases: this.inventory.aliases,\n            warnings: this.inventory.warnings,\n            errors\n        };\n    }\n\n    Inspect()\n    {\n        return {\n            format: { id: \"yaml\" },\n            source: { name: this.options.sourceName, length: this.source.length },\n            root: { kind: this.RootKind() },\n            tags: this.inventory.tags,\n            anchors: this.inventory.anchors,\n            aliases: this.inventory.aliases,\n            warnings: this.inventory.warnings,\n            errors: this.inventory.errors\n        };\n    }\n\n    RootKind()\n    {\n        const node = this.document.contents;\n        if (node === null) return \"null\";\n        if (isMap(node)) return \"mapping\";\n        if (isSeq(node)) return \"sequence\";\n        if (isScalar(node)) return \"scalar\";\n        if (isAlias(node)) return \"alias\";\n        return \"unknown\";\n    }\n\n    AssertSyntax()\n    {\n        if (!this.document.errors.length) return;\n        const first = this.document.errors[0];\n        const source = this.options.sourceName ? ` in ${this.options.sourceName}` : \"\";\n        throw new SyntaxError(`CjsYamlFormat${source}: ${displayMessage(first)}`);\n    }\n\n    AssertAliasLimit()\n    {\n        if (this.inventory.aliases.length <= this.options.maxAliasCount) return;\n        const source = this.options.sourceName ? ` in ${this.options.sourceName}` : \"\";\n        throw new RangeError(`CjsYamlFormat${source}: alias count ${this.inventory.aliases.length} exceeds maxAliasCount ${this.options.maxAliasCount}`);\n    }\n\n    Convert(node, memo)\n    {\n        if (node === null || node === undefined) return null;\n\n        if (isAlias(node))\n        {\n            const source = node.resolve(this.document);\n            if (!source) throw this.NodeError(node, `unresolved alias \"${node.source}\"`);\n            return this.Convert(source, memo);\n        }\n\n        if (memo.has(node)) return memo.get(node);\n\n        const tag = this.CustomTag(node);\n        if (tag)\n        {\n            this.AssertTagAllowed(tag, node);\n            const handler = this.FindTagHandler(tag);\n\n            if (handler)\n            {\n                const value = this.ConvertBase(node, memo, true);\n                const handled = handler(value, this.TagContext(tag, node));\n                memo.set(node, handled);\n                return handled;\n            }\n\n            if (tag === PYTHON_TUPLE)\n            {\n                if (!isSeq(node)) throw this.NodeError(node, `${tag} must decorate a sequence`);\n                return this.ConvertBase(node, memo, true);\n            }\n\n            if (tag === PYTHON_UNICODE)\n            {\n                if (!isScalar(node) || typeof node.value !== \"string\")\n                {\n                    throw this.NodeError(node, `${tag} must decorate a string scalar`);\n                }\n                return node.value;\n            }\n\n            if (this.options.tagPolicy === TAG_REJECT)\n            {\n                throw this.NodeError(node, `custom tag \"${tag}\" is rejected by tagPolicy`);\n            }\n\n            if (this.options.tagPolicy === TAG_HANDLE)\n            {\n                throw this.NodeError(node, `custom tag \"${tag}\" has no explicit handler`);\n            }\n\n            if (this.options.tagPolicy === TAG_PRESERVE || tag === PYTHON_PROJECTED_DECAL || tag === PYTHON_PART_METADATA)\n            {\n                const wrapper = { [this.options.tagField]: tag };\n                memo.set(node, wrapper);\n                wrapper[this.options.valueField] = this.ConvertBase(node, memo, false);\n                return wrapper;\n            }\n        }\n\n        return this.ConvertBase(node, memo, true);\n    }\n\n    ConvertBase(node, memo, memoize)\n    {\n        if (isScalar(node)) return node.value;\n\n        if (isSeq(node))\n        {\n            const out = [];\n            if (memoize) memo.set(node, out);\n            for (const item of node.items) out.push(this.Convert(item, memo));\n            return out;\n        }\n\n        if (isMap(node))\n        {\n            const out = {};\n            if (memoize) memo.set(node, out);\n            for (const pair of node.items)\n            {\n                const key = this.MapKey(pair.key);\n                if (this.options.uniqueKeys && Object.prototype.hasOwnProperty.call(out, key))\n                {\n                    throw this.NodeError(pair.key, `duplicate mapping key \"${key}\"`);\n                }\n                // Defining the property prevents keys such as \"__proto__\" from\n                // mutating the result object's prototype.\n                defineMappingValue(out, key, this.Convert(pair.value, memo));\n            }\n            return out;\n        }\n\n        throw this.NodeError(node, \"unsupported YAML node\");\n    }\n\n    MapKey(node)\n    {\n        if (!isScalar(node)) throw this.NodeError(node, \"mapping keys must be scalar values\");\n        return String(node.value);\n    }\n\n    CustomTag(node)\n    {\n        const tag = canonicalTag(node.tag);\n        return tag && !STANDARD_TAGS.has(tag) ? tag : null;\n    }\n\n    AssertTagAllowed(tag, node)\n    {\n        if (!this.options.allowedTags) return;\n        const allowed = new Set(this.options.allowedTags.map(canonicalTag));\n        if (!allowed.has(tag)) throw this.NodeError(node, `custom tag \"${tag}\" is not in allowedTags`);\n    }\n\n    FindTagHandler(tag)\n    {\n        const handlers = this.options.tagHandlers;\n        const short = tag.startsWith(TAG_PREFIX) ? `!!${tag.slice(TAG_PREFIX.length)}` : tag;\n        if (handlers instanceof Map) return handlers.get(tag) || handlers.get(short) || null;\n        return handlers[tag] || handlers[short] || null;\n    }\n\n    TagContext(tag, node)\n    {\n        return {\n            tag,\n            sourceName: this.options.sourceName,\n            location: this.TagLocation(node)\n        };\n    }\n\n    NodeError(node, message)\n    {\n        const at = node && node.tag ? this.TagLocation(node) : this.Location(node);\n        const source = this.options.sourceName ? `${this.options.sourceName}:` : \"\";\n        const where = at ? `${source}${at.line}:${at.column}` : (this.options.sourceName || \"YAML input\");\n        const error = new Error(`CjsYamlFormat ${where}: ${message}`);\n        error.code = \"YAML_TAG_POLICY\";\n        error.location = at;\n        return error;\n    }\n\n    Location(node)\n    {\n        if (!node || !Array.isArray(node.range)) return null;\n        const pos = this.lineCounter.linePos(node.range[0]);\n        return { offset: node.range[0], line: pos.line, column: pos.col };\n    }\n\n    TagLocation(node)\n    {\n        const fallback = this.Location(node);\n        if (!fallback || !node.tag) return fallback;\n\n        const lineStart = this.source.lastIndexOf(\"\\n\", node.range[0] - 1) + 1;\n        const prefix = this.source.slice(lineStart, node.range[0]);\n        const tags = [ ...prefix.matchAll(/!<[^>]+>|!!?[^\\s[\\]{},]+/g) ];\n        const match = tags[tags.length - 1];\n        if (!match) return fallback;\n\n        const offset = lineStart + match.index;\n        const pos = this.lineCounter.linePos(offset);\n        return { offset, line: pos.line, column: pos.col };\n    }\n\n    DescribeError(error)\n    {\n        const linePos = error && error.linePos && error.linePos[0];\n        return {\n            code: error && error.code ? error.code : \"YAML_ERROR\",\n            message: displayMessage(error),\n            location: error && error.location ? error.location : (linePos ? {\n                line: linePos.line,\n                column: linePos.col\n            } : null)\n        };\n    }\n\n    BuildInventory()\n    {\n        const tags = [];\n        const anchors = [];\n        const aliases = [];\n\n        visit(this.document, (_key, node) =>\n        {\n            if (!node || typeof node !== \"object\") return;\n            const tag = this.CustomTag(node);\n            const location = tag ? this.TagLocation(node) : this.Location(node);\n            if (tag) tags.push({ tag, kind: this.NodeKind(node), location });\n            if (node.anchor) anchors.push({ name: node.anchor, kind: this.NodeKind(node), location });\n            if (isAlias(node)) aliases.push({ name: node.source, location });\n        });\n\n        return {\n            tags,\n            anchors,\n            aliases,\n            warnings: this.document.warnings.map(error => this.DescribeError(error)),\n            errors: this.document.errors.map(error => this.DescribeError(error))\n        };\n    }\n\n    NodeKind(node)\n    {\n        if (isMap(node)) return \"mapping\";\n        if (isSeq(node)) return \"sequence\";\n        if (isScalar(node)) return \"scalar\";\n        if (isAlias(node)) return \"alias\";\n        return \"unknown\";\n    }\n}\n\nexport default CjsYamlReader;\n"],"names":["TAG_PREFIX","PYTHON_TUPLE","PYTHON_UNICODE","PYTHON_PROJECTED_DECAL","PYTHON_PART_METADATA","STANDARD_TAGS","Set","map","name","canonicalTag","tag","startsWith","slice","displayMessage","error","String","message","trim","defineMappingValue","target","key","value","Object","defineProperty","enumerable","configurable","writable","CjsYamlReader","CjsReader","constructor","input","options","TypeError","source","lineCounter","LineCounter","document","parseDocument","keepSourceTokens","prettyErrors","strict","uniqueKeys","inventory","BuildInventory","Read","ReadPayload","toJsonGraph","ReadRaw","AssertSyntax","AssertAliasLimit","Convert","contents","Map","ReadDocument","errors","length","push","DescribeError","format","id","sourceName","root","kind","RootKind","tags","anchors","aliases","warnings","Inspect","node","isMap","isSeq","isScalar","isAlias","first","SyntaxError","maxAliasCount","RangeError","memo","undefined","resolve","NodeError","has","get","CustomTag","AssertTagAllowed","handler","FindTagHandler","ConvertBase","handled","TagContext","set","tagPolicy","TAG_REJECT","TAG_HANDLE","TAG_PRESERVE","wrapper","tagField","valueField","memoize","out","item","items","pair","MapKey","prototype","hasOwnProperty","call","allowedTags","allowed","handlers","tagHandlers","short","location","TagLocation","at","Location","where","line","column","Error","code","Array","isArray","range","pos","linePos","offset","col","fallback","lineStart","lastIndexOf","prefix","matchAll","match","index","visit","_key","NodeKind","anchor"],"mappings":"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"}

package/docs/README.md

@@ -60,8 +60,12 @@ packages realize that payload into backend objects.
   `Tr2TexturePipeline` CPU steps and `Tr2TextureLodManager` membership.
 - [reference/events.md](reference/events.md): the `CjsEventEmitter` contract
   and event memory rules.
+- [reference/classes/README.md](reference/classes/README.md): the searchable
+  one-sentence class-purpose catalog.
 - [formats/README.md](formats/README.md): format import map and per-format
   output notes.
+- [formats/gr2.md](formats/gr2.md): Granny GR2/GSF reading, output modes,
+  conversions, graph shape, and class hydration.
 - [formats/wwise.md](formats/wwise.md): Wwise soundbank and media readers.
 - [formats/stl.md](formats/stl.md): STL geometry export.
 - [formats/provenance.md](formats/provenance.md): format ownership, fork

package/docs/formats/README.md

@@ -57,9 +57,10 @@ retention without introducing a parallel DTO class hierarchy.
 | Wwise media (`.wem`) | `CjsWemFormat` | `@carbonenginejs/runtime-resource/formats/wem` |
 | YAML (`.yaml`/`.yml`) | `CjsYamlFormat` | `@carbonenginejs/runtime-resource/formats/yaml` |
 
-Detailed pages: [Wwise soundbanks and media](wwise.md),
-[STL export](stl.md). Ownership history, retained snapshots, and donor
-licensing are recorded in [provenance.md](provenance.md).
+Detailed pages: [Granny GR2 and GSF](gr2.md),
+[Wwise soundbanks and media](wwise.md), and [STL export](stl.md). Ownership
+history, retained snapshots, and donor licensing are recorded in
+[provenance.md](provenance.md).
 
 ## Granny GR2/GSF
 
@@ -69,9 +70,9 @@ Oodle1, and the clean-room BitKnit2 decoder), reflected type-tree walking,
 GR2 JSON emission, optional curve decompression, CCP packed tangent-frame
 unpacking, and caller-class hydration (`emit: "gr2"`/`"cmf"` with a
 `classes` map). It was migrated from `@carbonenginejs/format-gr2` after that
-package's 2026-07-24 MIT relicense; the frozen donor repository documents
-the reader API and JSON graph in detail, and this copy preserves its
-behavior and test surface.
+package's 2026-07-24 MIT relicense, preserving its behavior and test
+surface; [gr2.md](gr2.md) documents the reader API, output modes, graph
+shape, and hydration contract.
 
 ## Red output markers
 

package/docs/formats/gr2.md

@@ -0,0 +1,161 @@
+# Granny GR2 and GSF
+
+Status: Evolving  
+Scope: `@carbonenginejs/runtime-resource/formats/gr2`  
+Audience: Users and integrators  
+Summary: Defines the pure-JavaScript GR2/GSF reader, its output modes, conversion options, graph shape, and class-hydration boundary.
+
+## Purpose
+
+`CjsGr2Format` reads Granny 3D `.gr2` geometry, skeleton, animation, and
+morph-target data, plus Granny State `.gsf` profiles. It runs in Node and the
+browser without `granny2.dll`, native addons, a GPU, or private assets.
+
+The reader owns Granny container parsing, reflected type-tree walking, section
+decompression, JSON projection, optional curve and vertex-channel conversion,
+GSF projection, and caller-class hydration. Resource caching and publication
+remain with `CjsResMan`; GPU realization remains with engine packages.
+
+Supported section compression is None, Oodle1, and the in-project clean-room
+BitKnit2 decoder. Licensing and migration history are recorded in
+[format provenance](provenance.md).
+
+## Import and basic use
+
+Import the runtime-resource wrapper from its explicit format subpath:
+
+```js
+import { CjsGr2Format } from "@carbonenginejs/runtime-resource/formats/gr2";
+
+const graph = CjsGr2Format.read(bytes);
+const summary = CjsGr2Format.inspect(bytes);
+const asynchronousGraph = await CjsGr2Format.readAsync(bytes);
+```
+
+The wrapper exposes the normal runtime-resource format metadata and
+`isSupported(bytes)` magic probe. It also exports the migrated
+`CjsFormatGr2` reader engine for compatibility, but new consumers should use
+`CjsGr2Format`.
+
+Register it with `CjsResMan` when GR2/GSF should participate in ordinary
+resource loading:
+
+```js
+import { CjsResMan } from "@carbonenginejs/runtime-resource";
+import { CjsGr2Format } from "@carbonenginejs/runtime-resource/formats/gr2";
+
+const resMan = new CjsResMan().Register({
+  source,
+  formats: [ CjsGr2Format ]
+});
+
+const resource = resMan.GetResource("res:/model/ship.gr2");
+const graph = await resource.Ready();
+```
+
+Concrete formats are not imported or registered by the package root.
+
+## Output modes
+
+`emit` selects the representation:
+
+| Value | Result |
+|---|---|
+| `"json"` | Default stable GR2 graph with plain objects |
+| `"gr2Json"` | Explicit alias for the JSON graph |
+| `"gr2"` | GR2 graph hydrated with caller-supplied classes |
+| `"cmf"` | CMF-shaped graph hydrated with caller-supplied classes |
+| `"raw"` | Low-level reflected `granny_file_info` result |
+
+`"gr2"` and `"cmf"` require a non-empty `classes` map. Classes may also be
+supplied with `"json"`/`"gr2Json"` to hydrate selected JSON nodes while
+leaving omitted nodes as plain objects.
+
+## Conversion options
+
+| Option | Default | Effect |
+|---|---:|---|
+| `decompressCurves` | `false` | Adds decoded `knots`, `controls`, and `dimension` to supported compressed animation curves while retaining the raw curve fields |
+| `unpackTangents` | `false` | Converts packed CCP tangent frames into separate normal, tangent, and binormal channels |
+| `rebuildMissingNormals` | `false` | Generates absent normals from positions and triangle indices |
+| `rebuildMissingTangents` | `false` | Generates absent tangents from positions, normals, UVs, and triangle indices |
+| `rebuildMissingBiNormals` | `false` | Generates absent binormals from normals and tangents |
+| `classes` | `{}` | Maps supported graph node keys to constructors |
+
+Tangent unpacking and missing-channel rebuild options may be functions when a
+caller needs per-mesh policy. Rebuild options fill absent data; they do not
+repair authored channels that are present but incorrect.
+
+A reusable reader profile can hold these defaults:
+
+```js
+const reader = new CjsGr2Format({
+  decompressCurves: true,
+  unpackTangents: true
+});
+
+const first = reader.Read(firstBytes);
+const second = reader.Read(secondBytes);
+```
+
+## JSON graph and hydration
+
+The default graph has this general shape:
+
+```text
+Root
+|-- grannyFileFormatRevision, grannyFileSource
+|-- meshes
+|   |-- boneBindings, morphTargets
+|   |-- vertex: flat numeric channels
+|   `-- indices: triangle index groups
+|-- models
+|   `-- skeleton -> bones
+`-- animations
+    `-- trackGroups -> transformTracks -> curves
+```
+
+Vertex channels include positions, normals, tangents, binormals, UVs, blend
+indices, and blend weights when available. `IndexGroup.faces` is a flat array
+of triangle indices. Sparse morph targets carry `vertexIndices`; native and
+annotation-set morph targets share the same projected shape.
+
+For each registered class key, hydration constructs the class without
+arguments and calls:
+
+```js
+new Class().SetValues(nodeFields);
+```
+
+Constructors must therefore support zero-argument construction and
+`SetValues(values)`. Supported GR2 and CMF keys are exposed through
+`CjsGr2Format.CLASS_KEYS`; use `SetClass`, `SetClasses`, `GetClass`, and
+`HasClass` on reusable reader instances.
+
+`ToJSON(value)` and static `toJSON(value)` convert hydrated output into a
+JSON-compatible value. They do not write a binary `.gr2` file or return JSON
+text.
+
+## Granny State
+
+GSF uses the ordinary Granny container with a GState root schema. The reader
+provides dedicated classification, projection, and inspection:
+
+```js
+if (CjsGr2Format.isGsf(bytes)) {
+  const state = CjsGr2Format.readGsf(bytes);
+  const dependencies = CjsGr2Format.inspectGsf(bytes);
+}
+```
+
+The stable GSF projection contains container revision data, model and
+retarget hints, the state machine, animation slots and sets, referenced
+relative `.gr2` files, token count, editor data, and extended data.
+`readGsfAsync` provides the equivalent promise-facing entry point.
+
+## Related documentation
+
+- [Format subpaths](README.md)
+- [Architecture and boundaries](../architecture.md)
+- [Resource lifecycle](../concepts/resource-lifecycle.md)
+- [Format ownership and provenance](provenance.md)

package/docs/reference/classes/README.md

@@ -0,0 +1,33 @@
+# Class catalog
+
+Status: Evolving  
+Scope: `@carbonenginejs/runtime-resource` classes  
+Audience: Users, maintainers, and automated readers  
+Summary: Indexes the one-sentence purpose descriptors for every maintained class in the package.
+
+## Purpose
+
+Every maintained class carries exactly one catalog entry with a stable HTML
+marker, so a class can be located with an exact low-cost search:
+
+```sh
+rg 'class:CjsResMan' docs/reference/classes
+```
+
+Entries record a one-sentence responsibility plus Export, Source, Visibility,
+and Kind metadata. The catalog is an index, not a replacement for the API
+reference or source documentation, and it is validated by the shared
+documentation check against the actual source tree.
+
+## Catalog pages
+
+- [core.md](core.md): the resource manager, MotherLode cache, resource and
+  source classes, and the format/probe bases.
+- [resources.md](resources.md): the Carbon-shaped semantic resource and data
+  classes under `src/resources`.
+- [texture.md](texture.md): texture-array aggregation classes under
+  `src/texture`.
+- [formats.md](formats.md): format entry classes and their internal reader
+  machinery under `src/formats`.
+- [dropped.md](dropped.md): retained native shapes under `src/dropped` that
+  are documented but never exported or bundled.

package/docs/reference/classes/core.md

@@ -0,0 +1,106 @@
+# Core class catalog
+
+Status: Evolving  
+Scope: `@carbonenginejs/runtime-resource` classes under `src/` and `src/format/`  
+Audience: Users, maintainers, and automated readers  
+Summary: Provides one-sentence purpose descriptors for the resource manager, registry, resource, source, and format/probe base classes.
+
+<!-- class:CjsMotherLode -->
+## `CjsMotherLode`
+
+Strong, deterministic resource registry that owns canonical path/variant identities and evicts entries only through explicit ownership removal, inactivity sweeps, or recorded-byte cache trimming, replacing Carbon's weak-live/strong-cache ownership transition.
+
+- Export: `@carbonenginejs/runtime-resource`
+- Source: `src/CjsMotherLode.js`
+- Visibility: Public
+- Kind: Adapted Carbon concept
+
+<!-- class:CjsResMan -->
+## `CjsResMan`
+
+GPU-free resource manager that resolves paths through registered sources and formats, publishes canonical resources into a `CjsMotherLode` registry under exact-owner generation guards, and drives the main/background work queues, read-operation caching, reload staging, and automatic purge policy.
+
+- Export: `@carbonenginejs/runtime-resource`
+- Source: `src/CjsResMan.js`
+- Visibility: Public
+- Kind: Adapted Carbon concept
+
+<!-- class:CjsResManWorkQueue -->
+## `CjsResManWorkQueue`
+
+Small FIFO executor used inside `CjsResMan` that tracks item ids, pause state, concurrency, cancellation, and sync/async completion while queue policy stays in the manager.
+
+- Export: None
+- Source: `src/CjsResManQueue.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:CjsResource -->
+## `CjsResource`
+
+Base runtime resource handle that carries normalized path/extension/requirement identity, load state, and an attached CPU payload, with manager lifecycle callbacks supplied by `CjsResMan` after canonical insertion.
+
+- Export: `@carbonenginejs/runtime-resource`
+- Source: `src/CjsResource.js`
+- Visibility: Public
+- Kind: Adapted Carbon concept
+
+<!-- class:CjsMemoryResourceSource -->
+## `CjsMemoryResourceSource`
+
+In-memory resource source that maps normalized resource paths to preset values and serves them to reads without any I/O.
+
+- Export: `@carbonenginejs/runtime-resource`
+- Source: `src/CjsResourceSource.js`
+- Visibility: Public
+- Kind: Original CarbonEngineJS class
+
+<!-- class:CjsFetchResourceSource -->
+## `CjsFetchResourceSource`
+
+Resource source that resolves a normalized path against an optional base URL and reads response bytes through an injected fetch implementation.
+
+- Export: `@carbonenginejs/runtime-resource`
+- Source: `src/CjsResourceSource.js`
+- Visibility: Public
+- Kind: Original CarbonEngineJS class
+
+<!-- class:CjsBlueReader -->
+## `CjsBlueReader`
+
+Shared output and hydration backend for Blue persistence readers that owns common payload/runtime targets, reference emission, hydration adapter phases, reports, finalization, and schema-descriptor helpers, while transports keep framing and member decoding.
+
+- Export: None
+- Source: `src/format/CjsBlueReader.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:CjsFormat -->
+## `CjsFormat`
+
+Base class for format readers that defines the static `read`/`readAsync`/`isSupported`/`resolveType` contract and instance option handling that concrete format packages implement.
+
+- Export: `@carbonenginejs/runtime-resource`
+- Source: `src/format/CjsFormat.js`
+- Visibility: Public
+- Kind: Original CarbonEngineJS class
+
+<!-- class:CjsReader -->
+## `CjsReader`
+
+Internal base for construction-bound readers that are created for one source and dropped after use, relying on garbage collection instead of explicit dispose/clear cleanup.
+
+- Export: None
+- Source: `src/format/CjsReader.js`
+- Visibility: Internal
+- Kind: Internal implementation class
+
+<!-- class:CjsResourceProbe -->
+## `CjsResourceProbe`
+
+Standard probe-report model that formats return from inspection, recording support status, content-verification state, confidence, preferred route, capability variants, warnings, and errors without choosing an engine or media backend.
+
+- Export: `@carbonenginejs/runtime-resource`
+- Source: `src/format/CjsResourceProbe.js`
+- Visibility: Public
+- Kind: Original CarbonEngineJS class

package/docs/reference/classes/dropped.md

@@ -0,0 +1,46 @@
+# Dropped class catalog
+
+Status: Evolving  
+Scope: `@carbonenginejs/runtime-resource` classes under `src/dropped`  
+Audience: Users, maintainers, and automated readers  
+Summary: Provides one-sentence purpose descriptors for retained-only Carbon reference shapes that are never exported or bundled.
+
+<!-- class:CmfVertexReader -->
+## `CmfVertexReader`
+
+Retained-only reference shape mirroring Carbon's CMF vertex-element pointer-lookup helper, superseded by the JavaScript CMF format's channel decoding.
+
+- Export: None
+- Source: `src/dropped/CmfVertexReader.js`
+- Visibility: Internal
+- Kind: Faithful Carbon port
+
+<!-- class:Tr2AsyncSave -->
+## `Tr2AsyncSave`
+
+Retained-only reference shape mirroring Carbon's abstract prepare/save callback base, superseded by promise-based format `Write`/`WriteAsync` operations and resource-level save-status compatibility methods.
+
+- Export: None
+- Source: `src/dropped/Tr2AsyncSave.js`
+- Visibility: Internal
+- Kind: Faithful Carbon port
+
+<!-- class:Tr2CmfContents -->
+## `Tr2CmfContents`
+
+Retained-only reference shape mirroring Carbon's native CMF section lifetime and decompression holder, superseded by `CjsCmfFormat`'s bounded section access and typed-array data.
+
+- Export: None
+- Source: `src/dropped/Tr2CmfContents.js`
+- Visibility: Internal
+- Kind: Faithful Carbon port
+
+<!-- class:Tr2LoadPrepareFence -->
+## `Tr2LoadPrepareFence`
+
+Retained-only reference shape mirroring Carbon's two-queue load/prepare fence helper, superseded by the snapshot-fence contract owned by `CjsResMan.Wait()`.
+
+- Export: None
+- Source: `src/dropped/Tr2LoadPrepareFence.js`
+- Visibility: Internal
+- Kind: Faithful Carbon port