@dereekb/dbx-components-mcp 13.42.0 → 13.43.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.42.0",
+  version: "13.43.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.42.0",
-    "@dereekb/util": "13.42.0"
+    "@dereekb/dbx-cli": "13.43.0",
+    "@dereekb/util": "13.43.0"
   }
 };
 
@@ -2003,6 +2003,221 @@ var FIREBASE_MODELS = [
     collectionKind: "root",
     archetypes: ["root-entity"]
   },
+  {
+    name: "FormSpace",
+    identityConst: "formSpaceIdentity",
+    modelType: "formSpace",
+    collectionPrefix: "fsp",
+    sourcePackage: "@dereekb/firebase",
+    sourceFile: "packages/firebase/src/lib/model/formspace/formspace.ts",
+    fields: [
+      {
+        name: "t",
+        longName: "formSpaceType",
+        converter: "firestoreString<FormSpaceType>()",
+        tsType: "FormSpaceType",
+        optional: false,
+        description: "The kind of form this space holds, resolving its upload restrictions, expiration policy, and the server-side handler its submission is dispatched to."
+      },
+      {
+        name: "n",
+        longName: "displayName",
+        converter: "optionalFirestoreString()",
+        tsType: "Maybe<string>",
+        optional: true,
+        description: "Display name of the space, for the owner's own list of in-progress forms."
+      },
+      {
+        name: "s",
+        longName: "state",
+        converter: "firestoreEnum<FormSpaceState>({ default: FormSpaceState.DRAFT })",
+        tsType: "FormSpaceState",
+        optional: false,
+        description: "Lifecycle state. Only DRAFT is editable.",
+        enumRef: "FormSpaceState"
+      },
+      {
+        name: "ps",
+        longName: "processingState",
+        converter: "firestoreEnum<FormSpaceProcessingState>({ default: FormSpaceProcessingState.INIT_OR_NONE })",
+        tsType: "FormSpaceProcessingState",
+        optional: false,
+        description: "Processing state of the submission.",
+        enumRef: "FormSpaceProcessingState"
+      },
+      {
+        name: "d",
+        longName: "data",
+        converter: "optionalFirestorePassthroughJsonField<FormSpaceData>({ dontStoreIfEmpty: true })",
+        tsType: "Maybe<T>",
+        optional: true,
+        description: "The form's own values, stored as pass-through JSON."
+      },
+      {
+        name: "u",
+        longName: "userId",
+        converter: "firestoreUID()",
+        tsType: "FirebaseAuthUserId",
+        optional: false,
+        description: "The user the space belongs to. Set at creation and never changed."
+      },
+      {
+        name: "o",
+        longName: "ownerKey",
+        converter: "optionalFirestoreString()",
+        tsType: "Maybe<FirebaseAuthOwnershipKey>",
+        optional: true,
+        description: "Ownership key, if applicable. Drives read access in the security rules."
+      },
+      {
+        name: "m",
+        longName: "targetModelKey",
+        converter: "optionalFirestoreString()",
+        tsType: "Maybe<FirestoreModelKey>",
+        optional: true,
+        description: "Key of the model this space was opened against, when it was opened against one."
+      },
+      {
+        name: "uc",
+        longName: "uploadCount",
+        converter: "firestoreNumber({ default: 0 })",
+        tsType: "number",
+        optional: false,
+        description: "Monotonic count of uploads this space has ACCEPTED over its whole lifetime."
+      },
+      {
+        name: "fi",
+        longName: "nextFileIndex",
+        converter: "firestoreNumber({ default: 0 })",
+        tsType: "number",
+        optional: false,
+        description: "The next index a file's permanent storage path is keyed by."
+      },
+      {
+        name: "f",
+        longName: "files",
+        converter: "firestoreObjectArray({ objectField: formSpaceFileSubObject })",
+        tsType: "FormSpaceFile[]",
+        optional: false,
+        description: "Every file the space currently holds, across every slot."
+      },
+      {
+        name: "pn",
+        longName: "processingNotificationKey",
+        converter: "optionalFirestoreString()",
+        tsType: "Maybe<NotificationKey>",
+        optional: true,
+        description: "The NotificationTask key processing this space's submission."
+      },
+      {
+        name: "pat",
+        longName: "processingAt",
+        converter: "optionalFirestoreDate()",
+        tsType: "Maybe<Date>",
+        optional: true,
+        description: "The date `ps` was last moved to PROCESSING. Used to detect a stuck task."
+      },
+      {
+        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: "sat",
+        longName: "submittedAt",
+        converter: "optionalFirestoreDate()",
+        tsType: "Maybe<Date>",
+        optional: true,
+        description: "The date the space was submitted, if it was. Its presence IS the lock."
+      },
+      {
+        name: "cpat",
+        longName: "completedAt",
+        converter: "optionalFirestoreDate()",
+        tsType: "Maybe<Date>",
+        optional: true,
+        description: "The date processing of the submission concluded, if it has."
+      },
+      {
+        name: "eat",
+        longName: "expiresAt",
+        converter: "optionalFirestoreDate()",
+        tsType: "Maybe<Date>",
+        optional: true,
+        description: "The date this space becomes eligible for the expiration sweep, if it expires at all."
+      }
+    ],
+    enums: [
+      {
+        name: "FormSpaceState",
+        values: [
+          {
+            name: "DRAFT",
+            value: 0
+          },
+          {
+            name: "SUBMITTED",
+            value: 1
+          },
+          {
+            name: "EXPIRED",
+            value: 2
+          },
+          {
+            name: "ARCHIVED",
+            value: 3
+          }
+        ],
+        description: "Lifecycle state of a {@link FormSpace}."
+      },
+      {
+        name: "FormSpaceProcessingState",
+        values: [
+          {
+            name: "INIT_OR_NONE",
+            value: 0
+          },
+          {
+            name: "QUEUED_FOR_PROCESSING",
+            value: 1
+          },
+          {
+            name: "PROCESSING",
+            value: 2
+          },
+          {
+            name: "FAILED",
+            value: 3
+          },
+          {
+            name: "SUCCESS",
+            value: 4
+          },
+          {
+            name: "DO_NOT_PROCESS",
+            value: 5
+          }
+        ],
+        description: "Processing state of a submitted {@link FormSpace}."
+      }
+    ],
+    detectionHints: ["t", "n", "ps", "m", "uc", "f", "pn", "pat", "uat", "sat", "cpat", "eat"],
+    description: "A type-registered container for a client-side form: its in-progress JSON, its uploads, and its submission state.",
+    modelGroup: "FormSpace",
+    collectionKind: "root",
+    archetypes: ["root-entity", "state-machine-item"]
+  },
   {
     name: "NotificationBox",
     identityConst: "notificationBoxIdentity",
@@ -3132,6 +3347,11 @@ var RESERVED_MODEL_FOLDERS = [
     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: "formspace",
+    reason: "FormSpace is a canonical group from `@dereekb/firebase` with a richer layout than the base 5 files (type, upload, task, util, etc.); a downstream project only registers its own types and does not redeclare the model.",
+    recommendedTool: "dbx_model_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.",

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

@@ -2016,6 +2016,10 @@
           "property": "overflow-y",
           "value": "hidden"
         },
+        {
+          "property": "padding-block",
+          "value": "var(--dbx-shadow-gutter, 4px)"
+        },
         {
           "property": "--mat-icon-button-touch-target-size",
           "value": "40px"
@@ -2053,7 +2057,11 @@
       "intent": "horizontal action bar — flex row that scrolls horizontally before wrapping",
       "seeAlso": [
         "dbx-flex-center",
-        "dbx-flex-fill"
+        "dbx-flex-fill",
+        "card-horizontal"
+      ],
+      "tokensRead": [
+        "--dbx-shadow-gutter"
       ],
       "tokensSet": [
         "--mat-button-filled-touch-target-size",
@@ -2072,7 +2080,7 @@
       "source": "@dereekb/dbx-web",
       "module": "@dereekb/dbx-web",
       "file": "src/lib/layout/flex/_flex.scss",
-      "line": 34,
+      "line": 44,
       "declarations": [
         {
           "property": "display",
@@ -2100,7 +2108,7 @@
       "source": "@dereekb/dbx-web",
       "module": "@dereekb/dbx-web",
       "file": "src/lib/layout/flex/_flex.scss",
-      "line": 44,
+      "line": 54,
       "declarations": [
         {
           "property": "display",
@@ -2123,7 +2131,7 @@
       "source": "@dereekb/dbx-web",
       "module": "@dereekb/dbx-web",
       "file": "src/lib/layout/flex/_flex.scss",
-      "line": 54,
+      "line": 64,
       "declarations": [
         {
           "property": "flex",
@@ -2143,7 +2151,7 @@
       "source": "@dereekb/dbx-web",
       "module": "@dereekb/dbx-web",
       "file": "src/lib/layout/flex/_flex.scss",
-      "line": 65,
+      "line": 75,
       "declarations": [
         {
           "property": "flex",
@@ -2167,7 +2175,7 @@
       "source": "@dereekb/dbx-web",
       "module": "@dereekb/dbx-web",
       "file": "src/lib/layout/flex/_flex.scss",
-      "line": 74,
+      "line": 84,
       "declarations": [
         {
           "property": "display",
@@ -3151,7 +3159,7 @@
       "source": "@dereekb/dbx-web",
       "module": "@dereekb/dbx-web",
       "file": "src/lib/layout/section/_section.scss",
-      "line": 76,
+      "line": 83,
       "declarations": [
         {
           "property": "padding",

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

@@ -1205,6 +1205,20 @@
         "--mat-sys-error"
       ]
     },
+    {
+      "cssVariable": "--dbx-file-list-item-details-gap",
+      "source": "dbx-web",
+      "role": "spacing",
+      "intents": [
+        "file list item details gap",
+        "file list item details gap spacing"
+      ],
+      "description": "Component-scoped override point (`download`) read in `packages/dbx-web/src/lib/extension/download/_download.scss` — set it (from an app, or via the owning dbx directive where one exists) to override; unset, it falls back to `0.25em`.",
+      "defaults": {
+        "light": "0.25em"
+      },
+      "componentScope": "download"
+    },
     {
       "cssVariable": "--dbx-file-upload-square-container-shape",
       "source": "dbx-web",
@@ -2225,6 +2239,21 @@
       },
       "componentScope": "section"
     },
+    {
+      "cssVariable": "--dbx-shadow-gutter",
+      "scssVariable": "$shadow-gutter-var",
+      "source": "dbx-web",
+      "role": "spacing",
+      "intents": [
+        "shadow gutter",
+        "elevation room",
+        "keep box-shadow from being clipped"
+      ],
+      "description": "Shadow gutter — the room a clipping/scrolling container must reserve INSIDE its padding box so an elevated child's `box-shadow` isn't clipped at the edge. Sized against Material's raised-button elevation: the resting shadow reaches 2.5px below the border box and the hover shadow reaches 5px, so 4px clears the resting state outright and all but the faintest 12% hover layer. Raise it to 5px to clear hover completely, or set it to 0px to opt out.",
+      "defaults": {
+        "light": "4px"
+      }
+    },
     {
       "cssVariable": "--dbx-sidenav-active-accent",
       "source": "dbx-web",

package/generated/dereekb-firebase.semantic-types.mcp.generated.json

@@ -270,6 +270,34 @@
       ],
       "notes": "Arbitrary string describing the kind of calendar a document is, driving its retention policy and its ICS\nemission config through the app's {@link CalendarTypeConfig} registry.\n\nOpen by design, exactly like {@link StorageFilePurpose}: a downstream app registers its own types without\na library change."
     },
+    {
+      "name": "FormSpaceType",
+      "package": "@dereekb/firebase",
+      "module": "src/lib/model/formspace/formspace.id",
+      "kind": "semantic-type",
+      "definition": "string",
+      "baseType": "string",
+      "topics": [
+        "identifier",
+        "string",
+        "dereekb-firebase:form-space"
+      ],
+      "notes": "Arbitrary string describing the kind of form a FormSpace holds, driving its upload restrictions, its\nexpiration policy, and the server-side handler its submission is dispatched to through the app's\n{@link FormSpaceTypeConfig} registry.\n\nOpen by design, exactly like {@link StorageFilePurpose} and {@link CalendarType}: a downstream app\nregisters its own types without a library change."
+    },
+    {
+      "name": "FormSpaceFileSlot",
+      "package": "@dereekb/firebase",
+      "module": "src/lib/model/formspace/formspace.id",
+      "kind": "semantic-type",
+      "definition": "string",
+      "baseType": "string",
+      "topics": [
+        "identifier",
+        "string",
+        "dereekb-firebase:form-space"
+      ],
+      "notes": "Names one upload \"slot\" within a FormSpace — the resume, the cover letter, the photo of the ID.\n\nA slot is stored on the uploaded {@link StorageFile} as its `pg` (purposeSubgroup), which is what makes\n\"replace the file in this slot\" the existing `flagPreviousForDelete` behaviour rather than new machinery."
+    },
     {
       "name": "NotificationTemplateType",
       "package": "@dereekb/firebase",

package/package.json

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