@bcts/dcbor 1.0.0-alpha.12 → 1.0.0-alpha.14

package/dist/index.mjs

@@ -5107,7 +5107,13 @@ var TagsStore = class {
 	/**
 	* Insert a tag into the registry.
 	*
-	* @param tag - The tag to register
+	* Matches Rust's TagsStore::insert() behavior:
+	* - Throws if the tag name is undefined or empty
+	* - Throws if a tag with the same value exists with a different name
+	* - Allows re-registering the same tag value with the same name
+	*
+	* @param tag - The tag to register (must have a non-empty name)
+	* @throws Error if tag has no name, empty name, or conflicts with existing registration
 	*
 	* @example
 	* ```typescript
@@ -5116,9 +5122,13 @@ var TagsStore = class {
 	* ```
 	*/
 	insert(tag) {
+		const name = tag.name;
+		if (name === void 0 || name === "") throw new Error(`Tag ${tag.value} must have a non-empty name`);
 		const key = this.#valueKey(tag.value);
+		const existing = this.#tagsByValue.get(key);
+		if (existing?.name !== void 0 && existing.name !== name) throw new Error(`Attempt to register tag: ${tag.value} '${existing.name}' with different name: '${name}'`);
 		this.#tagsByValue.set(key, tag);
-		if (tag.name !== void 0) this.#tagsByName.set(tag.name, tag);
+		this.#tagsByName.set(name, tag);
 	}
 	/**
 	* Insert multiple tags into the registry.
@@ -5156,21 +5166,6 @@ var TagsStore = class {
 		const key = this.#valueKey(tagValue$1);
 		this.#summarizers.set(key, summarizer);
 	}
-	/**
-	* Remove a tag from the registry.
-	*
-	* @param tagValue - The numeric tag value to remove
-	* @returns true if a tag was removed, false otherwise
-	*/
-	remove(tagValue$1) {
-		const key = this.#valueKey(tagValue$1);
-		const tag = this.#tagsByValue.get(key);
-		if (tag === void 0) return false;
-		this.#tagsByValue.delete(key);
-		if (tag.name !== void 0) this.#tagsByName.delete(tag.name);
-		this.#summarizers.delete(key);
-		return true;
-	}
 	assignedNameForTag(tag) {
 		const key = this.#valueKey(tag.value);
 		return this.#tagsByValue.get(key)?.name;
@@ -5194,30 +5189,6 @@ var TagsStore = class {
 		return this.#summarizers.get(key);
 	}
 	/**
-	* Get all registered tags.
-	*
-	* @returns Array of all registered tags
-	*/
-	getAllTags() {
-		return Array.from(this.#tagsByValue.values());
-	}
-	/**
-	* Clear all registered tags and summarizers.
-	*/
-	clear() {
-		this.#tagsByValue.clear();
-		this.#tagsByName.clear();
-		this.#summarizers.clear();
-	}
-	/**
-	* Get the number of registered tags.
-	*
-	* @returns Number of tags in the registry
-	*/
-	get size() {
-		return this.#tagsByValue.size;
-	}
-	/**
 	* Create a string key for a numeric tag value.
 	* Handles both number and bigint types.
 	*
@@ -5609,11 +5580,17 @@ function formatMap(map, opts) {
 }
 /**
 * Format tagged value.
+*
+* Matches Rust's diag_item() for Tagged case.
 */
 function formatTagged(tag, content, opts) {
 	if (opts.summarize === true) {
 		const summarizer = resolveTagsStore(opts.tags)?.summarizer(tag);
-		if (summarizer !== void 0) return summarizer(content, opts.flat ?? false);
+		if (summarizer !== void 0) {
+			const result$1 = summarizer(content, opts.flat ?? false);
+			if (result$1.ok) return result$1.value;
+			else return `<error: ${result$1.error.type === "Custom" ? result$1.error.message : result$1.error.type === "WrongTag" ? `expected CBOR tag ${result$1.error.expected.value}, but got ${result$1.error.actual.value}` : result$1.error.type}>`;
+		}
 	}
 	let comment;
 	if (opts.annotate === true) {
@@ -6898,21 +6875,20 @@ const asKeyValue = (element) => {
 * @param cbor - The CBOR value to traverse
 * @param initialState - Initial state value
 * @param visitor - Function to call for each element
-* @returns Final state after traversal
 *
 * @example
 * ```typescript
-* // Count all text strings in a structure
-* interface CountState { count: number }
+* // Count all text strings in a structure using RefCell-like pattern
+* const count = { value: 0 };
 *
 * const structure = cbor({ name: 'Alice', tags: ['urgent', 'draft'] });
-* const result = walk(structure, { count: 0 }, (element, level, edge, state) => {
+* walk(structure, null, (element, level, edge, state) => {
 *   if (element.type === 'single' && element.cbor.type === MajorType.Text) {
-*     return [{ count: state.count + 1 }, false];
+*     count.value++;
 *   }
 *   return [state, false];
 * });
-* console.log(result.count); // 3 (name, urgent, draft)
+* console.log(count.value); // 3 (name, urgent, draft)
 * ```
 *
 * @example
@@ -6921,7 +6897,7 @@ const asKeyValue = (element) => {
 * const structure = cbor([1, 2, 3, 'found', 5, 6]);
 * let found = false;
 *
-* walk(structure, null, (element, level, edge) => {
+* walk(structure, null, (element, level, edge, state) => {
 *   if (element.type === 'single' &&
 *       element.cbor.type === MajorType.Text &&
 *       element.cbor.value === 'found') {
@@ -6933,7 +6909,7 @@ const asKeyValue = (element) => {
 * ```
 */
 const walk = (cbor$1, initialState, visitor) => {
-	return walkInternal(cbor$1, 0, { type: EdgeType.None }, initialState, visitor);
+	walkInternal(cbor$1, 0, { type: EdgeType.None }, initialState, visitor);
 };
 /**
 * Internal recursive walk implementation.
@@ -7021,125 +6997,6 @@ function walkMap(cbor$1, level, state, visitor) {
 function walkTagged(cbor$1, level, state, visitor) {
 	return walkInternal(cbor$1.value, level + 1, { type: EdgeType.TaggedContent }, state, visitor);
 }
-/**
-* Helper: Count all elements in a CBOR tree.
-*
-* @param cbor - The CBOR value to count
-* @returns Total number of elements visited
-*
-* @example
-* ```typescript
-* const structure = cbor([1, 2, [3, 4]]);
-* const count = countElements(structure);
-* console.log(count); // 6 (array, 1, 2, inner array, 3, 4)
-* ```
-*/
-const countElements = (cbor$1) => {
-	return walk(cbor$1, { count: 0 }, (_element, _level, _edge, state) => {
-		return [{ count: state.count + 1 }, false];
-	}).count;
-};
-/**
-* Helper: Collect all elements at a specific depth level.
-*
-* @param cbor - The CBOR value to traverse
-* @param targetLevel - The depth level to collect (0 = root)
-* @returns Array of CBOR values at the target level
-*
-* @example
-* ```typescript
-* const structure = cbor([[1, 2], [3, 4]]);
-* const level1 = collectAtLevel(structure, 1);
-* // Returns: [[1, 2], [3, 4]]
-* const level2 = collectAtLevel(structure, 2);
-* // Returns: [1, 2, 3, 4]
-* ```
-*/
-const collectAtLevel = (cbor$1, targetLevel) => {
-	return walk(cbor$1, { items: [] }, (element, level, _edge, state) => {
-		if (level === targetLevel && element.type === "single") return [{ items: [...state.items, element.cbor] }, false];
-		return [state, false];
-	}).items;
-};
-/**
-* Helper: Find first element matching a predicate.
-*
-* @template T - Type of extracted value
-* @param cbor - The CBOR value to search
-* @param predicate - Function to test each element
-* @returns First matching element, or undefined if not found
-*
-* @example
-* ```typescript
-* const structure = cbor({ users: [
-*   { name: 'Alice', age: 30 },
-*   { name: 'Bob', age: 25 }
-* ]});
-*
-* const bob = findFirst(structure, (element) => {
-*   if (element.type === 'single' &&
-*       element.cbor.type === MajorType.Text &&
-*       element.cbor.value === 'Bob') {
-*     return true;
-*   }
-*   return false;
-* });
-* ```
-*/
-const findFirst = (cbor$1, predicate) => {
-	return walk(cbor$1, {}, (element, _level, _edge, state) => {
-		if (state.found !== void 0) return [state, true];
-		if (predicate(element)) {
-			if (element.type === "single") return [{ found: element.cbor }, true];
-			return [state, true];
-		}
-		return [state, false];
-	}).found;
-};
-/**
-* Helper: Collect all text strings in a CBOR tree.
-*
-* @param cbor - The CBOR value to traverse
-* @returns Array of all text string values found
-*
-* @example
-* ```typescript
-* const doc = cbor({
-*   title: 'Document',
-*   tags: ['urgent', 'draft'],
-*   author: { name: 'Alice' }
-* });
-*
-* const texts = collectAllText(doc);
-* // Returns: ['Document', 'urgent', 'draft', 'Alice']
-* ```
-*/
-const collectAllText = (cbor$1) => {
-	return walk(cbor$1, { texts: [] }, (element, _level, _edge, state) => {
-		if (element.type === "single" && element.cbor.type === MajorType.Text) return [{ texts: [...state.texts, element.cbor.value] }, false];
-		return [state, false];
-	}).texts;
-};
-/**
-* Helper: Get the maximum depth of a CBOR tree.
-*
-* @param cbor - The CBOR value to measure
-* @returns Maximum depth (0 for leaf values, 1+ for containers)
-*
-* @example
-* ```typescript
-* const flat = cbor([1, 2, 3]);
-* console.log(maxDepth(flat)); // 1
-*
-* const nested = cbor([[[1]]]);
-* console.log(maxDepth(nested)); // 3
-* ```
-*/
-const maxDepth = (cbor$1) => {
-	return walk(cbor$1, { maxDepth: 0 }, (_element, level, _edge, state) => {
-		return [{ maxDepth: Math.max(state.maxDepth, level) }, false];
-	}).maxDepth;
-};
 
 //#endregion
 //#region src/cbor.ts
@@ -7554,7 +7411,7 @@ const attachMethods = (obj) => {
 			return this.value;
 		},
 		walk(initialState, visitor) {
-			return walk(this, initialState, visitor);
+			walk(this, initialState, visitor);
 		},
 		validateTag(expectedTags) {
 			if (this.type !== MajorType.Tagged) throw new CborError({ type: "WrongType" });
@@ -8292,9 +8149,18 @@ const registerTagsIn = (tagsStore) => {
 	tagsStore.insertAll(tags);
 	tagsStore.setSummarizer(TAG_DATE, (untaggedCbor, _flat) => {
 		try {
-			return CborDate.fromUntaggedCbor(untaggedCbor).toString();
-		} catch {
-			return diagnostic(untaggedCbor);
+			return {
+				ok: true,
+				value: CborDate.fromUntaggedCbor(untaggedCbor).toString()
+			};
+		} catch (e) {
+			return {
+				ok: false,
+				error: {
+					type: "Custom",
+					message: e instanceof Error ? e.message : String(e)
+				}
+			};
 		}
 	});
 };
@@ -9023,5 +8889,5 @@ var ByteString = class ByteString {
 };
 
 //#endregion
-export { ByteString, Cbor, CborDate, CborError, CborMap, CborSet, Err, MajorType, Ok, TAG_BASE16, TAG_BASE64, TAG_BASE64URL, TAG_BASE64URL_TEXT, TAG_BASE64_TEXT, TAG_BIGFLOAT, TAG_BINARY_UUID, TAG_DATE, TAG_DATE_TIME_STRING, TAG_DECIMAL_FRACTION, TAG_ENCODED_CBOR, TAG_EPOCH_DATE, TAG_EPOCH_DATE_TIME, TAG_MIME_MESSAGE, TAG_NAME_DATE, TAG_NEGATIVE_BIGNUM, TAG_POSITIVE_BIGNUM, TAG_REGEXP, TAG_SELF_DESCRIBE_CBOR, TAG_SET, TAG_STRING_REF_NAMESPACE, TAG_URI, TAG_UUID, TagsStore, arrayIsEmpty, arrayItem, arrayLength, asArray, asBoolean, asByteString, asBytes, asCborArray, asCborMap, asFloat, asInteger, asKeyValue, asMap, asNegative, asNumber, asSingle, asTaggedValue, asText, asUnsigned, bytesToHex, cbor, cborData, collectAllText, collectAtLevel, countElements, createTag, createTaggedCbor, decodeCbor, decodeVarInt, decodeVarIntData, diagnosticOpt, edgeLabel, encodeVarInt, errorMsg, errorToString, expectArray, expectBoolean, expectBoolean as tryIntoBool, expectBytes, expectBytes as tryIntoByteString, expectFloat, expectInteger, expectMap, expectNegative, expectNumber, expectTaggedContent, expectTaggedContent as tryExpectedTaggedValue, expectText, expectText as tryIntoText, expectUnsigned, extractCbor, extractTaggedContent, findFirst, getGlobalTagsStore, getTaggedContent, hasFractionalPart, hasTag, hexOpt, hexToBytes, isArray, isBoolean, isBytes, isFloat, isInteger, isMap, isNaN$1 as isNaN, isNegative, isNull, isNumber, isSimple, isTagged, isText, isUnsigned, mapHas, mapIsEmpty, mapKeys, mapSize, mapValue, mapValues, maxDepth, registerTags, registerTagsIn, simpleName, summary, tagContent, tagValue, tagsForValues, toByteString, toByteStringFromHex, toTaggedValue, validateTag };
+export { ByteString, Cbor, CborDate, CborError, CborMap, CborSet, Err, MajorType, Ok, TAG_BASE16, TAG_BASE64, TAG_BASE64URL, TAG_BASE64URL_TEXT, TAG_BASE64_TEXT, TAG_BIGFLOAT, TAG_BINARY_UUID, TAG_DATE, TAG_DATE_TIME_STRING, TAG_DECIMAL_FRACTION, TAG_ENCODED_CBOR, TAG_EPOCH_DATE, TAG_EPOCH_DATE_TIME, TAG_MIME_MESSAGE, TAG_NAME_DATE, TAG_NEGATIVE_BIGNUM, TAG_POSITIVE_BIGNUM, TAG_REGEXP, TAG_SELF_DESCRIBE_CBOR, TAG_SET, TAG_STRING_REF_NAMESPACE, TAG_URI, TAG_UUID, TagsStore, arrayIsEmpty, arrayItem, arrayLength, asArray, asBoolean, asByteString, asBytes, asCborArray, asCborMap, asFloat, asInteger, asKeyValue, asMap, asNegative, asNumber, asSingle, asTaggedValue, asText, asUnsigned, bytesToHex, cbor, cborData, createTag, createTaggedCbor, decodeCbor, decodeVarInt, decodeVarIntData, diagnosticOpt, edgeLabel, encodeVarInt, errorMsg, errorToString, expectArray, expectBoolean, expectBoolean as tryIntoBool, expectBytes, expectBytes as tryIntoByteString, expectFloat, expectInteger, expectMap, expectNegative, expectNumber, expectTaggedContent, expectTaggedContent as tryExpectedTaggedValue, expectText, expectText as tryIntoText, expectUnsigned, extractCbor, extractTaggedContent, getGlobalTagsStore, getTaggedContent, hasFractionalPart, hasTag, hexOpt, hexToBytes, isArray, isBoolean, isBytes, isFloat, isInteger, isMap, isNaN$1 as isNaN, isNegative, isNull, isNumber, isSimple, isTagged, isText, isUnsigned, mapHas, mapIsEmpty, mapKeys, mapSize, mapValue, mapValues, registerTags, registerTagsIn, simpleName, summary, tagContent, tagValue, tagsForValues, toByteString, toByteStringFromHex, toTaggedValue, validateTag, walk };
 //# sourceMappingURL=index.mjs.map