@bcts/dcbor 1.0.0-alpha.11 → 1.0.0-alpha.13

package/dist/index.cjs

@@ -5108,7 +5108,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
@@ -5117,9 +5123,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.
@@ -5157,21 +5167,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;
@@ -5195,30 +5190,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.
 	*
@@ -5610,11 +5581,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) {
@@ -6899,21 +6876,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
@@ -6922,7 +6898,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') {
@@ -6934,7 +6910,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.
@@ -7022,125 +6998,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
@@ -7555,7 +7412,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" });
@@ -8293,9 +8150,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)
+				}
+			};
 		}
 	});
 };
@@ -9079,9 +8945,6 @@ exports.asUnsigned = asUnsigned;
 exports.bytesToHex = bytesToHex;
 exports.cbor = cbor;
 exports.cborData = cborData;
-exports.collectAllText = collectAllText;
-exports.collectAtLevel = collectAtLevel;
-exports.countElements = countElements;
 exports.createTag = createTag;
 exports.createTaggedCbor = createTaggedCbor;
 exports.decodeCbor = decodeCbor;
@@ -9105,7 +8968,6 @@ exports.expectText = expectText;
 exports.expectUnsigned = expectUnsigned;
 exports.extractCbor = extractCbor;
 exports.extractTaggedContent = extractTaggedContent;
-exports.findFirst = findFirst;
 exports.getGlobalTagsStore = getGlobalTagsStore;
 exports.getTaggedContent = getTaggedContent;
 exports.hasFractionalPart = hasFractionalPart;
@@ -9132,7 +8994,6 @@ exports.mapKeys = mapKeys;
 exports.mapSize = mapSize;
 exports.mapValue = mapValue;
 exports.mapValues = mapValues;
-exports.maxDepth = maxDepth;
 exports.registerTags = registerTags;
 exports.registerTagsIn = registerTagsIn;
 exports.simpleName = simpleName;
@@ -9148,4 +9009,5 @@ exports.tryIntoBool = expectBoolean;
 exports.tryIntoByteString = expectBytes;
 exports.tryIntoText = expectText;
 exports.validateTag = validateTag;
+exports.walk = walk;
 //# sourceMappingURL=index.cjs.map