@office-open/core 0.9.3 → 0.9.5

package/dist/descriptor-57JUzfpG.mjs

@@ -1,282 +0,0 @@
-import { children, escapeXml, findChild, textOf } from "@office-open/xml";
-//#region src/descriptor/builder.ts
-function element$1(tag) {
-	return new DescriptorBuilder(tag);
-}
-var DescriptorBuilder = class {
-	_tag;
-	_attrs = [];
-	_content = [];
-	constructor(tag) {
-		this._tag = tag;
-	}
-	/** Add an attribute mapping. */
-	attr(key, xmlName, opts) {
-		this._attrs.push({
-			kind: "child",
-			key,
-			xmlName,
-			...opts
-		});
-		return this;
-	}
-	/** Add a single child element mapping. */
-	child(key, tag, desc) {
-		this._content.push({
-			kind: "child",
-			key,
-			tag,
-			desc
-		});
-		return this;
-	}
-	/** Add a repeating child element mapping. */
-	children(key, tag, desc) {
-		this._content.push({
-			kind: "children",
-			key,
-			tag,
-			desc
-		});
-		return this;
-	}
-	/** Add a union (one-of-several) child mapping. */
-	union(key, variants) {
-		this._content.push({
-			kind: "union",
-			key,
-			variants
-		});
-		return this;
-	}
-	/** Add a text content mapping. */
-	text(key) {
-		this._content.push({
-			kind: "text",
-			key
-		});
-		return this;
-	}
-	/** Add a custom content handler. */
-	custom(spec) {
-		this._content.push(spec);
-		return this;
-	}
-	/** Build the immutable ElementDescriptor. */
-	build() {
-		const result = {
-			kind: "element",
-			tag: this._tag
-		};
-		if (this._attrs.length) result.attrs = Object.freeze(this._attrs);
-		if (this._content.length) result.content = Object.freeze(this._content);
-		return Object.freeze(result);
-	}
-};
-//#endregion
-//#region src/descriptor/runtime.ts
-/**
-* Descriptor runtime: stringify (write) and parse (parse path) functions.
-*
-* Write path: Options → stringify(desc, opts, ctx) → string
-* Parse path: Element → parse(desc, el, ctx) → Partial<Options>
-*
-* No intermediate representation — each path is a single step.
-*
-* @module
-*/
-/**
-* Serialize an Options object to an XML string using its descriptor.
-* Returns `undefined` when an optional element should be omitted.
-*/
-function stringify(desc, value, ctx) {
-	if (desc.kind === "custom") return desc.stringify(value, ctx);
-	return stringifyElement(desc, value, ctx);
-}
-function stringifyElement(desc, value, ctx) {
-	const tag = desc.tag;
-	const attrStr = stringifyAttrs(desc.attrs, value);
-	let hasContent = false;
-	const parts = [];
-	if (desc.content) for (let i = 0; i < desc.content.length; i++) {
-		const spec = desc.content[i];
-		const s = stringifyContentSpec(spec, value, ctx);
-		if (s !== void 0) {
-			hasContent = true;
-			parts.push(s);
-		}
-	}
-	if (!hasContent) {
-		if (!attrStr) return void 0;
-		return `<${tag}${attrStr}/>`;
-	}
-	parts.unshift(`<${tag}${attrStr}>`);
-	parts.push(`</${tag}>`);
-	return parts.join("");
-}
-function stringifyAttrs(attrs, value) {
-	if (!attrs) return "";
-	const parts = [];
-	for (let i = 0; i < attrs.length; i++) {
-		const spec = attrs[i];
-		const raw = value[spec.key];
-		if (raw === void 0) continue;
-		if (spec.default !== void 0 && raw === spec.default) continue;
-		const encoded = spec.encode ? spec.encode(raw) : typeof raw === "string" || typeof raw === "number" || typeof raw === "boolean" ? String(raw) : String(raw);
-		if (encoded === void 0) continue;
-		parts.push(`${spec.xmlName}="${escapeXml(encoded)}"`);
-	}
-	return parts.length ? " " + parts.join(" ") : "";
-}
-function stringifyContentSpec(spec, value, ctx) {
-	switch (spec.kind) {
-		case "child": return stringifyChild(spec, value, ctx);
-		case "children": return stringifyChildren(spec, value, ctx);
-		case "union": return stringifyUnion(spec, value, ctx);
-		case "text": return stringifyText(spec, value);
-		case "custom": return stringifyCustom(spec, value, ctx);
-	}
-}
-function stringifyChild(spec, value, ctx) {
-	const childValue = value[spec.key];
-	if (childValue === void 0 || childValue === null) return void 0;
-	return stringify(spec.desc, childValue, ctx);
-}
-function stringifyChildren(spec, value, ctx) {
-	const items = value[spec.key];
-	if (!items || items.length === 0) return void 0;
-	const parts = [];
-	for (let i = 0; i < items.length; i++) {
-		const s = stringify(spec.desc, items[i], ctx);
-		if (s !== void 0) parts.push(s);
-	}
-	return parts.length ? parts.join("") : void 0;
-}
-function stringifyUnion(spec, value, ctx) {
-	const childValue = value[spec.key];
-	if (childValue === void 0 || childValue === null) return void 0;
-	const variants = spec.variants;
-	for (let i = 0; i < variants.length; i++) {
-		const v = variants[i];
-		if (v.match(childValue)) return stringify(v.desc, childValue, ctx);
-	}
-}
-function stringifyText(spec, value) {
-	const text = value[spec.key];
-	if (text === void 0 || text === null) return void 0;
-	return escapeXml(typeof text === "string" ? text : String(text));
-}
-function stringifyCustom(spec, value, ctx) {
-	return spec.stringify(value, ctx);
-}
-/**
-* Parse an XML Element into an Options object using its descriptor.
-*/
-function parse(desc, el, ctx) {
-	if (desc.kind === "custom") return desc.parse(el, ctx);
-	return parseElement(desc, el, ctx);
-}
-function parseElement(desc, el, ctx) {
-	const result = {};
-	if (desc.attrs && el.attributes) for (let i = 0; i < desc.attrs.length; i++) {
-		const spec = desc.attrs[i];
-		const raw = el.attributes[spec.xmlName];
-		if (raw !== void 0) result[spec.key] = spec.decode ? spec.decode(String(raw)) : raw;
-	}
-	if (desc.content) for (let i = 0; i < desc.content.length; i++) {
-		const spec = desc.content[i];
-		parseContentSpec(spec, el, ctx, result);
-	}
-	return result;
-}
-function parseContentSpec(spec, el, ctx, result) {
-	switch (spec.kind) {
-		case "child": {
-			const child = findChild(el, spec.tag);
-			if (child) result[spec.key] = parse(spec.desc, child, ctx);
-			break;
-		}
-		case "children": {
-			const items = children(el, spec.tag);
-			if (items.length) result[spec.key] = items.map((c) => parse(spec.desc, c, ctx));
-			break;
-		}
-		case "union":
-			for (let i = 0; i < spec.variants.length; i++) {
-				const v = spec.variants[i];
-				const child = findChild(el, v.tag);
-				if (child) {
-					result[spec.key] = parse(v.desc, child, ctx);
-					break;
-				}
-			}
-			break;
-		case "text": {
-			const text = textOf(el);
-			if (text) result[spec.key] = text;
-			break;
-		}
-		case "custom":
-			Object.assign(result, spec.parse(el, ctx));
-			break;
-	}
-}
-//#endregion
-//#region src/descriptor/helpers.ts
-/**
-* OOXML-specific encode/decode helpers for descriptors.
-*
-* XML traversal helpers (findChild, etc.) are in @office-open/xml utils.
-* This file only contains OOXML value encoding/decoding.
-*
-* @module
-*/
-/** Encode boolean for CT_OnOff: true → omit val, false → "0". */
-const boolEncode = (v) => {
-	if (v === void 0) return void 0;
-	return v ? void 0 : "0";
-};
-/** Decode CT_OnOff: absent or "true"/"1" → true, "0"/"false" → false. */
-const boolDecode = (raw) => raw !== "0" && raw !== "false";
-/** Create an enum encoder from a JS↔XML mapping. */
-const enumEncode = (map) => (v) => {
-	if (v === void 0) return void 0;
-	return map[v] ?? v;
-};
-/** Create an enum decoder from a JS↔XML mapping (inverted). */
-const enumDecode = (map) => {
-	const inv = invertRecord(map);
-	return (raw) => inv[raw] ?? raw;
-};
-function invertRecord(map) {
-	const result = {};
-	for (const key of Object.keys(map)) result[map[key]] = key;
-	return result;
-}
-//#endregion
-//#region src/descriptor/registry.ts
-var DescriptorRegistry = class DescriptorRegistry {
-	static _map = /* @__PURE__ */ new Map();
-	/** Register a descriptor with its XML tag. */
-	static register(tag, desc) {
-		DescriptorRegistry._map.set(tag, desc);
-	}
-	/** Look up a descriptor by XML tag. */
-	static get(tag) {
-		return DescriptorRegistry._map.get(tag);
-	}
-	/** Get all registered tags. */
-	static tags() {
-		return new Set(DescriptorRegistry._map.keys());
-	}
-	/** Check if a tag is registered. */
-	static has(tag) {
-		return DescriptorRegistry._map.has(tag);
-	}
-	/** Get the number of registered descriptors. */
-	static get size() {
-		return DescriptorRegistry._map.size;
-	}
-};
-//#endregion
-export { enumEncode as a, DescriptorBuilder as c, enumDecode as i, element$1 as l, boolDecode as n, parse as o, boolEncode as r, stringify as s, DescriptorRegistry as t };

package/dist/index-D81RV9Vc.d.mts

@@ -1,153 +0,0 @@
-import { Element } from "@office-open/xml";
-
-//#region src/descriptor/context.d.ts
-/** Context passed during stringify (write path). */
-interface WriteContext {
-  /** Register a relationship and return its rId. */
-  addRelationship(type: string, target: string, mode?: string): string;
-  /** Add a media file and return its reference. */
-  addMedia(data: Uint8Array, type: string): string;
-}
-/** Context passed during parse (parse path). */
-interface ReadContext {
-  /** Resolve a relationship rId to its target path. */
-  resolveRelationship(rId: string): string | undefined;
-  /** Get a parsed XML part by path. */
-  getPart(path: string): Element | undefined;
-  /** Get raw binary data (images, media, etc.) by path. */
-  getRaw(path: string): Uint8Array | undefined;
-}
-//#endregion
-//#region src/descriptor/types.d.ts
-/** Element descriptor — declarative XML mapping. */
-interface ElementDescriptor<T> {
-  readonly kind: "element";
-  readonly tag: string;
-  readonly attrs?: readonly AttrSpec<T>[];
-  readonly content?: readonly ContentSpec<T>[];
-}
-/** Custom descriptor — for complex logic that doesn't fit the declarative model. */
-interface CustomDescriptor<T, Ctx = WriteContext> {
-  readonly kind: "custom";
-  stringify(value: T, ctx: Ctx): string | undefined;
-  parse(el: Element, ctx: ReadContext): T;
-}
-/** Union type for all descriptors. */
-type Descriptor<T> = ElementDescriptor<T> | CustomDescriptor<T>;
-interface AttrSpec<T> {
-  /** Property key in the Options object. */
-  readonly key: keyof T & string;
-  /** XML attribute name (e.g. "w:val"). */
-  readonly xmlName: string;
-  /** Default value — omitted during stringify when equal. */
-  readonly default?: unknown;
-  /** Encode a JS value to an XML attribute string. Return undefined to skip. */
-  readonly encode?: (v: any) => string | undefined;
-  /** Decode an XML attribute string to a JS value. */
-  readonly decode?: (raw: string) => any;
-}
-/** Single child element mapped to a property. */
-interface ChildSpec<T> {
-  readonly kind: "child";
-  readonly key: keyof T & string;
-  readonly tag: string;
-  readonly desc: Descriptor<any>;
-}
-/** Multiple child elements of the same tag mapped to an array property. */
-interface ChildrenSpec<T> {
-  readonly kind: "children";
-  readonly key: keyof T & string;
-  readonly tag: string;
-  readonly desc: Descriptor<any>;
-}
-/** Union child — one of several possible child elements. */
-interface UnionSpec<T> {
-  readonly kind: "union";
-  readonly key: keyof T & string;
-  readonly variants: readonly UnionVariant[];
-}
-/** Text content mapped to a property. */
-interface TextSpec<T> {
-  readonly kind: "text";
-  readonly key: keyof T & string;
-}
-interface UnionVariant {
-  readonly tag: string;
-  readonly match: (opts: any) => boolean;
-  readonly desc: Descriptor<any>;
-}
-/** Discriminated union of all content spec types. */
-type ContentSpec<T> = ChildSpec<T> | ChildrenSpec<T> | UnionSpec<T> | TextSpec<T> | CustomDescriptor<T>;
-//#endregion
-//#region src/descriptor/builder.d.ts
-declare function element$1<T extends object>(tag: string): DescriptorBuilder<T>;
-declare class DescriptorBuilder<T extends object> {
-  private readonly _tag;
-  private readonly _attrs;
-  private readonly _content;
-  constructor(tag: string);
-  /** Add an attribute mapping. */
-  attr(key: keyof T & string, xmlName: string, opts?: {
-    readonly default?: unknown;
-    readonly encode?: (v: any) => string | undefined;
-    readonly decode?: (raw: string) => any;
-  }): this;
-  /** Add a single child element mapping. */
-  child(key: keyof T & string, tag: string, desc: ChildSpec<T>["desc"]): this;
-  /** Add a repeating child element mapping. */
-  children(key: keyof T & string, tag: string, desc: ChildrenSpec<T>["desc"]): this;
-  /** Add a union (one-of-several) child mapping. */
-  union(key: keyof T & string, variants: readonly UnionVariant[]): this;
-  /** Add a text content mapping. */
-  text(key: keyof T & string): this;
-  /** Add a custom content handler. */
-  custom(spec: CustomDescriptor<T>): this;
-  /** Build the immutable ElementDescriptor. */
-  build(): ElementDescriptor<T>;
-}
-//#endregion
-//#region src/descriptor/runtime.d.ts
-/**
- * Serialize an Options object to an XML string using its descriptor.
- * Returns `undefined` when an optional element should be omitted.
- */
-declare function stringify<T>(desc: Descriptor<T>, value: T, ctx: WriteContext): string | undefined;
-/**
- * Parse an XML Element into an Options object using its descriptor.
- */
-declare function parse<T>(desc: Descriptor<T>, el: Element, ctx: ReadContext): T;
-//#endregion
-//#region src/descriptor/helpers.d.ts
-/**
- * OOXML-specific encode/decode helpers for descriptors.
- *
- * XML traversal helpers (findChild, etc.) are in @office-open/xml utils.
- * This file only contains OOXML value encoding/decoding.
- *
- * @module
- */
-/** Encode boolean for CT_OnOff: true → omit val, false → "0". */
-declare const boolEncode: (v: boolean | undefined) => string | undefined;
-/** Decode CT_OnOff: absent or "true"/"1" → true, "0"/"false" → false. */
-declare const boolDecode: (raw: string) => boolean;
-/** Create an enum encoder from a JS↔XML mapping. */
-declare const enumEncode: (map: Record<string, string>) => (v: string | undefined) => string | undefined;
-/** Create an enum decoder from a JS↔XML mapping (inverted). */
-declare const enumDecode: (map: Record<string, string>) => (raw: string) => string;
-//#endregion
-//#region src/descriptor/registry.d.ts
-declare class DescriptorRegistry {
-  private static readonly _map;
-  /** Register a descriptor with its XML tag. */
-  static register(tag: string, desc: Descriptor<any>): void;
-  /** Look up a descriptor by XML tag. */
-  static get(tag: string): Descriptor<any> | undefined;
-  /** Get all registered tags. */
-  static tags(): ReadonlySet<string>;
-  /** Check if a tag is registered. */
-  static has(tag: string): boolean;
-  /** Get the number of registered descriptors. */
-  static get size(): number;
-}
-//#endregion
-export { TextSpec as _, enumEncode as a, ReadContext as b, DescriptorBuilder as c, ChildSpec as d, ChildrenSpec as f, ElementDescriptor as g, Descriptor as h, enumDecode as i, element$1 as l, CustomDescriptor as m, boolDecode as n, parse as o, ContentSpec as p, boolEncode as r, stringify as s, DescriptorRegistry as t, AttrSpec as u, UnionSpec as v, WriteContext as x, UnionVariant as y };