@dereekb/dbx-components-mcp 13.41.0 → 13.43.0

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

@@ -72,6 +72,136 @@
       ],
       "notes": "The week in the year. Starts from 1."
     },
+    {
+      "name": "ICalendarComponentName",
+      "package": "@dereekb/date",
+      "module": "src/lib/icalendar/icalendar",
+      "kind": "semantic-type",
+      "definition": "SuggestedString<'VCALENDAR' | 'VEVENT' | 'VALARM' | 'VTIMEZONE' | 'STANDARD' | 'DAYLIGHT'>",
+      "baseType": "other",
+      "topics": [
+        "string",
+        "dereekb-date:icalendar"
+      ],
+      "notes": "The name of an iCalendar component. I.E. VCALENDAR, VEVENT, VALARM, VTIMEZONE, STANDARD, DAYLIGHT.\n\nhttps://datatracker.ietf.org/doc/html/rfc5545#section-3.6"
+    },
+    {
+      "name": "ICalendarPropertyName",
+      "package": "@dereekb/date",
+      "module": "src/lib/icalendar/icalendar",
+      "kind": "semantic-type",
+      "definition": "string",
+      "baseType": "string",
+      "topics": [
+        "string",
+        "dereekb-date:icalendar"
+      ],
+      "notes": "The name of an iCalendar property. I.E. DTSTART, SUMMARY, X-WR-CALNAME.\n\nhttps://datatracker.ietf.org/doc/html/rfc5545#section-3.7"
+    },
+    {
+      "name": "ICalendarParameterName",
+      "package": "@dereekb/date",
+      "module": "src/lib/icalendar/icalendar",
+      "kind": "semantic-type",
+      "definition": "SuggestedString<'TZID' | 'VALUE' | 'CN' | 'ROLE' | 'PARTSTAT' | 'RSVP' | 'RELATED'>",
+      "baseType": "other",
+      "topics": [
+        "string",
+        "dereekb-date:icalendar"
+      ],
+      "notes": "The name of an iCalendar property parameter. I.E. TZID, VALUE, CN.\n\nhttps://datatracker.ietf.org/doc/html/rfc5545#section-3.2"
+    },
+    {
+      "name": "ICalendarParameterValue",
+      "package": "@dereekb/date",
+      "module": "src/lib/icalendar/icalendar",
+      "kind": "semantic-type",
+      "definition": "string",
+      "baseType": "string",
+      "topics": [
+        "string",
+        "dereekb-date:icalendar"
+      ],
+      "notes": "An already-encoded iCalendar property parameter value."
+    },
+    {
+      "name": "ICalendarValue",
+      "package": "@dereekb/date",
+      "module": "src/lib/icalendar/icalendar",
+      "kind": "semantic-type",
+      "definition": "string",
+      "baseType": "string",
+      "topics": [
+        "string",
+        "dereekb-date:icalendar"
+      ],
+      "notes": "An already-encoded iCalendar property value. Escaping (where the value type calls for it) has already been applied."
+    },
+    {
+      "name": "ICalendarTextValue",
+      "package": "@dereekb/date",
+      "module": "src/lib/icalendar/icalendar",
+      "kind": "semantic-type",
+      "definition": "string",
+      "baseType": "string",
+      "topics": [
+        "string",
+        "dereekb-date:icalendar"
+      ],
+      "notes": "An escaped iCalendar TEXT value.\n\nhttps://datatracker.ietf.org/doc/html/rfc5545#section-3.3.11"
+    },
+    {
+      "name": "ICalendarIcsString",
+      "package": "@dereekb/date",
+      "module": "src/lib/icalendar/icalendar",
+      "kind": "semantic-type",
+      "definition": "string",
+      "baseType": "string",
+      "topics": [
+        "string",
+        "dereekb-date:icalendar"
+      ],
+      "notes": "A complete iCalendar (RFC 5545) document, folded and CRLF-terminated."
+    },
+    {
+      "name": "ICalendarUid",
+      "package": "@dereekb/date",
+      "module": "src/lib/icalendar/icalendar",
+      "kind": "semantic-type",
+      "definition": "string",
+      "baseType": "string",
+      "topics": [
+        "string",
+        "dereekb-date:icalendar"
+      ],
+      "notes": "A globally-unique, stable identifier for an event.\n\nhttps://datatracker.ietf.org/doc/html/rfc5545#section-3.8.4.7\n\nStability across publishes is what lets a subscribing client correlate an update or a deletion with the\nevent it already has. A UID that changes between publishes produces a duplicate event instead of an update."
+    },
+    {
+      "name": "ICalendarProductId",
+      "package": "@dereekb/date",
+      "module": "src/lib/icalendar/icalendar",
+      "kind": "semantic-type",
+      "definition": "string",
+      "baseType": "string",
+      "topics": [
+        "string",
+        "dereekb-date:icalendar"
+      ],
+      "notes": "The PRODID of the product that generated the calendar.\n\nhttps://datatracker.ietf.org/doc/html/rfc5545#section-3.7.3"
+    },
+    {
+      "name": "ICalendarCalAddress",
+      "package": "@dereekb/date",
+      "module": "src/lib/icalendar/icalendar",
+      "kind": "semantic-type",
+      "definition": "string",
+      "baseType": "string",
+      "topics": [
+        "string",
+        "dereekb-date:icalendar"
+      ],
+      "notes": "A CAL-ADDRESS URI value. I.E. \"mailto:person@example.com\".\n\nhttps://datatracker.ietf.org/doc/html/rfc5545#section-3.3.3"
+    },
     {
       "name": "RRuleLineString",
       "package": "@dereekb/date",

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

@@ -131,6 +131,20 @@
       ],
       "notes": "Storage bucket identifier for Firebase Cloud Storage.\n\nShould contain no slashes — just the bucket name (e.g., `\"my-app.appspot.com\"`)."
     },
+    {
+      "name": "StoragePublicUrlApiEndpoint",
+      "package": "@dereekb/firebase",
+      "module": "src/lib/common/storage/storage.url",
+      "kind": "semantic-type",
+      "definition": "string",
+      "baseType": "string",
+      "topics": [
+        "url",
+        "string",
+        "dereekb-firebase:storage"
+      ],
+      "notes": "Origin (protocol and host, with no trailing slash) that serves GCS-native public object urls."
+    },
     {
       "name": "StorageDownloadUrl",
       "package": "@dereekb/firebase",
@@ -214,6 +228,76 @@
       ],
       "notes": "Example:\n'data:text/plain;base64,5b6p5Y+344GX44G+44GX44Gf77yB44GK44KB44Gn44Go44GG77yB'"
     },
+    {
+      "name": "CalendarEventId",
+      "package": "@dereekb/firebase",
+      "module": "src/lib/model/calendar/calendar.id",
+      "kind": "semantic-type",
+      "definition": "string",
+      "baseType": "string",
+      "topics": [
+        "identifier",
+        "string",
+        "dereekb-firebase:calendar"
+      ],
+      "notes": "Identifier for a single event embedded in a Calendar. Unique within its own calendar only."
+    },
+    {
+      "name": "CalendarOccurrenceKey",
+      "package": "@dereekb/firebase",
+      "module": "src/lib/model/calendar/calendar.id",
+      "kind": "semantic-type",
+      "definition": "string",
+      "baseType": "string",
+      "topics": [
+        "identifier",
+        "string",
+        "dereekb-firebase:calendar"
+      ],
+      "notes": "Identifier for a single expanded OCCURRENCE of a calendar event.\n\nA one-off event's occurrence key is its {@link CalendarEventId}. A recurring event's occurrence key is\nits id plus the occurrence's unix seconds, which is what keeps a published VEVENT's UID stable across\nrepublishes of the same series."
+    },
+    {
+      "name": "CalendarType",
+      "package": "@dereekb/firebase",
+      "module": "src/lib/model/calendar/calendar.id",
+      "kind": "semantic-type",
+      "definition": "string",
+      "baseType": "string",
+      "topics": [
+        "identifier",
+        "string",
+        "dereekb-firebase:calendar"
+      ],
+      "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/generated/dereekb-firebase.utils.mcp.generated.json

@@ -263,6 +263,136 @@
         "firebase-auth-oob-code-data-pair-delimiter"
       ]
     },
+    {
+      "slug": "is-nth-hour-of-day",
+      "name": "isNthHourOfDay",
+      "kind": "function",
+      "category": "date",
+      "module": "@dereekb/firebase",
+      "subpath": "model/system/system.scheduler",
+      "signature": "isNthHourOfDay(everyNHours: Hours, date?: Maybe<Date>): boolean",
+      "description": "Whether the date's hour-of-day is an Nth hour, in the ambient timezone.\n\nThis is a modulo against the hour-of-day, NOT an interval since some epoch — so at hour 12 it is\ntrue for N = 1, 2, 3, 4, 6, and 12, and false for N = 5. Only divisors of 24 divide the day\nevenly; a non-divisor (5, 7, 9, …) will still fire, just with a short window across midnight.\n\nAn `everyNHours` of zero or less has no meaningful Nth hour and returns false rather than\ndividing by zero.",
+      "params": [
+        {
+          "name": "everyNHours",
+          "type": "Hours",
+          "description": "- Run every Nth hour of the day.",
+          "optional": false
+        },
+        {
+          "name": "date",
+          "type": "Maybe<Date>",
+          "description": "- Moment to test; defaults to now.",
+          "optional": true
+        }
+      ],
+      "returns": "True when the date's hour-of-day is an Nth hour.",
+      "tags": [
+        "schedule",
+        "hour",
+        "throttle",
+        "cron",
+        "gate",
+        "modulo",
+        "date",
+        "is",
+        "nth",
+        "of",
+        "day",
+        "isnthhourofday"
+      ],
+      "example": "isNthHourOfDay(3, new Date('2024-01-01T12:30:00')); // true (12 % 3 === 0)\nisNthHourOfDay(5, new Date('2024-01-01T12:30:00')); // false (12 % 5 === 2)",
+      "relatedSlugs": [
+        "has-run-in-current-hour"
+      ]
+    },
+    {
+      "slug": "has-run-in-current-hour",
+      "name": "hasRunInCurrentHour",
+      "kind": "function",
+      "category": "date",
+      "module": "@dereekb/firebase",
+      "subpath": "model/system/system.scheduler",
+      "signature": "hasRunInCurrentHour(lastRunAt: Maybe<Date>, now?: Maybe<Date>): boolean",
+      "description": "Whether the last run falls inside the same hour as now.\n\nThis is a same-hour-bucket compare, not an elapsed-time compare: a run at 12:59 and a `now` of\n13:01 are two minutes apart but in different hours, so this returns false. That is what makes the\ngate track the hourly cron rather than drift with it.\n\nA null `lastRunAt` means nothing has run, so it returns false.",
+      "params": [
+        {
+          "name": "lastRunAt",
+          "type": "Maybe<Date>",
+          "description": "- Moment the work last ran.",
+          "optional": false
+        },
+        {
+          "name": "now",
+          "type": "Maybe<Date>",
+          "description": "- Moment to compare against; defaults to now.",
+          "optional": true
+        }
+      ],
+      "returns": "True when both moments fall in the same hour.",
+      "tags": [
+        "schedule",
+        "hour",
+        "throttle",
+        "cron",
+        "gate",
+        "window",
+        "date",
+        "has",
+        "run",
+        "in",
+        "current",
+        "hasrunincurrenthour"
+      ],
+      "example": "hasRunInCurrentHour(new Date('2024-01-01T12:05:00'), new Date('2024-01-01T12:55:00')); // true\nhasRunInCurrentHour(new Date('2024-01-01T12:59:00'), new Date('2024-01-01T13:01:00')); // false",
+      "relatedSlugs": [
+        "is-nth-hour-of-day",
+        "round-down-to-hour"
+      ]
+    },
+    {
+      "slug": "nth-hour-of-day-index",
+      "name": "nthHourOfDayIndex",
+      "kind": "function",
+      "category": "date",
+      "module": "@dereekb/firebase",
+      "subpath": "model/system/system.scheduler",
+      "signature": "nthHourOfDayIndex(everyNHours: Hours, date?: Maybe<Date>): Maybe<number>",
+      "description": "The zero-based index of the date's hour within the day's every-N-hours schedule, or null when the\nhour is not an Nth hour.\n\nAt hour 12 with N=3 the day's matching hours are 0, 3, 6, 9, 12 — so the index is 4. Use it to\nrotate work across a day's windows (\"do the expensive pass only on index 0\") without each caller\nre-deriving the arithmetic from the hour-of-day.\n\nReturns null rather than a number for a non-matching hour, so a falsy check cannot confuse\n\"index 0\" — the first window of the day — with \"no window\".",
+      "params": [
+        {
+          "name": "everyNHours",
+          "type": "Hours",
+          "description": "- Run every Nth hour of the day.",
+          "optional": false
+        },
+        {
+          "name": "date",
+          "type": "Maybe<Date>",
+          "description": "- Moment to test; defaults to now.",
+          "optional": true
+        }
+      ],
+      "returns": "The zero-based window index, or null when the hour is not an Nth hour.",
+      "tags": [
+        "schedule",
+        "hour",
+        "throttle",
+        "cron",
+        "gate",
+        "index",
+        "window",
+        "date",
+        "nth",
+        "of",
+        "day",
+        "nthhourofdayindex"
+      ],
+      "example": "nthHourOfDayIndex(3, new Date('2024-01-01T12:30:00')); // 4 (0, 3, 6, 9, 12)\nnthHourOfDayIndex(3, new Date('2024-01-01T13:30:00')); // null (13 % 3 !== 0)",
+      "relatedSlugs": [
+        "is-nth-hour-of-day"
+      ]
+    },
     {
       "slug": "new-documents",
       "name": "newDocuments",

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

@@ -489,6 +489,19 @@
       ],
       "notes": "The minute of the day.\n\nNumber from 0-1439."
     },
+    {
+      "name": "UtcOffsetString",
+      "package": "@dereekb/util",
+      "module": "src/lib/date/offset",
+      "kind": "semantic-type",
+      "definition": "string",
+      "baseType": "string",
+      "topics": [
+        "timezone",
+        "string"
+      ],
+      "notes": "A UTC offset rendered in the ISO 8601 basic format, as a sign followed by two-digit hours and minutes.\n\nExamples:\n- -0600\n- +0530\n- +0000"
+    },
     {
       "name": "EncryptedString",
       "package": "@dereekb/util",
@@ -1340,6 +1353,19 @@
       ],
       "notes": "A website's domain and path combined, without the BaseWebsiteUrl\n\nExamples:\n- dereekb.com\n- components.dereekb.com/\n- components.dereekb.com/doc/home"
     },
+    {
+      "name": "UriScheme",
+      "package": "@dereekb/util",
+      "module": "src/lib/string/url",
+      "kind": "semantic-type",
+      "definition": "string",
+      "baseType": "string",
+      "topics": [
+        "url",
+        "string"
+      ],
+      "notes": "A URI scheme, without the trailing colon.\n\nExamples:\n- https\n- mailto\n- tel"
+    },
     {
       "name": "CityString",
       "package": "@dereekb/util",