@dereekb/dbx-components-mcp 13.40.0 → 13.42.0

package/dbx-components-mcp.js

@@ -10,7 +10,7 @@ var __export = (target, all) => {
 // packages/dbx-components-mcp/package.json
 var package_default = {
   name: "@dereekb/dbx-components-mcp",
-  version: "13.40.0",
+  version: "13.42.0",
   type: "module",
   bin: {
     "dbx-components-mcp": "dbx-components-mcp.js"
@@ -21,8 +21,8 @@ var package_default = {
     "ts-morph": "^21.0.0"
   },
   peerDependencies: {
-    "@dereekb/dbx-cli": "13.40.0",
-    "@dereekb/util": "13.40.0"
+    "@dereekb/dbx-cli": "13.42.0",
+    "@dereekb/util": "13.42.0"
   }
 };
 
@@ -1859,6 +1859,150 @@ var WORKSPACE_AUTH_CLAIMS = [...DEMO_CLAIMS];
 
 // packages/dbx-cli/generated/firebase-models.generated.ts
 var FIREBASE_MODELS = [
+  {
+    name: "Calendar",
+    identityConst: "calendarIdentity",
+    modelType: "calendar",
+    collectionPrefix: "cal",
+    sourcePackage: "@dereekb/firebase",
+    sourceFile: "packages/firebase/src/lib/model/calendar/calendar.ts",
+    fields: [
+      {
+        name: "t",
+        longName: "calendarType",
+        converter: "firestoreString<CalendarType>()",
+        tsType: "CalendarType",
+        optional: false,
+        description: "The kind of calendar this is, resolving its retention policy and ICS emission config."
+      },
+      {
+        name: "n",
+        longName: "name",
+        converter: "firestoreString<string>({ default: '' })",
+        tsType: "string",
+        optional: false,
+        description: "Display name of the calendar. Emitted as NAME/X-WR-CALNAME."
+      },
+      {
+        name: "d",
+        longName: "description",
+        converter: "optionalFirestoreString()",
+        tsType: "Maybe<string>",
+        optional: true,
+        description: "Description of the calendar. Emitted as DESCRIPTION/X-WR-CALDESC."
+      },
+      {
+        name: "tz",
+        longName: "timezone",
+        converter: "firestoreTimezoneString({ default: UTC_TIMEZONE_STRING })",
+        tsType: "TimezoneString",
+        optional: false,
+        description: "Default timezone of the calendar. Emitted as X-WR-TIMEZONE, and the fallback for an event with no `tz`."
+      },
+      {
+        name: "c",
+        longName: "color",
+        converter: "optionalFirestoreString()",
+        tsType: "Maybe<string>",
+        optional: true,
+        description: "CSS3 color name for the calendar. Emitted as COLOR."
+      },
+      {
+        name: "o",
+        longName: "ownerKey",
+        converter: "optionalFirestoreString()",
+        tsType: "Maybe<FirebaseAuthOwnershipKey>",
+        optional: true,
+        description: "Ownership key, if applicable."
+      },
+      {
+        name: "e",
+        longName: "events",
+        converter: "firestoreObjectArray({ objectField: calendarEventItem, sortWith: calendarEventItemsSortFunction<CalendarEventItem>(), filterUnique: calendarEventItemsFilterUniqueFunction<CalendarEventItem>() })",
+        tsType: "CalendarEventItem[]",
+        optional: false,
+        description: "The calendar's one-off events, ascending by start instant and unique by id."
+      },
+      {
+        name: "r",
+        longName: "recurringEvents",
+        converter: "firestoreObjectArray({ objectField: calendarRecurringEventItem, sortWith: calendarEventItemsSortFunction<CalendarRecurringEventItem>(), filterUnique: calendarEventItemsFilterUniqueFunction<CalendarRecurringEventItem>() })",
+        tsType: "CalendarRecurringEventItem[]",
+        optional: false,
+        description: "The calendar's recurring events, ascending by anchor instant and unique by id."
+      },
+      {
+        name: "x",
+        longName: "extensionData",
+        converter: "optionalFirestorePassthroughJsonField<CalendarExtensionData>({ filterEmptyValues: true, dontStoreIfEmpty: true })",
+        tsType: "Maybe<CalendarExtensionData>",
+        optional: true,
+        description: `Extension data emitted as "X-" properties on the calendar's VCALENDAR.`
+      },
+      {
+        name: "cat",
+        longName: "createdAt",
+        converter: "firestoreDate({ saveDefaultAsNow: true })",
+        tsType: "Date",
+        optional: false,
+        description: "Created at date."
+      },
+      {
+        name: "uat",
+        longName: "updatedAt",
+        converter: "firestoreDate({ saveDefaultAsNow: true })",
+        tsType: "Date",
+        optional: false,
+        description: "Updated at date. Moves on every content change."
+      },
+      {
+        name: "s",
+        longName: "needsSync",
+        converter: "optionalFirestoreBoolean({ dontStoreIf: false })",
+        tsType: "Maybe<NeedsSyncBoolean>",
+        optional: true,
+        description: "True if this Calendar should be swept and its published ICS regenerated."
+      },
+      {
+        name: "sat",
+        longName: "syncedAt",
+        converter: "optionalFirestoreDate()",
+        tsType: "Maybe<Date>",
+        optional: true,
+        description: "The last date the published ICS was successfully uploaded."
+      },
+      {
+        name: "rat",
+        longName: "icsRotatedAt",
+        converter: "optionalFirestoreDate()",
+        tsType: "Maybe<Date>",
+        optional: true,
+        description: "The last date this calendar's published ICS link was rotated."
+      },
+      {
+        name: "isf",
+        longName: "icsStorageFileId",
+        converter: "optionalFirestoreString()",
+        tsType: "Maybe<StorageFileId>",
+        optional: true,
+        description: "StorageFile that holds the published ICS for this calendar."
+      },
+      {
+        name: "iu",
+        longName: "icsUrl",
+        converter: "optionalFirestoreString<StorageFilePublicDownloadUrl>()",
+        tsType: "Maybe<StorageFilePublicDownloadUrl>",
+        optional: true,
+        description: "The permanent, anonymously-readable URL the published ICS is served from."
+      }
+    ],
+    enums: [],
+    detectionHints: ["t", "n", "tz", "c", "e", "r", "x", "uat", "sat", "rat", "isf", "iu"],
+    description: 'A calendar and all of its events, stored in one document and published as an ".ics" file.',
+    modelGroup: "Calendar",
+    collectionKind: "root",
+    archetypes: ["root-entity"]
+  },
   {
     name: "NotificationBox",
     identityConst: "notificationBoxIdentity",
@@ -2987,6 +3131,11 @@ var RESERVED_MODEL_FOLDERS = [
     name: "storagefile",
     reason: "StorageFile is a canonical group from `@dereekb/firebase` with a richer layout than the base 5 files (group, upload, file, etc.); downstream projects extend rather than redeclare it.",
     recommendedTool: "dbx_storagefile_m_validate_folder"
+  },
+  {
+    name: "calendar",
+    reason: "Calendar is a canonical group from `@dereekb/firebase` with a richer layout than the base 5 files (type, expand, ics, processing, etc.); downstream projects extend rather than redeclare it.",
+    recommendedTool: "dbx_model_validate_folder"
   }
 ];
 
@@ -4375,7 +4524,7 @@ function extractGroupModelNames(text) {
   while ((match = MODEL_NAME_RE.exec(text)) !== null) {
     seen.add(match[1]);
   }
-  return [...seen].sort((a, b) => a.localeCompare(b));
+  return Array.from(seen).sort((a, b) => a.localeCompare(b));
 }
 
 // packages/dbx-cli/src/lib/mcp-scan/scan/_jsdoc-tagged-export/extract-base.ts
@@ -8124,7 +8273,7 @@ function collectTokensReadFromBody(body) {
   while ((match = CSS_VAR_REFERENCE_RE.exec(body)) !== null) {
     set.add(match[1]);
   }
-  return [...set].sort((a, b) => a.localeCompare(b));
+  return Array.from(set).sort((a, b) => a.localeCompare(b));
 }
 function collectTokensSet(declarations) {
   const set = /* @__PURE__ */ new Set();
@@ -8133,7 +8282,7 @@ function collectTokensSet(declarations) {
       set.add(decl.property);
     }
   }
-  return [...set].sort((a, b) => a.localeCompare(b));
+  return Array.from(set).sort((a, b) => a.localeCompare(b));
 }
 
 // packages/dbx-cli/src/lib/mcp-scan/scan/css-utilities-scan-config-schema.ts
@@ -9050,7 +9199,7 @@ async function discoverConventionalDirs(workspaceRoot) {
       found.add(rel);
     }
   }
-  return [...found];
+  return Array.from(found);
 }
 function normaliseExplicitDirs(dirs) {
   const result = [];
@@ -9155,7 +9304,7 @@ async function detectCandidateClusters(absDir) {
     }
   } catch {
   }
-  return [...found];
+  return Array.from(found);
 }
 function mergeClusters(...lists) {
   const seen = /* @__PURE__ */ new Set();
@@ -10216,11 +10365,18 @@ function analyzeSequence(input) {
   if (isSingleFieldQuery(buckets)) {
     return analyzeSingleField({ buckets, collection, scope, warnings });
   }
+  if (scope === "COLLECTION" && isEqualityOnlySequence(buckets)) {
+    warnings.push({ kind: "equality-only-composite-skipped", factoryName, fields: buckets.equalities.map((e) => e.fieldPath) });
+    return { kind: "auto", warnings };
+  }
   return analyzeMultiField({ buckets, sequenceEntries: sequence.entries, collection, scope, factoryName, warnings });
 }
 function isSingleFieldQuery(buckets) {
   return buckets.distinctFieldCount === 1;
 }
+function isEqualityOnlySequence(buckets) {
+  return buckets.ranges.length === 0 && buckets.arrays.length === 0 && buckets.orderBys.length === 0 && buckets.equalities.length > 0 && buckets.equalities.every((e) => (e.operator ?? "==") === "==");
+}
 function analyzeSingleField(input) {
   const { buckets, collection, scope, warnings } = input;
   if (scope === "COLLECTION") {
@@ -10315,7 +10471,7 @@ function collectOrderByDirections(input) {
     }
   }
   for (const [field, dirs] of conflicts) {
-    warnings.push({ kind: "orderby-conflict", factoryName, field, directions: [...dirs] });
+    warnings.push({ kind: "orderby-conflict", factoryName, field, directions: Array.from(dirs) });
   }
   return out;
 }
@@ -10778,7 +10934,7 @@ function composeEntry(input) {
 }
 function resolveConstraintSequences(input) {
   const { candidate, tags, name, line, filePath, warnings } = input;
-  const bodyResult = extractConstraintsFromBody({ decl: candidate.decl, factoryName: name, filePath, dispatcher: tags.dispatcher });
+  const bodyResult = extractConstraintsFromBody({ decl: candidate.decl, factoryName: name, filePath, dispatcher: tags.dispatcher, suppressed: tags.skip || tags.specOnly });
   for (const warning of bodyResult.warnings) {
     warnings.push(warning);
   }
@@ -10859,11 +11015,14 @@ function buildConstraintSequences(input) {
   return sequences;
 }
 function extractConstraintsFromBody(input) {
-  const { decl, factoryName, filePath, dispatcher } = input;
+  const { decl, factoryName, filePath, dispatcher, suppressed } = input;
   const entries = [];
   const conditionalFieldSet = /* @__PURE__ */ new Set();
   const warnings = [];
   const body = decl.getBody();
+  if (suppressed) {
+    return { entries, conditionalFields: [], warnings, skipped: true, dispatcherDelegates: [] };
+  }
   if (dispatcher) {
     const violation = body === void 0 ? void 0 : findFirstConstraintCall(body);
     if (violation !== void 0) {
@@ -11584,6 +11743,9 @@ function formatModelFirebaseIndexBuildWarning(warning) {
       case "unsupported-array-contains-any":
         result = `${w.factoryName} field "${w.field}" uses array-contains-any \u2014 index support is partial`;
         break;
+      case "equality-only-composite-skipped":
+        result = `${w.factoryName} is equality-only on [${w.fields.join(", ")}] \u2014 no composite emitted, Firestore serves this by merging the automatic single-field indexes`;
+        break;
     }
   }
   return result;
@@ -14171,13 +14333,13 @@ async function discoverClaimsFiles(cwd) {
     } catch {
     }
   }
-  return [...found].sort((a, b) => a.localeCompare(b));
+  return Array.from(found).sort((a, b) => a.localeCompare(b));
 }
 function mergeAndNormalisePaths(discovered, extra) {
   const out = /* @__PURE__ */ new Set();
   for (const p of discovered) out.add(p);
   for (const p of extra) out.add(toPosix(p));
-  return [...out].sort((a, b) => a.localeCompare(b));
+  return Array.from(out).sort((a, b) => a.localeCompare(b));
 }
 function toPosix(value) {
   return value.split(sep4).join("/");
@@ -14827,12 +14989,13 @@ function pushInto13(map, key, entry) {
 var DEFAULT_BIN_NAME = "dbx-cli-generate-firestore-indexes";
 function buildUsage(binName) {
   return [
-    `Usage: ${binName} --component <dir> [--output <path>] [--check] [--json] [--help]`,
+    `Usage: ${binName} --component <dir> [--component <dir> ...] [--output <path>] [--check] [--json] [--help]`,
     "",
     "Generates `firestore.indexes.json` from `@dbxModelFirebaseIndex`-tagged factories.",
     "",
     "Options:",
-    "  --component <dir>  Required. Relative path to the `-firebase` component package.",
+    "  --component <dir>  Required, repeatable. Relative path to a `-firebase` component or package.",
+    "                     Repeat to derive one indexes file from several packages at once.",
     "  --output <path>    Output path. Defaults to `firestore.indexes.json` at the cwd.",
     "  --check            Compare against the on-disk file; exit 1 on drift, do not write.",
     "  --json             Print the diff summary as JSON instead of human-readable text.",
@@ -14852,23 +15015,40 @@ async function runGenerateFirestoreIndexesCli(input) {
     stderr(usage);
     return { exitCode: 2 };
   }
-  if (parsed.component === void 0) {
+  if (parsed.components.length === 0) {
     stderr("generate-firestore-indexes: --component is required");
     stderr(usage);
     return { exitCode: 2 };
   }
-  const componentAbs = resolve26(cwd, parsed.component);
   const outputAbs = resolve26(cwd, parsed.output);
-  const buildOutcome = await buildModelFirebaseIndexManifest({
-    projectRoot: componentAbs,
-    generator
-  });
-  if (buildOutcome.kind !== "success") {
-    stderr(formatBuildFailure(buildOutcome));
+  const entries = [];
+  const loadedSources = [];
+  let sawUnresolvedModel = false;
+  for (const component of parsed.components) {
+    const buildOutcome = await buildModelFirebaseIndexManifest({
+      projectRoot: resolve26(cwd, component),
+      generator
+    });
+    if (buildOutcome.kind !== "success") {
+      stderr(formatBuildFailure(buildOutcome));
+      return { exitCode: 1 };
+    }
+    for (const warning of buildOutcome.extractWarnings) {
+      stderr(`${warning.stage}-warning: ${formatModelFirebaseIndexBuildWarning(warning)}`);
+      if (warning.stage === "extract" && warning.warning.kind === "unresolved-model") {
+        sawUnresolvedModel = true;
+      }
+    }
+    for (const entry of buildOutcome.manifest.entries) {
+      entries.push(toModelFirebaseIndexEntryInfo(entry));
+    }
+    loadedSources.push(buildOutcome.manifest.source);
+  }
+  if (sawUnresolvedModel) {
+    stderr("generate-firestore-indexes: one or more @dbxModelFirebaseIndexModel tags could not be resolved, so their indexes were dropped. Add the missing identity file to the component\u2019s `dbx-mcp.scan.json` include globs.");
     return { exitCode: 1 };
   }
-  const entries = buildOutcome.manifest.entries.map(toModelFirebaseIndexEntryInfo);
-  const registry = createModelFirebaseIndexRegistryFromEntries({ entries, loadedSources: [buildOutcome.manifest.source] });
+  const registry = createModelFirebaseIndexRegistryFromEntries({ entries, loadedSources });
   const existingJson = await readExistingIndexes({ outputAbs, readFile: readFile33, stderr });
   const { json, diff } = generateFirestoreIndexesJson({ entries: registry.all, existingJson });
   const serialized = serializeFirestoreIndexesJson(json);
@@ -14891,7 +15071,7 @@ async function runGenerateFirestoreIndexesCli(input) {
   return { exitCode: 0 };
 }
 function parseArgv(argv) {
-  let component;
+  const components = [];
   let output = "firestore.indexes.json";
   let check = false;
   let json = false;
@@ -14906,7 +15086,7 @@ function parseArgv(argv) {
         if (i >= argv.length) {
           error = "generate-firestore-indexes: --component requires a value";
         } else {
-          component = argv[i];
+          components.push(argv[i]);
         }
         break;
       case "--output":
@@ -14933,7 +15113,7 @@ function parseArgv(argv) {
     }
     i += 1;
   }
-  return { component, output, check, json, help, error };
+  return { components, output, check, json, help, error };
 }
 async function readExistingIndexes(input) {
   const text = await readExistingIndexesText(input);
@@ -16350,7 +16530,7 @@ function warnDroppedFutureStates(tree, realNames, warnings) {
       continue;
     }
     const prefix = node.data.name.slice(0, -3);
-    const hasRealSubtree = realNames.has(prefix) || [...realNames].some((name) => name.startsWith(`${prefix}.`));
+    const hasRealSubtree = realNames.has(prefix) || Array.from(realNames).some((name) => name.startsWith(`${prefix}.`));
     if (!hasRealSubtree) {
       warnings.push({ kind: "dropped-future-state", severity: "warning", message: `Future state \`${node.data.name}\` was dropped and has no real subtree under \`${prefix}\`; its page will not match any URL.`, stateName: node.data.name });
     }
@@ -19044,9 +19224,9 @@ function scanFirestoreRules(source) {
       if (allow.ops.has("list") || allow.ops.has("read")) current.list = mergeAccess(current.list, allow.access);
     }
   });
-  const collections = [...accumulated.entries()].map(([collection, value]) => ({
+  const collections = Array.from(accumulated.entries()).map(([collection, value]) => ({
     collection,
-    paths: [...value.paths].sort(),
+    paths: Array.from(value.paths).sort(),
     get: value.get,
     list: value.list,
     collectionGroup: value.collectionGroup,
@@ -21958,7 +22138,7 @@ function formatDownstreamSection(downstream) {
     bucket.push(model);
     byPackage.set(model.sourcePackage, bucket);
   }
-  const packageNames = [...byPackage.keys()].sort((a, b) => a.localeCompare(b));
+  const packageNames = Array.from(byPackage.keys()).sort((a, b) => a.localeCompare(b));
   for (const pkg of packageNames) {
     lines.push(`### \`${pkg}\``, "");
     const bucket = byPackage.get(pkg) ?? [];
@@ -28680,13 +28860,18 @@ function readJsDocSummary(node) {
 }
 
 // packages/dbx-cli/manifest-extract/src/lib/extract-models.ts
-import { Node as Node24, Project as Project9 } from "ts-morph";
+import { Node as Node24, SyntaxKind as SyntaxKind10, Project as Project9 } from "ts-morph";
 var READ_LEVEL_VALUES2 = /* @__PURE__ */ new Set(["system", "owner", "admin-only", "permissions"]);
 var SERVICE_FACTORY_TAG = "dbxModelServiceFactory";
 var MCP_TOOL_NAME_SEGMENT_TAG = "dbxModelMcpToolNameSegment";
 var MODEL_TYPE_VALUE_PATTERN2 = /^[a-z][A-Za-z0-9_$]*$/;
 var TOOL_NAME_SEGMENT_PATTERN = /^[A-Za-z][A-Za-z0-9_$]*$/;
 var IDENTITY_FN = "firestoreModelIdentity";
+var SINGLE_ITEM_COLLECTION_FN = "singleItemFirestoreCollection";
+var ROOT_SINGLE_ITEM_COLLECTION_FN = "rootSingleItemFirestoreCollection";
+var SINGLE_ITEM_COLLECTION_FN_NAMES = [SINGLE_ITEM_COLLECTION_FN, ROOT_SINGLE_ITEM_COLLECTION_FN];
+var MODEL_IDENTITY_KEY = "modelIdentity";
+var SINGLE_ITEM_IDENTIFIER_KEY = "singleItemIdentifier";
 var CONVERTER_FN_NAMES = ["snapshotConverterFunctions", "firestoreSubObject", "firestoreObjectArray"];
 var SUB_OBJECT_FN = "firestoreSubObject";
 var OBJECT_ARRAY_FN = "firestoreObjectArray";
@@ -28703,7 +28888,9 @@ function extractModelsFromSource(input) {
   const enums = readEnums(sourceFile);
   const modelGroups = readModelGroups(sourceFile);
   const serviceFactories = readServiceFactories(sourceFile);
-  return { identities, interfaces, converters, enums, modelGroups, serviceFactories };
+  const singleItemCollections = readSingleItemCollections(sourceFile);
+  const stringConstants = readStringConstants(sourceFile);
+  return { identities, interfaces, converters, enums, modelGroups, serviceFactories, singleItemCollections, stringConstants };
 }
 function readIdentities(sourceFile) {
   const out = [];
@@ -28823,6 +29010,65 @@ function readServiceFactoryModelType(jsDocs) {
   }
   return result;
 }
+function readSingleItemCollections(sourceFile) {
+  const out = [];
+  const text = sourceFile.getFullText();
+  if (SINGLE_ITEM_COLLECTION_FN_NAMES.some((name) => text.includes(name))) {
+    for (const call of sourceFile.getDescendantsOfKind(SyntaxKind10.CallExpression)) {
+      const fnName = readCalleeName(call);
+      if (fnName !== SINGLE_ITEM_COLLECTION_FN && fnName !== ROOT_SINGLE_ITEM_COLLECTION_FN) continue;
+      const entry = buildSingleItemCollection(call, fnName === ROOT_SINGLE_ITEM_COLLECTION_FN);
+      if (entry) out.push(entry);
+    }
+  }
+  return out;
+}
+function readCalleeName(call) {
+  const expression = call.getExpression();
+  return Node24.isPropertyAccessExpression(expression) ? expression.getName() : expression.getText();
+}
+function buildSingleItemCollection(call, root) {
+  let result;
+  const args = call.getArguments();
+  if (args.length > 0) {
+    const config = args[0];
+    if (Node24.isObjectLiteralExpression(config)) {
+      const identityNode = readPropertyValue(config, MODEL_IDENTITY_KEY);
+      if (identityNode && Node24.isIdentifier(identityNode)) {
+        const identifierNode = readPropertyValue(config, SINGLE_ITEM_IDENTIFIER_KEY);
+        result = {
+          identityConst: identityNode.getText(),
+          root,
+          documentId: readStringLiteralText(identifierNode),
+          documentIdConstRef: identifierNode && Node24.isIdentifier(identifierNode) ? identifierNode.getText() : void 0,
+          explicitIdentifier: config.getProperty(SINGLE_ITEM_IDENTIFIER_KEY) !== void 0,
+          line: call.getStartLineNumber()
+        };
+      }
+    }
+  }
+  return result;
+}
+function readStringConstants(sourceFile) {
+  const out = [];
+  for (const statement of sourceFile.getVariableStatements()) {
+    if (!statement.isExported()) continue;
+    for (const decl of statement.getDeclarations()) {
+      const value = readStringLiteralText(decl.getInitializer());
+      if (value !== void 0) {
+        out.push({ name: decl.getName(), value });
+      }
+    }
+  }
+  return out;
+}
+function readStringLiteralText(node) {
+  let current = node;
+  while (current !== void 0 && Node24.isAsExpression(current)) {
+    current = current.getExpression();
+  }
+  return current !== void 0 && (Node24.isStringLiteral(current) || Node24.isNoSubstitutionTemplateLiteral(current)) ? current.getLiteralText() : void 0;
+}
 function readConverters(sourceFile) {
   const out = [];
   for (const statement of sourceFile.getVariableStatements()) {
@@ -29368,7 +29614,7 @@ function buildSummaries(entries, issues) {
     const summary = byModel.get(issue.model);
     if (summary) summary.errorCount += 1;
   }
-  return [...byModel.entries()].map(([model, s]) => ({ model, ...s })).sort((a, b) => a.model.localeCompare(b.model));
+  return Array.from(byModel.entries()).map(([model, s]) => ({ model, ...s })).sort((a, b) => a.model.localeCompare(b.model));
 }
 function compareEntries(a, b) {
   return a.model.localeCompare(b.model) || a.verb.localeCompare(b.verb) || (a.specifier ?? "").localeCompare(b.specifier ?? "");
@@ -29444,7 +29690,7 @@ async function readComponentDereekbDeps(componentAbs) {
       addScopedDependencyNames(json[field], out);
     }
   }
-  return [...out];
+  return Array.from(out);
 }
 function addScopedDependencyNames(field, out) {
   if (isRecord(field)) {
@@ -29804,7 +30050,7 @@ __export(dbx_asset_validate_app_exports, {
 import { Node as Node27, Project as Project12 } from "ts-morph";
 
 // packages/dbx-cli/validate/src/lib/_core/_validate/ast.ts
-import { Node as Node26, Project as Project11, SyntaxKind as SyntaxKind10 } from "ts-morph";
+import { Node as Node26, Project as Project11, SyntaxKind as SyntaxKind11 } from "ts-morph";
 var COMPONENT_VIRTUAL_PREFIX = "__component__/";
 var API_VIRTUAL_PREFIX = "__api__/";
 // @__NO_SIDE_EFFECTS__
@@ -29906,7 +30152,7 @@ function findLocalVariable(sf, name) {
       if (decl.getName() === name) return decl;
     }
   }
-  for (const decl of sf.getDescendantsOfKind(SyntaxKind10.VariableDeclaration)) {
+  for (const decl of sf.getDescendantsOfKind(SyntaxKind11.VariableDeclaration)) {
     if (decl.getName() === name) return decl;
   }
   return void 0;
@@ -29916,7 +30162,7 @@ function collectTypeofReferences(node, out) {
     out.push(node.getExprName().getText());
     return;
   }
-  for (const tq of node.getDescendantsOfKind(SyntaxKind10.TypeQuery)) {
+  for (const tq of node.getDescendantsOfKind(SyntaxKind11.TypeQuery)) {
     out.push(tq.getExprName().getText());
   }
 }
@@ -30607,7 +30853,7 @@ __export(notification_m_validate_app_exports, {
 });
 
 // packages/dbx-cli/validate/src/lib/notification-m-validate-app/extract.ts
-import { Node as Node28, SyntaxKind as SyntaxKind11 } from "ts-morph";
+import { Node as Node28, SyntaxKind as SyntaxKind12 } from "ts-morph";
 var NOTIF_TEMPLATE_TYPE = "NotificationTemplateType";
 var NOTIF_TEMPLATE_TYPE_INFO = "NotificationTemplateTypeInfo";
 var NOTIF_TEMPLATE_TYPE_INFO_ARRAY = "NotificationTemplateTypeInfo[]";
@@ -30877,7 +31123,7 @@ function tryReadTemplateInfoRecord(decl, rel, index) {
     symbolName: decl.getName(),
     directInfoIdentifiers: direct,
     spreadAggregateIdentifiers: spreads,
-    resolvedInfoIdentifiers: [...resolved],
+    resolvedInfoIdentifiers: Array.from(resolved),
     unresolvedSpreadIdentifiers: unresolved,
     sourceFile: rel
   };
@@ -30914,7 +31160,7 @@ function extractTemplateInfoRecordWiring(sources) {
   let result;
   outer: for (const sf of sources) {
     const rel = apiRelPath(sf);
-    for (const call of sf.getDescendantsOfKind(SyntaxKind11.CallExpression)) {
+    for (const call of sf.getDescendantsOfKind(SyntaxKind12.CallExpression)) {
       if (call.getExpression().getText() !== TEMPLATE_INFO_RECORD_SERVICE) continue;
       const args = call.getArguments();
       const first = args[0];
@@ -30934,7 +31180,7 @@ function extractTemplateConfigsArrayWiring(sources) {
   let result;
   outer: for (const sf of sources) {
     const rel = apiRelPath(sf);
-    for (const obj of sf.getDescendantsOfKind(SyntaxKind11.ObjectLiteralExpression)) {
+    for (const obj of sf.getDescendantsOfKind(SyntaxKind12.ObjectLiteralExpression)) {
       const provideIdent = readIdentifierProperty(obj, "provide");
       if (provideIdent !== TEMPLATE_CONFIGS_ARRAY_TOKEN) continue;
       const useFactoryIdent = readIdentifierProperty(obj, "useFactory");
@@ -31128,7 +31374,7 @@ function extractTaskServiceCalls(sources, index, trustedExternal) {
   const out = [];
   for (const sf of sources) {
     const rel = apiRelPath(sf);
-    for (const call of sf.getDescendantsOfKind(SyntaxKind11.CallExpression)) {
+    for (const call of sf.getDescendantsOfKind(SyntaxKind12.CallExpression)) {
       const expr = call.getExpression();
       if (!Node28.isIdentifier(expr) || expr.getText() !== TASK_SERVICE_FACTORY) continue;
       const args = call.getArguments();
@@ -31315,7 +31561,7 @@ function extractTaskHandlerEntries(sources) {
   const seenSymbols = /* @__PURE__ */ new Set();
   for (const sf of sources) {
     const rel = apiRelPath(sf);
-    for (const decl of sf.getDescendantsOfKind(SyntaxKind11.VariableDeclaration)) {
+    for (const decl of sf.getDescendantsOfKind(SyntaxKind12.VariableDeclaration)) {
       const entry = tryReadTaskHandlerEntry(decl, rel, seenSymbols);
       if (entry) {
         out.push(entry);
@@ -31994,7 +32240,7 @@ __export(storagefile_m_validate_app_exports, {
 });
 
 // packages/dbx-cli/validate/src/lib/storagefile-m-validate-app/extract.ts
-import { Node as Node29, SyntaxKind as SyntaxKind12 } from "ts-morph";
+import { Node as Node29, SyntaxKind as SyntaxKind13 } from "ts-morph";
 
 // packages/dbx-cli/validate/src/lib/storagefile-m-validate-app/group-ids.ts
 var GROUP_IDS_FUNCTION_SUFFIXES = ["StorageFileGroupIds", "FileGroupIds"];
@@ -32138,7 +32384,7 @@ function extractUploadInitializerEntries(sources) {
   const out = [];
   for (const sf of sources) {
     const rel = apiRelPath(sf);
-    for (const decl of sf.getDescendantsOfKind(SyntaxKind12.VariableDeclaration)) {
+    for (const decl of sf.getDescendantsOfKind(SyntaxKind13.VariableDeclaration)) {
       const typeText = typeAnnotationText(decl);
       if (typeText !== UPLOAD_SERVICE_INITIALIZER_TYPE) continue;
       const obj = asObjectLiteral(decl.getInitializer());
@@ -32303,7 +32549,7 @@ function extractUploadServiceCalls(sources, index) {
   const out = [];
   for (const sf of sources) {
     const rel = apiRelPath(sf);
-    for (const call of sf.getDescendantsOfKind(SyntaxKind12.CallExpression)) {
+    for (const call of sf.getDescendantsOfKind(SyntaxKind13.CallExpression)) {
       const expr = call.getExpression();
       if (!Node29.isIdentifier(expr) || expr.getText() !== UPLOAD_SERVICE_FACTORY) continue;
       const args = call.getArguments();
@@ -32380,7 +32626,7 @@ function extractUploadServiceWirings(sources) {
   const out = [];
   for (const sf of sources) {
     const rel = apiRelPath(sf);
-    for (const obj of sf.getDescendantsOfKind(SyntaxKind12.ObjectLiteralExpression)) {
+    for (const obj of sf.getDescendantsOfKind(SyntaxKind13.ObjectLiteralExpression)) {
       const provideIdent = readIdentifierProperty(obj, "provide");
       if (provideIdent !== UPLOAD_SERVICE_PROVIDE_TOKEN) continue;
       const useFactory = readIdentifierProperty(obj, "useFactory");
@@ -32393,7 +32639,7 @@ function extractProcessingConfigs(sources) {
   const out = [];
   for (const sf of sources) {
     const rel = apiRelPath(sf);
-    for (const decl of sf.getDescendantsOfKind(SyntaxKind12.VariableDeclaration)) {
+    for (const decl of sf.getDescendantsOfKind(SyntaxKind13.VariableDeclaration)) {
       const config = extractProcessingConfigFromDecl(decl, rel);
       if (config) {
         out.push(config);
@@ -32437,7 +32683,7 @@ function extractProcessingHandlerCalls(sources) {
   const out = [];
   for (const sf of sources) {
     const rel = apiRelPath(sf);
-    for (const call of sf.getDescendantsOfKind(SyntaxKind12.CallExpression)) {
+    for (const call of sf.getDescendantsOfKind(SyntaxKind13.CallExpression)) {
       const expr = call.getExpression();
       if (!Node29.isIdentifier(expr) || expr.getText() !== PROCESSING_HANDLER_FACTORY) continue;
       const args = call.getArguments();
@@ -32657,7 +32903,7 @@ function flagUploadServiceWiring(extracted, violations) {
   if (!anyWired) {
     pushViolation9(violations, {
       code: "STORAGEFILE_UPLOAD_SERVICE_NOT_WIRED",
-      message: `No NestJS provider with \`provide: StorageFileInitializeFromUploadService, useFactory: ${factoryNames.size > 0 ? [...factoryNames].join(" | ") : "<storage-file-upload-factory>"}\` found. Bind the factory function in a NestJS module.`,
+      message: `No NestJS provider with \`provide: StorageFileInitializeFromUploadService, useFactory: ${factoryNames.size > 0 ? Array.from(factoryNames).join(" | ") : "<storage-file-upload-factory>"}\` found. Bind the factory function in a NestJS module.`,
       side: "api",
       file: void 0
     });
@@ -33833,7 +34079,7 @@ function toPosix2(p) {
 }
 
 // packages/dbx-cli/model-test/src/lib/test/extract.ts
-import { Node as Node31, Project as Project14, SyntaxKind as SyntaxKind13 } from "ts-morph";
+import { Node as Node31, Project as Project14, SyntaxKind as SyntaxKind14 } from "ts-morph";
 var SPEC_FILE_VIRTUAL_PATH = "__spec__/spec.ts";
 var FIXTURE_CONTEXT_SUFFIX = "Context";
 var FIXTURE_FACTORY_SUFFIX = "ContextFactory";
@@ -33919,7 +34165,7 @@ function collectFixtureImports(sourceFile) {
       seen.add(name);
     }
   }
-  return [...seen];
+  return Array.from(seen);
 }
 function matchesFixtureModulePath(spec) {
   return /(^|\/)test\/fixture(\.[a-z]+)?$/.test(spec);
@@ -33951,7 +34197,7 @@ function trimToCamelBoundary(s) {
   return s;
 }
 function dedupedSorted(names) {
-  return [...new Set(names)].sort((a, b) => a.localeCompare(b));
+  return Array.from(new Set(names)).sort((a, b) => a.localeCompare(b));
 }
 function walkCall(call, ctx) {
   const calleeName = getCalleeName(call);
@@ -34161,7 +34407,7 @@ function appendHelperIfUsesDescribeOrIt(input) {
 function scanForDescribeOrIt(node) {
   const usage = { emitsDescribe: false, emitsIt: false };
   node.forEachDescendant((descendant) => {
-    if (descendant.getKind() !== SyntaxKind13.CallExpression) return;
+    if (descendant.getKind() !== SyntaxKind14.CallExpression) return;
     const call = descendant;
     const expr = call.getExpression();
     if (!Node31.isIdentifier(expr)) return;
@@ -34180,7 +34426,7 @@ import { readFile as readFile14 } from "node:fs/promises";
 import { join as join15 } from "node:path";
 
 // packages/dbx-cli/model-test/src/lib/fixture/extract.ts
-import { Node as Node32, Project as Project15, SyntaxKind as SyntaxKind14 } from "ts-morph";
+import { Node as Node32, Project as Project15, SyntaxKind as SyntaxKind15 } from "ts-morph";
 
 // packages/dbx-cli/model-test/src/lib/fixture/archetype.ts
 function classifyFixtureArchetype(input) {
@@ -34557,7 +34803,7 @@ function readParamsAccessFieldName(fn) {
   if (!Node32.isArrowFunction(fn) && !Node32.isFunctionExpression(fn)) return void 0;
   const body = fn.getBody();
   if (!body) return void 0;
-  for (const access2 of body.getDescendantsOfKind(SyntaxKind14.PropertyAccessExpression)) {
+  for (const access2 of body.getDescendantsOfKind(SyntaxKind15.PropertyAccessExpression)) {
     const expr = access2.getExpression();
     if (Node32.isIdentifier(expr) && expr.getText() === "params") {
       return access2.getName();
@@ -34612,7 +34858,7 @@ function collectAllModels(fixtures, instances) {
   const all = /* @__PURE__ */ new Set();
   for (const k of fixtures.keys()) all.add(k);
   for (const k of instances.keys()) all.add(k);
-  const list = [...all];
+  const list = Array.from(all);
   list.sort((a, b) => {
     const aLine = (fixtures.get(a) ?? instances.get(a))?.getStartLineNumber() ?? 0;
     const bLine = (fixtures.get(b) ?? instances.get(b))?.getStartLineNumber() ?? 0;
@@ -34647,8 +34893,8 @@ function readMethod(m) {
   return result;
 }
 function readVisibility(m) {
-  if (m.hasModifier(SyntaxKind14.PrivateKeyword)) return "private";
-  if (m.hasModifier(SyntaxKind14.ProtectedKeyword)) return "protected";
+  if (m.hasModifier(SyntaxKind15.PrivateKeyword)) return "private";
+  if (m.hasModifier(SyntaxKind15.ProtectedKeyword)) return "protected";
   return "public";
 }
 function readExtendsGenerics(cls) {
@@ -34666,7 +34912,7 @@ function collectIdentityImports(sourceFile) {
       }
     }
   }
-  const list = [...out];
+  const list = Array.from(out);
   list.sort((a, b) => a.localeCompare(b));
   return list;
 }
@@ -36290,7 +36536,7 @@ import { join as join20, relative as relative16, sep as sep14 } from "node:path"
 // packages/dbx-cli/validate/src/lib/model-api-lookup/extract-actions.ts
 import { readFile as readFile19 } from "node:fs/promises";
 import { join as join19, relative as relative15, sep as sep13 } from "node:path";
-import { Project as Project17, SyntaxKind as SyntaxKind15 } from "ts-morph";
+import { Project as Project17, SyntaxKind as SyntaxKind16 } from "ts-morph";
 var ACTION_SERVER_SUFFIX = ".action.server.ts";
 var COMMON_MODEL_SUBPATH = "src/app/common/model";
 async function buildActionLookup(apiAbs) {
@@ -36363,7 +36609,7 @@ function collectFactoryFunctions(input) {
   }
 }
 function findValidatorArgInBody(fn) {
-  for (const call of fn.getDescendantsOfKind(SyntaxKind15.CallExpression)) {
+  for (const call of fn.getDescendantsOfKind(SyntaxKind16.CallExpression)) {
     const expr = call.getExpression();
     const exprText = expr.getText();
     if (!exprText.endsWith("firebaseServerActionTransformFunctionFactory")) continue;
@@ -37586,7 +37832,7 @@ async function readFileIfExists2(absPath) {
 }
 
 // packages/dbx-cli/validate/src/lib/dbx-color-template-list-app/extract.ts
-import { Node as Node35, Project as Project19, SyntaxKind as SyntaxKind16 } from "ts-morph";
+import { Node as Node35, Project as Project19, SyntaxKind as SyntaxKind17 } from "ts-morph";
 var PROVIDE_FN_NAME = "provideDbxStyleService";
 var COLOR_SERVICE_CONFIG_PROP = "dbxColorServiceConfig";
 var TEMPLATES_PROP = "templates";
@@ -37612,7 +37858,7 @@ function extractColorTemplates(inspection) {
 }
 function findProvideCall(sf) {
   let result;
-  for (const call of sf.getDescendantsOfKind(SyntaxKind16.CallExpression)) {
+  for (const call of sf.getDescendantsOfKind(SyntaxKind17.CallExpression)) {
     const callee = call.getExpression();
     if (Node35.isIdentifier(callee) && callee.getText() === PROVIDE_FN_NAME) {
       result = call;
@@ -37710,9 +37956,9 @@ function parseConfig(ctx, sf, obj) {
 function assignConfigField(input) {
   const { ctx, sf, result, name, value } = input;
   if (name === "tonal") {
-    if (value.getKind() === SyntaxKind16.TrueKeyword) {
+    if (value.getKind() === SyntaxKind17.TrueKeyword) {
       result.tonal = true;
-    } else if (value.getKind() === SyntaxKind16.FalseKeyword) {
+    } else if (value.getKind() === SyntaxKind17.FalseKeyword) {
       result.tonal = false;
     } else {
       ctx.warnings.push(buildWarning(sf, value, `Template config field \`tonal\` is not a boolean literal; ignored.`));
@@ -37831,7 +38077,7 @@ __export(dbx_color_smell_check_exports, {
 });
 
 // packages/dbx-cli/validate/src/lib/dbx-color-smell-check/extract.ts
-import { Node as Node36, Project as Project20, SyntaxKind as SyntaxKind17 } from "ts-morph";
+import { Node as Node36, Project as Project20, SyntaxKind as SyntaxKind18 } from "ts-morph";
 var COLOR_INPUT_NAMES = /* @__PURE__ */ new Set(["color", "dbxColor", "dbxTextColor"]);
 var COLOR_TYPE_NAMES = /* @__PURE__ */ new Set(["DbxColorConfig", "DbxColorInput", "Maybe<DbxColorInput>", "Maybe<DbxColorConfig>"]);
 var KNOWN_CONFIG_KEYS = /* @__PURE__ */ new Set(["template", "color", "contrast", "tone", "tonal"]);
@@ -37839,7 +38085,7 @@ function extractTsLiterals(filePath, text) {
   const project = new Project20({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
   const sf = project.createSourceFile(filePath, text, { overwrite: true });
   const out = [];
-  for (const obj of sf.getDescendantsOfKind(SyntaxKind17.ObjectLiteralExpression)) {
+  for (const obj of sf.getDescendantsOfKind(SyntaxKind18.ObjectLiteralExpression)) {
     if (!isInColorPosition(obj)) continue;
     const literal = parseObjectLiteral({ filePath, sf, obj });
     if (literal !== void 0) out.push(literal);
@@ -37905,8 +38151,8 @@ function parseObjectLiteral(input) {
 function assignRawField(input) {
   const { raw, name, value, onDynamic } = input;
   if (name === "tonal") {
-    if (value.getKind() === SyntaxKind17.TrueKeyword) raw.tonal = true;
-    else if (value.getKind() === SyntaxKind17.FalseKeyword) raw.tonal = false;
+    if (value.getKind() === SyntaxKind18.TrueKeyword) raw.tonal = true;
+    else if (value.getKind() === SyntaxKind18.FalseKeyword) raw.tonal = false;
     else onDynamic();
     return;
   }
@@ -41667,7 +41913,7 @@ function collectConflicts(extraction, rendered) {
     if (e.factoryName === rendered.factoryName) out.push(rendered.factoryName);
     if (e.singletonName === rendered.singletonName) out.push(rendered.singletonName);
   }
-  return [...new Set(out)];
+  return Array.from(new Set(out));
 }
 var MODEL_FIXTURE_SCAFFOLD_TOOL = { definition: TOOL7, run: run6 };
 
@@ -43973,7 +44219,7 @@ function buildRemoteBase(args) {
   return { fragment, imports: buildImportLines(importsSet), notes };
 }
 function buildImportLines(symbols) {
-  const sorted = [...symbols].sort((a, b) => a.localeCompare(b));
+  const sorted = Array.from(symbols).sort((a, b) => a.localeCompare(b));
   const result = [`import { ${sorted.join(", ")} } from '@dereekb/rxjs';`];
   return result;
 }
@@ -51217,7 +51463,7 @@ function groupBySource(entries) {
       bucket.push(entry);
     }
   }
-  return [...map.entries()].sort(([a], [b]) => a.localeCompare(b));
+  return Array.from(map.entries()).sort(([a], [b]) => a.localeCompare(b));
 }
 var EXPLAIN_RULE_TOOL = { definition: TOOL16, run: run17 };
 
@@ -52129,7 +52375,7 @@ async function scanModelFacts(input) {
       }
     }
   }
-  return { interfaces: [...interfaces.values()], identities: [...identities.values()] };
+  return { interfaces: Array.from(interfaces.values()), identities: Array.from(identities.values()) };
 }
 async function walkTypeScriptFiles(dir) {
   const out = [];
@@ -52152,7 +52398,7 @@ async function walkTypeScriptFiles(dir) {
   return out;
 }
 function readManifestModelTypes(source) {
-  return [...source.matchAll(/modelType:\s*'([^']+)'/g)].map((m) => m[1]);
+  return Array.from(source.matchAll(/modelType:\s*'([^']+)'/g)).map((m) => m[1]);
 }
 async function readOptionalFile(path) {
   return readFile31(path, "utf8").catch(() => void 0);
@@ -53947,7 +54193,7 @@ function expandIntentQuery(query) {
   if (trimmed.length === 0) {
     result = [];
   } else {
-    result = [...collectSynonyms(trimmed)];
+    result = Array.from(collectSynonyms(trimmed));
   }
   return result;
 }