@bitcobblers/wod-wiki-core 0.43.2153 → 0.44.2155

package/dist/index.d.cts

@@ -933,6 +933,123 @@ interface Segment {
     metrics?: MetricContainer;
 }
 
+/**
+ * Tags — named bundles a script can reference.
+ *
+ * A script line points at a tag instead of repeating what the tag means:
+ *
+ * ```text
+ * 5 reps @ 100 kg #heavy
+ * ```
+ *
+ * A tag contributes three kinds of thing to the statements that reference
+ * it:
+ *
+ * - a **metric** — a typed value with a unit (the meaning of the line),
+ * - a **tag** — another tag, so a tag can build on a tag,
+ * - a **function** — a named calculation the tag activates where it applies.
+ *
+ * The model lives in core because both the parser (which resolves
+ * `#slug` references) and the runtime (which runs the functions a tag
+ * carries) need it, and neither should know how tags are stored.
+ */
+/** A metric a tag contributes: a typed value with an optional unit. */
+interface TagMetricContribution {
+    readonly kind: 'metric';
+    /** The metric type, e.g. `sound` or `rpe`. */
+    readonly type: string;
+    /** The metric's value. */
+    readonly value: string | number | boolean | null;
+    /** The unit the value is expressed in, when it has one. */
+    readonly unit?: string;
+}
+/** Another tag this tag applies. */
+interface TagTagContribution {
+    readonly kind: 'tag';
+    /** The slug of the applied tag. */
+    readonly slug: string;
+}
+/** A named function this tag carries. */
+interface TagFunctionContribution {
+    readonly kind: 'function';
+    /**
+     * The function's name — the id of the calculation it refers to. The
+     * calculation's own scope decides the grain it runs at: `segment` per
+     * record, `workout` at the end of the workout.
+     */
+    readonly name: string;
+}
+/** What a tag contributes. */
+type TagContribution = TagMetricContribution | TagTagContribution | TagFunctionContribution;
+/** A tag and what it contributes. */
+interface TagDefinition {
+    /** The slug a script references: `#slug`. */
+    readonly slug: string;
+    /** What the tag contributes when referenced. */
+    readonly contributions: readonly TagContribution[];
+}
+/** A slug → tag lookup. */
+interface TagIndex {
+    /**
+     * The tag with this slug, or `undefined` when the catalogue has no such
+     * tag.
+     */
+    resolve(slug: string): TagDefinition | undefined;
+    /** Every tag in the index. */
+    list(): readonly TagDefinition[];
+}
+/**
+ * A host-supplied source of tags.
+ *
+ * The language never reads storage: the host loads its tags and hands the
+ * language a {@link TagIndex}. A host implements this to feed the parser a
+ * database-configured catalogue.
+ */
+interface ITagSource {
+    /** Load every tag the host knows about. */
+    loadTags(): Promise<readonly TagDefinition[]>;
+}
+/**
+ * Build a tag index from tag definitions.
+ *
+ * Later definitions of the same slug win, matching how the app layers
+ * user-defined tags over seeded ones.
+ */
+declare function createTagIndex(tags: readonly TagDefinition[]): TagIndex;
+
+/**
+ * Tag references — the tag a metric came from.
+ *
+ * A script line can point at a tag (`5 reps @ 100 kg #heavy`), and the tag
+ * brings metrics, other tags and functions. The metrics it brings record
+ * where they came from, so the editor can show the tag, link to it, and the
+ * compiler can compose what the block used.
+ *
+ * Pure data: survives the stored-logs / JSON round-trip.
+ */
+/** A tag reference: the tag, what it carries, and what it names. */
+interface TagReferenceMetadata {
+    /** The tag's slug — what `#slug` refers to. */
+    slug: string;
+    /** The tag's display label (its slug, for now). */
+    label: string;
+    /** The functions the tag carries — named calculations it activates. */
+    functions?: readonly string[];
+    /**
+     * The sound profile the tag selects, when it names one. A tag that carries
+     * a sound metric points at the profile that metric names.
+     */
+    soundProfileId?: string;
+}
+/** Metadata key under which {@link TagReferenceMetadata} is stored on a metric. */
+declare const TAG_REFERENCE_METADATA_KEY = "tagReference";
+/**
+ * Read the tag reference off a metric's metadata. Validates shape before
+ * trusting persisted input: an unknown-shape payload is ignored rather than
+ * partially honored.
+ */
+declare function getTagReference(metadata: Record<string, unknown> | undefined): TagReferenceMetadata | undefined;
+
 /** Cross-note fingerprint of the trimmed, unfenced workout body. Never an occurrence ID. */
 declare function blockContentId(content: string): string;
 
@@ -1041,6 +1158,8 @@ interface Note {
     seedChunkId?: string;
     /** Authored seed path used for deterministic identity and routing. */
     sourcePath?: string;
+    /** Git commit hash in which this note was published or changed. */
+    seedCommit?: string;
 }
 interface Page {
     id: string;
@@ -1064,10 +1183,21 @@ interface TagTypeRecord {
     color?: string;
     createdAt: number;
 }
+/**
+ * A tag: a named bundle a script can reference with `#slug`.
+ *
+ * Keeping the contributions on the tag means the meaning lives in one place
+ * instead of being repeated on every line that wants the tag.
+ */
 interface Tag {
     id: string;
     label: string;
     type?: TagType;
+    /**
+     * What this tag contributes when referenced from script content: metrics,
+     * other tags, and functions.
+     */
+    contributions?: TagContribution[];
     createdAt: number;
 }
 interface NoteTag {
@@ -1629,13 +1759,13 @@ declare function patchFrontmatterProperty(raw: string, path: readonly string[],
  * Auto-generated build version metadata.
  * Do not edit directly; updated by scripts/stamp-version.ts
  */
-declare const VERSION = "0.43.2153";
-declare const GIT_SHA = "3bb3096";
-declare const BUILD_TIME = "2026-10-22T21:06:18.747Z";
+declare const VERSION = "0.44.2155";
+declare const GIT_SHA = "6807397";
+declare const BUILD_TIME = "2026-10-24T03:58:47.392Z";
 declare const SEMVER: {
-    readonly version: "0.43.2153";
-    readonly gitSha: "3bb3096";
-    readonly buildTime: "2026-10-22T21:06:18.747Z";
+    readonly version: "0.44.2155";
+    readonly gitSha: "6807397";
+    readonly buildTime: "2026-10-24T03:58:47.392Z";
 };
 
-export { type AnalyticsDataPoint, type AnalyticsGraphConfig, type AnalyticsGroup, type Attachment, BUILD_TIME, type BlockEffort, type BlockEquipment, type BlockIndexRow, BlockKey, type BlockRevision, type CatalogBackfillState, CodeMetadata, CodeStatement, DEFAULT_NOTEBOOK_SLUGS, type DefaultNotebookSlug, type DialectAnalysis, type DimensionKey, type DisplayStatus, type EventGrain, type EventRecord, type FenceDialect, type FieldCatalogEntry, type FieldContribution, type FieldLeaf, type FieldRef, type FieldSourceRecord, type FieldValueKind, type FieldValueRecord, type FrontMatterSubtype, type FrontmatterPatchValue, GIT_SHA, type IBlockKey, type ICodeMetadata, type ICodeStatement, type IDialect, type IDialectTagDescriptor, type IMetric, type IMetricOwnershipResolver, type IMetricSource, type IOutputStatement, type IScript, KNOWN_OUTPUT_TYPES, KNOWN_SECTION_WIDGETS, LEGACY_ORIGIN_TO_OWNERSHIP_LAYER, METRIC_OWNERSHIP_LAYER_CHAIN, type Membership, Metric, type MetricAction, MetricContainer, type MetricFilter, type MetricOrigin, type MetricOwnershipLayer, type MetricOwnershipLedger, type MetricOwnershipOutcome, type MetricOwnershipPromotionCandidate, type MetricOwnershipQuery, type MetricOwnershipResolvedContribution, type MetricOwnershipTypeExplanation, type MetricTemporal, MetricType, type MetricWithOptionalOwnershipLayer, NOTEBOOK_TAG_PREFIX, type Note, type NoteBlock, type NoteBlockChange, type NoteBlockKind, type NoteKind, type NoteTag, type Notebook, type NotebookId, type NotebookOrigin, type NullValueKind, type Origin, OutputStatement, type OutputStatementOptions, type OutputStatementType, OwnershipResolver, type Page, type PageNote, type ParseError, ParsedCodeStatement, REFERENCE_METADATA_KEY, type ReconcileNoteBlocksOptions, type ReducerStats, type ReferenceDiagnostic, type ReferenceDiagnosticReason, type ReferenceKind, type ReferenceMatchKind, type ReferenceMetadata, type ReferenceRef, type ResultOrigin, SEMVER, SYSTEM_DEFAULT_OUTPUT_UNIT, type ScriptBlock, type ScriptBlockState, type Section, type SectionDocument, type SectionRecognitionOptions, type SectionType, type Segment, type Session, type StoredOutputStatement, type SummaryCoverage, type Tag, type TagType, type TagTypeRecord, type TimeSpan, UNIT_CATALOG, UnitConversionError, type UnitDefinition, type UnitErrorCode, VALID_FENCE_DIALECTS, VERSION, type VisualizerFilter, type VisualizerSize, type WorkoutResults, type WorkoutSectionType, actionableSectionKind, blockContentId, buildRawContent, calculateTotalLines, convertViaCatalog, createMetricOwnershipLedger, detectScriptBlocks, dimensionKeyOf, extractBlockContent, fieldRefFromKey, fieldRefKey, findBlockAtLine, flattenFieldLeaves, fromNotebookTag, getMetricOwnershipLayer, getReferenceMetadata, isNoteEditable, isNotebookTag, isWorkoutSectionType, lookupUnit, mapNoteBlockChanges, matchDialectFence, normalizeFieldComponent, normalizeFieldPath, notebookSlugFromId, ownershipRank, parseDocumentSections, patchFrontmatterProperty, reconcileNoteBlocks, resolveLayer, runAffordance, systemDefaultUnit, toNotebookId, toNotebookTag, validateNoteBlocks, valueKindOf };
+export { type AnalyticsDataPoint, type AnalyticsGraphConfig, type AnalyticsGroup, type Attachment, BUILD_TIME, type BlockEffort, type BlockEquipment, type BlockIndexRow, BlockKey, type BlockRevision, type CatalogBackfillState, CodeMetadata, CodeStatement, DEFAULT_NOTEBOOK_SLUGS, type DefaultNotebookSlug, type DialectAnalysis, type DimensionKey, type DisplayStatus, type EventGrain, type EventRecord, type FenceDialect, type FieldCatalogEntry, type FieldContribution, type FieldLeaf, type FieldRef, type FieldSourceRecord, type FieldValueKind, type FieldValueRecord, type FrontMatterSubtype, type FrontmatterPatchValue, GIT_SHA, type IBlockKey, type ICodeMetadata, type ICodeStatement, type IDialect, type IDialectTagDescriptor, type IMetric, type IMetricOwnershipResolver, type IMetricSource, type IOutputStatement, type IScript, type ITagSource, KNOWN_OUTPUT_TYPES, KNOWN_SECTION_WIDGETS, LEGACY_ORIGIN_TO_OWNERSHIP_LAYER, METRIC_OWNERSHIP_LAYER_CHAIN, type Membership, Metric, type MetricAction, MetricContainer, type MetricFilter, type MetricOrigin, type MetricOwnershipLayer, type MetricOwnershipLedger, type MetricOwnershipOutcome, type MetricOwnershipPromotionCandidate, type MetricOwnershipQuery, type MetricOwnershipResolvedContribution, type MetricOwnershipTypeExplanation, type MetricTemporal, MetricType, type MetricWithOptionalOwnershipLayer, NOTEBOOK_TAG_PREFIX, type Note, type NoteBlock, type NoteBlockChange, type NoteBlockKind, type NoteKind, type NoteTag, type Notebook, type NotebookId, type NotebookOrigin, type NullValueKind, type Origin, OutputStatement, type OutputStatementOptions, type OutputStatementType, OwnershipResolver, type Page, type PageNote, type ParseError, ParsedCodeStatement, REFERENCE_METADATA_KEY, type ReconcileNoteBlocksOptions, type ReducerStats, type ReferenceDiagnostic, type ReferenceDiagnosticReason, type ReferenceKind, type ReferenceMatchKind, type ReferenceMetadata, type ReferenceRef, type ResultOrigin, SEMVER, SYSTEM_DEFAULT_OUTPUT_UNIT, type ScriptBlock, type ScriptBlockState, type Section, type SectionDocument, type SectionRecognitionOptions, type SectionType, type Segment, type Session, type StoredOutputStatement, type SummaryCoverage, TAG_REFERENCE_METADATA_KEY, type Tag, type TagContribution, type TagDefinition, type TagFunctionContribution, type TagIndex, type TagMetricContribution, type TagReferenceMetadata, type TagTagContribution, type TagType, type TagTypeRecord, type TimeSpan, UNIT_CATALOG, UnitConversionError, type UnitDefinition, type UnitErrorCode, VALID_FENCE_DIALECTS, VERSION, type VisualizerFilter, type VisualizerSize, type WorkoutResults, type WorkoutSectionType, actionableSectionKind, blockContentId, buildRawContent, calculateTotalLines, convertViaCatalog, createMetricOwnershipLedger, createTagIndex, detectScriptBlocks, dimensionKeyOf, extractBlockContent, fieldRefFromKey, fieldRefKey, findBlockAtLine, flattenFieldLeaves, fromNotebookTag, getMetricOwnershipLayer, getReferenceMetadata, getTagReference, isNoteEditable, isNotebookTag, isWorkoutSectionType, lookupUnit, mapNoteBlockChanges, matchDialectFence, normalizeFieldComponent, normalizeFieldPath, notebookSlugFromId, ownershipRank, parseDocumentSections, patchFrontmatterProperty, reconcileNoteBlocks, resolveLayer, runAffordance, systemDefaultUnit, toNotebookId, toNotebookTag, validateNoteBlocks, valueKindOf };

package/dist/index.d.ts

@@ -933,6 +933,123 @@ interface Segment {
     metrics?: MetricContainer;
 }
 
+/**
+ * Tags — named bundles a script can reference.
+ *
+ * A script line points at a tag instead of repeating what the tag means:
+ *
+ * ```text
+ * 5 reps @ 100 kg #heavy
+ * ```
+ *
+ * A tag contributes three kinds of thing to the statements that reference
+ * it:
+ *
+ * - a **metric** — a typed value with a unit (the meaning of the line),
+ * - a **tag** — another tag, so a tag can build on a tag,
+ * - a **function** — a named calculation the tag activates where it applies.
+ *
+ * The model lives in core because both the parser (which resolves
+ * `#slug` references) and the runtime (which runs the functions a tag
+ * carries) need it, and neither should know how tags are stored.
+ */
+/** A metric a tag contributes: a typed value with an optional unit. */
+interface TagMetricContribution {
+    readonly kind: 'metric';
+    /** The metric type, e.g. `sound` or `rpe`. */
+    readonly type: string;
+    /** The metric's value. */
+    readonly value: string | number | boolean | null;
+    /** The unit the value is expressed in, when it has one. */
+    readonly unit?: string;
+}
+/** Another tag this tag applies. */
+interface TagTagContribution {
+    readonly kind: 'tag';
+    /** The slug of the applied tag. */
+    readonly slug: string;
+}
+/** A named function this tag carries. */
+interface TagFunctionContribution {
+    readonly kind: 'function';
+    /**
+     * The function's name — the id of the calculation it refers to. The
+     * calculation's own scope decides the grain it runs at: `segment` per
+     * record, `workout` at the end of the workout.
+     */
+    readonly name: string;
+}
+/** What a tag contributes. */
+type TagContribution = TagMetricContribution | TagTagContribution | TagFunctionContribution;
+/** A tag and what it contributes. */
+interface TagDefinition {
+    /** The slug a script references: `#slug`. */
+    readonly slug: string;
+    /** What the tag contributes when referenced. */
+    readonly contributions: readonly TagContribution[];
+}
+/** A slug → tag lookup. */
+interface TagIndex {
+    /**
+     * The tag with this slug, or `undefined` when the catalogue has no such
+     * tag.
+     */
+    resolve(slug: string): TagDefinition | undefined;
+    /** Every tag in the index. */
+    list(): readonly TagDefinition[];
+}
+/**
+ * A host-supplied source of tags.
+ *
+ * The language never reads storage: the host loads its tags and hands the
+ * language a {@link TagIndex}. A host implements this to feed the parser a
+ * database-configured catalogue.
+ */
+interface ITagSource {
+    /** Load every tag the host knows about. */
+    loadTags(): Promise<readonly TagDefinition[]>;
+}
+/**
+ * Build a tag index from tag definitions.
+ *
+ * Later definitions of the same slug win, matching how the app layers
+ * user-defined tags over seeded ones.
+ */
+declare function createTagIndex(tags: readonly TagDefinition[]): TagIndex;
+
+/**
+ * Tag references — the tag a metric came from.
+ *
+ * A script line can point at a tag (`5 reps @ 100 kg #heavy`), and the tag
+ * brings metrics, other tags and functions. The metrics it brings record
+ * where they came from, so the editor can show the tag, link to it, and the
+ * compiler can compose what the block used.
+ *
+ * Pure data: survives the stored-logs / JSON round-trip.
+ */
+/** A tag reference: the tag, what it carries, and what it names. */
+interface TagReferenceMetadata {
+    /** The tag's slug — what `#slug` refers to. */
+    slug: string;
+    /** The tag's display label (its slug, for now). */
+    label: string;
+    /** The functions the tag carries — named calculations it activates. */
+    functions?: readonly string[];
+    /**
+     * The sound profile the tag selects, when it names one. A tag that carries
+     * a sound metric points at the profile that metric names.
+     */
+    soundProfileId?: string;
+}
+/** Metadata key under which {@link TagReferenceMetadata} is stored on a metric. */
+declare const TAG_REFERENCE_METADATA_KEY = "tagReference";
+/**
+ * Read the tag reference off a metric's metadata. Validates shape before
+ * trusting persisted input: an unknown-shape payload is ignored rather than
+ * partially honored.
+ */
+declare function getTagReference(metadata: Record<string, unknown> | undefined): TagReferenceMetadata | undefined;
+
 /** Cross-note fingerprint of the trimmed, unfenced workout body. Never an occurrence ID. */
 declare function blockContentId(content: string): string;
 
@@ -1041,6 +1158,8 @@ interface Note {
     seedChunkId?: string;
     /** Authored seed path used for deterministic identity and routing. */
     sourcePath?: string;
+    /** Git commit hash in which this note was published or changed. */
+    seedCommit?: string;
 }
 interface Page {
     id: string;
@@ -1064,10 +1183,21 @@ interface TagTypeRecord {
     color?: string;
     createdAt: number;
 }
+/**
+ * A tag: a named bundle a script can reference with `#slug`.
+ *
+ * Keeping the contributions on the tag means the meaning lives in one place
+ * instead of being repeated on every line that wants the tag.
+ */
 interface Tag {
     id: string;
     label: string;
     type?: TagType;
+    /**
+     * What this tag contributes when referenced from script content: metrics,
+     * other tags, and functions.
+     */
+    contributions?: TagContribution[];
     createdAt: number;
 }
 interface NoteTag {
@@ -1629,13 +1759,13 @@ declare function patchFrontmatterProperty(raw: string, path: readonly string[],
  * Auto-generated build version metadata.
  * Do not edit directly; updated by scripts/stamp-version.ts
  */
-declare const VERSION = "0.43.2153";
-declare const GIT_SHA = "3bb3096";
-declare const BUILD_TIME = "2026-10-22T21:06:18.747Z";
+declare const VERSION = "0.44.2155";
+declare const GIT_SHA = "6807397";
+declare const BUILD_TIME = "2026-10-24T03:58:47.392Z";
 declare const SEMVER: {
-    readonly version: "0.43.2153";
-    readonly gitSha: "3bb3096";
-    readonly buildTime: "2026-10-22T21:06:18.747Z";
+    readonly version: "0.44.2155";
+    readonly gitSha: "6807397";
+    readonly buildTime: "2026-10-24T03:58:47.392Z";
 };
 
-export { type AnalyticsDataPoint, type AnalyticsGraphConfig, type AnalyticsGroup, type Attachment, BUILD_TIME, type BlockEffort, type BlockEquipment, type BlockIndexRow, BlockKey, type BlockRevision, type CatalogBackfillState, CodeMetadata, CodeStatement, DEFAULT_NOTEBOOK_SLUGS, type DefaultNotebookSlug, type DialectAnalysis, type DimensionKey, type DisplayStatus, type EventGrain, type EventRecord, type FenceDialect, type FieldCatalogEntry, type FieldContribution, type FieldLeaf, type FieldRef, type FieldSourceRecord, type FieldValueKind, type FieldValueRecord, type FrontMatterSubtype, type FrontmatterPatchValue, GIT_SHA, type IBlockKey, type ICodeMetadata, type ICodeStatement, type IDialect, type IDialectTagDescriptor, type IMetric, type IMetricOwnershipResolver, type IMetricSource, type IOutputStatement, type IScript, KNOWN_OUTPUT_TYPES, KNOWN_SECTION_WIDGETS, LEGACY_ORIGIN_TO_OWNERSHIP_LAYER, METRIC_OWNERSHIP_LAYER_CHAIN, type Membership, Metric, type MetricAction, MetricContainer, type MetricFilter, type MetricOrigin, type MetricOwnershipLayer, type MetricOwnershipLedger, type MetricOwnershipOutcome, type MetricOwnershipPromotionCandidate, type MetricOwnershipQuery, type MetricOwnershipResolvedContribution, type MetricOwnershipTypeExplanation, type MetricTemporal, MetricType, type MetricWithOptionalOwnershipLayer, NOTEBOOK_TAG_PREFIX, type Note, type NoteBlock, type NoteBlockChange, type NoteBlockKind, type NoteKind, type NoteTag, type Notebook, type NotebookId, type NotebookOrigin, type NullValueKind, type Origin, OutputStatement, type OutputStatementOptions, type OutputStatementType, OwnershipResolver, type Page, type PageNote, type ParseError, ParsedCodeStatement, REFERENCE_METADATA_KEY, type ReconcileNoteBlocksOptions, type ReducerStats, type ReferenceDiagnostic, type ReferenceDiagnosticReason, type ReferenceKind, type ReferenceMatchKind, type ReferenceMetadata, type ReferenceRef, type ResultOrigin, SEMVER, SYSTEM_DEFAULT_OUTPUT_UNIT, type ScriptBlock, type ScriptBlockState, type Section, type SectionDocument, type SectionRecognitionOptions, type SectionType, type Segment, type Session, type StoredOutputStatement, type SummaryCoverage, type Tag, type TagType, type TagTypeRecord, type TimeSpan, UNIT_CATALOG, UnitConversionError, type UnitDefinition, type UnitErrorCode, VALID_FENCE_DIALECTS, VERSION, type VisualizerFilter, type VisualizerSize, type WorkoutResults, type WorkoutSectionType, actionableSectionKind, blockContentId, buildRawContent, calculateTotalLines, convertViaCatalog, createMetricOwnershipLedger, detectScriptBlocks, dimensionKeyOf, extractBlockContent, fieldRefFromKey, fieldRefKey, findBlockAtLine, flattenFieldLeaves, fromNotebookTag, getMetricOwnershipLayer, getReferenceMetadata, isNoteEditable, isNotebookTag, isWorkoutSectionType, lookupUnit, mapNoteBlockChanges, matchDialectFence, normalizeFieldComponent, normalizeFieldPath, notebookSlugFromId, ownershipRank, parseDocumentSections, patchFrontmatterProperty, reconcileNoteBlocks, resolveLayer, runAffordance, systemDefaultUnit, toNotebookId, toNotebookTag, validateNoteBlocks, valueKindOf };
+export { type AnalyticsDataPoint, type AnalyticsGraphConfig, type AnalyticsGroup, type Attachment, BUILD_TIME, type BlockEffort, type BlockEquipment, type BlockIndexRow, BlockKey, type BlockRevision, type CatalogBackfillState, CodeMetadata, CodeStatement, DEFAULT_NOTEBOOK_SLUGS, type DefaultNotebookSlug, type DialectAnalysis, type DimensionKey, type DisplayStatus, type EventGrain, type EventRecord, type FenceDialect, type FieldCatalogEntry, type FieldContribution, type FieldLeaf, type FieldRef, type FieldSourceRecord, type FieldValueKind, type FieldValueRecord, type FrontMatterSubtype, type FrontmatterPatchValue, GIT_SHA, type IBlockKey, type ICodeMetadata, type ICodeStatement, type IDialect, type IDialectTagDescriptor, type IMetric, type IMetricOwnershipResolver, type IMetricSource, type IOutputStatement, type IScript, type ITagSource, KNOWN_OUTPUT_TYPES, KNOWN_SECTION_WIDGETS, LEGACY_ORIGIN_TO_OWNERSHIP_LAYER, METRIC_OWNERSHIP_LAYER_CHAIN, type Membership, Metric, type MetricAction, MetricContainer, type MetricFilter, type MetricOrigin, type MetricOwnershipLayer, type MetricOwnershipLedger, type MetricOwnershipOutcome, type MetricOwnershipPromotionCandidate, type MetricOwnershipQuery, type MetricOwnershipResolvedContribution, type MetricOwnershipTypeExplanation, type MetricTemporal, MetricType, type MetricWithOptionalOwnershipLayer, NOTEBOOK_TAG_PREFIX, type Note, type NoteBlock, type NoteBlockChange, type NoteBlockKind, type NoteKind, type NoteTag, type Notebook, type NotebookId, type NotebookOrigin, type NullValueKind, type Origin, OutputStatement, type OutputStatementOptions, type OutputStatementType, OwnershipResolver, type Page, type PageNote, type ParseError, ParsedCodeStatement, REFERENCE_METADATA_KEY, type ReconcileNoteBlocksOptions, type ReducerStats, type ReferenceDiagnostic, type ReferenceDiagnosticReason, type ReferenceKind, type ReferenceMatchKind, type ReferenceMetadata, type ReferenceRef, type ResultOrigin, SEMVER, SYSTEM_DEFAULT_OUTPUT_UNIT, type ScriptBlock, type ScriptBlockState, type Section, type SectionDocument, type SectionRecognitionOptions, type SectionType, type Segment, type Session, type StoredOutputStatement, type SummaryCoverage, TAG_REFERENCE_METADATA_KEY, type Tag, type TagContribution, type TagDefinition, type TagFunctionContribution, type TagIndex, type TagMetricContribution, type TagReferenceMetadata, type TagTagContribution, type TagType, type TagTypeRecord, type TimeSpan, UNIT_CATALOG, UnitConversionError, type UnitDefinition, type UnitErrorCode, VALID_FENCE_DIALECTS, VERSION, type VisualizerFilter, type VisualizerSize, type WorkoutResults, type WorkoutSectionType, actionableSectionKind, blockContentId, buildRawContent, calculateTotalLines, convertViaCatalog, createMetricOwnershipLedger, createTagIndex, detectScriptBlocks, dimensionKeyOf, extractBlockContent, fieldRefFromKey, fieldRefKey, findBlockAtLine, flattenFieldLeaves, fromNotebookTag, getMetricOwnershipLayer, getReferenceMetadata, getTagReference, isNoteEditable, isNotebookTag, isWorkoutSectionType, lookupUnit, mapNoteBlockChanges, matchDialectFence, normalizeFieldComponent, normalizeFieldPath, notebookSlugFromId, ownershipRank, parseDocumentSections, patchFrontmatterProperty, reconcileNoteBlocks, resolveLayer, runAffordance, systemDefaultUnit, toNotebookId, toNotebookTag, validateNoteBlocks, valueKindOf };

package/dist/index.mjs

@@ -961,6 +961,31 @@ var BlockKey = class {
   }
 };
 
+// src/models/Tag.ts
+function createTagIndex(tags) {
+  const bySlug = /* @__PURE__ */ new Map();
+  for (const tag of tags) {
+    bySlug.set(tag.slug, tag);
+  }
+  return {
+    resolve: (slug) => bySlug.get(slug),
+    list: () => [...bySlug.values()]
+  };
+}
+
+// src/models/TagReference.ts
+var TAG_REFERENCE_METADATA_KEY = "tagReference";
+function getTagReference(metadata) {
+  const value = metadata?.[TAG_REFERENCE_METADATA_KEY];
+  if (!value || typeof value !== "object") return void 0;
+  const candidate = value;
+  if (typeof candidate.slug !== "string" || !candidate.slug) return void 0;
+  if (typeof candidate.label !== "string") return void 0;
+  if (candidate.functions !== void 0 && !Array.isArray(candidate.functions)) return void 0;
+  if (candidate.soundProfileId !== void 0 && typeof candidate.soundProfileId !== "string") return void 0;
+  return value;
+}
+
 // src/models/blockContentId.ts
 function blockContentId(content) {
   const normalized = content.trim();
@@ -1407,15 +1432,15 @@ function patchFrontmatterProperty(raw, path, value) {
 }
 
 // src/version.ts
-var VERSION = "0.43.2153";
-var GIT_SHA = "3bb3096";
-var BUILD_TIME = "2026-10-22T21:06:18.747Z";
+var VERSION = "0.44.2155";
+var GIT_SHA = "6807397";
+var BUILD_TIME = "2026-10-24T03:58:47.392Z";
 var SEMVER = {
-  version: "0.43.2153",
-  gitSha: "3bb3096",
-  buildTime: "2026-10-22T21:06:18.747Z"
+  version: "0.44.2155",
+  gitSha: "6807397",
+  buildTime: "2026-10-24T03:58:47.392Z"
 };
 
-export { BUILD_TIME, BlockKey, CodeMetadata, CodeStatement, DEFAULT_NOTEBOOK_SLUGS, GIT_SHA, KNOWN_OUTPUT_TYPES, KNOWN_SECTION_WIDGETS, LEGACY_ORIGIN_TO_OWNERSHIP_LAYER, METRIC_OWNERSHIP_LAYER_CHAIN, Metric, MetricContainer, MetricType, NOTEBOOK_TAG_PREFIX, OutputStatement, OwnershipResolver, ParsedCodeStatement, REFERENCE_METADATA_KEY, SEMVER, SYSTEM_DEFAULT_OUTPUT_UNIT, UNIT_CATALOG, UnitConversionError, VALID_FENCE_DIALECTS, VERSION, actionableSectionKind, blockContentId, buildRawContent, calculateTotalLines, convertViaCatalog, createMetricOwnershipLedger, detectScriptBlocks, dimensionKeyOf, extractBlockContent, fieldRefFromKey, fieldRefKey, findBlockAtLine, flattenFieldLeaves, fromNotebookTag, getMetricOwnershipLayer, getReferenceMetadata, isNoteEditable, isNotebookTag, isWorkoutSectionType, lookupUnit, mapNoteBlockChanges, matchDialectFence, normalizeFieldComponent, normalizeFieldPath, notebookSlugFromId, ownershipRank, parseDocumentSections, patchFrontmatterProperty, reconcileNoteBlocks, resolveLayer, runAffordance, systemDefaultUnit, toNotebookId, toNotebookTag, validateNoteBlocks, valueKindOf };
+export { BUILD_TIME, BlockKey, CodeMetadata, CodeStatement, DEFAULT_NOTEBOOK_SLUGS, GIT_SHA, KNOWN_OUTPUT_TYPES, KNOWN_SECTION_WIDGETS, LEGACY_ORIGIN_TO_OWNERSHIP_LAYER, METRIC_OWNERSHIP_LAYER_CHAIN, Metric, MetricContainer, MetricType, NOTEBOOK_TAG_PREFIX, OutputStatement, OwnershipResolver, ParsedCodeStatement, REFERENCE_METADATA_KEY, SEMVER, SYSTEM_DEFAULT_OUTPUT_UNIT, TAG_REFERENCE_METADATA_KEY, UNIT_CATALOG, UnitConversionError, VALID_FENCE_DIALECTS, VERSION, actionableSectionKind, blockContentId, buildRawContent, calculateTotalLines, convertViaCatalog, createMetricOwnershipLedger, createTagIndex, detectScriptBlocks, dimensionKeyOf, extractBlockContent, fieldRefFromKey, fieldRefKey, findBlockAtLine, flattenFieldLeaves, fromNotebookTag, getMetricOwnershipLayer, getReferenceMetadata, getTagReference, isNoteEditable, isNotebookTag, isWorkoutSectionType, lookupUnit, mapNoteBlockChanges, matchDialectFence, normalizeFieldComponent, normalizeFieldPath, notebookSlugFromId, ownershipRank, parseDocumentSections, patchFrontmatterProperty, reconcileNoteBlocks, resolveLayer, runAffordance, systemDefaultUnit, toNotebookId, toNotebookTag, validateNoteBlocks, valueKindOf };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map