@dereekb/dbx-components-mcp 14.1.0 → 14.2.0

package/dbx-components-mcp.js

@@ -10,7 +10,8 @@ var __export = (target, all) => {
 // packages/dbx-components-mcp/package.json
 var package_default = {
   name: "@dereekb/dbx-components-mcp",
-  version: "14.1.0",
+  version: "14.2.0",
+  sideEffects: false,
   type: "module",
   bin: {
     "dbx-components-mcp": "dbx-components-mcp.js"
@@ -21,8 +22,8 @@ var package_default = {
     "ts-morph": "^21.0.0"
   },
   peerDependencies: {
-    "@dereekb/dbx-cli": "14.1.0",
-    "@dereekb/util": "14.1.0"
+    "@dereekb/dbx-cli": "14.2.0",
+    "@dereekb/util": "14.2.0"
   }
 };
 
@@ -1934,7 +1935,7 @@ var FIREBASE_MODELS = [
       {
         name: "x",
         longName: "extensionData",
-        converter: "optionalFirestorePassthroughJsonField<CalendarExtensionData>({ filterEmptyValues: true, dontStoreIfEmpty: true })",
+        converter: "optionalFirestoreJsonStringField<CalendarExtensionData>({ filterEmptyValues: true, dontStoreIfEmpty: true })",
         tsType: "Maybe<CalendarExtensionData>",
         optional: true,
         description: `Extension data emitted as "X-" properties on the calendar's VCALENDAR.`
@@ -2048,7 +2049,7 @@ var FIREBASE_MODELS = [
       {
         name: "d",
         longName: "data",
-        converter: "optionalFirestorePassthroughJsonField<FormSpaceData>({ dontStoreIfEmpty: true })",
+        converter: "optionalFirestoreJsonStringField<FormSpaceData>({ dontStoreIfEmpty: true })",
         tsType: "Maybe<T>",
         optional: true,
         description: "The form's own values, stored as pass-through JSON."
@@ -29298,6 +29299,9 @@ 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 IDENTITY_TYPE = "FirestoreModelIdentity";
+var ROOT_IDENTITY_TYPE = "RootFirestoreModelIdentity";
+var IDENTITY_WITH_PARENT_TYPE = "FirestoreModelIdentityWithParent";
 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];
@@ -29329,16 +29333,73 @@ function readIdentities(sourceFile) {
     if (!statement.isExported()) continue;
     for (const decl of statement.getDeclarations()) {
       const initializer = decl.getInitializer();
-      if (!initializer || !Node24.isCallExpression(initializer)) continue;
-      if (initializer.getExpression().getText() !== IDENTITY_FN) continue;
-      const parsed = parseFirestoreModelIdentityArgs(initializer.getArguments());
-      if (parsed) {
-        out.push({ identityConst: decl.getName(), ...parsed });
+      if (initializer && Node24.isCallExpression(initializer)) {
+        if (initializer.getExpression().getText() !== IDENTITY_FN) continue;
+        const parsed = parseFirestoreModelIdentityArgs(initializer.getArguments());
+        if (parsed) {
+          out.push({ identityConst: decl.getName(), ...parsed, parentModelType: void 0 });
+        }
+      } else {
+        const parsed = parseDeclaredIdentityType(decl.getTypeNode());
+        if (parsed) {
+          out.push({ identityConst: decl.getName(), ...parsed });
+        }
       }
     }
   }
   return out;
 }
+function parseDeclaredIdentityType(typeNode) {
+  let result;
+  const named = readNamedTypeNode(typeNode);
+  if (named) {
+    const { typeName, args } = named;
+    if (typeName === IDENTITY_WITH_PARENT_TYPE && args.length >= 3) {
+      const parent = parseDeclaredIdentityType(args[0]);
+      result = {
+        modelType: readLiteralTypeText(args[1]) ?? "",
+        collectionPrefix: readLiteralTypeText(args[2]),
+        parentIdentityConst: void 0,
+        parentModelType: parent?.modelType
+      };
+    } else if ((typeName === ROOT_IDENTITY_TYPE || typeName === IDENTITY_TYPE) && args.length >= 2) {
+      result = {
+        modelType: readLiteralTypeText(args[0]) ?? "",
+        collectionPrefix: readLiteralTypeText(args[1]),
+        parentIdentityConst: void 0,
+        parentModelType: void 0
+      };
+    }
+    if (result && !result.modelType) {
+      result = void 0;
+    }
+  }
+  return result;
+}
+function readNamedTypeNode(typeNode) {
+  let result;
+  if (typeNode) {
+    if (Node24.isImportTypeNode(typeNode)) {
+      const qualifier = typeNode.getQualifier();
+      if (qualifier) {
+        result = { typeName: qualifier.getText().split(".").pop() ?? "", args: typeNode.getTypeArguments() };
+      }
+    } else if (Node24.isTypeReference(typeNode)) {
+      result = { typeName: typeNode.getTypeName().getText().split(".").pop() ?? "", args: typeNode.getTypeArguments() };
+    }
+  }
+  return result;
+}
+function readLiteralTypeText(node) {
+  let result;
+  if (node && Node24.isLiteralTypeNode(node)) {
+    const literal = node.getLiteral();
+    if (Node24.isStringLiteral(literal)) {
+      result = literal.getLiteralText();
+    }
+  }
+  return result;
+}
 function readInterfaces(sourceFile) {
   const out = [];
   for (const decl of sourceFile.getInterfaces()) {

package/generated/dereekb-dbx-web.css-utilities.mcp.generated.json

@@ -1795,7 +1795,7 @@
       "source": "@dereekb/dbx-web",
       "module": "@dereekb/dbx-web",
       "file": "src/lib/interaction/dialog/_dialog.scss",
-      "line": 20,
+      "line": 45,
       "declarations": [
         {
           "property": "display",

package/generated/dereekb-dbx-web.tokens.mcp.generated.json

@@ -1124,6 +1124,19 @@
       },
       "componentScope": "dialog"
     },
+    {
+      "cssVariable": "--dbx-dialog-max-width",
+      "source": "dbx-web",
+      "role": "size",
+      "intents": [
+        "dialog max width"
+      ],
+      "description": "Component-scoped override point (`dialog`) read in `packages/dbx-web/src/lib/interaction/dialog/_dialog.scss` — set it (from an app, or via the owning dbx directive where one exists) to override; unset, it falls back to `80vw`.",
+      "defaults": {
+        "light": "80vw"
+      },
+      "componentScope": "dialog"
+    },
     {
       "cssVariable": "--dbx-disabled-color",
       "scssVariable": "$dbx-disabled-color-var",

package/generated/dereekb-firebase.model-snapshot-fields.mcp.generated.json

@@ -132,6 +132,47 @@
         "firestore-sub-object"
       ]
     },
+    {
+      "slug": "optional-firestore-json-string-field",
+      "name": "optionalFirestoreJsonStringField",
+      "kind": "factory",
+      "category": "object",
+      "module": "@dereekb/firebase",
+      "subpath": "common/firestore/snapshot/snapshot.field",
+      "signature": "optionalFirestoreJsonStringField(config?: OptionalFirestoreJsonStringFieldConfig): FirestoreModelFieldMapFunctionsConfig<Maybe<T>, Maybe<string>>",
+      "description": "Creates a field mapping configuration for an optional object field that is stored as a JSON STRING.\n\nThe counterpart to {@link optionalFirestorePassthroughJsonField}, and the one to reach for when the\njson is arbitrary rather than merely unmodelled: a json schema, a tool definition, whatever an llm\nreturned. The passthrough field stores a native Firestore map, and a map cannot represent every legal\njson value — Firestore forbids an array directly inside an array, which an array-valued `enum`,\n`const`, `default`, or `examples` produces immediately. That write does not degrade, it FAILS, and it\nfails from inside whatever was doing the writing with an opaque \"invalid nested entity\" error.\n\nSerializing sidesteps the entire Firestore type system: the stored value is one string, so anything\n`JSON.stringify` accepts round-trips exactly, including the shapes a map rejects. The cost is that the\nfield is no longer queryable and no longer readable in the Firestore console — pick this one when the\njson is never a query target, and the passthrough field when it is.\n\nTwo behaviours worth knowing:\n\n- A value only `JSON.stringify` knows how to narrow is narrowed. A `Date` becomes an ISO string and\n  stays a string on read, where the passthrough field would have kept it a `Timestamp`. Anything\n  carrying non-json values wants the passthrough field, not this one.\n- Reads tolerate a legacy native map, so a field migrated from\n  {@link optionalFirestorePassthroughJsonField} keeps reading documents written before the switch. New\n  writes are always strings, so a document converts itself the next time it is written.",
+      "optional": true,
+      "params": [
+        {
+          "name": "config",
+          "type": "OptionalFirestoreJsonStringFieldConfig",
+          "description": "- Filtering and storage configuration. Defaults to stripping `undefined` values at every depth.",
+          "optional": true
+        }
+      ],
+      "returns": "A field mapping configuration for optional json values stored as a string.",
+      "tags": [
+        "json",
+        "string",
+        "serialized",
+        "stringify",
+        "object",
+        "raw",
+        "optional",
+        "arbitrary",
+        "schema",
+        "factory",
+        "firestore",
+        "field",
+        "optionalfirestorejsonstringfield"
+      ],
+      "example": "fields: {\n  // { model: 'm', text: { format: { schema: { enum: [['a']] } } } }\n  // stores as the string '{\"model\":\"m\",\"text\":{\"format\":{\"schema\":{\"enum\":[[\"a\"]]}}}}'\n  config: optionalFirestoreJsonStringField<MyVendorConfig>(),\n  // store null rather than the string '{}' when nothing survives the filtering\n  usage: optionalFirestoreJsonStringField<MyVendorUsage>({ filterEmptyValues: true, dontStoreIfEmpty: true })\n}",
+      "relatedSlugs": [
+        "optional-firestore-passthrough-json-field",
+        "optional-firestore-field",
+        "firestore-sub-object"
+      ]
+    },
     {
       "slug": "firestore-string",
       "name": "firestoreString",

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@dereekb/dbx-components-mcp",
-  "version": "14.1.0",
+  "version": "14.2.0",
+  "sideEffects": false,
   "type": "module",
   "bin": {
     "dbx-components-mcp": "dbx-components-mcp.js"
@@ -11,7 +12,7 @@
     "ts-morph": "^21.0.0"
   },
   "peerDependencies": {
-    "@dereekb/dbx-cli": "14.1.0",
-    "@dereekb/util": "14.1.0"
+    "@dereekb/dbx-cli": "14.2.0",
+    "@dereekb/util": "14.2.0"
   }
 }