@dereekb/dbx-components-mcp 14.16.0 → 14.18.0

package/generated/dereekb-util.utils.mcp.generated.json

@@ -1528,6 +1528,55 @@
         "random-number-factory"
       ]
     },
+    {
+      "slug": "array-to-object",
+      "name": "arrayToObject",
+      "kind": "function",
+      "category": "array",
+      "module": "@dereekb/util",
+      "subpath": "array/array.map",
+      "signature": "arrayToObject(values: T[], keyFnOrConfig: ReadKeyFunction<T, K> | ArrayToObjectConfig<T, K, V>, valueFn?: (t: T) => V): Record<K, V>",
+      "description": "Maps the values of the input array to a Record object, keyed by the result of a key function.\nItems with undefined keys are omitted. Optionally transforms each value using a value function.\n\nAlso accepts an {@link ArrayToObjectConfig} as the second argument, which can throw when two values share a key instead of letting the last value win.",
+      "params": [
+        {
+          "name": "values",
+          "type": "T[]",
+          "description": "- source array of items to map",
+          "optional": false
+        },
+        {
+          "name": "keyFnOrConfig",
+          "type": "ReadKeyFunction<T, K> | ArrayToObjectConfig<T, K, V>",
+          "description": "",
+          "optional": false
+        },
+        {
+          "name": "valueFn",
+          "type": "(t: T) => V",
+          "description": "- optional function to transform each item into the desired record value",
+          "optional": true
+        }
+      ],
+      "returns": "a Record of keys to values derived from the input array",
+      "tags": [
+        "array",
+        "object",
+        "record",
+        "index",
+        "key",
+        "lookup",
+        "duplicate",
+        "unique",
+        "registry",
+        "to",
+        "arraytoobject"
+      ],
+      "example": "const byId = arrayToObject([{ id: 'a' }, { id: 'b' }], (x) => x.id);\n// { a: { id: 'a' }, b: { id: 'b' } }\n\nconst registry = arrayToObject(configs, {\n  readKey: (x) => x.type,\n  throwOnDuplicateKey: (type) => new Error(`duplicate type in registry: ${type}`)\n});",
+      "relatedSlugs": [
+        "is-unique-keyed-function",
+        "key-value-map-factory"
+      ]
+    },
     {
       "slug": "random-pick-factory",
       "name": "randomPickFactory",
@@ -10089,6 +10138,40 @@
         "handler-factory"
       ]
     },
+    {
+      "slug": "typed-config-registry",
+      "name": "typedConfigRegistry",
+      "kind": "factory",
+      "category": "service",
+      "module": "@dereekb/util",
+      "subpath": "service/typed.service",
+      "signature": "typedConfigRegistry(config: TypedConfigRegistrySetupConfig<C, T>): TypedConfigRegistry<C, T>",
+      "description": "Creates a {@link TypedConfigRegistry} over a record of configs.\n\nLookups read the passed record with an own-property check, so a type such as `constructor` never resolves to an `Object.prototype` member. The known types and configs are captured when the registry is created and returned as copies.",
+      "params": [
+        {
+          "name": "config",
+          "type": "TypedConfigRegistrySetupConfig<C, T>",
+          "description": "- The configs and the fallback for unregistered types.",
+          "optional": false
+        }
+      ],
+      "returns": "A registry whose members can be re-exposed under domain-specific names.",
+      "tags": [
+        "service",
+        "registry",
+        "config",
+        "type",
+        "lookup",
+        "fallback",
+        "default",
+        "typed",
+        "typedconfigregistry"
+      ],
+      "example": "const registry = typedConfigRegistry({\n  configs: { a: { type: 'a', label: 'A' } },\n  defaultConfigForType: (type) => ({ type, label: 'Unknown' })\n});\n\nregistry.configForType('a'); // { type: 'a', label: 'A' }\nregistry.configForType('b'); // { type: 'b', label: 'Unknown' }\nregistry.registeredConfigForType('b'); // undefined",
+      "relatedSlugs": [
+        "array-to-object"
+      ]
+    },
     {
       "slug": "is-in-set-decision-function",
       "name": "isInSetDecisionFunction",
@@ -10828,6 +10911,44 @@
         "string-from-date-factory"
       ]
     },
+    {
+      "slug": "js-doc-inline-links-to-text",
+      "name": "jsDocInlineLinksToText",
+      "kind": "function",
+      "category": "string",
+      "module": "@dereekb/util",
+      "subpath": "string/jsdoc",
+      "signature": "jsDocInlineLinksToText(input: string): string",
+      "description": "Replaces JSDoc/TSDoc inline link tags (`{@link X}`, `{@linkplain X}`, `{@linkcode X}`) with plain display text.\n\n- `{@link Foo}` → `Foo`\n- `{@link Foo.bar}` → `Foo.bar`\n- `{@link Foo | the foo}` and `{@link Foo the foo}` → `the foo`\n- `{@link Foo#bar}` → `Foo.bar`\n- `{@link ./path/mod#member}` → `member`\n- `{@linkcode Foo}` → `` `Foo` ``\n- `{@link https://example.com}` → `https://example.com`, and with a label, the label.\n\nText without tags, and malformed tags with no target, are returned unchanged.",
+      "params": [
+        {
+          "name": "input",
+          "type": "string",
+          "description": "- The text to convert, typically a JSDoc description.",
+          "optional": false
+        }
+      ],
+      "returns": "The text with every inline link tag replaced by its display text.",
+      "tags": [
+        "jsdoc",
+        "tsdoc",
+        "link",
+        "markdown",
+        "text",
+        "documentation",
+        "string",
+        "js",
+        "doc",
+        "inline",
+        "links",
+        "to",
+        "jsdocinlinelinkstotext"
+      ],
+      "example": "jsDocInlineLinksToText('Creates a {@link NotificationBox} for the {@link Profile.uid}.');\n// 'Creates a NotificationBox for the Profile.uid.'",
+      "relatedSlugs": [
+        "first-sentence"
+      ]
+    },
     {
       "slug": "replace-strings-function",
       "name": "replaceStringsFunction",
@@ -11343,6 +11464,46 @@
         "case-insensitive-filter-by-index-of-decision-factory"
       ]
     },
+    {
+      "slug": "first-sentence",
+      "name": "firstSentence",
+      "kind": "function",
+      "category": "string",
+      "module": "@dereekb/util",
+      "subpath": "string/sentence",
+      "signature": "firstSentence(input: string, config?: Maybe<FirstSentenceConfig>): string",
+      "description": "Returns the first sentence of the first paragraph of the input.\n\n- The first paragraph ends at the first blank line.\n- Soft line breaks and runs of whitespace are collapsed to single spaces.\n- A sentence ends at `.`, `!` or `?` (plus optional closing `\"`, `'`, `)` or `]`) followed by the end of the text, or by whitespace and a character that is not a lowercase letter.\n- A period after `e.g`, `i.e`, `cf` or `vs` never ends a sentence.\n- With no terminator, the whole flattened paragraph is returned.\n- When `maxLength` is set and exceeded, the text is cut at the last space that fits and `endText` is appended.",
+      "params": [
+        {
+          "name": "input",
+          "type": "string",
+          "description": "- The text to read, typically a JSDoc description.",
+          "optional": false
+        },
+        {
+          "name": "config",
+          "type": "Maybe<FirstSentenceConfig>",
+          "description": "- Optional length cap and end text.",
+          "optional": true
+        }
+      ],
+      "returns": "The first sentence, flattened to a single line.",
+      "tags": [
+        "sentence",
+        "summary",
+        "first-line",
+        "truncate",
+        "paragraph",
+        "description",
+        "string",
+        "first",
+        "firstsentence"
+      ],
+      "example": "firstSentence('Creates the\\nthing for the user. Then more.');\n// 'Creates the thing for the user.'",
+      "relatedSlugs": [
+        "js-doc-inline-links-to-text"
+      ]
+    },
     {
       "slug": "compare-strings",
       "name": "compareStrings",

package/package.json

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