@flex-development/docmark-factory-identifier 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,104 @@
+# docmark-factory-identifier
+
+[![github release](https://img.shields.io/github/v/release/flex-development/docmark.svg?include_prereleases\&sort=date\&filter=docmark-factory-identifier%40*)](https://github.com/flex-development/docmark/releases/latest)
+[![npm](https://img.shields.io/npm/v/@flex-development/docmark-factory-identifier.svg)](https://npmjs.com/package/@flex-development/docmark-factory-identifier)
+[![npm downloads](https://img.shields.io/npm/dm/@flex-development/docmark-factory-identifier.svg)](https://www.npmcharts.com/compare/@flex-development/docmark-factory-identifier?interval=30)
+[![minified bundle size](https://badgen.net/bundlephobia/min/@flex-development/docmark-factory-identifier?cache)](https://bundlephobia.com/package/@flex-development/docmark-factory-identifier)
+[![install size](https://packagephobia.now.sh/badge?p=@flex-development/docmark-factory-identifier)](https://packagephobia.now.sh/result?p=@flex-development/docmark-factory-identifier)
+[![tree shaking suppport](https://badgen.net/bundlephobia/tree-shaking/@flex-development/docmark-factory-identifier)](https://bundlephobia.com/package/@flex-development/docmark-factory-identifier)
+[![module type: esm](https://img.shields.io/badge/module%20type-esm-brightgreen)](https://github.com/voxpelli/badges-cjs-esm)
+[![license](https://img.shields.io/github/license/flex-development/docmark)](LICENSE.md)
+
+[docmark][] factory to parse identifiers.
+
+## 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 exposes states to parse identifiers.
+
+## When should I use this?
+
+This package may be useful when making your own docmark extensions.
+
+## Install
+
+This package is [ESM only][esm].
+
+In Node.js with [yarn][]:
+
+```sh
+yarn add @flex-development/docmark-factory-identifier
+```
+
+<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 { factoryIdentifier } from 'https://esm.sh/@flex-development/docmark-factory-identifier'
+```
+
+In browsers with [`esm.sh`][esmsh]:
+
+```html
+<script type="module">
+  import { factoryIdentifier } from 'https://esm.sh/@flex-development/docmark-factory-identifier'
+</script>
+```
+
+## Use
+
+**TODO**: use
+
+## API
+
+**TODO**: api
+
+## Types
+
+This package is fully typed with [TypeScript][].
+It exports no additional types.
+
+## Project
+
+### Version
+
+docmark-factory-identifier adheres to [semver][].
+
+### 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.
+
+### Sponsor
+
+Small primitives power larger systems.
+Support long-term stability by sponsoring Flex Development.
+
+[docmark]: ../../README.md
+
+[esm]: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c
+
+[esmsh]: https://esm.sh
+
+[semver]: https://semver.org
+
+[typescript]: https://www.typescriptlang.org
+
+[yarn]: https://yarnpkg.com

package/dist/index.d.mts

@@ -0,0 +1,29 @@
+import type { Effects, State, TokenType } from '@flex-development/docmark-util-types';
+
+/**
+ * @file factoryIdentifier
+ * @module docmark-factory-identifier/factory
+ */
+
+/**
+ * Tokenize an identifier.
+ *
+ * @see {@linkcode Effects}
+ * @see {@linkcode State}
+ * @see {@linkcode TokenType}
+ *
+ * @param {Effects} effects
+ *  The context object used to transition the state machine
+ * @param {State} ok
+ *  The successful tokenization state
+ * @param {State} nok
+ *  The failed tokenization state
+ * @param {TokenType | null | undefined} [type]
+ *  The token type to capture the identifier as.
+ *  If omitted, defaults to {@linkcode tt.identifier}
+ * @return {State}
+ *  The initial state
+ */
+declare function factoryIdentifier(effects: Effects, ok: State, nok: State, type?: TokenType | null | undefined): State;
+
+export { factoryIdentifier };

package/dist/index.mjs

@@ -0,0 +1,22 @@
+import { tt } from '@flex-development/docmark-util-symbol';
+import { idStart, idContinue } from '@flex-development/mark-util-character';
+
+function factoryIdentifier(effects, ok, nok, type) {
+    type ??= tt.identifier;
+    return startIdentifier;
+    function startIdentifier(code) {
+        if (!idStart(code))
+            return nok(code);
+        effects.enter(type);
+        effects.consume(code);
+        return continueIdentifier;
+    }
+    function continueIdentifier(code) {
+        if (idContinue(code))
+            return effects.consume(code), continueIdentifier;
+        effects.exit(type);
+        return ok(code);
+    }
+}
+
+export { factoryIdentifier };

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@flex-development/docmark-factory-identifier",
+  "description": "docmark factory to parse identifiers",
+  "version": "1.0.0-alpha.1",
+  "keywords": [
+    "docmark",
+    "factory",
+    "identifier",
+    "typescript"
+  ],
+  "license": "BSD-3-Clause",
+  "homepage": "https://github.com/flex-development/docmark-util-types/tree/main/packages/flex-development/docmark-factory-identifier",
+  "repository": {
+    "directory": "packages/docmark-factory-identifier",
+    "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-factory-identifier",
+    "diff-src-prefix": "docmark-factory-identifier",
+    "directory": "./",
+    "executableFiles": [],
+    "node-options": null,
+    "pack-destination": ".",
+    "parseable": true,
+    "prefer-dedupe": true,
+    "provenance": true,
+    "tag-version-prefix": "docmark-factory-identifier@"
+  },
+  "type": "module",
+  "files": [
+    "LICENSE.md",
+    "README.md",
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "docmark": "./src/index.mts",
+      "default": "./dist/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "dependencies": {
+    "@flex-development/docmark-util-symbol": "1.0.0-alpha.6",
+    "@flex-development/docmark-util-types": "1.0.0-alpha.9",
+    "@flex-development/mark-util-character": "1.1.0"
+  },
+  "sideEffects": false,
+  "build": "941f59f6a224a6bd607d55df60276b2283de1520"
+}