@flex-development/docmark-util-combine-extensions 1.0.0-alpha.1

package/LICENSE.md

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, Flex Development, LLC All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors
+   may be used to endorse or promote products derived from this software without
+   specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,86 @@
+# docmark-util-combine-extensions
+
+[![npm](https://img.shields.io/npm/v/@flex-development/docmark-util-combine-extensions.svg)](https://npmjs.com/package/@flex-development/docmark-util-combine-extensions)
+[![npm downloads](https://img.shields.io/npm/dm/@flex-development/docmark-util-combine-extensions.svg)](https://www.npmcharts.com/compare/@flex-development/docmark-util-combine-extensions?interval=30)
+[![install size](https://packagephobia.now.sh/badge?p=@flex-development/docmark-util-combine-extensions)](https://packagephobia.now.sh/result?p=@flex-development/docmark-util-combine-extensions)
+[![module type: esm](https://img.shields.io/badge/module%20type-esm-brightgreen)](https://github.com/voxpelli/badges-cjs-esm)
+
+[docmark][] utility to combine extensions.
+
+## Contents
+
+- [What is this?](#what-is-this)
+- [When should I use this?](#when-should-i-use-this)
+- [Install](#install)
+- [Use](#use)
+- [API](#api)
+- [Types](#types)
+- [Contribute](#contribute)
+
+## What is this?
+
+This package can merge multiple syntax extensions into one.
+
+## When should I use this?
+
+This package is useful when building docmark extensions.
+
+## Install
+
+This package is [ESM only][esm].
+
+In Node.js with [yarn][]:
+
+```sh
+yarn add @flex-development/docmark-util-combine-extensions
+```
+
+<blockquote>
+  <small>
+    See <a href='https://yarnpkg.com/protocol/git'>Git - Protocols | Yarn</a>
+    &nbsp;for details regarding installing from Git.
+  </small>
+</blockquote>
+
+In Deno with [`esm.sh`][esmsh]:
+
+```ts
+import { combineExtensions } from 'https://esm.sh/@flex-development/docmark-util-combine-extensions'
+```
+
+In browsers with [`esm.sh`][esmsh]:
+
+```html
+<script type="module">
+  import { combineExtensions } from 'https://esm.sh/@flex-development/docmark-util-combine-extensions'
+</script>
+```
+
+## Use
+
+**TODO**: use
+
+## API
+
+**TODO**: api
+
+## Types
+
+This package is fully typed with [TypeScript][].
+
+## Contribute
+
+See [`CONTRIBUTING.md`](../../CONTRIBUTING.md).
+
+This project has a [code of conduct](../../CODE_OF_CONDUCT.md).
+By interacting with this repository, organization, or community you agree to abide by its terms.
+
+[docmark]: ../../README.md
+
+[esm]: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c
+
+[esmsh]: https://esm.sh
+
+[typescript]: https://www.typescriptlang.org
+
+[yarn]: https://yarnpkg.com

package/dist/index.d.mts

@@ -0,0 +1,39 @@
+import type { NormalizedExtension, AnyExtension } from '@flex-development/docmark-util-types';
+
+/**
+ * @file combineExtensions
+ * @module docmark-util-combine-extensions
+ */
+
+/**
+ * Combine multiple extensions into one.
+ *
+ * @see {@linkcode AnyExtension}
+ * @see {@linkcode NormalizedExtension}
+ *
+ * @template {NormalizedExtension} T
+ *  The combined extension
+ *
+ * @param {AnyExtension | AnyExtension[] | null | undefined} extensions
+ *  The extension or list of extensions
+ * @return {T}
+ *  The combined extension
+ */
+declare function combineExtensions<T extends NormalizedExtension>(extensions: AnyExtension | AnyExtension[] | null | undefined): T;
+/**
+ * Combine multiple extensions into one.
+ *
+ * @see {@linkcode AnyExtension}
+ * @see {@linkcode NormalizedExtension}
+ *
+ * @template {NormalizedExtension} T
+ *  The combined extension
+ *
+ * @param {(AnyExtension | AnyExtension[] | null | undefined)[]} extensions
+ *  The extensions to combine
+ * @return {T}
+ *  The combined extension
+ */
+declare function combineExtensions<T extends NormalizedExtension>(...extensions: (AnyExtension | AnyExtension[] | null | undefined)[]): T;
+
+export { combineExtensions, combineExtensions as default };

package/dist/index.mjs

@@ -0,0 +1,41 @@
+import { splice } from '@flex-development/mark-util-chunked';
+import { ok } from 'devlop';
+
+function combineExtensions(extensions, ...sources) {
+    const all = {};
+    const list = [extensions, ...sources].filter(s => !!s).flat();
+    let index = -1;
+    while (++index < list.length) {
+        const extension = list[index];
+        let hook;
+        for (hook in (ok(extension, 'expected `extension`'), extension)) {
+            const maybe = Object.hasOwnProperty.call(all, hook)
+                ? all[hook]
+                : undefined;
+            const left = maybe ?? (all[hook] = {});
+            const right = extension[hook];
+            if (right) {
+                let key;
+                for (key in right) {
+                    if (!Object.hasOwnProperty.call(left, key))
+                        left[key] = [];
+                    merge(toList(left[key]), toList(right[key] ?? []));
+                }
+            }
+        }
+    }
+    return all;
+}
+function merge(existing, list) {
+    const before = [];
+    let index = -1;
+    while (++index < list.length) {
+        (list[index].add === 'after' ? existing : before).push(list[index]);
+    }
+    return void splice(existing, 0, 0, before);
+}
+function toList(value) {
+    return (Array.isArray(value) ? value : [value]);
+}
+
+export { combineExtensions, combineExtensions as default };

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@flex-development/docmark-util-combine-extensions",
+  "description": "docmark utility to combine extensions",
+  "version": "1.0.0-alpha.1",
+  "keywords": [
+    "docmark",
+    "extension",
+    "tokenize",
+    "typescript",
+    "util",
+    "utility"
+  ],
+  "license": "BSD-3-Clause",
+  "homepage": "https://github.com/flex-development/docmark-util-types/tree/main/packages/flex-development/docmark-util-combine-extensions",
+  "repository": {
+    "directory": "packages/docmark-util-combine-extensions",
+    "type": "git",
+    "url": "git+https://github.com/flex-development/docmark.git"
+  },
+  "bugs": "https://github.com/flex-development/docmark/issues",
+  "author": {
+    "name": "Lexus Drumgold",
+    "url": "https://github.com/unicornware"
+  },
+  "publishConfig": {
+    "access": "public",
+    "diff-dst-prefix": "docmark-util-combine-extensions",
+    "diff-src-prefix": "docmark-util-combine-extensions",
+    "directory": "./",
+    "executableFiles": [],
+    "node-options": null,
+    "pack-destination": ".",
+    "parseable": true,
+    "prefer-dedupe": true,
+    "provenance": true,
+    "tag-version-prefix": "docmark-util-combine-extensions"
+  },
+  "type": "module",
+  "files": [
+    "LICENSE.md",
+    "README.md",
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "docmark": "./src/index.mts",
+      "default": "./dist/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "imports": {
+    "#fixtures/*": "./__fixtures__/*.mts"
+  },
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "dependencies": {
+    "@flex-development/docmark-util-types": "1.0.0-alpha.1",
+    "@flex-development/mark-util-chunked": "1.0.0",
+    "devlop": "1.1.0"
+  },
+  "sideEffects": false,
+  "build": "524f7d653272a777cde27efaac4656fb90cd4855"
+}