pbiplint 0.2.1 → 0.2.2

package/dist/pbiplint.mjs

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 
 // ../core/src/version.ts
-var VERSION = "0.2.1";
+var VERSION = "0.2.2";
 
 // ../core/src/engine/config.ts
 var ConfigError = class extends Error {
 };
 function bindConfig(config, rules) {
   const ruleByUpper = new Map(rules.map((r) => [r.id.toUpperCase(), r]));
-  const bound = {
+  const bound2 = {
     disabled: /* @__PURE__ */ new Set(),
     severity: /* @__PURE__ */ new Map(),
     options: /* @__PURE__ */ new Map(),
@@ -18,12 +18,12 @@ function bindConfig(config, rules) {
   for (const id of config.disabled) {
     const real = ruleByUpper.get(id.toUpperCase())?.id;
     if (real === void 0) unknownRules.push(id);
-    else bound.disabled.add(real);
+    else bound2.disabled.add(real);
   }
   for (const [id, severity] of config.severity) {
     const real = ruleByUpper.get(id.toUpperCase())?.id;
     if (real === void 0) unknownRules.push(id);
-    else bound.severity.set(real, severity);
+    else bound2.severity.set(real, severity);
   }
   for (const [id, options] of config.options) {
     const rule = ruleByUpper.get(id.toUpperCase());
@@ -51,9 +51,9 @@ function bindConfig(config, rules) {
           `pbiplint.config.json: rules["${real}"].${name} must be one of ${decl.values.join(", ")}`
         );
     }
-    bound.options.set(real, { ...options });
+    bound2.options.set(real, { ...options });
   }
-  return { config: bound, unknownRules: [...new Set(unknownRules)] };
+  return { config: bound2, unknownRules: [...new Set(unknownRules)] };
 }
 var SEVERITY_BY_NAME = { info: 1, warning: 2, error: 3 };
 var isRecord = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
@@ -205,12 +205,14 @@ function buildColumn(c, table) {
 }
 function buildMeasure(x, table) {
   const p = x.props;
+  const kpi = x.children.find((c) => c.type === "kpi")?.props;
   return {
     ...named(x),
     table,
     expression: x.value ?? "",
     formatString: str(p.formatstring),
     formatStringDefinition: str(p.formatstringdefinition),
+    kpiExpressions: kpi && [kpi.targetexpression, kpi.statusexpression, kpi.trendexpression].map(str).filter((e) => e !== void 0),
     isHidden: flag(p.ishidden),
     displayFolder: str(p.displayfolder)
   };
@@ -586,48 +588,215 @@ function buildReachabilityIndex(model, references, reportRefs) {
   };
 }
 
-// ../core/src/index/references.ts
-var QUALIFIED = /(?:'((?:[^']|'')+)'\s*|([\p{L}_][\p{L}\p{N}_]*))\[([^\]]+)\]/gu;
-var BARE = /\[([^\]]+)\]/g;
-function extractRefs(expression) {
-  const out = [];
-  const consumed = /* @__PURE__ */ new Set();
-  for (const m of expression.matchAll(QUALIFIED)) {
-    const table = m[1] !== void 0 ? m[1].replace(/''/g, "'") : m[2];
-    out.push({ table, name: m[3], qualified: true });
-    consumed.add(m.index + m[0].length - m[3].length - 2);
+// ../core/src/dax/tokenize.ts
+var OPERATORS = ["==", "<>", "<=", ">=", "&&", "||", "=", "<", ">", "+", "-", "*", "/", "^", "&"];
+var NUMBER = /(?:\d+(?:\.\d*)?|\.\d+)(?:[eE][+-]?\d+)?/y;
+var IDENTIFIER = /[\p{L}_][\p{L}\p{M}\p{N}_.]*/uy;
+var WORD_CHAR = /[\p{L}\p{M}\p{N}_]/u;
+var DIGIT = /[0-9]/;
+var isWord = (t, word) => t?.kind === "identifier" && t.text.toUpperCase() === word;
+var isPunctuation = (t, char) => t?.kind === "punctuation" && t.text === char;
+function quoted(text2, from, close) {
+  let value = "";
+  let j = from + 1;
+  while (j < text2.length) {
+    const c = text2[j];
+    if (c === close) {
+      if (text2[j + 1] !== close) return { value, end: j + 1 };
+      j++;
+    }
+    value += c;
+    j++;
+  }
+  return { value, end: text2.length };
+}
+function tokenizeDax(expression) {
+  const s = expression;
+  const tokens = [];
+  const push2 = (kind, text2, start, end) => {
+    tokens.push({ kind, text: text2, start, end, depth: 0 });
+  };
+  let i = 0;
+  while (i < s.length) {
+    const c = s[i];
+    if (/\s/.test(c)) {
+      i++;
+    } else if (s.startsWith("//", i) || s.startsWith("--", i)) {
+      const nl = s.indexOf("\n", i);
+      i = nl === -1 ? s.length : nl;
+    } else if (s.startsWith("/*", i)) {
+      const close = s.indexOf("*/", i + 2);
+      i = close === -1 ? s.length : close + 2;
+    } else if (c === '"') {
+      const q2 = quoted(s, i, '"');
+      push2("string", q2.value, i, q2.end);
+      i = q2.end;
+    } else if ((c === "d" || c === "D") && (s[i + 1] === "t" || s[i + 1] === "T") && s[i + 2] === '"' && !(i > 0 && WORD_CHAR.test(s[i - 1]))) {
+      const q2 = quoted(s, i + 2, '"');
+      push2("date", q2.value, i, q2.end);
+      i = q2.end;
+    } else if (c === "'" || c === "[") {
+      const q2 = quoted(s, i, c === "'" ? "'" : "]");
+      push2(c === "'" ? "table" : "column", q2.value, i, q2.end);
+      i = q2.end;
+    } else if (DIGIT.test(c) || c === "." && DIGIT.test(s[i + 1] ?? "")) {
+      NUMBER.lastIndex = i;
+      const text2 = NUMBER.exec(s)[0];
+      push2("number", text2, i, i + text2.length);
+      i += text2.length;
+    } else {
+      IDENTIFIER.lastIndex = i;
+      const id = IDENTIFIER.exec(s)?.[0];
+      const op = id === void 0 ? OPERATORS.find((o) => s.startsWith(o, i)) : void 0;
+      const text2 = id ?? op ?? c;
+      push2(
+        id !== void 0 ? "identifier" : op !== void 0 ? "operator" : "punctuation",
+        text2,
+        i,
+        i + text2.length
+      );
+      i += text2.length;
+    }
   }
-  for (const m of expression.matchAll(BARE)) {
-    if (consumed.has(m.index)) continue;
-    out.push({ name: m[1], qualified: false });
+  annotate(tokens);
+  return tokens;
+}
+function annotate(tokens) {
+  const open = [];
+  const args = [];
+  const place = (t) => {
+    t.depth = open.length;
+    if (open.length === 0) return;
+    t.parent = open[open.length - 1];
+    t.arg = args[args.length - 1];
+  };
+  tokens.forEach((t, k) => {
+    if (isPunctuation(t, "(") || isPunctuation(t, "{")) {
+      place(t);
+      const before = tokens[k - 1];
+      if (t.text === "(" && before?.kind === "identifier") t.call = before.text.toUpperCase();
+      open.push(k);
+      args.push(0);
+    } else if (isPunctuation(t, ")") || isPunctuation(t, "}")) {
+      const o = open.pop();
+      args.pop();
+      if (o !== void 0) {
+        tokens[o].close = k;
+        t.open = o;
+      }
+      place(t);
+    } else {
+      place(t);
+      if (isPunctuation(t, ",") && args.length > 0) args[args.length - 1] = args.at(-1) + 1;
+    }
+  });
+}
+function opensBlock(tokens, k) {
+  if (isWord(tokens[k - 1], "RETURN")) return true;
+  const eq = tokens[k - 1];
+  return isWord(tokens[k - 3], "VAR") && tokens[k - 2]?.kind === "identifier" && eq?.kind === "operator" && eq.text === "=";
+}
+function daxVariables(tokens) {
+  const out = [];
+  tokens.forEach((t, k) => {
+    const name = tokens[k + 1];
+    const eq = tokens[k + 2];
+    if (!isWord(t, "VAR") || name?.kind !== "identifier" || eq?.kind !== "operator") return;
+    if (eq.text !== "=") return;
+    const from = k + 3;
+    let to = from;
+    let nested = 0;
+    for (; to < tokens.length; to++) {
+      const x = tokens[to];
+      if (x.depth < t.depth) break;
+      if (x.depth !== t.depth) continue;
+      if (isWord(x, "VAR")) {
+        if (opensBlock(tokens, to)) nested++;
+        else if (nested === 0) break;
+      } else if (isWord(x, "RETURN")) {
+        if (nested === 0) break;
+        nested--;
+      }
+    }
+    let blockEnd2 = to;
+    for (; blockEnd2 < tokens.length; blockEnd2++) {
+      const x = tokens[blockEnd2];
+      if (x.depth < t.depth || x.depth === t.depth && isPunctuation(x, ",")) break;
+    }
+    out.push({ name: name.text, at: k, from, to, blockEnd: blockEnd2 });
+  });
+  for (const v of out)
+    for (const d of out) if (d.from <= v.at && v.at < d.to && d.to < v.blockEnd) v.blockEnd = d.to;
+  return out;
+}
+function variableAt(vars, name, use) {
+  const key4 = name.toUpperCase();
+  let found;
+  for (const v of vars)
+    if (v.name.toUpperCase() === key4 && v.at < use && use < v.blockEnd && !(v.from <= use && use < v.to))
+      found = v;
+  return found;
+}
+
+// ../core/src/index/references.ts
+var CREATES_COLUMNS = /* @__PURE__ */ new Set([
+  "ADDCOLUMNS",
+  "SELECTCOLUMNS",
+  "SUMMARIZE",
+  "SUMMARIZECOLUMNS",
+  "ROW",
+  "DATATABLE"
+]);
+function createdColumns(tokens) {
+  const out = /* @__PURE__ */ new Map();
+  for (const t of tokens) {
+    if (t.kind !== "string" || t.parent === void 0) continue;
+    const open = tokens[t.parent];
+    if (open.call === void 0 || !CREATES_COLUMNS.has(open.call)) continue;
+    const name = t.text.toLowerCase();
+    out.set(name, [...out.get(name) ?? [], [t.parent, open.close ?? tokens.length]]);
   }
   return out;
 }
+function refsInTokens(tokens) {
+  const created = createdColumns(tokens);
+  const out = [];
+  tokens.forEach((t, k) => {
+    if (t.kind !== "column") return;
+    const before = tokens[k - 1];
+    if (isPunctuation(before, ".") && tokens[k - 2]?.kind === "column") return;
+    if (before?.kind === "table" || before?.kind === "identifier" && before.end === t.start) {
+      out.push({ table: before.text, name: t.text, qualified: true });
+      return;
+    }
+    const calls = created.get(t.text.toLowerCase());
+    if (calls?.every(([open, close]) => k < open || k > close))
+      out.push({ name: t.text, qualified: false, created: true });
+    else out.push({ name: t.text, qualified: false });
+  });
+  return out;
+}
 var lower2 = (s) => s.toLowerCase();
 var key = (table, name) => `${lower2(table)} ${lower2(name)}`;
-var escapeRegExp = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 function functionCallReader(functions) {
   if (functions.length === 0) return () => [];
   const byName2 = /* @__PURE__ */ new Map();
   for (const f of functions) if (!byName2.has(lower2(f.name))) byName2.set(lower2(f.name), f);
-  const call = new RegExp(
-    `(^|[^\\p{L}\\p{N}_.])(${[...byName2.keys()].map(escapeRegExp).join("|")})(?=\\s*\\()`,
-    "giu"
-  );
   const order3 = new Map(functions.map((f, i) => [f, i]));
-  return (expression) => {
+  return (tokens) => {
     const found = /* @__PURE__ */ new Set();
-    for (const m of expression.matchAll(call)) {
-      const f = byName2.get(lower2(m[2]));
+    tokens.forEach((t, k) => {
+      const f = t.call === void 0 ? void 0 : byName2.get(lower2(tokens[k - 1].text));
       if (f) found.add(f);
-    }
+    });
     return [...found].sort((a, b) => order3.get(a) - order3.get(b));
   };
 }
-function resolveBareName(name, owner, lookup) {
+function resolveBareName(ref, owner, lookup) {
+  const { name } = ref;
   const measure = lookup.measureNamed(name);
   if (measure !== void 0) return { kind: "measure", measure };
-  if (owner.kind === "calculationItem") return { kind: "none" };
+  if (ref.created || owner.kind === "calculationItem") return { kind: "none" };
   if (owner.kind === "function") {
     const columns2 = lookup.tables.flatMap((t) => lookup.columnOf(t, name) ?? []);
     return columns2.length > 0 ? { kind: "columns", columns: columns2 } : { kind: "none" };
@@ -664,7 +833,7 @@ function buildReferenceIndex(model) {
       if (meas) return { kind: "measure", table: t.name, name: meas.name, qualified: true };
       return { kind: "unresolved", table: raw.table, name: raw.name, qualified: true };
     }
-    const bare = resolveBareName(raw.name, { kind: ownerKind, table: ownerTable }, lookup);
+    const bare = resolveBareName(raw, { kind: ownerKind, table: ownerTable }, lookup);
     if (bare.kind === "measure")
       return {
         kind: "measure",
@@ -686,19 +855,26 @@ function buildReferenceIndex(model) {
   const byObject = /* @__PURE__ */ new Map();
   const add = (of, ownerTable, ...expressions) => {
     const expression = expressions.filter((e) => e !== void 0).join("\n");
+    const tokens = tokenizeDax(expression);
     const owner = {
       ...of,
       ownerTable,
       expression,
-      refs: extractRefs(expression).flatMap((r) => resolve4(r, ownerTable, of.kind)),
-      calls: callsIn(expression)
+      refs: refsInTokens(tokens).flatMap((r) => resolve4(r, ownerTable, of.kind)),
+      calls: callsIn(tokens)
     };
     owners.push(owner);
     byObject.set(of.object, owner);
   };
   for (const t of model.tables) {
     for (const m of t.measures)
-      add({ kind: "measure", object: m }, t, m.expression, m.formatStringDefinition);
+      add(
+        { kind: "measure", object: m },
+        t,
+        m.expression,
+        m.formatStringDefinition,
+        ...m.kpiExpressions ?? []
+      );
     for (const c of t.columns)
       if (c.kind === "calculated") add({ kind: "calculatedColumn", object: c }, t, c.expression);
     if (t.kind === "calculated")
@@ -932,9 +1108,14 @@ function buildReportReferenceIndex(report, model) {
       return inModel ? { table: inModel.table.name, name: inModel.name } : reportMeasuresByName.get(lower3(name));
     }
   };
+  const callsIn = functionCallReader(model?.functions ?? []);
+  const functionCalls = [];
   for (const m of report.measures) {
     const owner = { kind: "reportMeasure", object: m };
-    for (const raw of extractRefs(m.expression)) {
+    const tokens = tokenizeDax(m.expression);
+    const calls = callsIn(tokens);
+    if (calls.length > 0) functionCalls.push({ measure: m, calls });
+    for (const raw of refsInTokens(tokens)) {
       if (raw.qualified) {
         const t = tables.get(lower3(raw.table));
         const kind = t && measureOf(t, raw.name) || reportMeasures.has(`${lower3(raw.table)}\0${lower3(raw.name)}`) ? "measure" : "column";
@@ -942,7 +1123,7 @@ function buildReportReferenceIndex(report, model) {
         continue;
       }
       const bare = resolveBareName(
-        raw.name,
+        raw,
         { kind: "reportMeasure", table: tables.get(lower3(m.table)) },
         bareLookup
       );
@@ -970,19 +1151,8 @@ function buildReportReferenceIndex(report, model) {
         });
     }
   }
-  const callsIn = functionCallReader(model?.functions ?? []);
-  const functionCalls = report.measures.map((measure) => ({ measure, calls: callsIn(measure.expression) })).filter((c) => c.calls.length > 0);
-  const byTarget = /* @__PURE__ */ new Map();
-  for (const r of refs) {
-    const target = r.resolution.kind === "column" ? r.resolution.column : r.resolution.kind === "measure" ? r.resolution.measure : void 0;
-    if (!target) continue;
-    const arr = byTarget.get(target) ?? [];
-    arr.push(r);
-    byTarget.set(target, arr);
-  }
   return {
     refs,
-    referencedBy: (target) => byTarget.get(target) ?? [],
     unresolved: () => refs.filter((r) => r.resolution.kind === "unresolved"),
     fieldsOf: (v) => refs.filter((r) => r.owner.kind === "visualField" && r.owner.object === v),
     functionCalls
@@ -1037,7 +1207,7 @@ var isRecord2 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
 var kindOf = (v) => v === null ? "null" : Array.isArray(v) ? "an array" : typeof v === "string" ? "a string" : typeof v === "number" ? "a number" : "a boolean";
 var CONFLICT_MARKER = /^(?:<{7}|={7}|>{7})(?:\s|$)/;
 var LINE_BREAK = /\r\n?|\n/;
-function quoted(line) {
+function quoted2(line) {
   if (line === void 0 || line.length <= 120) return line ?? "";
   const text2 = line.trimStart();
   if (text2.length <= 120) return text2;
@@ -1086,7 +1256,7 @@ function readJson(file, text2, options = {}) {
   const body = text2.charCodeAt(0) === 65279 ? text2.slice(1) : text2;
   const lines = body.split(LINE_BREAK);
   const issues = lines.flatMap(
-    (line, i) => CONFLICT_MARKER.test(line) ? [{ file, line: i + 1, text: quoted(line), reason: "merge conflict marker" }] : []
+    (line, i) => CONFLICT_MARKER.test(line) ? [{ file, line: i + 1, text: quoted2(line), reason: "merge conflict marker" }] : []
   );
   if (issues.length > 0) return { json: void 0, issues };
   let json;
@@ -1098,7 +1268,7 @@ function readJson(file, text2, options = {}) {
     const flat = message.replace(/\s+/g, " ");
     return {
       json: void 0,
-      issues: [{ file, line, text: quoted(lines[line - 1]), reason: `not valid JSON (${flat})` }]
+      issues: [{ file, line, text: quoted2(lines[line - 1]), reason: `not valid JSON (${flat})` }]
     };
   }
   const deep = tooDeepAt(body);
@@ -1110,7 +1280,7 @@ function readJson(file, text2, options = {}) {
         {
           file,
           line,
-          text: quoted(lines[line - 1]),
+          text: quoted2(lines[line - 1]),
           reason: `nested more than ${MAX_DEPTH} levels deep`
         }
       ]
@@ -1125,7 +1295,7 @@ function readJson(file, text2, options = {}) {
         {
           file,
           line: start + 1,
-          text: quoted(lines[start]),
+          text: quoted2(lines[start]),
           reason: `not a JSON object (the file holds ${kindOf(json)})`
         }
       ]
@@ -1357,13 +1527,16 @@ function filtersOf(filterConfig, file, pointer) {
     if (!isRecord4(f)) return [];
     const p = `${pointer}/filters/${i}`;
     const field = collectFieldRefs(f.field, `${p}/field`)[0];
+    const where = isRecord4(f.filter) && Array.isArray(f.filter.Where) ? f.filter.Where : void 0;
     return [
       {
         name: str2(f.name) ?? String(i),
         type: str2(f.type),
+        howCreated: str2(f.howCreated),
         ...field ? { field } : {},
         refs: collectFieldRefs(f, p),
         applied: isRecord4(f.filter),
+        ...where ? { where } : {},
         file,
         pointer: p
       }
@@ -1533,6 +1706,8 @@ function buildBookmark(id, file, text2, json) {
           visual,
           pointer: `/explorationState/sections/${escapePointer(page)}/visualContainers/${escapePointer(visual)}`
         });
+  const options = isRecord4(json.options) ? json.options : {};
+  const names = Array.isArray(options.targetVisualNames) ? options.targetVisualNames : [];
   return {
     id: str2(json.name) ?? id,
     displayName: str2(json.displayName) ?? id,
@@ -1541,6 +1716,11 @@ function buildBookmark(id, file, text2, json) {
     ...str2(state.activeSection) !== void 0 ? { activePage: str2(state.activeSection) } : {},
     pages: Object.keys(sections),
     visuals,
+    ...options.applyOnlyToTargetVisuals === true ? {
+      targetVisuals: names.flatMap(
+        (visual, i) => typeof visual === "string" ? [{ visual, pointer: `/options/targetVisualNames/${i}` }] : []
+      )
+    } : {},
     refs: collectFieldRefs(state, "/explorationState")
   };
 }
@@ -1893,7 +2073,7 @@ var dataType = (c) => (c.dataType ?? "").toLowerCase();
 var isNumericType = (c) => ["int64", "decimal", "double"].includes(dataType(c));
 var hiddenOrTableHidden = (c) => c.isHidden || c.table.isHidden;
 var isBlank = (s) => s === void 0 || s.trim() === "";
-var escapeRegExp2 = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+var escapeRegExp = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 var isDirectQueryTable = (t) => t.kind === "table" && t.partitions[0]?.mode === "directquery";
 var modelPartlyRead = (m) => m.unreadPaths.length > 0 || m.files.some((f) => f.issues.some((i) => i.canDropObjects));
 var tablesPartlyRead = (m) => m.unreadPaths.length > 0 || m.files.some((f) => f.issues.some((i) => i.canDropTableLine));
@@ -1986,6 +2166,13 @@ var finding = {
     location: e.location,
     object: e
   }),
+  /** A user-defined function, named bare (`Local.AddTax`) as Tabular Editor names it. */
+  function: (f) => ({
+    objectType: "Function",
+    objectName: f.name,
+    location: f.location,
+    object: f
+  }),
   dataSource: (d) => ({
     objectType: "DataSource",
     objectName: d.name,
@@ -2059,6 +2246,11 @@ var reportMeasureLabel = (m) => `[${m.name}] (report)`;
 var pageFilterLabel = (p) => `Page filter on "${p.displayName}"`;
 var REPORT_LABEL = "Report";
 var REPORT_FILTER_LABEL = "Report filter";
+var fieldLabel = (ref) => {
+  const inTable = (name) => ref.table === "" ? measureRef(name) : columnRef(ref.table, name);
+  const field = ref.variation ? `${inTable(ref.variation.column)}.${measureRef(ref.name)}` : ref.kind === "measure" ? measureRef(ref.name) : inTable(ref.name);
+  return ref.kind === "hierarchyLevel" && ref.level ? `${field}.${measureRef(ref.level)}` : field;
+};
 
 // ../core/src/rules/report-helpers.ts
 var isRecord5 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
@@ -3304,7 +3496,7 @@ var RULE_SUMMARIES = {
   "AVOID_USING_MANY-TO-MANY_RELATIONSHIPS_ON_TABLES_USED_FOR_DYNAMIC_ROW_LEVEL_SECURITY": "Regular tables that carry a row-level security filter in any role and take part in a many-to-many relationship.",
   AVOID_USING_THE_IFERROR_FUNCTION: "Measures and calculated columns that call IFERROR.",
   BROKEN_ACTION_TARGET: "Buttons, shapes, and images whose page navigation, drillthrough, or bookmark action names a page or a bookmark the report does not have, matched against the `name` in each page.json and bookmark file.",
-  BROKEN_BOOKMARK_REFERENCE: "Bookmarks whose active page, or another page they capture, is not in the report, or which capture a visual that is not on its page, matched against the `name` in each page.json and visual.json.",
+  BROKEN_BOOKMARK_REFERENCE: "Bookmarks whose active page, or another page they capture, is not in the report, which capture a visual that is not on its page, or which apply only to selected visuals and name one that is not on their active page, matched against the `name` in each page.json and visual.json.",
   BROKEN_FIELD_REFERENCE: "References in the report to a table, column, measure, hierarchy, or hierarchy level that the model does not have, wherever the report names a field: a visual's wells, formatting, and sort, a filter on a visual, a page, or the whole report, a drillthrough or tooltip page's fields, and a bookmark.",
   CALCULATION_GROUPS_WITH_NO_CALCULATION_ITEMS: "Calculation groups that contain no calculation items.",
   "CHECK_IF_BI-DIRECTIONAL_AND_MANY-TO-MANY_RELATIONSHIPS_ARE_VALID": "Every relationship that is bi-directional, many-to-many, or both. This is a review list at info severity, not a defect.",
@@ -3328,6 +3520,7 @@ var RULE_SUMMARIES = {
   FIX_REFERENTIAL_INTEGRITY_VIOLATIONS: "Relationships where the many side holds key values that do not exist on the one side. The count of offending rows is a statistic of the loaded data, not of the model files, so pbiplint lists this rule but does not run it: it needs statistics that only a live model carries.",
   "FORMAT_FLAG_COLUMNS_AS_YES/NO_VALUE_STRINGS": "Visible columns whose name starts with Is and whose type is whole number, and visible columns whose name ends with the word Flag after a space and whose type is not text.",
   HARDCODED_PERIOD_IN_DAX: "Measures, calculated columns, and calculation items whose DAX fixes a year or a date, and date tables whose CALENDAR ends on a fixed date.",
+  HARDCODED_YEAR_IN_FILTER: "Filters in the Filters pane, on a visual, a page, or all pages, that hold a year column to fixed years: years picked in Basic filtering, a year set with Advanced filtering's is, years kept up to one with is less than or is less than or equal to, and a range between two years.",
   HIDDEN_VISUAL_WITH_FIELDS: "Visuals hidden in the Selection pane, with their own eye icon or with that of a group they sit in, that still have fields in their wells.",
   HIDE_FACT_TABLE_COLUMNS: "Visible numeric columns that a measure aggregates directly with a fully qualified reference, such as `SUM('Sales'[Amount])`. COUNT, COUNTBLANK, SUM, AVERAGE, MIN, MAX, DISTINCTCOUNT, VALUES, DISTINCT, and the A-suffixed COUNTA, AVERAGEA, MAXA, and MINA count as aggregations.",
   HIDE_FOREIGN_KEYS: "Visible columns whose name matches the from column of a relationship whose from side is many. Only the from cardinality is tested, so a many-to-many relationship counts here too, not just many-to-one.",
@@ -3382,6 +3575,9 @@ var RULE_SUMMARIES = {
   SPLIT_DATE_AND_TIME: "DateTime columns holding values that are not at midnight. Whether any row carries a time is a statistic of the loaded data, not of the model files, so pbiplint lists this rule but does not run it: it needs statistics that only a live model carries.",
   TAB_ORDER_FOLLOWS_LAYOUT: "Pages whose tab order, the order keyboard users move through the visuals in, disagrees with the order the layout reads in: rows from top to bottom, and left to right within a row. The rule checks this only when the project's policy asks for tab order to follow the layout, and reports nothing without it.",
   TRIM_OBJECT_NAMES: "Names that start or end with a space, across every named object type in the model.",
+  UDF_NOT_CALLED: "User-defined functions that no measure, calculated column, calculated table, calculation item, row-level security filter, format string expression, KPI, or other function in the model calls. The functions of a DAX Lib package, which share one `DAXLIB_PackageId` annotation, count as one: the package is reported once, on its first function, when nothing outside it calls any of them.",
+  UDF_USE_COMPOUND_NAMES: "User-defined functions whose name holds neither a dot nor an underscore, such as `AddTax`. Tabular Editor 3 has a built-in rule with the same test.",
+  UDF_WITHOUT_DESCRIPTION: "User-defined functions with no description, or one of only spaces, other than functions installed from a DAX Lib package. Tabular Editor 3 has a built-in rule with the same test, which also reports package functions.",
   UNNECESSARY_COLUMNS: "Hidden columns, or columns in hidden tables, that nothing references: no DAX expression, relationship, hierarchy, sort-by column, group-by column, row-level security filter, or object-level security rule.",
   UNNECESSARY_MEASURES: "Hidden measures, or measures on hidden tables, that no DAX expression references.",
   "UNPIVOT_PIVOTED_(MONTH)_DATA": "Tables that have a numeric column for each of Jan, Feb, Mar, Apr, May, and Jun, matched as substrings of the column names.",
@@ -3413,6 +3609,7 @@ var SCOPE_MAP = {
   NamedExpression: "NamedExpression",
   ProviderDataSource: "DataSource",
   StructuredDataSource: "DataSource",
+  UserDefinedFunction: "Function",
   KPI: null
 };
 function mapScope(scope) {
@@ -3580,7 +3777,7 @@ var HIDE_FACT_TABLE_COLUMNS = bpaRule("HIDE_FACT_TABLE_COLUMNS", (m) => {
   return columns(m, (c) => {
     if (c.isHidden || !isNumericType(c)) return false;
     const re = new RegExp(
-      `(?:${AGGREGATIONS.join("|")})\\s*\\(\\s*'*${escapeRegExp2(c.table.name)}'*\\[${escapeRegExp2(c.name)}\\]\\s*\\)`,
+      `(?:${AGGREGATIONS.join("|")})\\s*\\(\\s*'*${escapeRegExp(c.table.name)}'*\\[${escapeRegExp(c.name)}\\]\\s*\\)`,
       "i"
     );
     return measures.some((x) => re.test(x.expression));
@@ -3925,7 +4122,7 @@ var INACTIVE_RELATIONSHIPS_THAT_ARE_NEVER_ACTIVATED = bpaRule(
     return m.relationships.filter((r) => {
       if (r.isActive) return false;
       const re = new RegExp(
-        `USERELATIONSHIP\\s*\\(\\s*'*${escapeRegExp2(r.fromTable)}'*\\[${escapeRegExp2(r.fromColumn)}\\]\\s*,\\s*'*${escapeRegExp2(r.toTable)}'*\\[${escapeRegExp2(r.toColumn)}\\]`,
+        `USERELATIONSHIP\\s*\\(\\s*'*${escapeRegExp(r.fromTable)}'*\\[${escapeRegExp(r.fromColumn)}\\]\\s*,\\s*'*${escapeRegExp(r.toTable)}'*\\[${escapeRegExp(r.toColumn)}\\]`,
         "i"
       );
       return !expressions.some((e) => re.test(e));
@@ -4107,7 +4304,7 @@ var AVOID_THE_USERELATIONSHIP_FUNCTION_AND_RLS_AGAINST_THE_SAME_TABLE = bpaRule(
     return tablesInScope(m).filter((t) => {
       if (!permissions.some((tp) => tp.table === t.name && tp.filter !== void 0)) return false;
       const re = new RegExp(
-        `USERELATIONSHIP\\s*\\(\\s*.+?(?=\\])\\]\\s*,\\s*'*${escapeRegExp2(t.name)}'*\\[`,
+        `USERELATIONSHIP\\s*\\(\\s*.+?(?=\\])\\]\\s*,\\s*'*${escapeRegExp(t.name)}'*\\[`,
         "i"
       );
       return measures.some((x) => re.test(x.expression));
@@ -4489,404 +4686,34 @@ function pbiplintRule(spec) {
   };
 }
 
-// ../core/src/rules/pbiplint/actions.ts
-var CHECKED = /* @__PURE__ */ new Map([
-  ["pagenavigation", { action: "Page navigation", object: "page" }],
-  ["drillthrough", { action: "Drillthrough", object: "page" }],
-  ["bookmark", { action: "Bookmark", object: "bookmark" }]
-]);
-var BROKEN_ACTION_TARGET = pbiplintRule({
-  id: "BROKEN_ACTION_TARGET",
-  name: "Action points at nothing",
-  category: "Error Prevention",
-  severity: 3,
-  scope: ["Visual"],
-  layer: "report",
-  check: ({ report }) => {
-    if (!report) return [];
-    const pages = new Set(report.pages.map((p) => p.id));
-    const bookmarks = new Set(report.bookmarks.map((b) => b.id));
-    const exists = {
-      page: (name) => pages.has(name) || pageUnread(report, name),
-      bookmark: (name) => bookmarks.has(name) || bookmarkUnread(report, name)
-    };
-    return allVisuals(report).flatMap(
-      (v) => v.actions.flatMap((a) => {
-        const checked = CHECKED.get(a.type.toLowerCase());
-        if (!checked || !a.on || a.target === void 0) return [];
-        if (exists[checked.object](a.target)) return [];
-        return [
-          reportFinding.visual(
-            v,
-            a.pointer,
-            `${checked.action} action points at ${checked.object} "${a.target}", which does not exist`
-          )
-        ];
-      })
-    );
-  }
-});
-var ACTION_WITHOUT_DESTINATION = pbiplintRule({
-  id: "ACTION_WITHOUT_DESTINATION",
-  name: "Action has no destination",
-  category: "Report Design",
-  severity: 2,
-  scope: ["Visual"],
-  layer: "report",
-  // The same three types as BROKEN_ACTION_TARGET, on any visual, hidden or not. The pointer is the
-  // destination property when it is there and empty, else the entry's properties.
-  check: ({ report }) => report ? allVisuals(report).flatMap(
-    (v) => v.actions.flatMap((a) => {
-      const checked = CHECKED.get(a.type.toLowerCase());
-      if (!checked || !a.on || a.target !== void 0 || a.conditional) return [];
-      return [
-        reportFinding.visual(v, a.pointer, `${checked.action} action has no destination`)
-      ];
-    })
-  ) : []
-});
-var SECTIONS = "/explorationState/sections";
-var BROKEN_BOOKMARK_REFERENCE = pbiplintRule({
-  id: "BROKEN_BOOKMARK_REFERENCE",
-  name: "Bookmark refers to a missing page or visual",
-  category: "Error Prevention",
-  severity: 2,
-  scope: ["Bookmark"],
-  layer: "report",
-  // Groups are captured apart from visuals and are not read, nor is the list of target visuals.
-  // A page or a visual whose own file could not be read is there, under the folder name Desktop
-  // gives it, so it is never reported missing, and neither is one a folder that could not be read
-  // could hold.
-  check: ({ report }) => {
-    if (!report) return [];
-    const pages = new Map(report.pages.map((p) => [p.id, p]));
-    const missing = (id) => !pages.has(id) && !pageUnread(report, id);
-    return report.bookmarks.flatMap((b) => {
-      const out = [];
-      if (b.activePage !== void 0 && missing(b.activePage))
-        out.push(
-          reportFinding.bookmark(
-            b,
-            `active page "${b.activePage}" does not exist`,
-            "/explorationState/activeSection"
-          )
-        );
-      for (const id of b.pages)
-        if (id !== b.activePage && missing(id))
-          out.push(
-            reportFinding.bookmark(
-              b,
-              `captured page "${id}" does not exist`,
-              `${SECTIONS}/${escapePointer(id)}`
-            )
-          );
-      for (const { page, visual, pointer } of b.visuals) {
-        const p = pages.get(page);
-        if (p && !p.visuals.some((v) => v.id === visual) && !visualUnread(report, p, visual))
-          out.push(
-            reportFinding.bookmark(
-              b,
-              `captured visual "${visual}" is not on page "${p.displayName}"`,
-              pointer
-            )
-          );
-      }
-      return out;
-    });
-  }
-});
-var actionRules = [
-  BROKEN_ACTION_TARGET,
-  ACTION_WITHOUT_DESTINATION,
-  BROKEN_BOOKMARK_REFERENCE
-];
-
-// ../core/src/rules/pbiplint/measures.ts
-var REPORT_LEVEL_MEASURES = pbiplintRule({
-  id: "REPORT_LEVEL_MEASURES",
-  name: "Measure defined in the report",
-  category: "Maintenance",
-  severity: 2,
-  scope: ["ReportMeasure"],
-  layer: "report",
-  // Its findings are report objects, yet it reports only beside the model the report reads, so a
-  // run without the model skips it rather than counting it as run.
-  needs: ["model", "report"],
-  // The detail says where the measure lives; the rule's page gives the fix.
-  check: (project) => reportMeasuresToMove(project).map(
-    (m) => reportFinding.reportMeasure(m, `defined in the report on table "${m.table}"`)
-  )
-});
-var measureRules2 = [REPORT_LEVEL_MEASURES];
-
-// ../core/src/rules/pbiplint/opening.ts
-var LANDING_PAGE_NOT_SET = pbiplintRule({
-  id: "LANDING_PAGE_NOT_SET",
-  name: "No landing page set",
-  category: "Report Design",
-  severity: 1,
-  scope: ["Report"],
-  layer: "report",
-  check: ({ report }) => {
-    const opens = report && landingPageNotSet(report) ? openingPage(report) : void 0;
-    if (!report || !opens) return [];
-    const pointer = opens.by === "active" ? "/activePageName" : void 0;
-    if (opens.page === void 0 && !opens.unread)
-      return [
-        reportFinding.pagesHeader(
-          report,
-          pointer,
-          `no landing page set; the active page "${opens.name}" does not exist`
-        )
-      ];
-    const name = opens.page?.displayName ?? opens.name;
-    const which = opens.by === "first" ? "the first page" : "the page open when it was saved";
-    return [reportFinding.pagesHeader(report, pointer, `opens on "${name}", ${which}`)];
-  }
-});
-var OPENING_PAGE_INVALID = pbiplintRule({
-  id: "OPENING_PAGE_INVALID",
-  name: "Opening page missing or hidden",
-  category: "Error Prevention",
-  severity: 3,
-  scope: ["Report"],
-  layer: "report",
-  check: ({ report }) => {
-    const opens = report && openingPage(report);
-    if (!report || !opens || !openingPageInvalid(opens)) return [];
-    const pointer = opens.by === "landing" ? "/landingPageName" : "/activePageName";
-    const detail = opens.page === void 0 ? `${opens.by} page "${opens.name}" does not exist` : `active page "${opens.page.displayName}" is hidden from readers`;
-    return [reportFinding.pagesHeader(report, pointer, detail)];
-  }
-});
-var FILTERS_PANE_STATE = pbiplintRule({
-  id: "FILTERS_PANE_STATE",
-  name: "Filters pane state differs from policy",
-  category: "Report Design",
-  severity: 2,
-  scope: ["Report"],
-  layer: "report",
-  options: [{ name: "expect", type: "string", values: ["open", "closed"] }],
-  check: ({ report }, ctx) => {
-    const expect = ctx.options.expect;
-    if (!report || expect === void 0) return [];
-    const pane = filtersPaneState(report);
-    if (!pane || pane.state === expect) return [];
-    const { state, recordedAt } = pane;
-    const saved = recordedAt === void 0 ? `not recorded, read as ${state}` : `saved ${state}`;
-    return [
-      reportFinding.report(report, `${saved}; the policy expects ${expect}`, "report", recordedAt)
-    ];
-  }
-});
-var openingRules = [LANDING_PAGE_NOT_SET, OPENING_PAGE_INVALID, FILTERS_PANE_STATE];
-
-// ../core/src/rules/pbiplint/pages.ts
-var NEW_PAGE = "is the name Power BI Desktop gives a new page";
-var DUPLICATE = "is the name Power BI Desktop gives a duplicated page";
-var DEFAULT_NAMES = [
-  [/^(?:Page|Seite|Página|Pagina|ページ) [1-9]\d*$/, NEW_PAGE],
-  [/^(?:Duplicate of|Duplicado de|Doublon de|Duplicata de|Duplikat av) .+$/, DUPLICATE],
-  [/^Duplikat von ".+"$/, DUPLICATE],
-  [/^.+ \(copy\)$/, "is named as a copy"]
-];
-var recordedName = (p) => {
-  const name = p.json?.displayName;
-  return typeof name === "string" ? name : void 0;
-};
-var DEFAULT_PAGE_NAME = pbiplintRule({
-  id: "DEFAULT_PAGE_NAME",
-  name: "Page keeps its default name",
-  category: "Report Design",
-  severity: 2,
-  scope: ["Page"],
-  layer: "report",
-  check: ({ report }) => report ? report.pages.flatMap((p) => {
-    const name = recordedName(p);
-    const match = name === void 0 ? void 0 : DEFAULT_NAMES.find(([re]) => re.test(name));
-    return match ? [reportFinding.page(p, "/displayName", `"${name}" ${match[1]}`)] : [];
-  }) : []
-});
-var pageRules2 = [DEFAULT_PAGE_NAME];
-
-// ../core/src/dax/tokenize.ts
-var OPERATORS = ["==", "<>", "<=", ">=", "&&", "||", "=", "<", ">", "+", "-", "*", "/", "^", "&"];
-var NUMBER = /(?:\d+(?:\.\d*)?|\.\d+)(?:[eE][+-]?\d+)?/y;
-var IDENTIFIER = /[\p{L}_][\p{L}\p{M}\p{N}_.]*/uy;
-var WORD_CHAR = /[\p{L}\p{M}\p{N}_]/u;
-var DIGIT = /[0-9]/;
-var isWord = (t, word) => t?.kind === "identifier" && t.text.toUpperCase() === word;
-var isPunctuation = (t, char) => t?.kind === "punctuation" && t.text === char;
-function quoted2(text2, from, close) {
-  let value = "";
-  let j = from + 1;
-  while (j < text2.length) {
-    const c = text2[j];
-    if (c === close) {
-      if (text2[j + 1] !== close) return { value, end: j + 1 };
-      j++;
-    }
-    value += c;
-    j++;
-  }
-  return { value, end: text2.length };
-}
-function tokenizeDax(expression) {
-  const s = expression;
-  const tokens = [];
-  const push2 = (kind, text2, start, end) => {
-    tokens.push({ kind, text: text2, start, end, depth: 0 });
-  };
-  let i = 0;
-  while (i < s.length) {
-    const c = s[i];
-    if (/\s/.test(c)) {
-      i++;
-    } else if (s.startsWith("//", i) || s.startsWith("--", i)) {
-      const nl = s.indexOf("\n", i);
-      i = nl === -1 ? s.length : nl;
-    } else if (s.startsWith("/*", i)) {
-      const close = s.indexOf("*/", i + 2);
-      i = close === -1 ? s.length : close + 2;
-    } else if (c === '"') {
-      const q2 = quoted2(s, i, '"');
-      push2("string", q2.value, i, q2.end);
-      i = q2.end;
-    } else if ((c === "d" || c === "D") && (s[i + 1] === "t" || s[i + 1] === "T") && s[i + 2] === '"' && !(i > 0 && WORD_CHAR.test(s[i - 1]))) {
-      const q2 = quoted2(s, i + 2, '"');
-      push2("date", q2.value, i, q2.end);
-      i = q2.end;
-    } else if (c === "'" || c === "[") {
-      const q2 = quoted2(s, i, c === "'" ? "'" : "]");
-      push2(c === "'" ? "table" : "column", q2.value, i, q2.end);
-      i = q2.end;
-    } else if (DIGIT.test(c) || c === "." && DIGIT.test(s[i + 1] ?? "")) {
-      NUMBER.lastIndex = i;
-      const text2 = NUMBER.exec(s)[0];
-      push2("number", text2, i, i + text2.length);
-      i += text2.length;
-    } else {
-      IDENTIFIER.lastIndex = i;
-      const id = IDENTIFIER.exec(s)?.[0];
-      const op = id === void 0 ? OPERATORS.find((o) => s.startsWith(o, i)) : void 0;
-      const text2 = id ?? op ?? c;
-      push2(
-        id !== void 0 ? "identifier" : op !== void 0 ? "operator" : "punctuation",
-        text2,
-        i,
-        i + text2.length
-      );
-      i += text2.length;
-    }
-  }
-  annotate(tokens);
-  return tokens;
-}
-function annotate(tokens) {
-  const open = [];
-  const args = [];
-  const place = (t) => {
-    t.depth = open.length;
-    if (open.length === 0) return;
-    t.parent = open[open.length - 1];
-    t.arg = args[args.length - 1];
-  };
-  tokens.forEach((t, k) => {
-    if (isPunctuation(t, "(") || isPunctuation(t, "{")) {
-      place(t);
-      const before = tokens[k - 1];
-      if (t.text === "(" && before?.kind === "identifier") t.call = before.text.toUpperCase();
-      open.push(k);
-      args.push(0);
-    } else if (isPunctuation(t, ")") || isPunctuation(t, "}")) {
-      const o = open.pop();
-      args.pop();
-      if (o !== void 0) {
-        tokens[o].close = k;
-        t.open = o;
-      }
-      place(t);
-    } else {
-      place(t);
-      if (isPunctuation(t, ",") && args.length > 0) args[args.length - 1] = args.at(-1) + 1;
-    }
-  });
-}
-function opensBlock(tokens, k) {
-  if (isWord(tokens[k - 1], "RETURN")) return true;
-  const eq = tokens[k - 1];
-  return isWord(tokens[k - 3], "VAR") && tokens[k - 2]?.kind === "identifier" && eq?.kind === "operator" && eq.text === "=";
-}
-function daxVariables(tokens) {
-  const out = [];
-  tokens.forEach((t, k) => {
-    const name = tokens[k + 1];
-    const eq = tokens[k + 2];
-    if (!isWord(t, "VAR") || name?.kind !== "identifier" || eq?.kind !== "operator") return;
-    if (eq.text !== "=") return;
-    const from = k + 3;
-    let to = from;
-    let nested = 0;
-    for (; to < tokens.length; to++) {
-      const x = tokens[to];
-      if (x.depth < t.depth) break;
-      if (x.depth !== t.depth) continue;
-      if (isWord(x, "VAR")) {
-        if (opensBlock(tokens, to)) nested++;
-        else if (nested === 0) break;
-      } else if (isWord(x, "RETURN")) {
-        if (nested === 0) break;
-        nested--;
-      }
-    }
-    let blockEnd2 = to;
-    for (; blockEnd2 < tokens.length; blockEnd2++) {
-      const x = tokens[blockEnd2];
-      if (x.depth < t.depth || x.depth === t.depth && isPunctuation(x, ",")) break;
-    }
-    out.push({ name: name.text, at: k, from, to, blockEnd: blockEnd2 });
-  });
-  for (const v of out)
-    for (const d of out) if (d.from <= v.at && v.at < d.to && d.to < v.blockEnd) v.blockEnd = d.to;
-  return out;
-}
-function variableAt(vars, name, use) {
-  const key4 = name.toUpperCase();
-  let found;
-  for (const v of vars)
-    if (v.name.toUpperCase() === key4 && v.at < use && use < v.blockEnd && !(v.from <= use && use < v.to))
-      found = v;
-  return found;
-}
-
-// ../core/src/rules/pbiplint/period-words.ts
-var YEAR_WORDS = /* @__PURE__ */ new Set([
-  "year",
-  "years",
-  "yr",
-  "yrs",
-  "a\xF1o",
-  "a\xF1os",
-  "ano",
-  "anos",
-  "anio",
-  "jahr",
-  "ann\xE9e",
-  "annee",
-  "anno",
-  "jaar",
-  "\xE5r",
-  "rok",
-  "vuosi",
-  "ejercicio",
-  "exercice",
-  "fy",
-  "ay",
-  "cy",
-  "ly",
-  "py",
-  "yyyy",
-  "y"
+// ../core/src/rules/pbiplint/period-words.ts
+var YEAR_WORDS = /* @__PURE__ */ new Set([
+  "year",
+  "years",
+  "yr",
+  "yrs",
+  "a\xF1o",
+  "a\xF1os",
+  "ano",
+  "anos",
+  "anio",
+  "jahr",
+  "ann\xE9e",
+  "annee",
+  "anno",
+  "jaar",
+  "\xE5r",
+  "rok",
+  "vuosi",
+  "ejercicio",
+  "exercice",
+  "fy",
+  "ay",
+  "cy",
+  "ly",
+  "py",
+  "yyyy",
+  "y"
 ]);
 var MONTH_WORDS = /* @__PURE__ */ new Set([
   "month",
@@ -4933,6 +4760,7 @@ function nameClass(name) {
 // ../core/src/rules/pbiplint/period-forms.ts
 var FIRST_YEAR = 1950;
 var LAST_YEAR = 2049;
+var inYearRange = (year) => year >= FIRST_YEAR && year <= LAST_YEAR;
 var COMPARISONS = /* @__PURE__ */ new Set(["=", "==", "<>"]);
 var WRAPPERS = /* @__PURE__ */ new Set([
   "SELECTEDVALUE",
@@ -4966,7 +4794,7 @@ function yearIn(t, strings) {
   const text2 = t?.kind === "number" ? t.text : strings && t?.kind === "string" ? t.text.trim() : void 0;
   if (text2 === void 0 || !/^\d{4}$/.test(text2)) return void 0;
   const year = Number(text2);
-  return year >= FIRST_YEAR && year <= LAST_YEAR ? year : void 0;
+  return inYearRange(year) ? year : void 0;
 }
 function argumentsOf(tokens, open) {
   const end = tokens[open]?.close ?? tokens.length;
@@ -5066,14 +4894,14 @@ function expressionPeriods(expression) {
       }
     if (t.call === "DATE" && !isBound(tokens, k) && !isYearFreeFormat(tokens, k)) {
       const [y, m, d] = argumentsOf(tokens, k).map((span) => only(tokens, span));
-      const fixed = yearIn(y, false);
-      if (fixed !== void 0) {
+      const fixed2 = yearIn(y, false);
+      if (fixed2 !== void 0) {
         if (isWhole(m) && isWhole(d)) {
           const [month, day] = [Number(m.text), Number(d.text)];
-          const epoch = fixed === UNIX_EPOCH.year && month === UNIX_EPOCH.month && day === UNIX_EPOCH.day;
-          const date = daxDate(fixed, month, day);
-          if (!epoch && date) found.push({ at: tokens[k - 1].start, year: fixed, date });
-        } else year(y, fixed);
+          const epoch = fixed2 === UNIX_EPOCH.year && month === UNIX_EPOCH.month && day === UNIX_EPOCH.day;
+          const date = daxDate(fixed2, month, day);
+          if (!epoch && date) found.push({ at: tokens[k - 1].start, year: fixed2, date });
+        } else year(y, fixed2);
       }
     }
   });
@@ -5234,27 +5062,417 @@ function periodFindings(model) {
         )
       );
   }
-  return out;
-}
-var HARDCODED_PERIOD_IN_DAX = pbiplintRule({
-  id: "HARDCODED_PERIOD_IN_DAX",
-  name: "Hardcoded period in DAX",
-  category: "DAX Expressions",
-  severity: 1,
-  scope: ["Measure", "CalculatedColumn", "CalculationItem", "CalculatedTable"],
-  layer: "model",
-  // No skipWhenModelUnread: each finding rests on the object's own expression, so a file the
-  // parser could not read can hide an object from the rule, never put a period in one.
-  check: ({ model }) => model ? periodFindings(model) : []
+  return out;
+}
+var HARDCODED_PERIOD_IN_DAX = pbiplintRule({
+  id: "HARDCODED_PERIOD_IN_DAX",
+  name: "Hardcoded period in DAX",
+  category: "DAX Expressions",
+  severity: 1,
+  scope: ["Measure", "CalculatedColumn", "CalculationItem", "CalculatedTable"],
+  layer: "model",
+  // No skipWhenModelUnread: each finding rests on the object's own expression, so a file the
+  // parser could not read can hide an object from the rule, never put a period in one.
+  check: ({ model }) => model ? periodFindings(model) : []
+});
+var periodRules = [HARDCODED_PERIOD_IN_DAX];
+
+// ../core/src/rules/pbiplint/actions.ts
+var CHECKED = /* @__PURE__ */ new Map([
+  ["pagenavigation", { action: "Page navigation", object: "page" }],
+  ["drillthrough", { action: "Drillthrough", object: "page" }],
+  ["bookmark", { action: "Bookmark", object: "bookmark" }]
+]);
+var BROKEN_ACTION_TARGET = pbiplintRule({
+  id: "BROKEN_ACTION_TARGET",
+  name: "Action points at nothing",
+  category: "Error Prevention",
+  severity: 3,
+  scope: ["Visual"],
+  layer: "report",
+  check: ({ report }) => {
+    if (!report) return [];
+    const pages = new Set(report.pages.map((p) => p.id));
+    const bookmarks = new Set(report.bookmarks.map((b) => b.id));
+    const exists = {
+      page: (name) => pages.has(name) || pageUnread(report, name),
+      bookmark: (name) => bookmarks.has(name) || bookmarkUnread(report, name)
+    };
+    return allVisuals(report).flatMap(
+      (v) => v.actions.flatMap((a) => {
+        const checked = CHECKED.get(a.type.toLowerCase());
+        if (!checked || !a.on || a.target === void 0) return [];
+        if (exists[checked.object](a.target)) return [];
+        return [
+          reportFinding.visual(
+            v,
+            a.pointer,
+            `${checked.action} action points at ${checked.object} "${a.target}", which does not exist`
+          )
+        ];
+      })
+    );
+  }
+});
+var ACTION_WITHOUT_DESTINATION = pbiplintRule({
+  id: "ACTION_WITHOUT_DESTINATION",
+  name: "Action has no destination",
+  category: "Report Design",
+  severity: 2,
+  scope: ["Visual"],
+  layer: "report",
+  // The same three types as BROKEN_ACTION_TARGET, on any visual, hidden or not. The pointer is the
+  // destination property when it is there and empty, else the entry's properties.
+  check: ({ report }) => report ? allVisuals(report).flatMap(
+    (v) => v.actions.flatMap((a) => {
+      const checked = CHECKED.get(a.type.toLowerCase());
+      if (!checked || !a.on || a.target !== void 0 || a.conditional) return [];
+      return [
+        reportFinding.visual(v, a.pointer, `${checked.action} action has no destination`)
+      ];
+    })
+  ) : []
+});
+var SECTIONS = "/explorationState/sections";
+var BROKEN_BOOKMARK_REFERENCE = pbiplintRule({
+  id: "BROKEN_BOOKMARK_REFERENCE",
+  name: "Bookmark refers to a missing page or visual",
+  category: "Error Prevention",
+  severity: 2,
+  scope: ["Bookmark"],
+  layer: "report",
+  // Groups, captured apart from visuals under `visualContainerGroups`, are not read. A page or a
+  // visual whose own file could not be read is there, under the folder name Desktop gives it, so
+  // it is never reported missing, and neither is one a folder that could not be read could hold.
+  check: ({ report }) => {
+    if (!report) return [];
+    const pages = new Map(report.pages.map((p) => [p.id, p]));
+    const missing = (id) => !pages.has(id) && !pageUnread(report, id);
+    const notOn = (p, id) => !p.visuals.some((v) => v.id === id) && !visualUnread(report, p, id);
+    return report.bookmarks.flatMap((b) => {
+      const out = [];
+      if (b.activePage !== void 0 && missing(b.activePage))
+        out.push(
+          reportFinding.bookmark(
+            b,
+            `active page "${b.activePage}" does not exist`,
+            "/explorationState/activeSection"
+          )
+        );
+      for (const id of b.pages)
+        if (id !== b.activePage && missing(id))
+          out.push(
+            reportFinding.bookmark(
+              b,
+              `captured page "${id}" does not exist`,
+              `${SECTIONS}/${escapePointer(id)}`
+            )
+          );
+      for (const { page, visual, pointer } of b.visuals) {
+        const p = pages.get(page);
+        if (p && notOn(p, visual))
+          out.push(
+            reportFinding.bookmark(
+              b,
+              `captured visual "${visual}" is not on page "${p.displayName}"`,
+              pointer
+            )
+          );
+      }
+      const active = b.activePage === void 0 ? void 0 : pages.get(b.activePage);
+      const stale = active ? (b.targetVisuals ?? []).filter((t) => notOn(active, t.visual)) : [];
+      if (active && stale.length > 0) {
+        const many = stale.length > 1;
+        const names = englishList(stale.map((t) => `"${t.visual}"`));
+        out.push(
+          reportFinding.bookmark(
+            b,
+            `target visual${many ? "s" : ""} ${names} ${many ? "are" : "is"} not on page "${active.displayName}"`,
+            stale[0].pointer
+          )
+        );
+      }
+      return out;
+    });
+  }
+});
+var actionRules = [
+  BROKEN_ACTION_TARGET,
+  ACTION_WITHOUT_DESTINATION,
+  BROKEN_BOOKMARK_REFERENCE
+];
+
+// ../core/src/rules/pbiplint/filters.ts
+var isRecord7 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+function yearOf(e) {
+  const value = isRecord7(e) && isRecord7(e.Literal) ? e.Literal.Value : void 0;
+  const m = typeof value === "string" ? /^(?:(\d{4})L|'(\d{4})')$/.exec(value) : null;
+  const year = m ? Number(m[1] ?? m[2]) : void 0;
+  return year !== void 0 && inYearRange(year) ? year : void 0;
+}
+function isYearColumn(e) {
+  if (!isRecord7(e)) return false;
+  const name = isRecord7(e.Column) ? e.Column.Property : isRecord7(e.HierarchyLevel) ? e.HierarchyLevel.Level : void 0;
+  return typeof name === "string" && nameClass(name) === "year";
+}
+var fixed = (years) => `fixed year${years.length > 1 ? "s" : ""} ${englishList(years.map(String))}`;
+function keptYears(condition, at2) {
+  if (!isRecord7(condition)) return void 0;
+  const { In: inList, Comparison: compared2 } = condition;
+  if (isRecord7(inList) && Array.isArray(inList.Expressions) && inList.Expressions.length === 1 && isYearColumn(inList.Expressions[0]) && Array.isArray(inList.Values)) {
+    const found = inList.Values.flatMap((row, i) => {
+      const year = Array.isArray(row) && row.length === 1 ? yearOf(row[0]) : void 0;
+      return year === void 0 ? [] : [{ year, at: `${at2}/In/Values/${i}/0/Literal/Value` }];
+    });
+    if (found.length === 0) return void 0;
+    const years = [...new Set(found.map((f) => f.year))];
+    return { years, detail: fixed(years), at: found[0].at };
+  }
+  if (isRecord7(compared2) && compared2.ComparisonKind === 0 && isYearColumn(compared2.Left)) {
+    const year = yearOf(compared2.Right);
+    if (year === void 0) return void 0;
+    return { years: [year], detail: fixed([year]), at: `${at2}/Comparison/Right/Literal/Value` };
+  }
+  return void 0;
+}
+function bound(condition, at2) {
+  const compared2 = isRecord7(condition) ? condition.Comparison : void 0;
+  if (!isRecord7(compared2) || !isYearColumn(compared2.Left)) return void 0;
+  const year = yearOf(compared2.Right);
+  if (year === void 0) return void 0;
+  const literal2 = `${at2}/Comparison/Right/Literal/Value`;
+  switch (compared2.ComparisonKind) {
+    case 1:
+      return { side: "lower", year: year + 1, at: literal2 };
+    case 2:
+      return { side: "lower", year, at: literal2 };
+    case 3:
+      return { side: "upper", year: year - 1, at: literal2 };
+    case 4:
+      return { side: "upper", year, at: literal2 };
+    default:
+      return void 0;
+  }
+}
+function yearsUpTo(condition, at2) {
+  const alone = bound(condition, at2);
+  if (alone?.side === "upper")
+    return { years: [alone.year], detail: `years up to ${alone.year}`, at: alone.at };
+  const both = isRecord7(condition) ? condition.And : void 0;
+  if (!isRecord7(both)) return void 0;
+  const sides = [bound(both.Left, `${at2}/And/Left`), bound(both.Right, `${at2}/And/Right`)];
+  const lower4 = sides.find((b) => b?.side === "lower");
+  const upper = sides.find((b) => b?.side === "upper");
+  if (!lower4 || !upper) return void 0;
+  return {
+    years: [lower4.year, upper.year],
+    detail: `years ${lower4.year} to ${upper.year}`,
+    at: upper.at
+  };
+}
+function yearFinding(f, names, make) {
+  if (f.howCreated === "Drillthrough" || f.howCreated === "Drill") return [];
+  const kept = (f.where ?? []).map((w, i) => {
+    if (!isRecord7(w)) return void 0;
+    const at2 = `${f.pointer}/filter/Where/${i}/Condition`;
+    return keptYears(w.Condition, at2) ?? yearsUpTo(w.Condition, at2);
+  }).find((k) => k !== void 0);
+  if (!kept || kept.years.some((y) => names.some((n2) => n2 !== void 0 && namesYear(n2, y))))
+    return [];
+  return [make(kept.at, f.field ? `${kept.detail} on ${fieldLabel(f.field)}` : kept.detail)];
+}
+function yearFindings(report) {
+  const out = report.filters.flatMap(
+    (f) => yearFinding(f, [], (at2, detail) => reportFinding.reportFilter(report, at2, detail))
+  );
+  for (const p of report.pages) {
+    for (const f of p.filters)
+      out.push(...yearFinding(f, [p.displayName], (at2, d) => reportFinding.pageFilter(p, at2, d)));
+    for (const v of p.visuals)
+      for (const f of v.filters)
+        out.push(
+          ...yearFinding(f, [p.displayName, v.title], (at2, d) => reportFinding.visual(v, at2, d))
+        );
+  }
+  return out;
+}
+var HARDCODED_YEAR_IN_FILTER = pbiplintRule({
+  id: "HARDCODED_YEAR_IN_FILTER",
+  name: "Hardcoded year in a filter",
+  category: "Report Design",
+  severity: 1,
+  scope: ["Visual", "Page", "Report"],
+  layer: "report",
+  // No skipWhenUnread: a report file that could not be read hides its filters from the rule,
+  // never adds one.
+  check: ({ report }) => report ? yearFindings(report) : []
+});
+var filterRules = [HARDCODED_YEAR_IN_FILTER];
+
+// ../core/src/rules/pbiplint/functions.ts
+var packageOf = (f) => f.annotations.DAXLIB_PackageId;
+function notCalled(model, references) {
+  const calledBy = (f) => references.functionCalledBy(f);
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const f of model.functions) {
+    const pkg = packageOf(f);
+    if (pkg === void 0) {
+      if (calledBy(f).length === 0) out.push(finding.function(f));
+      continue;
+    }
+    if (seen.has(pkg)) continue;
+    seen.add(pkg);
+    const members = model.functions.filter((g) => packageOf(g) === pkg);
+    const fromOutside = members.some(
+      (g) => calledBy(g).some((o) => !(o.kind === "function" && members.includes(o.object)))
+    );
+    if (fromOutside) continue;
+    const detail = members.length === 1 ? `package ${pkg}: its one function is not called` : `package ${pkg}: none of its ${members.length} functions is called`;
+    out.push({ ...finding.function(f), detail });
+  }
+  return out;
+}
+var UDF_NOT_CALLED = pbiplintRule({
+  id: "UDF_NOT_CALLED",
+  name: "User-defined function nothing calls",
+  category: "Maintenance",
+  severity: 1,
+  scope: ["Function"],
+  layer: "model",
+  // A model file pbiplint could not fully read may hold the call.
+  skipWhenModelUnread: modelPartlyRead,
+  check: ({ model }, { indexes: { references } }) => model ? notCalled(model, references) : []
+});
+var UDF_USE_COMPOUND_NAMES = pbiplintRule({
+  id: "UDF_USE_COMPOUND_NAMES",
+  name: "User-defined function with a one-word name",
+  category: "Error Prevention",
+  severity: 1,
+  scope: ["Function"],
+  layer: "model",
+  check: ({ model }) => (model?.functions ?? []).filter((f) => !f.name.includes(".") && !f.name.includes("_")).map(finding.function)
+});
+var UDF_WITHOUT_DESCRIPTION = pbiplintRule({
+  id: "UDF_WITHOUT_DESCRIPTION",
+  name: "User-defined function with no description",
+  category: "Maintenance",
+  severity: 1,
+  scope: ["Function"],
+  layer: "model",
+  check: ({ model }) => (model?.functions ?? []).filter((f) => packageOf(f) === void 0 && isBlank(f.description)).map(finding.function)
+});
+var functionRules = [UDF_NOT_CALLED, UDF_USE_COMPOUND_NAMES, UDF_WITHOUT_DESCRIPTION];
+
+// ../core/src/rules/pbiplint/measures.ts
+var REPORT_LEVEL_MEASURES = pbiplintRule({
+  id: "REPORT_LEVEL_MEASURES",
+  name: "Measure defined in the report",
+  category: "Maintenance",
+  severity: 2,
+  scope: ["ReportMeasure"],
+  layer: "report",
+  // Its findings are report objects, yet it reports only beside the model the report reads, so a
+  // run without the model skips it rather than counting it as run.
+  needs: ["model", "report"],
+  // The detail says where the measure lives; the rule's page gives the fix.
+  check: (project) => reportMeasuresToMove(project).map(
+    (m) => reportFinding.reportMeasure(m, `defined in the report on table "${m.table}"`)
+  )
+});
+var measureRules2 = [REPORT_LEVEL_MEASURES];
+
+// ../core/src/rules/pbiplint/opening.ts
+var LANDING_PAGE_NOT_SET = pbiplintRule({
+  id: "LANDING_PAGE_NOT_SET",
+  name: "No landing page set",
+  category: "Report Design",
+  severity: 1,
+  scope: ["Report"],
+  layer: "report",
+  check: ({ report }) => {
+    const opens = report && landingPageNotSet(report) ? openingPage(report) : void 0;
+    if (!report || !opens) return [];
+    const pointer = opens.by === "active" ? "/activePageName" : void 0;
+    if (opens.page === void 0 && !opens.unread)
+      return [
+        reportFinding.pagesHeader(
+          report,
+          pointer,
+          `no landing page set; the active page "${opens.name}" does not exist`
+        )
+      ];
+    const name = opens.page?.displayName ?? opens.name;
+    const which = opens.by === "first" ? "the first page" : "the page open when it was saved";
+    return [reportFinding.pagesHeader(report, pointer, `opens on "${name}", ${which}`)];
+  }
+});
+var OPENING_PAGE_INVALID = pbiplintRule({
+  id: "OPENING_PAGE_INVALID",
+  name: "Opening page missing or hidden",
+  category: "Error Prevention",
+  severity: 3,
+  scope: ["Report"],
+  layer: "report",
+  check: ({ report }) => {
+    const opens = report && openingPage(report);
+    if (!report || !opens || !openingPageInvalid(opens)) return [];
+    const pointer = opens.by === "landing" ? "/landingPageName" : "/activePageName";
+    const detail = opens.page === void 0 ? `${opens.by} page "${opens.name}" does not exist` : `active page "${opens.page.displayName}" is hidden from readers`;
+    return [reportFinding.pagesHeader(report, pointer, detail)];
+  }
 });
-var periodRules = [HARDCODED_PERIOD_IN_DAX];
+var FILTERS_PANE_STATE = pbiplintRule({
+  id: "FILTERS_PANE_STATE",
+  name: "Filters pane state differs from policy",
+  category: "Report Design",
+  severity: 2,
+  scope: ["Report"],
+  layer: "report",
+  options: [{ name: "expect", type: "string", values: ["open", "closed"] }],
+  check: ({ report }, ctx) => {
+    const expect = ctx.options.expect;
+    if (!report || expect === void 0) return [];
+    const pane = filtersPaneState(report);
+    if (!pane || pane.state === expect) return [];
+    const { state, recordedAt } = pane;
+    const saved = recordedAt === void 0 ? `not recorded, read as ${state}` : `saved ${state}`;
+    return [
+      reportFinding.report(report, `${saved}; the policy expects ${expect}`, "report", recordedAt)
+    ];
+  }
+});
+var openingRules = [LANDING_PAGE_NOT_SET, OPENING_PAGE_INVALID, FILTERS_PANE_STATE];
 
-// ../core/src/rules/pbiplint/references.ts
-var fieldLabel = (ref) => {
-  const inTable = (name) => ref.table === "" ? measureRef(name) : columnRef(ref.table, name);
-  const field = ref.variation ? `${inTable(ref.variation.column)}.${measureRef(ref.name)}` : ref.kind === "measure" ? measureRef(ref.name) : inTable(ref.name);
-  return ref.kind === "hierarchyLevel" && ref.level ? `${field}.${measureRef(ref.level)}` : field;
+// ../core/src/rules/pbiplint/pages.ts
+var NEW_PAGE = "is the name Power BI Desktop gives a new page";
+var DUPLICATE = "is the name Power BI Desktop gives a duplicated page";
+var DEFAULT_NAMES = [
+  [/^(?:Page|Seite|Página|Pagina|ページ) [1-9]\d*$/, NEW_PAGE],
+  [/^(?:Duplicate of|Duplicado de|Doublon de|Duplicata de|Duplikat av) .+$/, DUPLICATE],
+  [/^Duplikat von ".+"$/, DUPLICATE],
+  [/^.+ \(copy\)$/, "is named as a copy"]
+];
+var recordedName = (p) => {
+  const name = p.json?.displayName;
+  return typeof name === "string" ? name : void 0;
 };
+var DEFAULT_PAGE_NAME = pbiplintRule({
+  id: "DEFAULT_PAGE_NAME",
+  name: "Page keeps its default name",
+  category: "Report Design",
+  severity: 2,
+  scope: ["Page"],
+  layer: "report",
+  check: ({ report }) => report ? report.pages.flatMap((p) => {
+    const name = recordedName(p);
+    const match = name === void 0 ? void 0 : DEFAULT_NAMES.find(([re]) => re.test(name));
+    return match ? [reportFinding.page(p, "/displayName", `"${name}" ${match[1]}`)] : [];
+  }) : []
+});
+var pageRules2 = [DEFAULT_PAGE_NAME];
+
+// ../core/src/rules/pbiplint/references.ts
 var firstPerObjectAndField = (findings) => {
   const seen = /* @__PURE__ */ new Set();
   return findings.filter((f) => {
@@ -5525,6 +5743,8 @@ var pbiplintRules = [
   ...pageRules2,
   ...measureRules2,
   ...periodRules,
+  ...filterRules,
+  ...functionRules,
   ...actionRules,
   ...tabOrderRules
 ];
@@ -7512,17 +7732,19 @@ Why it matters
 
 A bookmark captures the state of a report page: Microsoft lists the current page among what a bookmark saves, with its filters and slicers, sort order, and which objects the Selection pane shows or hides. With its Current page option on, which Microsoft describes as navigating to the page that was active when the bookmark was created, a bookmark whose active page is not in the report has no page to take readers to, whether they select it in the Bookmarks pane or through a button or bookmark navigator that applies it. A captured visual that is not on its page is state kept for a visual the page does not have: whatever the bookmark was made to do to it, show it, hide it, or sort it, has nothing to act on.
 
-Microsoft's PBIR documentation, in its answer about a bookmark file copied from another report, says that Power BI Desktop removes invalid visuals from a bookmark's configuration when it saves. So a captured visual that names nothing usually means a bookmark file edited, copied, or merged outside Desktop and not saved in Desktop since. The documentation says nothing of the same for a missing page, and Power BI Desktop's saved files do keep bookmarks whose active page is gone.
+With Selected visuals on, Microsoft says the bookmark "Applies the bookmark settings only to the visuals you select before creating or updating the bookmark" (Create report bookmarks (https://learn.microsoft.com/power-bi/create-reports/desktop-bookmarks#create-report-bookmarks)), and the file keeps those visuals by name. A name in that list that no visual on the page has is a visual the bookmark was made to act on and can no longer reach. A visual put in its place since has a name of its own, which the list does not hold, so the bookmark leaves it alone.
+
+Microsoft's PBIR documentation, in its answer about a bookmark file copied from another report, says that Power BI Desktop removes invalid visuals from a bookmark's configuration when it saves. So a captured visual that names nothing usually means a bookmark file edited, copied, or merged outside Desktop and not saved in Desktop since. The documentation says nothing of the same for a missing page, and Power BI Desktop's saved files do keep bookmarks whose active page is gone. Power BI Desktop's saved files also keep names in the list of visuals a bookmark applies to after their visual is gone, even from a save that removed the same visual from the bookmark's captured visuals.
 
 How to fix it
 
-In Power BI Desktop, on the View tab, select Bookmarks to open the Bookmarks pane. Go to the page the bookmark should show, arrange its visuals as the bookmark should leave them, then select More options (...) next to the bookmark's name and choose Update. If nobody needs the bookmark any more, choose Delete from the same menu. Deleting it and adding a new one from the right page also works, but the new bookmark gets a new name, so point any button that used the old one at the new one; BROKEN_ACTION_TARGET reports any that still name it. For a captured visual that is no longer on the page, opening the report in Desktop and saving it is enough, since Desktop removes such visuals from the bookmark when it saves.
+In Power BI Desktop, on the View tab, select Bookmarks to open the Bookmarks pane. Go to the page the bookmark should show, arrange its visuals as the bookmark should leave them, then select More options (...) next to the bookmark's name and choose Update. If nobody needs the bookmark any more, choose Delete from the same menu. Deleting it and adding a new one from the right page also works, but the new bookmark gets a new name, so point any button that used the old one at the new one; BROKEN_ACTION_TARGET reports any that still name it. For a captured visual that is no longer on the page, opening the report in Desktop and saving it is enough, since Desktop removes such visuals from the bookmark when it saves. For a target visual, saving is not enough: select the visuals the bookmark should apply to, on the page or in the Selection pane (hold Ctrl to select more than one), then choose Update from the bookmark's More options (...) menu.
 
-In the bookmark file, a captured visual is a key under explorationState.sections.<page>.visualContainers, named by the visual's name: remove the key that names nothing, as the example does. A missing page is activeSection and the matching key of sections. Pointing both at the name of a page that exists leaves the bookmark holding state for the old page's visuals, which that page does not have, so for a missing page, recapture the bookmark in Desktop instead.
+In the bookmark file, a captured visual is a key under explorationState.sections.<page>.visualContainers, named by the visual's name: remove the key that names nothing, as the example does. A target visual is a string in options.targetVisualNames: remove each one that names nothing. To have the bookmark act on a visual added since, update it in Desktop as above. A missing page is activeSection and the matching key of sections. Pointing both at the name of a page that exists leaves the bookmark holding state for the old page's visuals, which that page does not have, so for a missing page, recapture the bookmark in Desktop instead.
 
 When to ignore it
 
-There is no legitimate case. A bookmark that names a page or visual the report lacks keeps state for something that is not there, so recapture it or delete it; a bookmark nobody uses is better deleted than ignored.
+There is no legitimate case. A bookmark that names a page or visual the report lacks keeps state for, or applies to, something that is not there, so recapture it or delete it; a bookmark nobody uses is better deleted than ignored.
 
 This rule reports on bookmarks, and a bookmark's file has no place for an annotation, so there is no object to annotate. To turn the rule off for a whole project, set "BROKEN_BOOKMARK_REFERENCE": "off" under rules in pbiplint.config.json.
 
@@ -7530,14 +7752,16 @@ Quirks
 
 - A bookmark captures one page. Power BI Desktop's saved files write one key in sections, the active page's, so a missing page is reported once, at activeSection. A sections key that names a different missing page is reported on its own line.
 - The rule reports a missing active page whether or not the bookmark's Current page option is on. With it off, Microsoft says the bookmark applies its settings to whichever page is being viewed, but the visuals it captured are still those of the page that is gone.
-- A captured visual is checked against the page it is captured under, and only when that page exists: a missing page is reported in place of the visuals captured under it.
-- Groups, which a bookmark keeps apart from visuals under visualContainerGroups, are not checked, nor is the list of visuals the Selected visuals option applies to, options.targetVisualNames. Power BI Desktop's saved files write that list in every bookmark, whether or not Selected visuals is on.
+- A captured visual is checked against the page it is captured under, and a target visual against the active page, whose visuals and groups the list names; each only when that page exists, since a missing page is reported in place of the visuals under it.
+- The list of target visuals is checked only when Selected visuals is on, which the file records as applyOnlyToTargetVisuals set to true beside the list. Power BI Desktop's saved files write the list in every bookmark whether or not the option is on, and with All visuals, Microsoft says, the bookmark applies to every visual on the page (Create report bookmarks (https://learn.microsoft.com/power-bi/create-reports/desktop-bookmarks#create-report-bookmarks)), so a name left in the list then is not reported.
+- A bookmark's stale target visuals are one finding together, while each stale captured visual is a finding of its own: one Update with the right visuals selected replaces the whole list.
+- A group the list names, which is a container on the page with no visual of its own, is found as a visual is. Groups that a bookmark keeps apart from visuals under visualContainerGroups, and the visuals listed as each group's children, are not checked.
 - Pages and visuals are matched by name, never by display name, and never by folder name, except when their own file cannot be read, as the next point says. Microsoft says renaming a name is supported, and that Power BI Desktop keeps the original folder names when it saves.
 - A page or a visual whose own file cannot be read, such as a page.json or a visual.json holding merge-conflict markers or one pbiplint could not open at all, is not reported missing, because pbiplint does not guess what a file it could not read says. It is known by its folder name instead, which Microsoft's PBIR documentation says is a page's or a visual's name by default, so a bookmark that captures it is not reported. Nor is a page or a visual that a folder under the definition folder, which pbiplint could not list, could hold, such as any visual on a page whose visuals folder could not be listed. The file's own PARSE_ISSUE finding names it, or a notice does for a file pbiplint could not open or a folder it could not list.
 - bookmarks.json, which holds the bookmarks' order and groups, is not checked: a name it lists with no bookmark file, or a bookmark file it does not list, is not reported.
 
 Read more: https://pbiplint.com/rules/broken-bookmark-reference`,
-    markdown: '### Example\n\n**Fires the rule in Reset.bookmark.json**\n\n```json\n{\n  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/bookmark/1.0.0/schema.json",\n  "name": "Reset",\n  "displayName": "Reset",\n  "explorationState": {\n    "version": "1.3",\n    "activeSection": "p1",\n    "sections": {\n      "p1": {\n        "visualContainers": {\n          "8b2e41c07d95a3f6e210": {\n            "singleVisual": {\n              "visualType": "tableEx",\n              "objects": {}\n            }\n          }\n        }\n      }\n    }\n  },\n  "options": {\n    "targetVisualNames": []\n  }\n}\n```\n\n**After the fix in Reset.bookmark.json**\n\n```json\n{\n  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/bookmark/1.0.0/schema.json",\n  "name": "Reset",\n  "displayName": "Reset",\n  "explorationState": {\n    "version": "1.3",\n    "activeSection": "p1",\n    "sections": {\n      "p1": {\n        "visualContainers": {}\n      }\n    }\n  },\n  "options": {\n    "targetVisualNames": []\n  }\n}\n```\n\nThe Reset bookmark captures the Overview page with the state of a table, `8b2e41c07d95a3f6e210`, that is not on the page, as a bookmark file copied in from another report or merged by hand can, so the finding reads `Bookmark "Reset"` with `captured visual "8b2e41c07d95a3f6e210" is not on page "Overview"`. The fix removes the table\'s entry from `visualContainers`.\n\n### Why it matters\n\nA bookmark captures the state of a report page: Microsoft lists the current page among what a bookmark saves, with its filters and slicers, sort order, and which objects the Selection pane shows or hides. With its Current page option on, which Microsoft describes as navigating to the page that was active when the bookmark was created, a bookmark whose active page is not in the report has no page to take readers to, whether they select it in the Bookmarks pane or through a button or bookmark navigator that applies it. A captured visual that is not on its page is state kept for a visual the page does not have: whatever the bookmark was made to do to it, show it, hide it, or sort it, has nothing to act on.\n\nMicrosoft\'s PBIR documentation, in its answer about a bookmark file copied from another report, says that Power BI Desktop removes invalid visuals from a bookmark\'s configuration when it saves. So a captured visual that names nothing usually means a bookmark file edited, copied, or merged outside Desktop and not saved in Desktop since. The documentation says nothing of the same for a missing page, and Power BI Desktop\'s saved files do keep bookmarks whose active page is gone.\n\n### How to fix it\n\nIn Power BI Desktop, on the View tab, select Bookmarks to open the Bookmarks pane. Go to the page the bookmark should show, arrange its visuals as the bookmark should leave them, then select More options (...) next to the bookmark\'s name and choose Update. If nobody needs the bookmark any more, choose Delete from the same menu. Deleting it and adding a new one from the right page also works, but the new bookmark gets a new `name`, so point any button that used the old one at the new one; `BROKEN_ACTION_TARGET` reports any that still name it. For a captured visual that is no longer on the page, opening the report in Desktop and saving it is enough, since Desktop removes such visuals from the bookmark when it saves.\n\nIn the bookmark file, a captured visual is a key under `explorationState.sections.<page>.visualContainers`, named by the visual\'s `name`: remove the key that names nothing, as the example does. A missing page is `activeSection` and the matching key of `sections`. Pointing both at the `name` of a page that exists leaves the bookmark holding state for the old page\'s visuals, which that page does not have, so for a missing page, recapture the bookmark in Desktop instead.\n\n### When to ignore it\n\nThere is no legitimate case. A bookmark that names a page or visual the report lacks keeps state for something that is not there, so recapture it or delete it; a bookmark nobody uses is better deleted than ignored.\n\nThis rule reports on bookmarks, and a bookmark\'s file has no place for an annotation, so there is no object to annotate. To turn the rule off for a whole project, set `"BROKEN_BOOKMARK_REFERENCE": "off"` under `rules` in `pbiplint.config.json`.\n\n### Quirks\n\n- A bookmark captures one page. Power BI Desktop\'s saved files write one key in `sections`, the active page\'s, so a missing page is reported once, at `activeSection`. A `sections` key that names a different missing page is reported on its own line.\n- The rule reports a missing active page whether or not the bookmark\'s Current page option is on. With it off, Microsoft says the bookmark applies its settings to whichever page is being viewed, but the visuals it captured are still those of the page that is gone.\n- A captured visual is checked against the page it is captured under, and only when that page exists: a missing page is reported in place of the visuals captured under it.\n- Groups, which a bookmark keeps apart from visuals under `visualContainerGroups`, are not checked, nor is the list of visuals the Selected visuals option applies to, `options.targetVisualNames`. Power BI Desktop\'s saved files write that list in every bookmark, whether or not Selected visuals is on.\n- Pages and visuals are matched by `name`, never by display name, and never by folder name, except when their own file cannot be read, as the next point says. Microsoft says renaming a `name` is supported, and that Power BI Desktop keeps the original folder names when it saves.\n- A page or a visual whose own file cannot be read, such as a page.json or a visual.json holding merge-conflict markers or one pbiplint could not open at all, is not reported missing, because pbiplint does not guess what a file it could not read says. It is known by its folder name instead, which Microsoft\'s PBIR documentation says is a page\'s or a visual\'s `name` by default, so a bookmark that captures it is not reported. Nor is a page or a visual that a folder under the definition folder, which pbiplint could not list, could hold, such as any visual on a page whose visuals folder could not be listed. The file\'s own `PARSE_ISSUE` finding names it, or a notice does for a file pbiplint could not open or a folder it could not list.\n- bookmarks.json, which holds the bookmarks\' order and groups, is not checked: a name it lists with no bookmark file, or a bookmark file it does not list, is not reported.\n\nRead more: https://pbiplint.com/rules/broken-bookmark-reference'
+    markdown: '### Example\n\n**Fires the rule in Reset.bookmark.json**\n\n```json\n{\n  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/bookmark/1.0.0/schema.json",\n  "name": "Reset",\n  "displayName": "Reset",\n  "explorationState": {\n    "version": "1.3",\n    "activeSection": "p1",\n    "sections": {\n      "p1": {\n        "visualContainers": {\n          "8b2e41c07d95a3f6e210": {\n            "singleVisual": {\n              "visualType": "tableEx",\n              "objects": {}\n            }\n          }\n        }\n      }\n    }\n  },\n  "options": {\n    "targetVisualNames": []\n  }\n}\n```\n\n**After the fix in Reset.bookmark.json**\n\n```json\n{\n  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/bookmark/1.0.0/schema.json",\n  "name": "Reset",\n  "displayName": "Reset",\n  "explorationState": {\n    "version": "1.3",\n    "activeSection": "p1",\n    "sections": {\n      "p1": {\n        "visualContainers": {}\n      }\n    }\n  },\n  "options": {\n    "targetVisualNames": []\n  }\n}\n```\n\nThe Reset bookmark captures the Overview page with the state of a table, `8b2e41c07d95a3f6e210`, that is not on the page, as a bookmark file copied in from another report or merged by hand can, so the finding reads `Bookmark "Reset"` with `captured visual "8b2e41c07d95a3f6e210" is not on page "Overview"`. The fix removes the table\'s entry from `visualContainers`.\n\n### Why it matters\n\nA bookmark captures the state of a report page: Microsoft lists the current page among what a bookmark saves, with its filters and slicers, sort order, and which objects the Selection pane shows or hides. With its Current page option on, which Microsoft describes as navigating to the page that was active when the bookmark was created, a bookmark whose active page is not in the report has no page to take readers to, whether they select it in the Bookmarks pane or through a button or bookmark navigator that applies it. A captured visual that is not on its page is state kept for a visual the page does not have: whatever the bookmark was made to do to it, show it, hide it, or sort it, has nothing to act on.\n\nWith Selected visuals on, Microsoft says the bookmark "Applies the bookmark settings only to the visuals you select before creating or updating the bookmark" ([Create report bookmarks](https://learn.microsoft.com/power-bi/create-reports/desktop-bookmarks#create-report-bookmarks)), and the file keeps those visuals by `name`. A name in that list that no visual on the page has is a visual the bookmark was made to act on and can no longer reach. A visual put in its place since has a `name` of its own, which the list does not hold, so the bookmark leaves it alone.\n\nMicrosoft\'s PBIR documentation, in its answer about a bookmark file copied from another report, says that Power BI Desktop removes invalid visuals from a bookmark\'s configuration when it saves. So a captured visual that names nothing usually means a bookmark file edited, copied, or merged outside Desktop and not saved in Desktop since. The documentation says nothing of the same for a missing page, and Power BI Desktop\'s saved files do keep bookmarks whose active page is gone. Power BI Desktop\'s saved files also keep names in the list of visuals a bookmark applies to after their visual is gone, even from a save that removed the same visual from the bookmark\'s captured visuals.\n\n### How to fix it\n\nIn Power BI Desktop, on the View tab, select Bookmarks to open the Bookmarks pane. Go to the page the bookmark should show, arrange its visuals as the bookmark should leave them, then select More options (...) next to the bookmark\'s name and choose Update. If nobody needs the bookmark any more, choose Delete from the same menu. Deleting it and adding a new one from the right page also works, but the new bookmark gets a new `name`, so point any button that used the old one at the new one; `BROKEN_ACTION_TARGET` reports any that still name it. For a captured visual that is no longer on the page, opening the report in Desktop and saving it is enough, since Desktop removes such visuals from the bookmark when it saves. For a target visual, saving is not enough: select the visuals the bookmark should apply to, on the page or in the Selection pane (hold Ctrl to select more than one), then choose Update from the bookmark\'s More options (...) menu.\n\nIn the bookmark file, a captured visual is a key under `explorationState.sections.<page>.visualContainers`, named by the visual\'s `name`: remove the key that names nothing, as the example does. A target visual is a string in `options.targetVisualNames`: remove each one that names nothing. To have the bookmark act on a visual added since, update it in Desktop as above. A missing page is `activeSection` and the matching key of `sections`. Pointing both at the `name` of a page that exists leaves the bookmark holding state for the old page\'s visuals, which that page does not have, so for a missing page, recapture the bookmark in Desktop instead.\n\n### When to ignore it\n\nThere is no legitimate case. A bookmark that names a page or visual the report lacks keeps state for, or applies to, something that is not there, so recapture it or delete it; a bookmark nobody uses is better deleted than ignored.\n\nThis rule reports on bookmarks, and a bookmark\'s file has no place for an annotation, so there is no object to annotate. To turn the rule off for a whole project, set `"BROKEN_BOOKMARK_REFERENCE": "off"` under `rules` in `pbiplint.config.json`.\n\n### Quirks\n\n- A bookmark captures one page. Power BI Desktop\'s saved files write one key in `sections`, the active page\'s, so a missing page is reported once, at `activeSection`. A `sections` key that names a different missing page is reported on its own line.\n- The rule reports a missing active page whether or not the bookmark\'s Current page option is on. With it off, Microsoft says the bookmark applies its settings to whichever page is being viewed, but the visuals it captured are still those of the page that is gone.\n- A captured visual is checked against the page it is captured under, and a target visual against the active page, whose visuals and groups the list names; each only when that page exists, since a missing page is reported in place of the visuals under it.\n- The list of target visuals is checked only when Selected visuals is on, which the file records as `applyOnlyToTargetVisuals` set to `true` beside the list. Power BI Desktop\'s saved files write the list in every bookmark whether or not the option is on, and with All visuals, Microsoft says, the bookmark applies to every visual on the page ([Create report bookmarks](https://learn.microsoft.com/power-bi/create-reports/desktop-bookmarks#create-report-bookmarks)), so a name left in the list then is not reported.\n- A bookmark\'s stale target visuals are one finding together, while each stale captured visual is a finding of its own: one Update with the right visuals selected replaces the whole list.\n- A group the list names, which is a container on the page with no visual of its own, is found as a visual is. Groups that a bookmark keeps apart from visuals under `visualContainerGroups`, and the visuals listed as each group\'s `children`, are not checked.\n- Pages and visuals are matched by `name`, never by display name, and never by folder name, except when their own file cannot be read, as the next point says. Microsoft says renaming a `name` is supported, and that Power BI Desktop keeps the original folder names when it saves.\n- A page or a visual whose own file cannot be read, such as a page.json or a visual.json holding merge-conflict markers or one pbiplint could not open at all, is not reported missing, because pbiplint does not guess what a file it could not read says. It is known by its folder name instead, which Microsoft\'s PBIR documentation says is a page\'s or a visual\'s `name` by default, so a bookmark that captures it is not reported. Nor is a page or a visual that a folder under the definition folder, which pbiplint could not list, could hold, such as any visual on a page whose visuals folder could not be listed. The file\'s own `PARSE_ISSUE` finding names it, or a notice does for a file pbiplint could not open or a folder it could not list.\n- bookmarks.json, which holds the bookmarks\' order and groups, is not checked: a name it lists with no bookmark file, or a bookmark file it does not list, is not reported.\n\nRead more: https://pbiplint.com/rules/broken-bookmark-reference'
   },
   BROKEN_FIELD_REFERENCE: {
     text: `Example
@@ -8081,7 +8305,7 @@ Put the table name in front of every column reference:
 
 Total Sales = SUM ( 'Sales'[Amount] )
 
-In Power BI Desktop, select the measure in the Data pane and edit it in the formula bar, which completes the qualified form as soon as you start typing the table name. A row-level security filter is edited under Modeling, Manage roles. In the TMDL file, edit the expression after measure 'Total Sales' =, or the filter after tablePermission Sales = inside the role.
+In Power BI Desktop, select the measure in the Data pane and edit it in the formula bar, which completes the qualified form as soon as you start typing the table name. A row-level security filter is edited under Modeling, Manage roles. In the TMDL file, edit the expression after measure 'Total Sales' =, or the filter after tablePermission Sales = inside the role. A finding that only the measure's KPI raises is fixed in the TMDL file, after targetExpression =, statusExpression =, or trendExpression = in the measure's kpi block, an edit Power BI Desktop keeps.
 
 When to ignore it
 
@@ -8094,13 +8318,14 @@ Quirks
 - Calculation items are in the rule's scope but never fire, because Tabular Editor does not resolve bare column references inside calculation items and pbiplint matches that.
 - A bare name that matches any measure in the model is treated as a measure reference, so a column that shares its name with a measure is never flagged.
 - A bare name that matches no measure is looked for on the expression's own table first, then on every other table in the order pbiplint reads the model's files, so a finding can be raised by a column that lives on a table the expression never mentions.
-- References are found by pattern matching, so a bare [Column] inside a string literal or a comment counts.
-- A measure's dynamic format string is read together with its expression, so a bare column reference written inside formatStringDefinition reports the measure that carries it.
+- A bare name for a column the same DAX creates with ADDCOLUMNS, SELECTCOLUMNS, SUMMARIZE, SUMMARIZECOLUMNS, ROW, or DATATABLE is that column, not a model column, so it is not reported, even when a model column has the same name: [Share] in MAXX ( ADDCOLUMNS ( VALUES ( 'Sales'[Region] ), "Share", [Total] ), [Share] ). Inside a call that creates the name, such as SELECTCOLUMNS ( 'Sales', "Region", [Region] ), the name is read as any other bare name is, since a call cannot read a column it is creating.
+- DAX is read token by token, so a bare [Column] inside a string literal or a comment is not reported, nor is the name after the dot in extended column syntax such as 'Date'[Date].[Year].
+- A measure's dynamic format string and its KPI's target, status, and trend expressions are read together with its expression, so a bare column reference written in any of them reports the measure that carries it, once however many of them hold one. Tabular Editor reports a reference in a KPI's expression on the KPI, named like [Total Sales].KPI, so a measure whose own expression and KPI both hold one gets two findings there and one here: pbiplint has no KPI object, so it names the measure.
 - Calculated columns and calculated tables are out of scope, so a bare column reference in either is not reported.
 - While a model file has a parse issue that can take a declaration out of the model, such as a line indented with spaces, or pbiplint could not open a model file or folder at all, the rule reports nothing, because a bare name reads as a column only when the model has no measure of that name, and a measure of that name could be in what pbiplint missed; pbiplint does not guess what a file it could not read says. The skipped line gives the reason, a model file could not be fully read, and the file's own PARSE_ISSUE finding names it, or a notice does for a file or folder pbiplint could not open.
 
 Read more: https://pbiplint.com/rules/dax-columns-fully-qualified`,
-    markdown: "### Example\n\n**Fires the rule**\n\n```tmdl\ntable Sales\n	column Amount\n		dataType: decimal\n		sourceColumn: Amount\n	measure 'Total Sales' = SUM([Amount])\n		formatString: #,0\n```\n\n**After the fix**\n\n```tmdl\ntable Sales\n	column Amount\n		dataType: decimal\n		sourceColumn: Amount\n	measure 'Total Sales' = SUM('Sales'[Amount])\n		formatString: #,0\n```\n\n### Why it matters\n\nIn DAX a bare `[Name]` is the convention for a measure. A column written the same way reads as a measure to everyone who maintains the model, and the two behave differently in a row context, so the expression is misread before it is ever debugged. The bare form also breaks when the column moves to another table, or when a measure with the same name is added and the engine binds to that instead.\n\n### How to fix it\n\nPut the table name in front of every column reference:\n\n```\nTotal Sales = SUM ( 'Sales'[Amount] )\n```\n\nIn Power BI Desktop, select the measure in the Data pane and edit it in the formula bar, which completes the qualified form as soon as you start typing the table name. A row-level security filter is edited under Modeling, Manage roles. In the TMDL file, edit the expression after `measure 'Total Sales' =`, or the filter after `tablePermission Sales =` inside the role.\n\n### When to ignore it\n\nThere is no case for the bare form. The rule is worth reading as a warning rather than a style note: the reference that fires it resolved to a column because no measure of that name exists today, and the day someone adds one, the expression silently starts reading the measure instead. Qualifying it is what stops that.\n\nTo ignore this rule on one object, add `annotation pbiplint.ignore = DAX_COLUMNS_FULLY_QUALIFIED` under the object in its TMDL file. Power BI Desktop keeps the annotation. To turn the rule off for a whole project, set `\"DAX_COLUMNS_FULLY_QUALIFIED\": \"off\"` under `rules` in `pbiplint.config.json`.\n\n### Quirks\n\n- Calculation items are in the rule's scope but never fire, because Tabular Editor does not resolve bare column references inside calculation items and pbiplint matches that.\n- A bare name that matches any measure in the model is treated as a measure reference, so a column that shares its name with a measure is never flagged.\n- A bare name that matches no measure is looked for on the expression's own table first, then on every other table in the order pbiplint reads the model's files, so a finding can be raised by a column that lives on a table the expression never mentions.\n- References are found by pattern matching, so a bare `[Column]` inside a string literal or a comment counts.\n- A measure's dynamic format string is read together with its expression, so a bare column reference written inside `formatStringDefinition` reports the measure that carries it.\n- Calculated columns and calculated tables are out of scope, so a bare column reference in either is not reported.\n- While a model file has a parse issue that can take a declaration out of the model, such as a line indented with spaces, or pbiplint could not open a model file or folder at all, the rule reports nothing, because a bare name reads as a column only when the model has no measure of that name, and a measure of that name could be in what pbiplint missed; pbiplint does not guess what a file it could not read says. The skipped line gives the reason, `a model file could not be fully read`, and the file's own `PARSE_ISSUE` finding names it, or a notice does for a file or folder pbiplint could not open.\n\nRead more: https://pbiplint.com/rules/dax-columns-fully-qualified"
+    markdown: "### Example\n\n**Fires the rule**\n\n```tmdl\ntable Sales\n	column Amount\n		dataType: decimal\n		sourceColumn: Amount\n	measure 'Total Sales' = SUM([Amount])\n		formatString: #,0\n```\n\n**After the fix**\n\n```tmdl\ntable Sales\n	column Amount\n		dataType: decimal\n		sourceColumn: Amount\n	measure 'Total Sales' = SUM('Sales'[Amount])\n		formatString: #,0\n```\n\n### Why it matters\n\nIn DAX a bare `[Name]` is the convention for a measure. A column written the same way reads as a measure to everyone who maintains the model, and the two behave differently in a row context, so the expression is misread before it is ever debugged. The bare form also breaks when the column moves to another table, or when a measure with the same name is added and the engine binds to that instead.\n\n### How to fix it\n\nPut the table name in front of every column reference:\n\n```\nTotal Sales = SUM ( 'Sales'[Amount] )\n```\n\nIn Power BI Desktop, select the measure in the Data pane and edit it in the formula bar, which completes the qualified form as soon as you start typing the table name. A row-level security filter is edited under Modeling, Manage roles. In the TMDL file, edit the expression after `measure 'Total Sales' =`, or the filter after `tablePermission Sales =` inside the role. A finding that only the measure's KPI raises is fixed in the TMDL file, after `targetExpression =`, `statusExpression =`, or `trendExpression =` in the measure's `kpi` block, an edit Power BI Desktop keeps.\n\n### When to ignore it\n\nThere is no case for the bare form. The rule is worth reading as a warning rather than a style note: the reference that fires it resolved to a column because no measure of that name exists today, and the day someone adds one, the expression silently starts reading the measure instead. Qualifying it is what stops that.\n\nTo ignore this rule on one object, add `annotation pbiplint.ignore = DAX_COLUMNS_FULLY_QUALIFIED` under the object in its TMDL file. Power BI Desktop keeps the annotation. To turn the rule off for a whole project, set `\"DAX_COLUMNS_FULLY_QUALIFIED\": \"off\"` under `rules` in `pbiplint.config.json`.\n\n### Quirks\n\n- Calculation items are in the rule's scope but never fire, because Tabular Editor does not resolve bare column references inside calculation items and pbiplint matches that.\n- A bare name that matches any measure in the model is treated as a measure reference, so a column that shares its name with a measure is never flagged.\n- A bare name that matches no measure is looked for on the expression's own table first, then on every other table in the order pbiplint reads the model's files, so a finding can be raised by a column that lives on a table the expression never mentions.\n- A bare name for a column the same DAX creates with ADDCOLUMNS, SELECTCOLUMNS, SUMMARIZE, SUMMARIZECOLUMNS, ROW, or DATATABLE is that column, not a model column, so it is not reported, even when a model column has the same name: `[Share]` in `MAXX ( ADDCOLUMNS ( VALUES ( 'Sales'[Region] ), \"Share\", [Total] ), [Share] )`. Inside a call that creates the name, such as `SELECTCOLUMNS ( 'Sales', \"Region\", [Region] )`, the name is read as any other bare name is, since a call cannot read a column it is creating.\n- DAX is read token by token, so a bare `[Column]` inside a string literal or a comment is not reported, nor is the name after the dot in extended column syntax such as `'Date'[Date].[Year]`.\n- A measure's dynamic format string and its KPI's target, status, and trend expressions are read together with its expression, so a bare column reference written in any of them reports the measure that carries it, once however many of them hold one. Tabular Editor reports a reference in a KPI's expression on the KPI, named like `[Total Sales].KPI`, so a measure whose own expression and KPI both hold one gets two findings there and one here: pbiplint has no KPI object, so it names the measure.\n- Calculated columns and calculated tables are out of scope, so a bare column reference in either is not reported.\n- While a model file has a parse issue that can take a declaration out of the model, such as a line indented with spaces, or pbiplint could not open a model file or folder at all, the rule reports nothing, because a bare name reads as a column only when the model has no measure of that name, and a measure of that name could be in what pbiplint missed; pbiplint does not guess what a file it could not read says. The skipped line gives the reason, `a model file could not be fully read`, and the file's own `PARSE_ISSUE` finding names it, or a notice does for a file or folder pbiplint could not open.\n\nRead more: https://pbiplint.com/rules/dax-columns-fully-qualified"
   },
   DAX_MEASURES_UNQUALIFIED: {
     text: `Example
@@ -8143,7 +8368,7 @@ Delete the table name from the reference and leave the brackets:
 
 Average Price = DIVIDE ( [Total Sales], SUM ( Sales[Quantity] ) )
 
-In Power BI Desktop, select the measure in the Data pane and edit it in the formula bar; the same goes for a calculated column, a calculated table, and a calculation item, each selected in the model view or the Data pane. In the TMDL file, edit the expression after measure 'Average Price' =, after column Name = for a calculated column, after source = in a calculated table's partition, or after calculationItem Name = in the calculation group.
+In Power BI Desktop, select the measure in the Data pane and edit it in the formula bar; the same goes for a calculated column, a calculated table, and a calculation item, each selected in the model view or the Data pane. In the TMDL file, edit the expression after measure 'Average Price' =, after column Name = for a calculated column, after source = in a calculated table's partition, or after calculationItem Name = in the calculation group. A finding that only the measure's KPI raises is fixed in the TMDL file, after targetExpression =, statusExpression =, or trendExpression = in the measure's kpi block, an edit Power BI Desktop keeps.
 
 When to ignore it
 
@@ -8153,14 +8378,14 @@ To ignore this rule on one object, add annotation pbiplint.ignore = DAX_MEASURES
 
 Quirks
 
-- References are found by pattern matching, so a qualified measure reference inside a string literal or a comment counts.
-- A measure's dynamic format string is read together with its expression, so 'Sales'[Total Sales] written inside formatStringDefinition reports the measure that carries it.
+- DAX is read token by token, so a qualified measure reference inside a comment or a string literal, such as a field parameter's "'Sales'[Total Sales]", is not reported.
+- A measure's dynamic format string and its KPI's target, status, and trend expressions are read together with its expression, so 'Sales'[Total Sales] written in any of them reports the measure that carries it, once however many of them hold one. Tabular Editor reports a reference in a KPI's expression on the KPI, named like [Total Sales].KPI, so a measure whose own expression and KPI both hold one gets two findings there and one here: pbiplint has no KPI object, so it names the measure.
 - The reference has to resolve. 'Sales'[Total Sales] written where the model has no table called Sales, or where Sales has no measure of that name, is not reported by this rule at all.
 - Row-level security filters are out of scope, so a qualified measure reference inside a role's table filter is never reported.
 - The table name may be written bare or in single quotes; both forms are matched.
 
 Read more: https://pbiplint.com/rules/dax-measures-unqualified`,
-    markdown: "### Example\n\n**Fires the rule**\n\n```tmdl\ntable Sales\n	column Amount\n		dataType: decimal\n		sourceColumn: Amount\n	column Quantity\n		dataType: int64\n		sourceColumn: Quantity\n	measure 'Total Sales' = SUM(Sales[Amount])\n		formatString: #,0\n	measure 'Average Price' = DIVIDE('Sales'[Total Sales], SUM(Sales[Quantity]))\n		formatString: #,0.00\n```\n\n**After the fix**\n\n```tmdl\ntable Sales\n	column Amount\n		dataType: decimal\n		sourceColumn: Amount\n	column Quantity\n		dataType: int64\n		sourceColumn: Quantity\n	measure 'Total Sales' = SUM(Sales[Amount])\n		formatString: #,0\n	measure 'Average Price' = DIVIDE([Total Sales], SUM(Sales[Quantity]))\n		formatString: #,0.00\n```\n\n### Why it matters\n\nA measure belongs to the model, not to the table it sits in; the table is only its home in the field list. Writing `'Sales'[Total Sales]` makes it look like a column, which changes what the next reader expects it to do, and it breaks the moment someone moves the measure to a measure table, which is a routine tidy-up.\n\n### How to fix it\n\nDelete the table name from the reference and leave the brackets:\n\n```\nAverage Price = DIVIDE ( [Total Sales], SUM ( Sales[Quantity] ) )\n```\n\nIn Power BI Desktop, select the measure in the Data pane and edit it in the formula bar; the same goes for a calculated column, a calculated table, and a calculation item, each selected in the model view or the Data pane. In the TMDL file, edit the expression after `measure 'Average Price' =`, after `column Name =` for a calculated column, after `source =` in a calculated table's partition, or after `calculationItem Name =` in the calculation group.\n\n### When to ignore it\n\nThere is no case for the table prefix on a measure. If a finding surprises you, check whether the table really does hold a measure of that name: pbiplint resolves `'Table'[Name]` to a column first and only calls it a measure when the table has no column of that name, so a finding here means the reference bound to a measure.\n\nTo ignore this rule on one object, add `annotation pbiplint.ignore = DAX_MEASURES_UNQUALIFIED` under the object in its TMDL file. Power BI Desktop keeps the annotation. To turn the rule off for a whole project, set `\"DAX_MEASURES_UNQUALIFIED\": \"off\"` under `rules` in `pbiplint.config.json`.\n\n### Quirks\n\n- References are found by pattern matching, so a qualified measure reference inside a string literal or a comment counts.\n- A measure's dynamic format string is read together with its expression, so `'Sales'[Total Sales]` written inside `formatStringDefinition` reports the measure that carries it.\n- The reference has to resolve. `'Sales'[Total Sales]` written where the model has no table called Sales, or where Sales has no measure of that name, is not reported by this rule at all.\n- Row-level security filters are out of scope, so a qualified measure reference inside a role's table filter is never reported.\n- The table name may be written bare or in single quotes; both forms are matched.\n\nRead more: https://pbiplint.com/rules/dax-measures-unqualified"
+    markdown: "### Example\n\n**Fires the rule**\n\n```tmdl\ntable Sales\n	column Amount\n		dataType: decimal\n		sourceColumn: Amount\n	column Quantity\n		dataType: int64\n		sourceColumn: Quantity\n	measure 'Total Sales' = SUM(Sales[Amount])\n		formatString: #,0\n	measure 'Average Price' = DIVIDE('Sales'[Total Sales], SUM(Sales[Quantity]))\n		formatString: #,0.00\n```\n\n**After the fix**\n\n```tmdl\ntable Sales\n	column Amount\n		dataType: decimal\n		sourceColumn: Amount\n	column Quantity\n		dataType: int64\n		sourceColumn: Quantity\n	measure 'Total Sales' = SUM(Sales[Amount])\n		formatString: #,0\n	measure 'Average Price' = DIVIDE([Total Sales], SUM(Sales[Quantity]))\n		formatString: #,0.00\n```\n\n### Why it matters\n\nA measure belongs to the model, not to the table it sits in; the table is only its home in the field list. Writing `'Sales'[Total Sales]` makes it look like a column, which changes what the next reader expects it to do, and it breaks the moment someone moves the measure to a measure table, which is a routine tidy-up.\n\n### How to fix it\n\nDelete the table name from the reference and leave the brackets:\n\n```\nAverage Price = DIVIDE ( [Total Sales], SUM ( Sales[Quantity] ) )\n```\n\nIn Power BI Desktop, select the measure in the Data pane and edit it in the formula bar; the same goes for a calculated column, a calculated table, and a calculation item, each selected in the model view or the Data pane. In the TMDL file, edit the expression after `measure 'Average Price' =`, after `column Name =` for a calculated column, after `source =` in a calculated table's partition, or after `calculationItem Name =` in the calculation group. A finding that only the measure's KPI raises is fixed in the TMDL file, after `targetExpression =`, `statusExpression =`, or `trendExpression =` in the measure's `kpi` block, an edit Power BI Desktop keeps.\n\n### When to ignore it\n\nThere is no case for the table prefix on a measure. If a finding surprises you, check whether the table really does hold a measure of that name: pbiplint resolves `'Table'[Name]` to a column first and only calls it a measure when the table has no column of that name, so a finding here means the reference bound to a measure.\n\nTo ignore this rule on one object, add `annotation pbiplint.ignore = DAX_MEASURES_UNQUALIFIED` under the object in its TMDL file. Power BI Desktop keeps the annotation. To turn the rule off for a whole project, set `\"DAX_MEASURES_UNQUALIFIED\": \"off\"` under `rules` in `pbiplint.config.json`.\n\n### Quirks\n\n- DAX is read token by token, so a qualified measure reference inside a comment or a string literal, such as a field parameter's `\"'Sales'[Total Sales]\"`, is not reported.\n- A measure's dynamic format string and its KPI's target, status, and trend expressions are read together with its expression, so `'Sales'[Total Sales]` written in any of them reports the measure that carries it, once however many of them hold one. Tabular Editor reports a reference in a KPI's expression on the KPI, named like `[Total Sales].KPI`, so a measure whose own expression and KPI both hold one gets two findings there and one here: pbiplint has no KPI object, so it names the measure.\n- The reference has to resolve. `'Sales'[Total Sales]` written where the model has no table called Sales, or where Sales has no measure of that name, is not reported by this rule at all.\n- Row-level security filters are out of scope, so a qualified measure reference inside a role's table filter is never reported.\n- The table name may be written bare or in single quotes; both forms are matched.\n\nRead more: https://pbiplint.com/rules/dax-measures-unqualified"
   },
   DEFAULT_PAGE_NAME: {
     text: `Example
@@ -9075,6 +9300,134 @@ Quirks
 Read more: https://pbiplint.com/rules/hardcoded-period-in-dax`,
     markdown: "### Example\n\n**Fires the rule**\n\n```tmdl\ntable Sales\n	column Amount\n		dataType: decimal\n		sourceColumn: Amount\n	column 'Order Date'\n		dataType: dateTime\n		sourceColumn: Order Date\n	measure 'Current Year Sales' = CALCULATE(SUM(Sales[Amount]), YEAR(Sales[Order Date]) = 2025)\n		formatString: #,0\n```\n\n**After the fix**\n\n```tmdl\ntable Sales\n	column Amount\n		dataType: decimal\n		sourceColumn: Amount\n	column 'Order Date'\n		dataType: dateTime\n		sourceColumn: Order Date\n	measure 'Current Year Sales' = CALCULATE(SUM(Sales[Amount]), YEAR(Sales[Order Date]) = YEAR(TODAY()))\n		formatString: #,0\n```\n\n### Why it matters\n\nA year typed into DAX is right for the year it was written in and quietly wrong after it. A measure named Current Year Sales that filters on 2025 still shows 2025's sales all through 2026, under the same name, with no error, and a reader has no way to tell.\n\nA date table built with `CALENDAR(DATE(2020, 1, 1), DATE(2026, 12, 31))` has no rows after December 31, 2026. From January 1, 2027, new rows in a table related to it find no date there. A visual that groups by the date table's columns shows them under a blank value: the [blank virtual row](https://learn.microsoft.com/power-bi/transform-model/desktop-relationships-understand#regular-relationships) Power BI adds when a value on a relationship's many side has no match on its one side. A filter or slicer on the date table leaves them out, and time intelligence stops at the table's last day. [Microsoft's guidance on date tables](https://learn.microsoft.com/power-bi/guidance/model-date-tables#generate-with-dax) says CALENDAR's start and end can come from other DAX functions, like `MAX(Sales[OrderDate])`. An end taken from the data moves with it.\n\n### How to fix it\n\nTake the period from something that moves with time.\n\n- For the current period, use `TODAY()`: `YEAR(TODAY())` for this year, as the fixed example does, or `TODAY()` itself for an as-of date.\n- For the latest period in the data, which stays right when a refresh runs late, take it from the fact table: `YEAR(MAX(Sales[Order Date]))`. Inside a measure, MAX reads only the dates the visual's filters leave, so write `CALCULATE(MAX(Sales[Order Date]), REMOVEFILTERS())` when the measure needs the latest date in all the data.\n- When a report reader should choose the period, add a parameter: on the Modeling tab, select New parameter, then Numeric range, and set its Minimum and Maximum to the first and last years it should offer. Power BI Desktop creates the parameter and, with it, a measure that gives the parameter's current value ([what-if parameters](https://learn.microsoft.com/power-bi/transform-model/desktop-what-if#create-a-parameter)), and your measure compares with that measure instead of a number. Parameters are [designed for measures](https://learn.microsoft.com/power-bi/transform-model/desktop-what-if#considerations-and-limitations), so this route suits a measure, not a calculated column.\n\nA filter argument of CALCULATE written as a comparison, as in the example, [can't reference a measure or use a nested CALCULATE](https://learn.microsoft.com/dax/calculate-function-dax#boolean-filter-expressions), so put the latest year or the parameter's value in a variable first:\n\n```\nLatest Year Sales =\nVAR LatestYear = YEAR ( CALCULATE ( MAX ( Sales[Order Date] ), REMOVEFILTERS () ) )\nRETURN\n    CALCULATE ( SUM ( Sales[Amount] ), YEAR ( Sales[Order Date] ) = LatestYear )\n```\n\nFor a date table, end CALENDAR on the data rather than on a day:\n\n```\nDate = CALENDAR ( DATE ( 2020, 1, 1 ), DATE ( YEAR ( MAX ( Sales[Order Date] ) ), 12, 31 ) )\n```\n\nThis ends on the last day of the latest year in Sales, so the table spans full years, as [Microsoft's guidance](https://learn.microsoft.com/power-bi/guidance/model-date-tables) asks of a date table, and grows when a refresh brings a new year. [CALENDARAUTO](https://learn.microsoft.com/dax/calendarauto-function-dax#remarks) does the same from every date in the model outside calculated columns and tables, so a birth date or a placeholder such as December 31, 9999 stretches it too. To reach the end of the current year whether or not the data gets there yet, end CALENDAR on `DATE ( YEAR ( TODAY () ), 12, 31 )` instead.\n\nIn Power BI Desktop, select a measure, calculated column, or calculated table in the Data pane and edit its DAX in the formula bar. A calculation item is edited in Model view: select Model at the top of the Data pane to open [Model explorer](https://learn.microsoft.com/power-bi/transform-model/model-explorer#find-model-explorer), then select the calculation item under its calculation group, and its DAX opens in the DAX formula bar ([calculation groups](https://learn.microsoft.com/power-bi/transform-model/calculation-groups#add-a-new-calculation-group-in-model-view)). In TMDL, edit the expression after the object's `=`, or, for a date table, the `source` of its `calculated` partition.\n\n### When to ignore it\n\nA fixed period is sometimes the point: a baseline year a measure compares against, a known event such as a change of data source or a day of bad data, a cohort such as customers whose first purchase was in 2023, a rule that changed in a given year, or sample data that never changes. A date table can end on purpose too, such as one that must stop at a contract's last day.\n\nOften the better move is a name that says so. An object whose name carries its year, such as `Sales 2024` or `Growth from 19/20`, reads as deliberate to anyone who opens the model, and the rule leaves it alone.\n\nTo ignore this rule on one object, add `annotation pbiplint.ignore = HARDCODED_PERIOD_IN_DAX` under the object in its TMDL file. Power BI Desktop keeps the annotation. To turn the rule off for a whole project, set `\"HARDCODED_PERIOD_IN_DAX\": \"off\"` under `rules` in `pbiplint.config.json`.\n\n### Quirks\n\n- An object whose name carries one of the years it fixes, as four digits (`Sales 2024`) or as the year's last two digits with no digit beside them (`Jan-24`, `19/20`), is left out, since such an object is almost always meant to fix its year. Two digits can match by chance, as `Top 20` beside a fixed 2020 does, which hides that one object.\n- A date string at a date table's end whose day and month read either way, such as `\"01/02/2026\"`, is quoted as written: DAX reads it by the model's culture, which pbiplint does not settle.\n- A year outside 1950 to 2049 is left alone, such as `DATE(9999, 12, 31)` as an open end or `DATE(1900, 1, 1)` as a default, and so is the Unix epoch, `DATE(1970, 1, 1)`, the base of a conversion such as `DATE(1970, 1, 1) + 'Log'[UnixTime] / 86400`. A date table's end is reported whatever its year or day.\n- A year compared with `<`, `<=`, `>`, or `>=` is left out, since in real models it is usually a cut-off or a cohort, and so are year-month keys such as `202306` and date strings outside a date table's end, which never went stale there. Year arithmetic such as `[Year] - 2025` and fiscal-year labels such as `\"2024/25\"` are left out too, since each came up in too few models to judge. A `DATE()` with a fixed year is read whatever it is compared with, though, so `'Sales'[Order Date] >= DATE(2024, 1, 1)` is reported.\n- From a calculated table, the rule reads only where its CALENDAR calls end, so a year compared inside a date table's ADDCOLUMNS is not reported. The rest of a calculated table's DAX, user-defined functions, and row-level security filters are left out, since in real models they mostly hold inline data, sample generators, or deliberate cut-offs. Format string expressions are not read either, since they choose how a value is shown rather than which rows are counted, and fixed dates in Power Query (M) are left to pbiplint's Power Query rules, which are still to come. A date table end reached through a measure or written with arithmetic, such as `DATE(2026, 12, 31) + 1`, is not taken for a fixed end, and a `DATE()` inside a `CALENDAR` or `GENERATESERIES` call in a measure, a calculated column, or a calculation item is taken for a table's bound and left alone.\n- A month or a quarter compared with a number, a year-end date such as `\"6/30\"` given to DATESYTD, and a `DATE()` given straight to FORMAT with a format that shows no year, as in `FORMAT(DATE(2000, [Month], 1), \"mmmm\")` for a month's name, never fire: none of them goes stale. The rule counts a format as showing the year when it has a `y` in it or is one of the named formats General Date, Long Date, Medium Date, and Short Date, so `FORMAT(DATE(2024, 12, 31), \"Long Date\")` is reported. A `DATE()` inside another call within FORMAT is reported whatever the format, as in `FORMAT(EOMONTH(DATE(2000, [Month], 1), 0), \"mmmm\")`.\n- Year names are read in several languages (year, a\xF1o, anio, jahr, ann\xE9e, anno, jaar, \xE5r, and more), whatever the model's culture.\n- Desktop's own auto date/time tables are left alone, since Desktop builds them itself.\n\nRead more: https://pbiplint.com/rules/hardcoded-period-in-dax"
   },
+  HARDCODED_YEAR_IN_FILTER: {
+    text: `Example
+
+Fires the rule in page.json
+
+{
+  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/page/2.1.0/schema.json",
+  "name": "3cea48e58036b1654474",
+  "displayName": "Overview",
+  "displayOption": "FitToPage",
+  "height": 720,
+  "width": 1280,
+  "filterConfig": {
+    "filters": [
+      {
+        "name": "21d1dc168996da6409ea",
+        "field": { "Column": { "Expression": { "SourceRef": { "Entity": "Date" } }, "Property": "Year" } },
+        "type": "Categorical",
+        "filter": {
+          "Version": 2,
+          "From": [{ "Name": "d", "Entity": "Date", "Type": 0 }],
+          "Where": [
+            {
+              "Condition": {
+                "In": {
+                  "Expressions": [
+                    { "Column": { "Expression": { "SourceRef": { "Source": "d" } }, "Property": "Year" } }
+                  ],
+                  "Values": [[{ "Literal": { "Value": "2025L" } }]]
+                }
+              }
+            }
+          ]
+        },
+        "howCreated": "User"
+      }
+    ]
+  }
+}
+
+After the fix in page.json
+
+{
+  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/page/2.1.0/schema.json",
+  "name": "3cea48e58036b1654474",
+  "displayName": "Overview",
+  "displayOption": "FitToPage",
+  "height": 720,
+  "width": 1280,
+  "filterConfig": {
+    "filters": [
+      {
+        "name": "f7a189206cee6051586c",
+        "field": { "Column": { "Expression": { "SourceRef": { "Entity": "Date" } }, "Property": "Date" } },
+        "type": "RelativeDate",
+        "filter": {
+          "Version": 2,
+          "From": [{ "Name": "d", "Entity": "Date", "Type": 0 }],
+          "Where": [
+            {
+              "Condition": {
+                "Comparison": {
+                  "ComparisonKind": 0,
+                  "Left": { "Column": { "Expression": { "SourceRef": { "Source": "d" } }, "Property": "Date" } },
+                  "Right": { "DateSpan": { "Expression": { "Now": {} }, "TimeUnit": 3 } }
+                }
+              }
+            }
+          ]
+        },
+        "howCreated": "User"
+      }
+    ]
+  }
+}
+
+The Overview page was saved with 2025 picked for 'Date'[Year] under Filters on this page, so the finding reads Page filter on "Overview" with fixed year 2025 on 'Date'[Year]. The fix filters 'Date'[Date] instead, with a relative date filter that keeps the dates in this year. Nothing in it names a year, so on January 1 the page moves to the new one by itself.
+
+Why it matters
+
+A filter set in the Filters pane is saved with the report, and Microsoft says such filters "become the default filter state for all your report readers" (Reset to default values (https://learn.microsoft.com/power-bi/create-reports/power-bi-report-add-filter#reset-to-default-values)). A year picked there is right for the year it was saved in and quietly wrong after it. A page filtered to 2026 still shows 2026 all through 2027, under the same titles, and nothing on it says the year has passed.
+
+A filter that keeps years up to one, or years picked one by one, goes wrong more quietly still. When a new year's data arrives the filter leaves it out, and the visuals look complete without it. A hidden filter is the hardest to catch: in Microsoft's words, "If you hide the filter, they can't even see it" (Lock or hide filters (https://learn.microsoft.com/power-bi/create-reports/power-bi-report-filter#lock-or-hide-filters)).
+
+How to fix it
+
+Filter the date, not the year, with a filter that moves with the calendar. In Power BI Desktop:
+
+1. Drag the date column, such as 'Date'[Date], from the Data pane into the section of the Filters pane that holds the year filter: Filters on this visual, Filters on this page, or Filters on all pages (Add a filter to a visual (https://learn.microsoft.com/power-bi/create-reports/power-bi-report-add-filter#add-a-filter-to-a-visual)).
+2. On the date column's filter card, select Relative date from the Filter type drop-down (Create the relative date range filter (https://learn.microsoft.com/power-bi/visuals/desktop-slicer-filter-date-range#create-the-relative-date-range-filter)).
+3. Under Show items when the value, choose is in this, then year.
+4. Remove the year filter. A filter you added can be deleted from the pane; a year that is one of the visual's own fields cannot be deleted, since the visual refers to it, so clear it instead (Types of filters (https://learn.microsoft.com/power-bi/create-reports/power-bi-report-filter-types#compare-filter-types)).
+
+A relative date filter needs a column whose data type is a date, and it cannot use the auto date/time hierarchy, so for a filter on a date column's Year level, filter that date column itself (Considerations and limitations (https://learn.microsoft.com/power-bi/visuals/desktop-slicer-filter-date-range#considerations-and-limitations)).
+
+When the filter keeps every year up to the latest one, as a range, an upper bound, or years picked one by one, it usually means every year from the first on. On its card, choose Advanced filtering, set the first condition to is greater than or equal to the first year, leave the second empty, and select Apply filter (Add a filter to a visual (https://learn.microsoft.com/power-bi/create-reports/power-bi-report-add-filter#add-a-filter-to-a-visual)), so each new year is kept as it arrives.
+
+When the page should follow the latest year in the data rather than the calendar, as when data for a year lands weeks after it starts, or when the model has no date column, mark the year in the model instead. Right-click the date table in the Data pane, select New column, and enter the column's DAX in the formula bar (Using calculated columns (https://learn.microsoft.com/power-bi/transform-model/desktop-calculated-columns#lets-look-at-an-example)):
+
+Is Latest Year = 'Date'[Year] = YEAR ( MAX ( Sales[Order Date] ) )
+
+Then drag Is Latest Year into the Filters pane in place of the year filter and keep True. For the calendar's current year, write YEAR ( TODAY () ) in place of the MAX. Either way the flag moves at the first refresh of the new year, since, as Microsoft puts it for calculated columns, "Column values are recalculated as necessary, like when the underlying data is refreshed and values have changed" (Using calculated columns (https://learn.microsoft.com/power-bi/transform-model/desktop-calculated-columns)).
+
+In the report's files, the filter is an entry in filterConfig in report.json for all pages, the page.json for a page, or the visual.json for a visual: replace the year's entry with one on the date column, as the example does.
+
+When to ignore it
+
+A fixed year is sometimes the point: a page or a visual about one year, such as a review of 2024; a baseline year others are compared with; a cohort; a series that has ended, such as figures that stopped being published; or sample data that never changes.
+
+Often the better move is a name that says so. A page whose name, or a visual whose title, carries one of the years its filter keeps, such as Sales 2024 or Review FY24, reads as deliberate to every reader, and the rule leaves that filter alone.
+
+To ignore this rule on one page or visual, add { "name": "pbiplint.ignore", "value": "HARDCODED_YEAR_IN_FILTER" } to the annotations array of its page.json or visual.json. Power BI Desktop keeps the annotation. To turn the rule off for a whole project, set "HARDCODED_YEAR_IN_FILTER": "off" under rules in pbiplint.config.json.
+
+Quirks
+
+- A filter that leaves years out, with is not or with Select all and years cleared, or only starts from a year, with is greater than or is greater than or equal to, is not reported, since each new year still shows.
+- Years are counted whole, so is less than 2026 reads as years up to 2025, and a range from is greater than 2017 reads as starting in 2018.
+- An upper bound joined by And to anything but a lower bound, such as is not blank, and conditions joined by Or are not read.
+- A filter kept to one day, such as a date column set to December 31, 2025, is not read, and neither is a year written as a label, such as FY2025 or 2024/25, or stored as a decimal number.
+- Filters that drilling sets are left alone: a drillthrough page's field keeps the last value passed to it, and a visual saved drilled down keeps the value drilled into, and the author picked neither.
+- A filter hidden from readers or locked is reported like any other, since it still filters.
+- Only the Filters pane is read. A year saved as a slicer's selection is SLICER_SELECTION_SAVED's to report, and bookmarks are not read.
+- A name that pairs a year with a month or a quarter, such as YearMonth, is not a year column, and neither is a count of years, such as Years of Service.
+- In the Power BI service, Microsoft says "slicer and filter relative options are always based on the time in UTC" (Considerations and limitations (https://learn.microsoft.com/power-bi/visuals/desktop-slicer-filter-date-range#considerations-and-limitations)), so a relative date filter moves to the new year at midnight UTC, not at local midnight.
+
+Read more: https://pbiplint.com/rules/hardcoded-year-in-filter`,
+    markdown: '### Example\n\n**Fires the rule in page.json**\n\n```json\n{\n  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/page/2.1.0/schema.json",\n  "name": "3cea48e58036b1654474",\n  "displayName": "Overview",\n  "displayOption": "FitToPage",\n  "height": 720,\n  "width": 1280,\n  "filterConfig": {\n    "filters": [\n      {\n        "name": "21d1dc168996da6409ea",\n        "field": { "Column": { "Expression": { "SourceRef": { "Entity": "Date" } }, "Property": "Year" } },\n        "type": "Categorical",\n        "filter": {\n          "Version": 2,\n          "From": [{ "Name": "d", "Entity": "Date", "Type": 0 }],\n          "Where": [\n            {\n              "Condition": {\n                "In": {\n                  "Expressions": [\n                    { "Column": { "Expression": { "SourceRef": { "Source": "d" } }, "Property": "Year" } }\n                  ],\n                  "Values": [[{ "Literal": { "Value": "2025L" } }]]\n                }\n              }\n            }\n          ]\n        },\n        "howCreated": "User"\n      }\n    ]\n  }\n}\n```\n\n**After the fix in page.json**\n\n```json\n{\n  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/page/2.1.0/schema.json",\n  "name": "3cea48e58036b1654474",\n  "displayName": "Overview",\n  "displayOption": "FitToPage",\n  "height": 720,\n  "width": 1280,\n  "filterConfig": {\n    "filters": [\n      {\n        "name": "f7a189206cee6051586c",\n        "field": { "Column": { "Expression": { "SourceRef": { "Entity": "Date" } }, "Property": "Date" } },\n        "type": "RelativeDate",\n        "filter": {\n          "Version": 2,\n          "From": [{ "Name": "d", "Entity": "Date", "Type": 0 }],\n          "Where": [\n            {\n              "Condition": {\n                "Comparison": {\n                  "ComparisonKind": 0,\n                  "Left": { "Column": { "Expression": { "SourceRef": { "Source": "d" } }, "Property": "Date" } },\n                  "Right": { "DateSpan": { "Expression": { "Now": {} }, "TimeUnit": 3 } }\n                }\n              }\n            }\n          ]\n        },\n        "howCreated": "User"\n      }\n    ]\n  }\n}\n```\n\nThe Overview page was saved with 2025 picked for \'Date\'[Year] under Filters on this page, so the finding reads `Page filter on "Overview"` with `fixed year 2025 on \'Date\'[Year]`. The fix filters \'Date\'[Date] instead, with a relative date filter that keeps the dates in this year. Nothing in it names a year, so on January 1 the page moves to the new one by itself.\n\n### Why it matters\n\nA filter set in the Filters pane is saved with the report, and Microsoft says such filters "become the default filter state for all your report readers" ([Reset to default values](https://learn.microsoft.com/power-bi/create-reports/power-bi-report-add-filter#reset-to-default-values)). A year picked there is right for the year it was saved in and quietly wrong after it. A page filtered to 2026 still shows 2026 all through 2027, under the same titles, and nothing on it says the year has passed.\n\nA filter that keeps years up to one, or years picked one by one, goes wrong more quietly still. When a new year\'s data arrives the filter leaves it out, and the visuals look complete without it. A hidden filter is the hardest to catch: in Microsoft\'s words, "If you hide the filter, they can\'t even see it" ([Lock or hide filters](https://learn.microsoft.com/power-bi/create-reports/power-bi-report-filter#lock-or-hide-filters)).\n\n### How to fix it\n\nFilter the date, not the year, with a filter that moves with the calendar. In Power BI Desktop:\n\n1. Drag the date column, such as \'Date\'[Date], from the Data pane into the section of the Filters pane that holds the year filter: Filters on this visual, Filters on this page, or Filters on all pages ([Add a filter to a visual](https://learn.microsoft.com/power-bi/create-reports/power-bi-report-add-filter#add-a-filter-to-a-visual)).\n2. On the date column\'s filter card, select Relative date from the Filter type drop-down ([Create the relative date range filter](https://learn.microsoft.com/power-bi/visuals/desktop-slicer-filter-date-range#create-the-relative-date-range-filter)).\n3. Under Show items when the value, choose is in this, then year.\n4. Remove the year filter. A filter you added can be deleted from the pane; a year that is one of the visual\'s own fields cannot be deleted, since the visual refers to it, so clear it instead ([Types of filters](https://learn.microsoft.com/power-bi/create-reports/power-bi-report-filter-types#compare-filter-types)).\n\nA relative date filter needs a column whose data type is a date, and it cannot use the auto date/time hierarchy, so for a filter on a date column\'s Year level, filter that date column itself ([Considerations and limitations](https://learn.microsoft.com/power-bi/visuals/desktop-slicer-filter-date-range#considerations-and-limitations)).\n\nWhen the filter keeps every year up to the latest one, as a range, an upper bound, or years picked one by one, it usually means every year from the first on. On its card, choose Advanced filtering, set the first condition to is greater than or equal to the first year, leave the second empty, and select Apply filter ([Add a filter to a visual](https://learn.microsoft.com/power-bi/create-reports/power-bi-report-add-filter#add-a-filter-to-a-visual)), so each new year is kept as it arrives.\n\nWhen the page should follow the latest year in the data rather than the calendar, as when data for a year lands weeks after it starts, or when the model has no date column, mark the year in the model instead. Right-click the date table in the Data pane, select New column, and enter the column\'s DAX in the formula bar ([Using calculated columns](https://learn.microsoft.com/power-bi/transform-model/desktop-calculated-columns#lets-look-at-an-example)):\n\n```\nIs Latest Year = \'Date\'[Year] = YEAR ( MAX ( Sales[Order Date] ) )\n```\n\nThen drag Is Latest Year into the Filters pane in place of the year filter and keep True. For the calendar\'s current year, write `YEAR ( TODAY () )` in place of the MAX. Either way the flag moves at the first refresh of the new year, since, as Microsoft puts it for calculated columns, "Column values are recalculated as necessary, like when the underlying data is refreshed and values have changed" ([Using calculated columns](https://learn.microsoft.com/power-bi/transform-model/desktop-calculated-columns)).\n\nIn the report\'s files, the filter is an entry in `filterConfig` in report.json for all pages, the page.json for a page, or the visual.json for a visual: replace the year\'s entry with one on the date column, as the example does.\n\n### When to ignore it\n\nA fixed year is sometimes the point: a page or a visual about one year, such as a review of 2024; a baseline year others are compared with; a cohort; a series that has ended, such as figures that stopped being published; or sample data that never changes.\n\nOften the better move is a name that says so. A page whose name, or a visual whose title, carries one of the years its filter keeps, such as `Sales 2024` or `Review FY24`, reads as deliberate to every reader, and the rule leaves that filter alone.\n\nTo ignore this rule on one page or visual, add `{ "name": "pbiplint.ignore", "value": "HARDCODED_YEAR_IN_FILTER" }` to the `annotations` array of its page.json or visual.json. Power BI Desktop keeps the annotation. To turn the rule off for a whole project, set `"HARDCODED_YEAR_IN_FILTER": "off"` under `rules` in `pbiplint.config.json`.\n\n### Quirks\n\n- A filter that leaves years out, with is not or with Select all and years cleared, or only starts from a year, with is greater than or is greater than or equal to, is not reported, since each new year still shows.\n- Years are counted whole, so `is less than 2026` reads as `years up to 2025`, and a range from `is greater than 2017` reads as starting in 2018.\n- An upper bound joined by And to anything but a lower bound, such as is not blank, and conditions joined by Or are not read.\n- A filter kept to one day, such as a date column set to December 31, 2025, is not read, and neither is a year written as a label, such as FY2025 or 2024/25, or stored as a decimal number.\n- Filters that drilling sets are left alone: a drillthrough page\'s field keeps the last value passed to it, and a visual saved drilled down keeps the value drilled into, and the author picked neither.\n- A filter hidden from readers or locked is reported like any other, since it still filters.\n- Only the Filters pane is read. A year saved as a slicer\'s selection is `SLICER_SELECTION_SAVED`\'s to report, and bookmarks are not read.\n- A name that pairs a year with a month or a quarter, such as YearMonth, is not a year column, and neither is a count of years, such as Years of Service.\n- In the Power BI service, Microsoft says "slicer and filter relative options are always based on the time in UTC" ([Considerations and limitations](https://learn.microsoft.com/power-bi/visuals/desktop-slicer-filter-date-range#considerations-and-limitations)), so a relative date filter moves to the new year at midnight UTC, not at local midnight.\n\nRead more: https://pbiplint.com/rules/hardcoded-year-in-filter'
+  },
   HIDDEN_VISUAL_WITH_FIELDS: {
     text: `Example
 
@@ -10435,15 +10788,16 @@ Quirks
 - Both columns of a relationship, the columns and measures that row-level security filters name, the columns that object-level security names, the default column of a variation, and the columns of an aggregation table that carry an alternateOf mapping are reached whether or not the report uses them, because the model needs them: a role whose filter names a deleted measure fails, and UNNECESSARY_MEASURES already counts such a measure as used. A column that a reached column sorts by or groups by is reached too, and so is the detail column or table that an aggregation column's mapping names. Report queries name the detail table, and Power BI answers them from the aggregation table when that table covers the query, so a report can use the mapped columns without naming them. A column of an aggregation table with no mapping is treated like any other column.
 - Calculated tables whose names start with LocalDateTable_ or DateTableTemplate_, which pbiplint reads as Power BI Desktop's auto date/time tables the way REMOVE_AUTO-DATE_TABLE does, are left out of the findings, reached or not. So is a composite model's copy of one: a LocalDateTable_ table whose entity partition reads, in DirectQuery mode, the table of that name in the Power BI semantic model or Analysis Services model it extends, and which Desktop saves with showAsVariationsOnly, so it is shown only through a date column's hierarchy. Desktop manages these tables and keeps them out of view, so there is nothing here to delete. Turning Auto date/time off removes the calculated ones, and REMOVE_AUTO-DATE_TABLE reports them; the table a copy reads is calculated in the model it extends, and that model's own run reports it. The relationship Desktop adds from a date column to its auto date/time table, or to a copy, does not count as a use of the date column, so a date column the report never shows is still reported.
 - UNNECESSARY_MEASURES and UNNECESSARY_COLUMNS keep the one-hop test of the ruleset they are ported from, as Tabular Editor runs it: they look only at hidden fields and at the model's own references. This rule reads the report and follows the chain as far as it goes, so it reports visible fields too, and a measure that only another unused measure references.
-- DAX references are found by pattern, the way the model rules find them, so a field named inside a string or a comment of a reached measure counts as reached.
+- DAX is read token by token, the way the model rules read it, so a field named only inside a string or a comment of a reached measure is not reached through it.
+- A bare name for a column the same DAX creates with ADDCOLUMNS, SELECTCOLUMNS, SUMMARIZE, SUMMARIZECOLUMNS, ROW, or DATATABLE reaches no model column: [Share] in MAXX ( ADDCOLUMNS ( VALUES ( 'Sales'[Region] ), "Share", [Total] ), [Share] ) does not reach a model column called Share. Inside a call that creates the name, the name reaches what any other bare name reaches, since a call cannot read a column it is creating.
 - A table that nothing reaches has no finding of its own. Each of its columns and measures is reported instead.
-- A user-defined function that nothing reaches has no finding of its own either. Each column and measure that only it uses is reported, with the function named in the detail. A call is found by pattern too: the function's name, in any letter case, followed by an opening parenthesis, with no letter, digit, underscore, or dot just before the name.
+- A user-defined function that nothing reaches has no finding of its own either. Each column and measure that only it uses is reported, with the function named in the detail. A call is the function's whole name, dots included, in any letter case, followed by an opening parenthesis; one written inside a string or a comment is not a call.
 - The rule compares the report with its model, so it runs only when both are in the input.
 - The rule also needs every file it reads the report's fields from: report.json (the report's filters), reportExtensions.json (the report's own measures), each page.json (a page's filters and its drillthrough or tooltip fields), each visual.json, and each bookmark file. While one of them cannot be read, such as a visual.json holding merge-conflict markers, a reportExtensions.json that is not valid JSON, or a file pbiplint could not open at all, the rule reports nothing, because that file may use any field in the model and pbiplint does not guess what a file it could not read says. A folder under the definition folder that pbiplint could not open counts as every file it could hold. The skipped line gives the reason, a report file could not be read, the file's own PARSE_ISSUE finding names it, or a notice does for a file or folder pbiplint could not open, and the Model line of Report at a glance says the count is unknown. pbiplint reads no field from version.json, pages.json, bookmarks.json, or a visual's mobile.json, which hold the report's format version, the order of its pages, the order and groups of its bookmarks, and a visual's mobile layout, so one of them that cannot be read, a merge conflict in pages.json included, does not stop the rule. Nor does a .platform or definition.pbir that cannot be read, or a JSON file of your own in the definition folder.
 - The rule also needs the whole model. While a model file has a parse issue that can take a declaration out of the model, such as a line indented with spaces or a misspelt table, or pbiplint could not open a model file or folder at all, the rule reports nothing, because whatever only the missing declaration reaches, such as a measure that only its DAX uses, would read as reached by nothing. The skipped line gives the reason, a model file could not be fully read, the file's own PARSE_ISSUE finding names it, or a notice does for a file or folder pbiplint could not open, and the Model line of Report at a glance says the count is unknown. A /// description with a blank line after it takes no declaration out, so it does not stop the rule. When a report file could not be read as well, the skipped line gives that reason instead.
 
 Read more: https://pbiplint.com/rules/not-reached-from-report`,
-    markdown: '### Example\n\nThe example runs against a model with one table, Sales, holding Amount and Region and the measure Total Sales.\n\n**Fires the rule in visual.json**\n\n```json\n{\n  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/visualContainer/2.8.0/schema.json",\n  "name": "c897ed0802274ab55e2d",\n  "position": { "x": 580, "y": 520, "z": 3000, "height": 190, "width": 650, "tabOrder": 3000 },\n  "visual": {\n    "visualType": "tableEx",\n    "query": {\n      "queryState": {\n        "Values": {\n          "projections": [\n            {\n              "field": { "Column": { "Expression": { "SourceRef": { "Entity": "Sales" } }, "Property": "Region" } },\n              "queryRef": "Sales.Region",\n              "nativeQueryRef": "Region"\n            }\n          ]\n        }\n      }\n    }\n  }\n}\n```\n\n**After the fix in visual.json**\n\n```json\n{\n  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/visualContainer/2.8.0/schema.json",\n  "name": "c897ed0802274ab55e2d",\n  "position": { "x": 580, "y": 520, "z": 3000, "height": 190, "width": 650, "tabOrder": 3000 },\n  "visual": {\n    "visualType": "tableEx",\n    "query": {\n      "queryState": {\n        "Values": {\n          "projections": [\n            {\n              "field": { "Column": { "Expression": { "SourceRef": { "Entity": "Sales" } }, "Property": "Region" } },\n              "queryRef": "Sales.Region",\n              "nativeQueryRef": "Region"\n            },\n            {\n              "field": { "Measure": { "Expression": { "SourceRef": { "Entity": "Sales" } }, "Property": "Total Sales" } },\n              "queryRef": "Sales.Total Sales",\n              "nativeQueryRef": "Total Sales"\n            }\n          ]\n        }\n      }\n    }\n  }\n}\n```\n\nWith only Region in the table, two findings come back: `[Total Sales]`, which nothing uses, and `\'Sales\'[Amount]`, which only Total Sales uses. Here the measure was meant to be in the table, so the fix adds it, and that reaches Amount through the measure\'s DAX. When a field really is unused, the fix is to delete it from the model, as How to fix it describes.\n\n### Why it matters\n\nA column earns its place in a model in one of two ways, Microsoft\'s modeling guidance says: a report filters, groups, or summarizes by it, or the model\'s structure needs it, for a relationship, a calculation, a security role, or formatting. A column that does neither can usually be removed, and an imported one is still loaded on every refresh and held in memory, where a smaller model refreshes faster and competes less for capacity. A measure nothing reaches adds no data to the model, but it sits in the Data pane beside the measures that matter, and the next author has to read it, keep it working through model changes, and guess whether something depends on it. The findings list what this report never touches, so that clean-up can start from evidence instead of a guess.\n\n### How to fix it\n\nCheck first that nothing outside this report needs the field: another report built on the same model, a paginated report, or an Excel workbook that reads the model. Removing a column that something else uses breaks that thing, and pbiplint sees only the report in front of it.\n\nThen remove the field from the model. In Power BI Desktop, right-click the measure or calculated column in the Data pane, or select it in Model view, and choose Delete from model. For a column that Power Query loads, open Power Query Editor, select the column in the table\'s query, and choose Remove Columns, so it is no longer loaded at all. If a hierarchy level uses the column, first select the hierarchy in Model view and, in the Properties pane, set its levels without that column, then select Apply Level Changes. In the TMDL files, delete the `measure` or `column` block from the table\'s file, and, for a column Power Query loads, remove it from the table\'s query as well. When the finding names a level of a user hierarchy, also delete that `level` block, which sits under its `hierarchy` block in the same file and names the column on its `column:` line, or point that `column:` at another column of the same table. A dead chain is listed with its measures before its columns, so one pass down the list removes all of it. When a detail names a user-defined function, as in `referenced only by Sales.NetAfterReserve, which nothing reaches either`, nothing reaches that function either, and it has no finding of its own: delete its `function` block from `definition/functions.tmdl` too, or edit it so it no longer names the fields you delete, since a function that names a field the model no longer has breaks.\n\n### When to ignore it\n\nA measure kept for another report on the same model, or for people who analyze the model in Excel, is not dead because this report does not use it, and neither is a column that a paginated report or a workbook reads. When several reports share the model, a finding here says only that this report does not reach the field; weigh it against the others before deleting anything, and ignore it on the fields they need.\n\nTo ignore this rule on one object, add `annotation pbiplint.ignore = NOT_REACHED_FROM_REPORT` under the object in its TMDL file. Power BI Desktop keeps the annotation. To turn the rule off for a whole project, set `"NOT_REACHED_FROM_REPORT": "off"` under `rules` in `pbiplint.config.json`.\n\n### Quirks\n\n- The rule reads one report at a time. A model that several reports share lists, for each report, what that report does not reach, even when another report uses it.\n- Both columns of a relationship, the columns and measures that row-level security filters name, the columns that object-level security names, the default column of a variation, and the columns of an aggregation table that carry an `alternateOf` mapping are reached whether or not the report uses them, because the model needs them: a role whose filter names a deleted measure fails, and `UNNECESSARY_MEASURES` already counts such a measure as used. A column that a reached column sorts by or groups by is reached too, and so is the detail column or table that an aggregation column\'s mapping names. Report queries name the detail table, and Power BI answers them from the aggregation table when that table covers the query, so a report can use the mapped columns without naming them. A column of an aggregation table with no mapping is treated like any other column.\n- Calculated tables whose names start with `LocalDateTable_` or `DateTableTemplate_`, which pbiplint reads as Power BI Desktop\'s auto date/time tables the way `REMOVE_AUTO-DATE_TABLE` does, are left out of the findings, reached or not. So is a composite model\'s copy of one: a `LocalDateTable_` table whose `entity` partition reads, in DirectQuery mode, the table of that name in the Power BI semantic model or Analysis Services model it extends, and which Desktop saves with `showAsVariationsOnly`, so it is shown only through a date column\'s hierarchy. Desktop manages these tables and keeps them out of view, so there is nothing here to delete. Turning Auto date/time off removes the calculated ones, and `REMOVE_AUTO-DATE_TABLE` reports them; the table a copy reads is calculated in the model it extends, and that model\'s own run reports it. The relationship Desktop adds from a date column to its auto date/time table, or to a copy, does not count as a use of the date column, so a date column the report never shows is still reported.\n- `UNNECESSARY_MEASURES` and `UNNECESSARY_COLUMNS` keep the one-hop test of the ruleset they are ported from, as Tabular Editor runs it: they look only at hidden fields and at the model\'s own references. This rule reads the report and follows the chain as far as it goes, so it reports visible fields too, and a measure that only another unused measure references.\n- DAX references are found by pattern, the way the model rules find them, so a field named inside a string or a comment of a reached measure counts as reached.\n- A table that nothing reaches has no finding of its own. Each of its columns and measures is reported instead.\n- A user-defined function that nothing reaches has no finding of its own either. Each column and measure that only it uses is reported, with the function named in the detail. A call is found by pattern too: the function\'s name, in any letter case, followed by an opening parenthesis, with no letter, digit, underscore, or dot just before the name.\n- The rule compares the report with its model, so it runs only when both are in the input.\n- The rule also needs every file it reads the report\'s fields from: report.json (the report\'s filters), reportExtensions.json (the report\'s own measures), each page.json (a page\'s filters and its drillthrough or tooltip fields), each visual.json, and each bookmark file. While one of them cannot be read, such as a visual.json holding merge-conflict markers, a reportExtensions.json that is not valid JSON, or a file pbiplint could not open at all, the rule reports nothing, because that file may use any field in the model and pbiplint does not guess what a file it could not read says. A folder under the definition folder that pbiplint could not open counts as every file it could hold. The skipped line gives the reason, `a report file could not be read`, the file\'s own `PARSE_ISSUE` finding names it, or a notice does for a file or folder pbiplint could not open, and the Model line of Report at a glance says the count is unknown. pbiplint reads no field from version.json, pages.json, bookmarks.json, or a visual\'s mobile.json, which hold the report\'s format version, the order of its pages, the order and groups of its bookmarks, and a visual\'s mobile layout, so one of them that cannot be read, a merge conflict in pages.json included, does not stop the rule. Nor does a .platform or definition.pbir that cannot be read, or a JSON file of your own in the definition folder.\n- The rule also needs the whole model. While a model file has a parse issue that can take a declaration out of the model, such as a line indented with spaces or a misspelt `table`, or pbiplint could not open a model file or folder at all, the rule reports nothing, because whatever only the missing declaration reaches, such as a measure that only its DAX uses, would read as reached by nothing. The skipped line gives the reason, `a model file could not be fully read`, the file\'s own `PARSE_ISSUE` finding names it, or a notice does for a file or folder pbiplint could not open, and the Model line of Report at a glance says the count is unknown. A `///` description with a blank line after it takes no declaration out, so it does not stop the rule. When a report file could not be read as well, the skipped line gives that reason instead.\n\nRead more: https://pbiplint.com/rules/not-reached-from-report'
+    markdown: '### Example\n\nThe example runs against a model with one table, Sales, holding Amount and Region and the measure Total Sales.\n\n**Fires the rule in visual.json**\n\n```json\n{\n  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/visualContainer/2.8.0/schema.json",\n  "name": "c897ed0802274ab55e2d",\n  "position": { "x": 580, "y": 520, "z": 3000, "height": 190, "width": 650, "tabOrder": 3000 },\n  "visual": {\n    "visualType": "tableEx",\n    "query": {\n      "queryState": {\n        "Values": {\n          "projections": [\n            {\n              "field": { "Column": { "Expression": { "SourceRef": { "Entity": "Sales" } }, "Property": "Region" } },\n              "queryRef": "Sales.Region",\n              "nativeQueryRef": "Region"\n            }\n          ]\n        }\n      }\n    }\n  }\n}\n```\n\n**After the fix in visual.json**\n\n```json\n{\n  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/visualContainer/2.8.0/schema.json",\n  "name": "c897ed0802274ab55e2d",\n  "position": { "x": 580, "y": 520, "z": 3000, "height": 190, "width": 650, "tabOrder": 3000 },\n  "visual": {\n    "visualType": "tableEx",\n    "query": {\n      "queryState": {\n        "Values": {\n          "projections": [\n            {\n              "field": { "Column": { "Expression": { "SourceRef": { "Entity": "Sales" } }, "Property": "Region" } },\n              "queryRef": "Sales.Region",\n              "nativeQueryRef": "Region"\n            },\n            {\n              "field": { "Measure": { "Expression": { "SourceRef": { "Entity": "Sales" } }, "Property": "Total Sales" } },\n              "queryRef": "Sales.Total Sales",\n              "nativeQueryRef": "Total Sales"\n            }\n          ]\n        }\n      }\n    }\n  }\n}\n```\n\nWith only Region in the table, two findings come back: `[Total Sales]`, which nothing uses, and `\'Sales\'[Amount]`, which only Total Sales uses. Here the measure was meant to be in the table, so the fix adds it, and that reaches Amount through the measure\'s DAX. When a field really is unused, the fix is to delete it from the model, as How to fix it describes.\n\n### Why it matters\n\nA column earns its place in a model in one of two ways, Microsoft\'s modeling guidance says: a report filters, groups, or summarizes by it, or the model\'s structure needs it, for a relationship, a calculation, a security role, or formatting. A column that does neither can usually be removed, and an imported one is still loaded on every refresh and held in memory, where a smaller model refreshes faster and competes less for capacity. A measure nothing reaches adds no data to the model, but it sits in the Data pane beside the measures that matter, and the next author has to read it, keep it working through model changes, and guess whether something depends on it. The findings list what this report never touches, so that clean-up can start from evidence instead of a guess.\n\n### How to fix it\n\nCheck first that nothing outside this report needs the field: another report built on the same model, a paginated report, or an Excel workbook that reads the model. Removing a column that something else uses breaks that thing, and pbiplint sees only the report in front of it.\n\nThen remove the field from the model. In Power BI Desktop, right-click the measure or calculated column in the Data pane, or select it in Model view, and choose Delete from model. For a column that Power Query loads, open Power Query Editor, select the column in the table\'s query, and choose Remove Columns, so it is no longer loaded at all. If a hierarchy level uses the column, first select the hierarchy in Model view and, in the Properties pane, set its levels without that column, then select Apply Level Changes. In the TMDL files, delete the `measure` or `column` block from the table\'s file, and, for a column Power Query loads, remove it from the table\'s query as well. When the finding names a level of a user hierarchy, also delete that `level` block, which sits under its `hierarchy` block in the same file and names the column on its `column:` line, or point that `column:` at another column of the same table. A dead chain is listed with its measures before its columns, so one pass down the list removes all of it. When a detail names a user-defined function, as in `referenced only by Sales.NetAfterReserve, which nothing reaches either`, nothing reaches that function either, and it has no finding of its own: delete its `function` block from `definition/functions.tmdl` too, or edit it so it no longer names the fields you delete, since a function that names a field the model no longer has breaks.\n\n### When to ignore it\n\nA measure kept for another report on the same model, or for people who analyze the model in Excel, is not dead because this report does not use it, and neither is a column that a paginated report or a workbook reads. When several reports share the model, a finding here says only that this report does not reach the field; weigh it against the others before deleting anything, and ignore it on the fields they need.\n\nTo ignore this rule on one object, add `annotation pbiplint.ignore = NOT_REACHED_FROM_REPORT` under the object in its TMDL file. Power BI Desktop keeps the annotation. To turn the rule off for a whole project, set `"NOT_REACHED_FROM_REPORT": "off"` under `rules` in `pbiplint.config.json`.\n\n### Quirks\n\n- The rule reads one report at a time. A model that several reports share lists, for each report, what that report does not reach, even when another report uses it.\n- Both columns of a relationship, the columns and measures that row-level security filters name, the columns that object-level security names, the default column of a variation, and the columns of an aggregation table that carry an `alternateOf` mapping are reached whether or not the report uses them, because the model needs them: a role whose filter names a deleted measure fails, and `UNNECESSARY_MEASURES` already counts such a measure as used. A column that a reached column sorts by or groups by is reached too, and so is the detail column or table that an aggregation column\'s mapping names. Report queries name the detail table, and Power BI answers them from the aggregation table when that table covers the query, so a report can use the mapped columns without naming them. A column of an aggregation table with no mapping is treated like any other column.\n- Calculated tables whose names start with `LocalDateTable_` or `DateTableTemplate_`, which pbiplint reads as Power BI Desktop\'s auto date/time tables the way `REMOVE_AUTO-DATE_TABLE` does, are left out of the findings, reached or not. So is a composite model\'s copy of one: a `LocalDateTable_` table whose `entity` partition reads, in DirectQuery mode, the table of that name in the Power BI semantic model or Analysis Services model it extends, and which Desktop saves with `showAsVariationsOnly`, so it is shown only through a date column\'s hierarchy. Desktop manages these tables and keeps them out of view, so there is nothing here to delete. Turning Auto date/time off removes the calculated ones, and `REMOVE_AUTO-DATE_TABLE` reports them; the table a copy reads is calculated in the model it extends, and that model\'s own run reports it. The relationship Desktop adds from a date column to its auto date/time table, or to a copy, does not count as a use of the date column, so a date column the report never shows is still reported.\n- `UNNECESSARY_MEASURES` and `UNNECESSARY_COLUMNS` keep the one-hop test of the ruleset they are ported from, as Tabular Editor runs it: they look only at hidden fields and at the model\'s own references. This rule reads the report and follows the chain as far as it goes, so it reports visible fields too, and a measure that only another unused measure references.\n- DAX is read token by token, the way the model rules read it, so a field named only inside a string or a comment of a reached measure is not reached through it.\n- A bare name for a column the same DAX creates with ADDCOLUMNS, SELECTCOLUMNS, SUMMARIZE, SUMMARIZECOLUMNS, ROW, or DATATABLE reaches no model column: `[Share]` in `MAXX ( ADDCOLUMNS ( VALUES ( \'Sales\'[Region] ), "Share", [Total] ), [Share] )` does not reach a model column called Share. Inside a call that creates the name, the name reaches what any other bare name reaches, since a call cannot read a column it is creating.\n- A table that nothing reaches has no finding of its own. Each of its columns and measures is reported instead.\n- A user-defined function that nothing reaches has no finding of its own either. Each column and measure that only it uses is reported, with the function named in the detail. A call is the function\'s whole name, dots included, in any letter case, followed by an opening parenthesis; one written inside a string or a comment is not a call.\n- The rule compares the report with its model, so it runs only when both are in the input.\n- The rule also needs every file it reads the report\'s fields from: report.json (the report\'s filters), reportExtensions.json (the report\'s own measures), each page.json (a page\'s filters and its drillthrough or tooltip fields), each visual.json, and each bookmark file. While one of them cannot be read, such as a visual.json holding merge-conflict markers, a reportExtensions.json that is not valid JSON, or a file pbiplint could not open at all, the rule reports nothing, because that file may use any field in the model and pbiplint does not guess what a file it could not read says. A folder under the definition folder that pbiplint could not open counts as every file it could hold. The skipped line gives the reason, `a report file could not be read`, the file\'s own `PARSE_ISSUE` finding names it, or a notice does for a file or folder pbiplint could not open, and the Model line of Report at a glance says the count is unknown. pbiplint reads no field from version.json, pages.json, bookmarks.json, or a visual\'s mobile.json, which hold the report\'s format version, the order of its pages, the order and groups of its bookmarks, and a visual\'s mobile layout, so one of them that cannot be read, a merge conflict in pages.json included, does not stop the rule. Nor does a .platform or definition.pbir that cannot be read, or a JSON file of your own in the definition folder.\n- The rule also needs the whole model. While a model file has a parse issue that can take a declaration out of the model, such as a line indented with spaces or a misspelt `table`, or pbiplint could not open a model file or folder at all, the rule reports nothing, because whatever only the missing declaration reaches, such as a measure that only its DAX uses, would read as reached by nothing. The skipped line gives the reason, `a model file could not be fully read`, the file\'s own `PARSE_ISSUE` finding names it, or a notice does for a file or folder pbiplint could not open, and the Model line of Report at a glance says the count is unknown. A `///` description with a blank line after it takes no declaration out, so it does not stop the rule. When a report file could not be read as well, the skipped line gives that reason instead.\n\nRead more: https://pbiplint.com/rules/not-reached-from-report'
   },
   NUMERIC_COLUMN_SUMMARIZE_BY: {
     text: `Example
@@ -12831,7 +13185,7 @@ To ignore this rule on one visual, add { "name": "pbiplint.ignore", "value": "SL
 
 Quirks
 
-- A filter on the slicer in the Filters pane, which visual.json keeps in the slicer's filterConfig, is a visual-level filter, not the slicer's selection, and is not reported.
+- A filter on the slicer in the Filters pane, which visual.json keeps in the slicer's filterConfig, is a visual-level filter, not the slicer's selection, and this rule does not report it. HARDCODED_YEAR_IN_FILTER reports one that holds a year column to fixed years.
 - Select all saves no selection. Microsoft says it produces the same filtering result as clearing the slicer, and that Power BI does not store each item as a selection. Clearing items after Select all is a selection, though: Power BI applies an is not filter holding the cleared items, and that is reported.
 - In Power BI Desktop's saved files, a range or relative date slicer saves its value the same way as a list of picked items, so it is reported the same way.
 - Each synced copy of a slicer is reported on its own page, since Power BI Desktop's saved files write the selection into every copy.
@@ -12840,7 +13194,7 @@ Quirks
 - Only the slicer as saved in visual.json is read. A bookmark that captures a different selection is not.
 
 Read more: https://pbiplint.com/rules/slicer-selection-saved`,
-    markdown: '### Example\n\nWithout a policy the finding is info. The config below applies to both documents and sets the policy, `expect` set to `none`, which raises the finding to a warning.\n\n**pbiplint.config.json**\n\n```json\n{\n  "rules": {\n    "SLICER_SELECTION_SAVED": { "expect": "none" }\n  }\n}\n```\n\n**Fires the rule in visual.json**\n\n```json\n{\n  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/visualContainer/2.8.0/schema.json",\n  "name": "096193a525ec376a0147",\n  "position": { "x": 432, "y": 222, "z": 10000, "height": 62, "width": 416, "tabOrder": 10000 },\n  "visual": {\n    "visualType": "slicer",\n    "query": {\n      "queryState": {\n        "Values": {\n          "projections": [\n            {\n              "field": { "Column": { "Expression": { "SourceRef": { "Entity": "Sales" } }, "Property": "Region" } },\n              "queryRef": "Sales.Region",\n              "nativeQueryRef": "Region",\n              "active": true\n            }\n          ]\n        }\n      }\n    },\n    "objects": {\n      "data": [\n        { "properties": { "mode": { "expr": { "Literal": { "Value": "\'Basic\'" } } } } }\n      ],\n      "general": [\n        {\n          "properties": {\n            "orientation": { "expr": { "Literal": { "Value": "1D" } } },\n            "filter": {\n              "filter": {\n                "Version": 2,\n                "From": [{ "Name": "s", "Entity": "Sales", "Type": 0 }],\n                "Where": [\n                  {\n                    "Condition": {\n                      "In": {\n                        "Expressions": [\n                          { "Column": { "Expression": { "SourceRef": { "Source": "s" } }, "Property": "Region" } }\n                        ],\n                        "Values": [[{ "Literal": { "Value": "\'West\'" } }]]\n                      }\n                    }\n                  }\n                ]\n              }\n            }\n          }\n        }\n      ]\n    }\n  }\n}\n```\n\n**After the fix in visual.json**\n\n```json\n{\n  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/visualContainer/2.8.0/schema.json",\n  "name": "096193a525ec376a0147",\n  "position": { "x": 432, "y": 222, "z": 10000, "height": 62, "width": 416, "tabOrder": 10000 },\n  "visual": {\n    "visualType": "slicer",\n    "query": {\n      "queryState": {\n        "Values": {\n          "projections": [\n            {\n              "field": { "Column": { "Expression": { "SourceRef": { "Entity": "Sales" } }, "Property": "Region" } },\n              "queryRef": "Sales.Region",\n              "nativeQueryRef": "Region",\n              "active": true\n            }\n          ]\n        }\n      }\n    },\n    "objects": {\n      "data": [\n        { "properties": { "mode": { "expr": { "Literal": { "Value": "\'Basic\'" } } } } }\n      ],\n      "general": [\n        {\n          "properties": {\n            "orientation": { "expr": { "Literal": { "Value": "1D" } } }\n          }\n        }\n      ]\n    }\n  }\n}\n```\n\nThe Region slicer was saved with West selected, so every reader starts with the page filtered to the West region, and the finding reads `slicer (096193) on "Overview"` with `opens with this selection applied`. The fix clears the selection, which takes the `filter` out of `objects.general` and leaves the slicer\'s other settings as they were.\n\n### Why it matters\n\nA slicer narrows what the other visuals show, and its selection is saved with the report: "The slicer saves the selected values," in the words of Microsoft\'s troubleshooting guidance, which goes on to warn: "Report authors should avoid saving and publishing reports with selected items that might be inappropriate for certain users, particularly in environments that use row-level security (RLS)." It recommends clearing any selection that shouldn\'t apply to everyone before saving and distributing a report, and points out that a saved selection can stop being relevant or appropriate when the data or a user\'s permissions change.\n\nA saved selection is also what readers come back to. Microsoft says readers can always return to the state the author published with the Reset to default button, so a value left selected while the author checked one region becomes every reader\'s starting point, and the state Reset to default restores.\n\n### How to fix it\n\nIn Power BI Desktop, clear the slicer and save the report in that state, as Microsoft recommends before publishing: select the slicer\'s Clear button, an eraser icon, then save. On the original slicer the Clear button sits in the Slicer header and shows when you hover over it; on the Slicer (new) visuals it sits in the Visual container header. Either way, if the header that holds it is turned off, turn that header on first, as Microsoft advises for the Slicer header, since the Clear button is not there without it. Check any bookmark that captures the slicer as well, since a bookmark saves slicer state of its own.\n\nA custom slicer from AppSource that filters through the Visual Filters API sets and clears that filter itself, as Microsoft\'s guidance for building Power BI visuals describes, so the controls for clearing it are the visual\'s own. In Power BI Desktop, clear it on the visual the way it offers, then save the report in that state. The Chiclet Slicer, for one, is cleared with the Clear button in the visual\'s top right corner, by its README in Microsoft\'s repository for the visual. Check any bookmark that captures it as well, since Microsoft\'s guidance for building visuals says that when a reader switches bookmarks, Power BI hands the visual the filter the bookmark holds.\n\nIn visual.json, the selection is the `filter` property under `objects.general[0].properties`, on a custom slicer as on the slicers built into Power BI: remove it, as the example does, and leave the rest of `general` as it is.\n\n### When to ignore it\n\nA default selection readers are meant to start from, which Microsoft endorses for slicers other than range slicers: "you might intentionally save a default selection so that report consumers start with a specific set of filters." Examples are a button slicer or list slicer with Force selection on, or an original slicer with Single select on, which Microsoft\'s visual capability data describes the same way: only one item can be chosen, and the first available is chosen when none is. Others are a slicer saved on the scenario a page opens in, such as Actual rather than Budget, and a field parameter slicer saved on the field the visuals should open with. Microsoft recommends saving range slicers cleared, and says date range slicers typically work best when they start that way, so a saved range deserves a second look. Without a policy the finding is info, a prompt to check each selection; with `expect` set to `none`, ignore it on the slicers whose default is deliberate.\n\nTo ignore this rule on one visual, add `{ "name": "pbiplint.ignore", "value": "SLICER_SELECTION_SAVED" }` to the `annotations` array of its visual.json. Power BI Desktop keeps the annotation. To turn the rule off for a whole project, set `"SLICER_SELECTION_SAVED": "off"` under `rules` in `pbiplint.config.json`.\n\n### Quirks\n\n- A filter on the slicer in the Filters pane, which visual.json keeps in the slicer\'s `filterConfig`, is a visual-level filter, not the slicer\'s selection, and is not reported.\n- Select all saves no selection. Microsoft says it produces the same filtering result as clearing the slicer, and that Power BI does not store each item as a selection. Clearing items after Select all is a selection, though: Power BI applies an is not filter holding the cleared items, and that is reported.\n- In Power BI Desktop\'s saved files, a range or relative date slicer saves its value the same way as a list of picked items, so it is reported the same way.\n- Each synced copy of a slicer is reported on its own page, since Power BI Desktop\'s saved files write the selection into every copy.\n- A hidden slicer is reported like a visible one. Microsoft notes that slicers continue to filter a report page whether or not they are visible.\n- A selection is read by where it sits, not by the visual\'s type, so custom slicers from AppSource, such as the Chiclet Slicer, the Hierarchy Slicer, and the Text Filter, are reported the same way as the slicers built into Power BI. Microsoft\'s guidance for building Power BI visuals says a visual that filters through the Visual Filters API declares a `filter` in the `general` section of its capabilities and applies its filter there. Separately, Power BI Desktop\'s saved files keep these slicers\' selections in that `filter` under `objects.general`, and in those files every kind of visual that carries that `filter` is one that filters the report.\n- Only the slicer as saved in visual.json is read. A bookmark that captures a different selection is not.\n\nRead more: https://pbiplint.com/rules/slicer-selection-saved'
+    markdown: '### Example\n\nWithout a policy the finding is info. The config below applies to both documents and sets the policy, `expect` set to `none`, which raises the finding to a warning.\n\n**pbiplint.config.json**\n\n```json\n{\n  "rules": {\n    "SLICER_SELECTION_SAVED": { "expect": "none" }\n  }\n}\n```\n\n**Fires the rule in visual.json**\n\n```json\n{\n  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/visualContainer/2.8.0/schema.json",\n  "name": "096193a525ec376a0147",\n  "position": { "x": 432, "y": 222, "z": 10000, "height": 62, "width": 416, "tabOrder": 10000 },\n  "visual": {\n    "visualType": "slicer",\n    "query": {\n      "queryState": {\n        "Values": {\n          "projections": [\n            {\n              "field": { "Column": { "Expression": { "SourceRef": { "Entity": "Sales" } }, "Property": "Region" } },\n              "queryRef": "Sales.Region",\n              "nativeQueryRef": "Region",\n              "active": true\n            }\n          ]\n        }\n      }\n    },\n    "objects": {\n      "data": [\n        { "properties": { "mode": { "expr": { "Literal": { "Value": "\'Basic\'" } } } } }\n      ],\n      "general": [\n        {\n          "properties": {\n            "orientation": { "expr": { "Literal": { "Value": "1D" } } },\n            "filter": {\n              "filter": {\n                "Version": 2,\n                "From": [{ "Name": "s", "Entity": "Sales", "Type": 0 }],\n                "Where": [\n                  {\n                    "Condition": {\n                      "In": {\n                        "Expressions": [\n                          { "Column": { "Expression": { "SourceRef": { "Source": "s" } }, "Property": "Region" } }\n                        ],\n                        "Values": [[{ "Literal": { "Value": "\'West\'" } }]]\n                      }\n                    }\n                  }\n                ]\n              }\n            }\n          }\n        }\n      ]\n    }\n  }\n}\n```\n\n**After the fix in visual.json**\n\n```json\n{\n  "$schema": "https://developer.microsoft.com/json-schemas/fabric/item/report/definition/visualContainer/2.8.0/schema.json",\n  "name": "096193a525ec376a0147",\n  "position": { "x": 432, "y": 222, "z": 10000, "height": 62, "width": 416, "tabOrder": 10000 },\n  "visual": {\n    "visualType": "slicer",\n    "query": {\n      "queryState": {\n        "Values": {\n          "projections": [\n            {\n              "field": { "Column": { "Expression": { "SourceRef": { "Entity": "Sales" } }, "Property": "Region" } },\n              "queryRef": "Sales.Region",\n              "nativeQueryRef": "Region",\n              "active": true\n            }\n          ]\n        }\n      }\n    },\n    "objects": {\n      "data": [\n        { "properties": { "mode": { "expr": { "Literal": { "Value": "\'Basic\'" } } } } }\n      ],\n      "general": [\n        {\n          "properties": {\n            "orientation": { "expr": { "Literal": { "Value": "1D" } } }\n          }\n        }\n      ]\n    }\n  }\n}\n```\n\nThe Region slicer was saved with West selected, so every reader starts with the page filtered to the West region, and the finding reads `slicer (096193) on "Overview"` with `opens with this selection applied`. The fix clears the selection, which takes the `filter` out of `objects.general` and leaves the slicer\'s other settings as they were.\n\n### Why it matters\n\nA slicer narrows what the other visuals show, and its selection is saved with the report: "The slicer saves the selected values," in the words of Microsoft\'s troubleshooting guidance, which goes on to warn: "Report authors should avoid saving and publishing reports with selected items that might be inappropriate for certain users, particularly in environments that use row-level security (RLS)." It recommends clearing any selection that shouldn\'t apply to everyone before saving and distributing a report, and points out that a saved selection can stop being relevant or appropriate when the data or a user\'s permissions change.\n\nA saved selection is also what readers come back to. Microsoft says readers can always return to the state the author published with the Reset to default button, so a value left selected while the author checked one region becomes every reader\'s starting point, and the state Reset to default restores.\n\n### How to fix it\n\nIn Power BI Desktop, clear the slicer and save the report in that state, as Microsoft recommends before publishing: select the slicer\'s Clear button, an eraser icon, then save. On the original slicer the Clear button sits in the Slicer header and shows when you hover over it; on the Slicer (new) visuals it sits in the Visual container header. Either way, if the header that holds it is turned off, turn that header on first, as Microsoft advises for the Slicer header, since the Clear button is not there without it. Check any bookmark that captures the slicer as well, since a bookmark saves slicer state of its own.\n\nA custom slicer from AppSource that filters through the Visual Filters API sets and clears that filter itself, as Microsoft\'s guidance for building Power BI visuals describes, so the controls for clearing it are the visual\'s own. In Power BI Desktop, clear it on the visual the way it offers, then save the report in that state. The Chiclet Slicer, for one, is cleared with the Clear button in the visual\'s top right corner, by its README in Microsoft\'s repository for the visual. Check any bookmark that captures it as well, since Microsoft\'s guidance for building visuals says that when a reader switches bookmarks, Power BI hands the visual the filter the bookmark holds.\n\nIn visual.json, the selection is the `filter` property under `objects.general[0].properties`, on a custom slicer as on the slicers built into Power BI: remove it, as the example does, and leave the rest of `general` as it is.\n\n### When to ignore it\n\nA default selection readers are meant to start from, which Microsoft endorses for slicers other than range slicers: "you might intentionally save a default selection so that report consumers start with a specific set of filters." Examples are a button slicer or list slicer with Force selection on, or an original slicer with Single select on, which Microsoft\'s visual capability data describes the same way: only one item can be chosen, and the first available is chosen when none is. Others are a slicer saved on the scenario a page opens in, such as Actual rather than Budget, and a field parameter slicer saved on the field the visuals should open with. Microsoft recommends saving range slicers cleared, and says date range slicers typically work best when they start that way, so a saved range deserves a second look. Without a policy the finding is info, a prompt to check each selection; with `expect` set to `none`, ignore it on the slicers whose default is deliberate.\n\nTo ignore this rule on one visual, add `{ "name": "pbiplint.ignore", "value": "SLICER_SELECTION_SAVED" }` to the `annotations` array of its visual.json. Power BI Desktop keeps the annotation. To turn the rule off for a whole project, set `"SLICER_SELECTION_SAVED": "off"` under `rules` in `pbiplint.config.json`.\n\n### Quirks\n\n- A filter on the slicer in the Filters pane, which visual.json keeps in the slicer\'s `filterConfig`, is a visual-level filter, not the slicer\'s selection, and this rule does not report it. `HARDCODED_YEAR_IN_FILTER` reports one that holds a year column to fixed years.\n- Select all saves no selection. Microsoft says it produces the same filtering result as clearing the slicer, and that Power BI does not store each item as a selection. Clearing items after Select all is a selection, though: Power BI applies an is not filter holding the cleared items, and that is reported.\n- In Power BI Desktop\'s saved files, a range or relative date slicer saves its value the same way as a list of picked items, so it is reported the same way.\n- Each synced copy of a slicer is reported on its own page, since Power BI Desktop\'s saved files write the selection into every copy.\n- A hidden slicer is reported like a visible one. Microsoft notes that slicers continue to filter a report page whether or not they are visible.\n- A selection is read by where it sits, not by the visual\'s type, so custom slicers from AppSource, such as the Chiclet Slicer, the Hierarchy Slicer, and the Text Filter, are reported the same way as the slicers built into Power BI. Microsoft\'s guidance for building Power BI visuals says a visual that filters through the Visual Filters API declares a `filter` in the `general` section of its capabilities and applies its filter there. Separately, Power BI Desktop\'s saved files keep these slicers\' selections in that `filter` under `objects.general`, and in those files every kind of visual that carries that `filter` is one that filters the report.\n- Only the slicer as saved in visual.json is read. A bookmark that captures a different selection is not.\n\nRead more: https://pbiplint.com/rules/slicer-selection-saved'
   },
   SNOWFLAKE_SCHEMA_ARCHITECTURE: {
     text: `Example
@@ -13233,6 +13587,181 @@ Quirks
 Read more: https://pbiplint.com/rules/trim-object-names`,
     markdown: "### Example\n\n**Fires the rule**\n\n```tmdl\ntable Sales\n	column 'Order ID '\n		dataType: int64\n		sourceColumn: OrderID\n	column Amount\n		dataType: decimal\n		sourceColumn: Amount\n	measure 'Total Sales' = SUM(Sales[Amount])\n```\n\n**After the fix**\n\n```tmdl\ntable Sales\n	column 'Order ID'\n		dataType: int64\n		sourceColumn: OrderID\n	column Amount\n		dataType: decimal\n		sourceColumn: Amount\n	measure 'Total Sales' = SUM(Sales[Amount])\n```\n\n### Why it matters\n\nA leading or trailing space is invisible in the field list but part of the name, so \"Sales \" and \"Sales\" are two objects to the engine, and a DAX reference, a visual binding, or a deployment script that uses the trimmed name fails against something that looks correct. The space usually arrives with a source column name or a paste. `OBJECTS_SHOULD_NOT_START_OR_END_WITH_A_SPACE` reports the same names at error severity for a narrower set of object types.\n\n### How to fix it\n\nIn Power BI Desktop, double-click the field in the Data pane and retype the name without the space, or select the object and clear the space from Name in the Properties pane. In the TMDL file the name is on the declaration line, so `column 'Order ID '` becomes `column 'Order ID'`. A data column carries its own `sourceColumn`, so the model name and the source column name are independent and trimming the model name does not change what the refresh loads. Renaming in Desktop updates the visuals bound to the field; a hand edit in the TMDL file does not, so open the report and check its visuals after one. Where the space arrives with a source column name, trim it in Power Query as well, so the next column you add from that query comes in clean.\n\n### When to ignore it\n\nNo name should start or end with a space. A leading space is sometimes used to push a measure to the top of the field list; a display folder gathers the measure with the ones it belongs beside, and it does that without hiding a character in the name.\n\nTo ignore this rule on one object, add `annotation pbiplint.ignore = TRIM_OBJECT_NAMES` under the object in its TMDL file. Power BI Desktop keeps the annotation. To turn the rule off for a whole project, set `\"TRIM_OBJECT_NAMES\": \"off\"` under `rules` in `pbiplint.config.json`.\n\n### Quirks\n\n- The test is for a space character at the start or the end of the name. A name padded with a tab is not reported here; `SPECIAL_CHARS_IN_OBJECT_NAMES` covers that one.\n- The model object is in scope, and a finding on the model is always named `Model` whatever the model is called, so a stray space in the model's own name gives a finding with nothing in the line to show it. The model's name is on the `model` line in the TMDL file.\n\nRead more: https://pbiplint.com/rules/trim-object-names"
   },
+  UDF_NOT_CALLED: {
+    text: `Example
+
+Fires the rule
+
+table Sales
+	column Amount
+		dataType: decimal
+		sourceColumn: Amount
+	measure 'Sales With Tax' = Local.AddTax(SUM('Sales'[Amount]))
+		formatString: #,0
+
+/// Adds 10 percent sales tax to an amount.
+function 'Local.AddTax' = (amount: NUMERIC) => amount * 1.1
+
+/// Adds 20 percent VAT to an amount.
+function 'Local.AddVat' = (amount: NUMERIC) => amount * 1.2
+
+After the fix
+
+table Sales
+	column Amount
+		dataType: decimal
+		sourceColumn: Amount
+	measure 'Sales With Tax' = Local.AddTax(SUM('Sales'[Amount]))
+		formatString: #,0
+
+/// Adds 10 percent sales tax to an amount.
+function 'Local.AddTax' = (amount: NUMERIC) => amount * 1.1
+
+Why it matters
+
+A function nothing calls is dead code that looks alive. It sits under Functions in Model explorer beside the ones in use, and anyone writing DAX in the model can find it and call it, with nothing to say whether it still does what its name promises or was left behind by a rewrite.
+
+It also keeps other dead code alive. A hidden measure or column that a function names counts as used, whether or not anything calls the function, so UNNECESSARY_MEASURES and UNNECESSARY_COLUMNS pass over everything the dead function names. Deleting the function brings those to light.
+
+A DAX Lib package installs all of its functions at once, so a model that calls one of them carries the rest unused as a matter of course. The rule reports a package only when none of it is called: the whole library was installed and never used.
+
+How to fix it
+
+Delete the function, after checking the callers pbiplint cannot see, listed under When to ignore it.
+
+In Power BI Desktop's Model view, select Model at the top of the Data pane to open Model explorer (https://learn.microsoft.com/power-bi/transform-model/model-explorer#find-model-explorer), right-click the function under Functions, and choose Delete from model (Using Model explorer (https://learn.microsoft.com/dax/best-practices/dax-user-defined-functions#using-model-explorer)). In TMDL, remove the function's block from definition/functions.tmdl: its /// description lines, its function line, and the lines indented under it. For a package, delete each function that carries its DAXLIB_PackageId annotation.
+
+When to ignore it
+
+When something outside the model's own DAX calls the function:
+
+- A DAX query, such as a test harness that runs a model's test functions from outside it.
+- A report's own measures, which this rule does not read, including a live-connected report's, which can call the functions of the model it connects to (Considerations and limitations (https://learn.microsoft.com/dax/best-practices/dax-user-defined-functions#considerations-and-limitations)).
+- A visual calculation, which pbiplint does not read.
+
+Or when the function is kept on purpose, such as one written ahead of the measures that will call it.
+
+To ignore this rule on one object, add annotation pbiplint.ignore = UDF_NOT_CALLED under the object in its TMDL file. Power BI Desktop keeps the annotation. To turn the rule off for a whole project, set "UDF_NOT_CALLED": "off" under rules in pbiplint.config.json.
+
+Quirks
+
+- A call is the function's whole name, dots included, in any letter case, followed by an opening parenthesis, so MySales.Tax( is not a call to Sales.Tax. A call written inside a string or a comment is not a call.
+- The rule looks one step. A function that only an uncalled function calls is not reported until that caller is gone, and then the next run reports it.
+- A package is known by the DAXLIB_PackageId annotation that Power BI Desktop keeps when it installs a package from DAX Lib. Functions installed without that annotation, such as through semantic-link-labs, which writes its own (_functions.py (https://github.com/microsoft/semantic-link-labs/blob/main/src/sempy_labs/daxlib/_functions.py)), are each checked as the model's own.
+- While a model file has a parse issue that can take a declaration out of the model, such as a line indented with spaces, or pbiplint could not open a model file or folder at all, the rule reports nothing, because the DAX that calls the function could be in what pbiplint missed, and pbiplint does not guess what a file it could not read says. The skipped line gives the reason, a model file could not be fully read, and the file's own PARSE_ISSUE finding names it, or a notice does for a file or folder pbiplint could not open.
+
+Read more: https://pbiplint.com/rules/udf-not-called`,
+    markdown: "### Example\n\n**Fires the rule**\n\n```tmdl\ntable Sales\n	column Amount\n		dataType: decimal\n		sourceColumn: Amount\n	measure 'Sales With Tax' = Local.AddTax(SUM('Sales'[Amount]))\n		formatString: #,0\n\n/// Adds 10 percent sales tax to an amount.\nfunction 'Local.AddTax' = (amount: NUMERIC) => amount * 1.1\n\n/// Adds 20 percent VAT to an amount.\nfunction 'Local.AddVat' = (amount: NUMERIC) => amount * 1.2\n```\n\n**After the fix**\n\n```tmdl\ntable Sales\n	column Amount\n		dataType: decimal\n		sourceColumn: Amount\n	measure 'Sales With Tax' = Local.AddTax(SUM('Sales'[Amount]))\n		formatString: #,0\n\n/// Adds 10 percent sales tax to an amount.\nfunction 'Local.AddTax' = (amount: NUMERIC) => amount * 1.1\n```\n\n### Why it matters\n\nA function nothing calls is dead code that looks alive. It sits under Functions in Model explorer beside the ones in use, and anyone writing DAX in the model can find it and call it, with nothing to say whether it still does what its name promises or was left behind by a rewrite.\n\nIt also keeps other dead code alive. A hidden measure or column that a function names counts as used, whether or not anything calls the function, so `UNNECESSARY_MEASURES` and `UNNECESSARY_COLUMNS` pass over everything the dead function names. Deleting the function brings those to light.\n\nA DAX Lib package installs all of its functions at once, so a model that calls one of them carries the rest unused as a matter of course. The rule reports a package only when none of it is called: the whole library was installed and never used.\n\n### How to fix it\n\nDelete the function, after checking the callers pbiplint cannot see, listed under When to ignore it.\n\nIn Power BI Desktop's Model view, select Model at the top of the Data pane to open [Model explorer](https://learn.microsoft.com/power-bi/transform-model/model-explorer#find-model-explorer), right-click the function under Functions, and choose Delete from model ([Using Model explorer](https://learn.microsoft.com/dax/best-practices/dax-user-defined-functions#using-model-explorer)). In TMDL, remove the function's block from `definition/functions.tmdl`: its `///` description lines, its `function` line, and the lines indented under it. For a package, delete each function that carries its `DAXLIB_PackageId` annotation.\n\n### When to ignore it\n\nWhen something outside the model's own DAX calls the function:\n\n- A DAX query, such as a test harness that runs a model's test functions from outside it.\n- A report's own measures, which this rule does not read, including a live-connected report's, which can call the functions of the model it connects to ([Considerations and limitations](https://learn.microsoft.com/dax/best-practices/dax-user-defined-functions#considerations-and-limitations)).\n- A visual calculation, which pbiplint does not read.\n\nOr when the function is kept on purpose, such as one written ahead of the measures that will call it.\n\nTo ignore this rule on one object, add `annotation pbiplint.ignore = UDF_NOT_CALLED` under the object in its TMDL file. Power BI Desktop keeps the annotation. To turn the rule off for a whole project, set `\"UDF_NOT_CALLED\": \"off\"` under `rules` in `pbiplint.config.json`.\n\n### Quirks\n\n- A call is the function's whole name, dots included, in any letter case, followed by an opening parenthesis, so `MySales.Tax(` is not a call to `Sales.Tax`. A call written inside a string or a comment is not a call.\n- The rule looks one step. A function that only an uncalled function calls is not reported until that caller is gone, and then the next run reports it.\n- A package is known by the `DAXLIB_PackageId` annotation that Power BI Desktop keeps when it installs a package from DAX Lib. Functions installed without that annotation, such as through semantic-link-labs, which writes its own ([`_functions.py`](https://github.com/microsoft/semantic-link-labs/blob/main/src/sempy_labs/daxlib/_functions.py)), are each checked as the model's own.\n- While a model file has a parse issue that can take a declaration out of the model, such as a line indented with spaces, or pbiplint could not open a model file or folder at all, the rule reports nothing, because the DAX that calls the function could be in what pbiplint missed, and pbiplint does not guess what a file it could not read says. The skipped line gives the reason, `a model file could not be fully read`, and the file's own `PARSE_ISSUE` finding names it, or a notice does for a file or folder pbiplint could not open.\n\nRead more: https://pbiplint.com/rules/udf-not-called"
+  },
+  UDF_USE_COMPOUND_NAMES: {
+    text: `Example
+
+Fires the rule
+
+table Sales
+	column Amount
+		dataType: decimal
+		sourceColumn: Amount
+	measure 'Sales With Tax' = AddTax(SUM('Sales'[Amount]))
+		formatString: #,0
+
+/// Adds 10 percent sales tax to an amount.
+function AddTax = (amount: NUMERIC) => amount * 1.1
+
+After the fix
+
+table Sales
+	column Amount
+		dataType: decimal
+		sourceColumn: Amount
+	measure 'Sales With Tax' = Local.AddTax(SUM('Sales'[Amount]))
+		formatString: #,0
+
+/// Adds 10 percent sales tax to an amount.
+function 'Local.AddTax' = (amount: NUMERIC) => amount * 1.1
+
+Why it matters
+
+Most of DAX's built-in functions have one-word names, and new ones arrive with Power BI releases. Microsoft's naming rules say a function's name "Must not conflict with built-in DAX functions" (Define and manage user-defined functions (https://learn.microsoft.com/dax/best-practices/dax-user-defined-functions#define-and-manage-user-defined-functions)), but a one-word name that is free today can be taken by a built-in tomorrow. Microsoft does not say what happens to the model's function then. Tabular Editor's guidance says that "the built-in function takes precedence and your UDF will stop working" (Use compound names for user-defined functions (https://docs.tabulareditor.com/en/kb/bpa-udf-use-compound-names.html#why-this-matters)), so every call to it would reach the built-in instead.
+
+A dot or an underscore marks the name as the model's own. SQLBI's naming conventions recommend a Local. prefix for a model's own functions "to avoid conflicts with future DAX function names" (Function names (https://docs.sqlbi.com/dax-style/dax-naming-conventions#function-names)), and a library's functions start with the library's name.
+
+How to fix it
+
+Rename the function to a compound name, such as Local.AddTax for a function of the model's own, or a prefix for your organization or library.
+
+In Power BI Desktop's Model view, select Model at the top of the Data pane to open Model explorer (https://learn.microsoft.com/power-bi/transform-model/model-explorer#find-model-explorer), right-click the function under Functions, choose Rename, and enter the new name; Desktop updates the measures and functions that call it.
+
+In TMDL, change the name on the function's line in definition/functions.tmdl, in single quotes when it holds a dot (function 'Local.AddTax' =), and at every call in the files under definition/, where it is written without quotes (Local.AddTax(). Searching those files for the old name followed by an opening parenthesis finds the calls.
+
+When to ignore it
+
+When the name is fixed by something outside the model: a live-connected report's own measures, or a DAX query kept elsewhere, calls the function by that name, and renaming it would break them where nothing in the model shows it. Otherwise the finding is not noise, though the risk it guards against lies in future releases rather than in the model today.
+
+To ignore this rule on one object, add annotation pbiplint.ignore = UDF_USE_COMPOUND_NAMES under the object in its TMDL file. Power BI Desktop keeps the annotation. To turn the rule off for a whole project, set "UDF_USE_COMPOUND_NAMES": "off" under rules in pbiplint.config.json.
+
+Quirks
+
+- The test is Tabular Editor's: a dot or an underscore anywhere in the name passes, so _toggleButton passes, and so does add_tax.
+- A dot is no guarantee against a clash. Microsoft's own built-ins include dotted names, such as INFO.USERDEFINEDFUNCTIONS (https://learn.microsoft.com/dax/info-userdefinedfunctions-function-dax).
+- A function from a DAX Lib package is checked as any other, since its name is what callers write.
+
+Read more: https://pbiplint.com/rules/udf-use-compound-names`,
+    markdown: "### Example\n\n**Fires the rule**\n\n```tmdl\ntable Sales\n	column Amount\n		dataType: decimal\n		sourceColumn: Amount\n	measure 'Sales With Tax' = AddTax(SUM('Sales'[Amount]))\n		formatString: #,0\n\n/// Adds 10 percent sales tax to an amount.\nfunction AddTax = (amount: NUMERIC) => amount * 1.1\n```\n\n**After the fix**\n\n```tmdl\ntable Sales\n	column Amount\n		dataType: decimal\n		sourceColumn: Amount\n	measure 'Sales With Tax' = Local.AddTax(SUM('Sales'[Amount]))\n		formatString: #,0\n\n/// Adds 10 percent sales tax to an amount.\nfunction 'Local.AddTax' = (amount: NUMERIC) => amount * 1.1\n```\n\n### Why it matters\n\nMost of DAX's built-in functions have one-word names, and new ones arrive with Power BI releases. Microsoft's naming rules say a function's name \"Must not conflict with built-in DAX functions\" ([Define and manage user-defined functions](https://learn.microsoft.com/dax/best-practices/dax-user-defined-functions#define-and-manage-user-defined-functions)), but a one-word name that is free today can be taken by a built-in tomorrow. Microsoft does not say what happens to the model's function then. Tabular Editor's guidance says that \"the built-in function takes precedence and your UDF will stop working\" ([Use compound names for user-defined functions](https://docs.tabulareditor.com/en/kb/bpa-udf-use-compound-names.html#why-this-matters)), so every call to it would reach the built-in instead.\n\nA dot or an underscore marks the name as the model's own. SQLBI's naming conventions recommend a `Local.` prefix for a model's own functions \"to avoid conflicts with future DAX function names\" ([Function names](https://docs.sqlbi.com/dax-style/dax-naming-conventions#function-names)), and a library's functions start with the library's name.\n\n### How to fix it\n\nRename the function to a compound name, such as `Local.AddTax` for a function of the model's own, or a prefix for your organization or library.\n\nIn Power BI Desktop's Model view, select Model at the top of the Data pane to open [Model explorer](https://learn.microsoft.com/power-bi/transform-model/model-explorer#find-model-explorer), right-click the function under Functions, choose Rename, and enter the new name; Desktop updates the measures and functions that call it.\n\nIn TMDL, change the name on the function's line in `definition/functions.tmdl`, in single quotes when it holds a dot (`function 'Local.AddTax' =`), and at every call in the files under `definition/`, where it is written without quotes (`Local.AddTax(`). Searching those files for the old name followed by an opening parenthesis finds the calls.\n\n### When to ignore it\n\nWhen the name is fixed by something outside the model: a live-connected report's own measures, or a DAX query kept elsewhere, calls the function by that name, and renaming it would break them where nothing in the model shows it. Otherwise the finding is not noise, though the risk it guards against lies in future releases rather than in the model today.\n\nTo ignore this rule on one object, add `annotation pbiplint.ignore = UDF_USE_COMPOUND_NAMES` under the object in its TMDL file. Power BI Desktop keeps the annotation. To turn the rule off for a whole project, set `\"UDF_USE_COMPOUND_NAMES\": \"off\"` under `rules` in `pbiplint.config.json`.\n\n### Quirks\n\n- The test is Tabular Editor's: a dot or an underscore anywhere in the name passes, so `_toggleButton` passes, and so does `add_tax`.\n- A dot is no guarantee against a clash. Microsoft's own built-ins include dotted names, such as [`INFO.USERDEFINEDFUNCTIONS`](https://learn.microsoft.com/dax/info-userdefinedfunctions-function-dax).\n- A function from a DAX Lib package is checked as any other, since its name is what callers write.\n\nRead more: https://pbiplint.com/rules/udf-use-compound-names"
+  },
+  UDF_WITHOUT_DESCRIPTION: {
+    text: `Example
+
+Fires the rule
+
+table Sales
+	column Amount
+		dataType: decimal
+		sourceColumn: Amount
+	measure 'Sales With Tax' = Local.AddTax(SUM('Sales'[Amount]))
+		formatString: #,0
+
+function 'Local.AddTax' = (amount: NUMERIC) => amount * 1.1
+
+After the fix
+
+table Sales
+	column Amount
+		dataType: decimal
+		sourceColumn: Amount
+	measure 'Sales With Tax' = Local.AddTax(SUM('Sales'[Amount]))
+		formatString: #,0
+
+/// Adds 10 percent sales tax to an amount.
+function 'Local.AddTax' = (amount: NUMERIC) => amount * 1.1
+
+Why it matters
+
+A function is written once and called from many places, often by someone other than its author, and its description is what they see of it while they write the call. Microsoft's guidance is to document a function with /// lines, and it notes that single-line (//) or multi-line (/* */) comments "will not appear in IntelliSense function descriptions" (General form (https://learn.microsoft.com/dax/best-practices/dax-user-defined-functions#general-form)). Without a description, a caller learns what the function returns, and what its parameters expect, only by opening its DAX.
+
+How to fix it
+
+Write a sentence or two on what the function returns and what each parameter expects.
+
+In Power BI Desktop, open the function in DAX query view: in Model view, select Model at the top of the Data pane to open Model explorer, right-click the function under Functions, and choose Quick queries, then Define and evaluate (Using Model explorer (https://learn.microsoft.com/dax/best-practices/dax-user-defined-functions#using-model-explorer)). Write /// lines directly above its FUNCTION line and select Update model with changes (Saving to the model (https://learn.microsoft.com/dax/best-practices/dax-user-defined-functions#saving-to-the-model)); the /// syntax serves "both measure and function descriptions" (Add measure descriptions (https://learn.microsoft.com/power-bi/transform-model/dax-query-view#add-measure-descriptions)). In TMDL, add the /// lines directly above the function's function line in definition/functions.tmdl, with no blank line between the last of them and the declaration.
+
+Microsoft says parameter descriptions are not supported (Considerations and limitations (https://learn.microsoft.com/dax/best-practices/dax-user-defined-functions#considerations-and-limitations)), so say what the parameters expect in the description itself; @param and @returns tags are optional.
+
+When to ignore it
+
+A function whose name and parameters already say everything, such as Local.Double(amount), gains little from a sentence repeating them. A function nothing calls is better deleted than described.
+
+To ignore this rule on one object, add annotation pbiplint.ignore = UDF_WITHOUT_DESCRIPTION under the object in its TMDL file. Power BI Desktop keeps the annotation. To turn the rule off for a whole project, set "UDF_WITHOUT_DESCRIPTION": "off" under rules in pbiplint.config.json.
+
+Quirks
+
+- Functions with a DAXLIB_PackageId annotation, which Power BI Desktop keeps when it installs a package from DAX Lib, are skipped, since a published package version cannot be edited, only replaced by a new version (Submitting a library to DAX Lib (https://docs.daxlib.org/contribute/fork-daxlib#submitting-library-to-dax-lib)). Tabular Editor's rule reports them. Functions installed without that annotation, such as through semantic-link-labs, which writes its own (_functions.py (https://github.com/microsoft/semantic-link-labs/blob/main/src/sempy_labs/daxlib/_functions.py)), are checked as the model's own.
+- A description of only spaces or tabs counts as none.
+- Whether a function is hidden makes no difference, as in Tabular Editor's rule, whose name speaks of visible functions but which reports a hidden one too.
+
+Read more: https://pbiplint.com/rules/udf-without-description`,
+    markdown: "### Example\n\n**Fires the rule**\n\n```tmdl\ntable Sales\n	column Amount\n		dataType: decimal\n		sourceColumn: Amount\n	measure 'Sales With Tax' = Local.AddTax(SUM('Sales'[Amount]))\n		formatString: #,0\n\nfunction 'Local.AddTax' = (amount: NUMERIC) => amount * 1.1\n```\n\n**After the fix**\n\n```tmdl\ntable Sales\n	column Amount\n		dataType: decimal\n		sourceColumn: Amount\n	measure 'Sales With Tax' = Local.AddTax(SUM('Sales'[Amount]))\n		formatString: #,0\n\n/// Adds 10 percent sales tax to an amount.\nfunction 'Local.AddTax' = (amount: NUMERIC) => amount * 1.1\n```\n\n### Why it matters\n\nA function is written once and called from many places, often by someone other than its author, and its description is what they see of it while they write the call. Microsoft's guidance is to document a function with `///` lines, and it notes that single-line (`//`) or multi-line (`/* */`) comments \"will not appear in IntelliSense function descriptions\" ([General form](https://learn.microsoft.com/dax/best-practices/dax-user-defined-functions#general-form)). Without a description, a caller learns what the function returns, and what its parameters expect, only by opening its DAX.\n\n### How to fix it\n\nWrite a sentence or two on what the function returns and what each parameter expects.\n\nIn Power BI Desktop, open the function in DAX query view: in Model view, select Model at the top of the Data pane to open Model explorer, right-click the function under Functions, and choose Quick queries, then Define and evaluate ([Using Model explorer](https://learn.microsoft.com/dax/best-practices/dax-user-defined-functions#using-model-explorer)). Write `///` lines directly above its `FUNCTION` line and select Update model with changes ([Saving to the model](https://learn.microsoft.com/dax/best-practices/dax-user-defined-functions#saving-to-the-model)); the `///` syntax serves \"both measure and function descriptions\" ([Add measure descriptions](https://learn.microsoft.com/power-bi/transform-model/dax-query-view#add-measure-descriptions)). In TMDL, add the `///` lines directly above the function's `function` line in `definition/functions.tmdl`, with no blank line between the last of them and the declaration.\n\nMicrosoft says parameter descriptions are not supported ([Considerations and limitations](https://learn.microsoft.com/dax/best-practices/dax-user-defined-functions#considerations-and-limitations)), so say what the parameters expect in the description itself; `@param` and `@returns` tags are optional.\n\n### When to ignore it\n\nA function whose name and parameters already say everything, such as `Local.Double(amount)`, gains little from a sentence repeating them. A function nothing calls is better deleted than described.\n\nTo ignore this rule on one object, add `annotation pbiplint.ignore = UDF_WITHOUT_DESCRIPTION` under the object in its TMDL file. Power BI Desktop keeps the annotation. To turn the rule off for a whole project, set `\"UDF_WITHOUT_DESCRIPTION\": \"off\"` under `rules` in `pbiplint.config.json`.\n\n### Quirks\n\n- Functions with a `DAXLIB_PackageId` annotation, which Power BI Desktop keeps when it installs a package from DAX Lib, are skipped, since a published package version cannot be edited, only replaced by a new version ([Submitting a library to DAX Lib](https://docs.daxlib.org/contribute/fork-daxlib#submitting-library-to-dax-lib)). Tabular Editor's rule reports them. Functions installed without that annotation, such as through semantic-link-labs, which writes its own ([`_functions.py`](https://github.com/microsoft/semantic-link-labs/blob/main/src/sempy_labs/daxlib/_functions.py)), are checked as the model's own.\n- A description of only spaces or tabs counts as none.\n- Whether a function is hidden makes no difference, as in Tabular Editor's rule, whose name speaks of visible functions but which reports a hidden one too.\n\nRead more: https://pbiplint.com/rules/udf-without-description"
+  },
   UNNECESSARY_COLUMNS: {
     text: `Example
 
@@ -13285,17 +13814,18 @@ To ignore this rule on one object, add annotation pbiplint.ignore = UNNECESSARY_
 
 Quirks
 
-- DAX references are approximated by pattern matching: references inside strings or comments count, and a bare [Column] reference resolves measure-first, then the expression's own table, then the first table with that column.
+- DAX is read token by token, so a column named only inside a string or a comment of a DAX expression is not a use (a row-level security filter's text test, below, still counts it), and in extended column syntax, 'Date'[Date].[Year], only 'Date'[Date] is. A bare [Column] reference resolves measure-first, then the expression's own table, then the first table with that column.
+- A bare name for a column the same DAX creates with ADDCOLUMNS, SELECTCOLUMNS, SUMMARIZE, SUMMARIZECOLUMNS, ROW, or DATATABLE is not a use of a model column of that name: a hidden 'Archive'[DueDate] that DAX names only as [DueDate] outside SUMMARIZE ( 'Invoices', 'Invoices'[Key], "DueDate", MAX ( 'Invoices'[DueDate] ) ) is reported, as Tabular Editor reports it. Inside a call that creates the name, the name counts as any other bare name does, since a call cannot read a column it is creating. Outside those calls pbiplint does not work out which table a row context walks, so in DAX that also creates a column Qty, the [Qty] in SUMX ( 'Sales', [Qty] ) is not a use of 'Sales'[Qty] either.
 - A column that a user-defined function names with its table counts as used, even when nothing calls the function, as Tabular Editor counts it.
 - A column that a user-defined function names without its table counts as used, on every table with a column of that name, since the caller can hand the function any table. In pbiplint's parity check, Tabular Editor counted such a name inside SUMX ( 'Sales', [Handling Fee] ) but reported the column a function names in MAX ( [Tax Rate] ), though deleting it would break the function.
 - A column that another column in its table groups by counts as used, as a field parameter's hidden Fields column is: the parameter's display column names it as its groupByColumn under relatedColumnDetails, and the parameter stops working without it. The source rule does not test groupByColumn, so Tabular Editor reports that column.
 - Report usage is not visible to this rule. A hidden column used only by a visual, a slicer, or a report-level filter is still flagged.
 - Variations are not tested, here or in the source rule, so a hidden column that a variation names as its default column is reported. SET_ISAVAILABLEINMDX_TO_TRUE_ON_NECESSARY_COLUMNS does read variations.
-- Row-level security is matched as text, ignoring letter case, the way the source rule matches it. A bare [Column] in any role's filter already counts as a DAX reference (see above), so the text test only adds the qualified forms Table[Column] and 'Table'[Column].
+- Row-level security filters are also matched as text, ignoring letter case, the way the source rule matches them: Table[Column] or 'Table'[Column] in any role's filter, or [Column] in a filter on the column's own table, counts as a use even inside a comment or a string there.
 - While a model file has a parse issue that can take a declaration out of the model, such as a line indented with spaces, or pbiplint could not open a model file or folder at all, the rule reports nothing, because a measure, a relationship, or a security filter that uses the column could be in what pbiplint missed, and pbiplint does not guess what a file it could not read says. The skipped line gives the reason, a model file could not be fully read, and the file's own PARSE_ISSUE finding names it, or a notice does for a file or folder pbiplint could not open.
 
 Read more: https://pbiplint.com/rules/unnecessary-columns`,
-    markdown: "### Example\n\n**Fires the rule**\n\n```tmdl\ntable Sales\n	column 'Order ID'\n		dataType: int64\n		sourceColumn: OrderID\n\n	column Amount\n		dataType: decimal\n		sourceColumn: Amount\n\n	column 'Legacy Region Code'\n		dataType: string\n		isHidden\n		sourceColumn: LegacyRegionCode\n\n	measure 'Total Sales' = SUM('Sales'[Amount])\n		formatString: #,0\n```\n\n**After the fix**\n\n```tmdl\ntable Sales\n	column 'Order ID'\n		dataType: int64\n		sourceColumn: OrderID\n\n	column Amount\n		dataType: decimal\n		sourceColumn: Amount\n\n	measure 'Total Sales' = SUM('Sales'[Amount])\n		formatString: #,0\n```\n\n### Why it matters\n\nA hidden column that nothing uses is loaded, compressed, and refreshed for no reader. Key columns and helper columns pile up this way as a model evolves, and each one costs memory and refresh time in proportion to its cardinality. Removing them is the cheapest model diet there is.\n\n### How to fix it\n\nFor a data column, stop loading it: in Power BI Desktop, Transform data, select the query, and use Choose Columns or Remove Columns, so the column never reaches the model. Where the query reads a view or a stored procedure, drop it from the select list there instead and the refresh gets shorter too. For a calculated column, right-click it in the Data pane and choose Delete from model, or remove its `column` block from the table's TMDL file. If the column turns out to be needed after all, clear Is hidden in the Properties pane, or remove `isHidden` from under the column in the file, and the finding goes with it.\n\n### When to ignore it\n\nReport usage is the case to check first. A hidden column that a visual, a slicer, or a report-level filter binds to is in use, but this rule reads the model only, as the source rule does, so it reports that column all the same. When the report is in the input, `NOT_REACHED_FROM_REPORT` says which fields that report never reaches; other reports on the same model are still yours to open before you delete anything. A column named as the default column of a variation is in the same position: the rule does not read variations, so it reports one that Power BI Desktop is quietly relying on. A staging column you are about to reference is a fair thing to leave for a week. A hidden key that no relationship uses is not: that one is what the rule is for.\n\nTo ignore this rule on one object, add `annotation pbiplint.ignore = UNNECESSARY_COLUMNS` under the object in its TMDL file. Power BI Desktop keeps the annotation. To turn the rule off for a whole project, set `\"UNNECESSARY_COLUMNS\": \"off\"` under `rules` in `pbiplint.config.json`.\n\n### Quirks\n\n- DAX references are approximated by pattern matching: references inside strings or comments count, and a bare `[Column]` reference resolves measure-first, then the expression's own table, then the first table with that column.\n- A column that a user-defined function names with its table counts as used, even when nothing calls the function, as Tabular Editor counts it.\n- A column that a user-defined function names without its table counts as used, on every table with a column of that name, since the caller can hand the function any table. In pbiplint's parity check, Tabular Editor counted such a name inside `SUMX ( 'Sales', [Handling Fee] )` but reported the column a function names in `MAX ( [Tax Rate] )`, though deleting it would break the function.\n- A column that another column in its table groups by counts as used, as a field parameter's hidden Fields column is: the parameter's display column names it as its `groupByColumn` under `relatedColumnDetails`, and the parameter stops working without it. The source rule does not test `groupByColumn`, so Tabular Editor reports that column.\n- Report usage is not visible to this rule. A hidden column used only by a visual, a slicer, or a report-level filter is still flagged.\n- Variations are not tested, here or in the source rule, so a hidden column that a variation names as its default column is reported. `SET_ISAVAILABLEINMDX_TO_TRUE_ON_NECESSARY_COLUMNS` does read variations.\n- Row-level security is matched as text, ignoring letter case, the way the source rule matches it. A bare `[Column]` in any role's filter already counts as a DAX reference (see above), so the text test only adds the qualified forms `Table[Column]` and `'Table'[Column]`.\n- While a model file has a parse issue that can take a declaration out of the model, such as a line indented with spaces, or pbiplint could not open a model file or folder at all, the rule reports nothing, because a measure, a relationship, or a security filter that uses the column could be in what pbiplint missed, and pbiplint does not guess what a file it could not read says. The skipped line gives the reason, `a model file could not be fully read`, and the file's own `PARSE_ISSUE` finding names it, or a notice does for a file or folder pbiplint could not open.\n\nRead more: https://pbiplint.com/rules/unnecessary-columns"
+    markdown: "### Example\n\n**Fires the rule**\n\n```tmdl\ntable Sales\n	column 'Order ID'\n		dataType: int64\n		sourceColumn: OrderID\n\n	column Amount\n		dataType: decimal\n		sourceColumn: Amount\n\n	column 'Legacy Region Code'\n		dataType: string\n		isHidden\n		sourceColumn: LegacyRegionCode\n\n	measure 'Total Sales' = SUM('Sales'[Amount])\n		formatString: #,0\n```\n\n**After the fix**\n\n```tmdl\ntable Sales\n	column 'Order ID'\n		dataType: int64\n		sourceColumn: OrderID\n\n	column Amount\n		dataType: decimal\n		sourceColumn: Amount\n\n	measure 'Total Sales' = SUM('Sales'[Amount])\n		formatString: #,0\n```\n\n### Why it matters\n\nA hidden column that nothing uses is loaded, compressed, and refreshed for no reader. Key columns and helper columns pile up this way as a model evolves, and each one costs memory and refresh time in proportion to its cardinality. Removing them is the cheapest model diet there is.\n\n### How to fix it\n\nFor a data column, stop loading it: in Power BI Desktop, Transform data, select the query, and use Choose Columns or Remove Columns, so the column never reaches the model. Where the query reads a view or a stored procedure, drop it from the select list there instead and the refresh gets shorter too. For a calculated column, right-click it in the Data pane and choose Delete from model, or remove its `column` block from the table's TMDL file. If the column turns out to be needed after all, clear Is hidden in the Properties pane, or remove `isHidden` from under the column in the file, and the finding goes with it.\n\n### When to ignore it\n\nReport usage is the case to check first. A hidden column that a visual, a slicer, or a report-level filter binds to is in use, but this rule reads the model only, as the source rule does, so it reports that column all the same. When the report is in the input, `NOT_REACHED_FROM_REPORT` says which fields that report never reaches; other reports on the same model are still yours to open before you delete anything. A column named as the default column of a variation is in the same position: the rule does not read variations, so it reports one that Power BI Desktop is quietly relying on. A staging column you are about to reference is a fair thing to leave for a week. A hidden key that no relationship uses is not: that one is what the rule is for.\n\nTo ignore this rule on one object, add `annotation pbiplint.ignore = UNNECESSARY_COLUMNS` under the object in its TMDL file. Power BI Desktop keeps the annotation. To turn the rule off for a whole project, set `\"UNNECESSARY_COLUMNS\": \"off\"` under `rules` in `pbiplint.config.json`.\n\n### Quirks\n\n- DAX is read token by token, so a column named only inside a string or a comment of a DAX expression is not a use (a row-level security filter's text test, below, still counts it), and in extended column syntax, `'Date'[Date].[Year]`, only `'Date'[Date]` is. A bare `[Column]` reference resolves measure-first, then the expression's own table, then the first table with that column.\n- A bare name for a column the same DAX creates with ADDCOLUMNS, SELECTCOLUMNS, SUMMARIZE, SUMMARIZECOLUMNS, ROW, or DATATABLE is not a use of a model column of that name: a hidden `'Archive'[DueDate]` that DAX names only as `[DueDate]` outside `SUMMARIZE ( 'Invoices', 'Invoices'[Key], \"DueDate\", MAX ( 'Invoices'[DueDate] ) )` is reported, as Tabular Editor reports it. Inside a call that creates the name, the name counts as any other bare name does, since a call cannot read a column it is creating. Outside those calls pbiplint does not work out which table a row context walks, so in DAX that also creates a column Qty, the `[Qty]` in `SUMX ( 'Sales', [Qty] )` is not a use of `'Sales'[Qty]` either.\n- A column that a user-defined function names with its table counts as used, even when nothing calls the function, as Tabular Editor counts it.\n- A column that a user-defined function names without its table counts as used, on every table with a column of that name, since the caller can hand the function any table. In pbiplint's parity check, Tabular Editor counted such a name inside `SUMX ( 'Sales', [Handling Fee] )` but reported the column a function names in `MAX ( [Tax Rate] )`, though deleting it would break the function.\n- A column that another column in its table groups by counts as used, as a field parameter's hidden Fields column is: the parameter's display column names it as its `groupByColumn` under `relatedColumnDetails`, and the parameter stops working without it. The source rule does not test `groupByColumn`, so Tabular Editor reports that column.\n- Report usage is not visible to this rule. A hidden column used only by a visual, a slicer, or a report-level filter is still flagged.\n- Variations are not tested, here or in the source rule, so a hidden column that a variation names as its default column is reported. `SET_ISAVAILABLEINMDX_TO_TRUE_ON_NECESSARY_COLUMNS` does read variations.\n- Row-level security filters are also matched as text, ignoring letter case, the way the source rule matches them: `Table[Column]` or `'Table'[Column]` in any role's filter, or `[Column]` in a filter on the column's own table, counts as a use even inside a comment or a string there.\n- While a model file has a parse issue that can take a declaration out of the model, such as a line indented with spaces, or pbiplint could not open a model file or folder at all, the rule reports nothing, because a measure, a relationship, or a security filter that uses the column could be in what pbiplint missed, and pbiplint does not guess what a file it could not read says. The skipped line gives the reason, `a model file could not be fully read`, and the file's own `PARSE_ISSUE` finding names it, or a notice does for a file or folder pbiplint could not open.\n\nRead more: https://pbiplint.com/rules/unnecessary-columns"
   },
   UNNECESSARY_MEASURES: {
     text: `Example
@@ -13330,7 +13860,7 @@ A hidden measure that no other measure uses can only be reached by a report that
 
 How to fix it
 
-In Power BI Desktop, right-click the measure in the Data pane and choose Delete from model, or, if reports still use it, clear Is hidden in the Properties pane so the dependency is visible to the next person. In the TMDL file, remove the measure block from its table, or remove isHidden from under it. Search the project for the measure's name before you delete it: this rule has already searched the model's DAX (measures and their format strings, calculated columns and tables, calculation items, row-level security filters, and user-defined functions), so what a search adds is the report files, which this rule does not read, and anything else in the model that names the measure.
+In Power BI Desktop, right-click the measure in the Data pane and choose Delete from model, or, if reports still use it, clear Is hidden in the Properties pane so the dependency is visible to the next person. In the TMDL file, remove the measure block from its table, or remove isHidden from under it. Search the project for the measure's name before you delete it: this rule has already searched the model's DAX (measures with their format strings and KPIs, calculated columns and tables, calculation items, row-level security filters, and user-defined functions), so what a search adds is the report files, which this rule does not read, and anything else in the model that names the measure.
 
 When to ignore it
 
@@ -13344,11 +13874,11 @@ Quirks
 - Report usage is not visible to this rule. A hidden measure used only by a visual is still flagged.
 - A row-level security filter counts as a DAX expression, so a measure named in one is used.
 - A measure named in a user-defined function counts as referenced, even when nothing calls the function, as Tabular Editor counts it. When the report is in the input, NOT_REACHED_FROM_REPORT follows the calls, so it reports a measure that only an uncalled function uses.
-- A bare [Measure] reference resolves by name across the whole model, ignoring letter case, so it counts wherever the measure lives. References are found by pattern, not by parsing, so a measure named inside a string or a comment counts as used too.
+- A bare [Measure] reference resolves by name across the whole model, ignoring letter case, so it counts wherever the measure lives. DAX is read token by token, so a measure named only inside a string or a comment is not a use.
 - While a model file has a parse issue that can take a declaration out of the model, such as a line indented with spaces, or pbiplint could not open a model file or folder at all, the rule reports nothing, because the DAX that references the measure could be in what pbiplint missed, and pbiplint does not guess what a file it could not read says. The skipped line gives the reason, a model file could not be fully read, and the file's own PARSE_ISSUE finding names it, or a notice does for a file or folder pbiplint could not open.
 
 Read more: https://pbiplint.com/rules/unnecessary-measures`,
-    markdown: "### Example\n\n**Fires the rule**\n\n```tmdl\ntable Sales\n	column Amount\n		dataType: decimal\n		sourceColumn: Amount\n\n	measure 'Total Sales' = SUM('Sales'[Amount])\n		formatString: #,0\n\n	measure 'Total Sales Legacy' = SUMX('Sales', 'Sales'[Amount])\n		isHidden\n		formatString: #,0\n```\n\n**After the fix**\n\n```tmdl\ntable Sales\n	column Amount\n		dataType: decimal\n		sourceColumn: Amount\n\n	measure 'Total Sales' = SUM('Sales'[Amount])\n		formatString: #,0\n```\n\n### Why it matters\n\nA hidden measure that no other measure uses can only be reached by a report that already had it, so it is either dead or a hidden dependency that breaks the day someone deletes it as dead. Either way it belongs in the open or in the bin.\n\n### How to fix it\n\nIn Power BI Desktop, right-click the measure in the Data pane and choose Delete from model, or, if reports still use it, clear Is hidden in the Properties pane so the dependency is visible to the next person. In the TMDL file, remove the `measure` block from its table, or remove `isHidden` from under it. Search the project for the measure's name before you delete it: this rule has already searched the model's DAX (measures and their format strings, calculated columns and tables, calculation items, row-level security filters, and user-defined functions), so what a search adds is the report files, which this rule does not read, and anything else in the model that names the measure.\n\n### When to ignore it\n\nReport usage is the case to check first. A hidden measure that a visual or a report-level filter binds to directly is in use, but this rule reads the model only, as the source rule does, so it reports that measure all the same. When the report is in the input, `NOT_REACHED_FROM_REPORT` says which fields that report never reaches; other reports on the same model are still yours to open before you delete a measure. A measure you have written for a calculation item or a measure you have not finished is a fair thing to leave for as long as that lasts. A hidden measure nobody can name a caller for is what the rule is for.\n\nTo ignore this rule on one object, add `annotation pbiplint.ignore = UNNECESSARY_MEASURES` under the object in its TMDL file. Power BI Desktop keeps the annotation. To turn the rule off for a whole project, set `\"UNNECESSARY_MEASURES\": \"off\"` under `rules` in `pbiplint.config.json`.\n\n### Quirks\n\n- References from calculation items and from other hidden measures count as usage.\n- Report usage is not visible to this rule. A hidden measure used only by a visual is still flagged.\n- A row-level security filter counts as a DAX expression, so a measure named in one is used.\n- A measure named in a user-defined function counts as referenced, even when nothing calls the function, as Tabular Editor counts it. When the report is in the input, `NOT_REACHED_FROM_REPORT` follows the calls, so it reports a measure that only an uncalled function uses.\n- A bare `[Measure]` reference resolves by name across the whole model, ignoring letter case, so it counts wherever the measure lives. References are found by pattern, not by parsing, so a measure named inside a string or a comment counts as used too.\n- While a model file has a parse issue that can take a declaration out of the model, such as a line indented with spaces, or pbiplint could not open a model file or folder at all, the rule reports nothing, because the DAX that references the measure could be in what pbiplint missed, and pbiplint does not guess what a file it could not read says. The skipped line gives the reason, `a model file could not be fully read`, and the file's own `PARSE_ISSUE` finding names it, or a notice does for a file or folder pbiplint could not open.\n\nRead more: https://pbiplint.com/rules/unnecessary-measures"
+    markdown: "### Example\n\n**Fires the rule**\n\n```tmdl\ntable Sales\n	column Amount\n		dataType: decimal\n		sourceColumn: Amount\n\n	measure 'Total Sales' = SUM('Sales'[Amount])\n		formatString: #,0\n\n	measure 'Total Sales Legacy' = SUMX('Sales', 'Sales'[Amount])\n		isHidden\n		formatString: #,0\n```\n\n**After the fix**\n\n```tmdl\ntable Sales\n	column Amount\n		dataType: decimal\n		sourceColumn: Amount\n\n	measure 'Total Sales' = SUM('Sales'[Amount])\n		formatString: #,0\n```\n\n### Why it matters\n\nA hidden measure that no other measure uses can only be reached by a report that already had it, so it is either dead or a hidden dependency that breaks the day someone deletes it as dead. Either way it belongs in the open or in the bin.\n\n### How to fix it\n\nIn Power BI Desktop, right-click the measure in the Data pane and choose Delete from model, or, if reports still use it, clear Is hidden in the Properties pane so the dependency is visible to the next person. In the TMDL file, remove the `measure` block from its table, or remove `isHidden` from under it. Search the project for the measure's name before you delete it: this rule has already searched the model's DAX (measures with their format strings and KPIs, calculated columns and tables, calculation items, row-level security filters, and user-defined functions), so what a search adds is the report files, which this rule does not read, and anything else in the model that names the measure.\n\n### When to ignore it\n\nReport usage is the case to check first. A hidden measure that a visual or a report-level filter binds to directly is in use, but this rule reads the model only, as the source rule does, so it reports that measure all the same. When the report is in the input, `NOT_REACHED_FROM_REPORT` says which fields that report never reaches; other reports on the same model are still yours to open before you delete a measure. A measure you have written for a calculation item or a measure you have not finished is a fair thing to leave for as long as that lasts. A hidden measure nobody can name a caller for is what the rule is for.\n\nTo ignore this rule on one object, add `annotation pbiplint.ignore = UNNECESSARY_MEASURES` under the object in its TMDL file. Power BI Desktop keeps the annotation. To turn the rule off for a whole project, set `\"UNNECESSARY_MEASURES\": \"off\"` under `rules` in `pbiplint.config.json`.\n\n### Quirks\n\n- References from calculation items and from other hidden measures count as usage.\n- Report usage is not visible to this rule. A hidden measure used only by a visual is still flagged.\n- A row-level security filter counts as a DAX expression, so a measure named in one is used.\n- A measure named in a user-defined function counts as referenced, even when nothing calls the function, as Tabular Editor counts it. When the report is in the input, `NOT_REACHED_FROM_REPORT` follows the calls, so it reports a measure that only an uncalled function uses.\n- A bare `[Measure]` reference resolves by name across the whole model, ignoring letter case, so it counts wherever the measure lives. DAX is read token by token, so a measure named only inside a string or a comment is not a use.\n- While a model file has a parse issue that can take a declaration out of the model, such as a line indented with spaces, or pbiplint could not open a model file or folder at all, the rule reports nothing, because the DAX that references the measure could be in what pbiplint missed, and pbiplint does not guess what a file it could not read says. The skipped line gives the reason, `a model file could not be fully read`, and the file's own `PARSE_ISSUE` finding names it, or a notice does for a file or folder pbiplint could not open.\n\nRead more: https://pbiplint.com/rules/unnecessary-measures"
   },
   "UNPIVOT_PIVOTED_(MONTH)_DATA": {
     text: `Example
@@ -13743,7 +14273,7 @@ var statOf = (p) => statSync(p, { throwIfNoEntry: false });
 var isDir = (p) => statOf(p)?.isDirectory() ?? false;
 var isFile = (p) => statOf(p)?.isFile() ?? false;
 var byName = (a, b) => a.localeCompare(b, "en");
-var isRecord7 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+var isRecord8 = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
 function folderAt(p) {
   try {
     const stat = statOf(p);
@@ -13930,9 +14460,9 @@ function walked(input, base, read) {
 }
 function reportsNamed(name, text2) {
   const json = readJson(name, text2).json;
-  if (!isRecord7(json) || !Array.isArray(json.artifacts)) return [];
+  if (!isRecord8(json) || !Array.isArray(json.artifacts)) return [];
   return json.artifacts.flatMap(
-    (a) => isRecord7(a) && isRecord7(a.report) && typeof a.report.path === "string" ? [a.report.path] : []
+    (a) => isRecord8(a) && isRecord8(a.report) && typeof a.report.path === "string" ? [a.report.path] : []
   );
 }
 function resolvePbip(input, path) {
@@ -14106,7 +14636,7 @@ function readFolder(w, input, path, preferred) {
 }
 
 // src/main.ts
-var VERSION2 = true ? "0.2.1" : "0.0.0-dev";
+var VERSION2 = true ? "0.2.2" : "0.0.0-dev";
 function listRules() {
   const width = Math.max(...defaultRules.map((r) => r.id.length));
   return defaultRules.map(