@noldova/context.text 0.0.0-stage → 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Noldova
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/THIRD-PARTY-NOTICES.txt

@@ -0,0 +1,51 @@
+THIRD-PARTY NOTICES
+
+This package includes tables generated from the Unicode Character Database,
+in services/unicode-code-point.service.js:
+
+- Unicode 15.1 ID_Start and ID_Continue properties, from
+  https://www.unicode.org/Public/15.1.0/ucd/DerivedCoreProperties.txt
+
+They are used under the Unicode License v3, whose text follows.
+
+--------------------------------------------------------------------------------
+
+UNICODE LICENSE V3
+
+COPYRIGHT AND PERMISSION NOTICE
+
+Copyright © 1991-2026 Unicode, Inc.
+
+NOTICE TO USER: Carefully read the following legal agreement. BY
+DOWNLOADING, INSTALLING, COPYING OR OTHERWISE USING DATA FILES, AND/OR
+SOFTWARE, YOU UNEQUIVOCALLY ACCEPT, AND AGREE TO BE BOUND BY, ALL OF THE
+TERMS AND CONDITIONS OF THIS AGREEMENT. IF YOU DO NOT AGREE, DO NOT
+DOWNLOAD, INSTALL, COPY, DISTRIBUTE OR USE THE DATA FILES OR SOFTWARE.
+
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of data files and any associated documentation (the "Data Files") or
+software and any associated documentation (the "Software") to deal in the
+Data Files or Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, and/or sell
+copies of the Data Files or Software, and to permit persons to whom the
+Data Files or Software are furnished to do so, provided that either (a)
+this copyright and permission notice appear with all copies of the Data
+Files or Software, or (b) this copyright and permission notice appear in
+associated Documentation.
+
+THE DATA FILES AND SOFTWARE ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
+KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF
+THIRD PARTY RIGHTS.
+
+IN NO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS INCLUDED IN THIS NOTICE
+BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL INDIRECT OR CONSEQUENTIAL DAMAGES,
+OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
+WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
+ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THE DATA
+FILES OR SOFTWARE.
+
+Except as contained in this notice, the name of a copyright holder shall
+not be used in advertising or otherwise to promote the sale, use or other
+dealings in these Data Files or Software without prior written
+authorization of the copyright holder.

package/api/index.d.ts

@@ -0,0 +1,460 @@
+/**
+ * @license
+ * Copyright (c) Noldova.
+ *
+ * This source code is licensed under the license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import "@noldova/context.core";
+
+declare global {
+  /**
+   * Text operations added to the global `String` constructor.
+   *
+   * @example
+   * ```ts
+   * import "@noldova/context.text";
+   *
+   * String.isAsciiBinaryDigit("1"); // true
+   * String.isAsciiBinaryDigit("2"); // false
+   * String.isAsciiOctalDigit("7"); // true
+   * String.isAsciiOctalDigit("8"); // false
+   * String.isAsciiOctalDigit("07"); // false: not one character.
+   * ```
+   */
+  interface StringConstructor {
+    /**
+     * Identifies a single ASCII binary digit.
+     *
+     * @param character The complete string to classify; no trimming or numeric
+     * conversion is performed.
+     * @returns True only for `"0"` or `"1"`. Empty strings, longer strings,
+     * and non-ASCII digits return false.
+     * @example
+     * ```ts
+     * import "@noldova/context.text";
+     *
+     * String.isAsciiBinaryDigit("1"); // true
+     * String.isAsciiBinaryDigit("10"); // false: not one character.
+     * ```
+     */
+    isAsciiBinaryDigit(character: string): boolean;
+
+    /**
+     * Identifies a single ASCII octal digit.
+     *
+     * @param character The complete string to classify; no trimming or numeric
+     * conversion is performed.
+     * @returns True only for one character from `"0"` through `"7"`. Empty
+     * strings, longer strings, and non-ASCII digits return false.
+     * @example
+     * ```ts
+     * import "@noldova/context.text";
+     *
+     * String.isAsciiOctalDigit("7"); // true
+     * String.isAsciiOctalDigit("8"); // false
+     * ```
+     */
+    isAsciiOctalDigit(character: string): boolean;
+  }
+}
+
+/**
+ * Defines a language's line-terminator policy for UTF-16 text.
+ * Sequence recognition and single-code-unit classification are distinct operations.
+ * This contract does not select the host operating system's newline convention.
+ *
+ * @see {@link EcmaScriptLineTerminator} for a concrete policy and examples.
+ */
+export declare abstract class LineTerminator {
+  /**
+   * Examines the sequence beginning at one UTF-16 position.
+   *
+   * @param value The complete text to inspect, without changing or normalizing it.
+   * @param index The zero-based UTF-16 offset to inspect. Must be an integer
+   * between zero and `value.length`, inclusive.
+   * @returns The recognized sequence's length in code units, or zero for an
+   * ordinary position or the end of the string.
+   * @example
+   * ```ts
+   * import { EcmaScriptLineTerminator, LineTerminator } from "@noldova/context.text";
+   *
+   * const terminator: LineTerminator = new EcmaScriptLineTerminator();
+   * terminator.getLength("a\r\nb", 1); // 2: CRLF.
+   * terminator.getLength("ab", 1); // 0: an ordinary position.
+   * ```
+   */
+  public abstract getLength(value: string, index: number): 0 | 1 | 2;
+
+  /**
+   * Classifies one complete code unit as a line terminator.
+   *
+   * @param character The whole string to classify, not a position within a
+   * larger string. Only a one-code-unit string can qualify.
+   * @returns True when that code unit is a line terminator under this policy.
+   * Empty strings and multi-code-unit strings return false.
+   * @example
+   * ```ts
+   * import { EcmaScriptLineTerminator, LineTerminator } from "@noldova/context.text";
+   *
+   * const terminator: LineTerminator = new EcmaScriptLineTerminator();
+   * terminator.isLineTerminator("\n"); // true
+   * terminator.isLineTerminator(""); // false
+   * ```
+   */
+  public abstract isLineTerminator(character: string): boolean;
+}
+
+/**
+ * Recognizes the ECMAScript sequences CRLF, CR, LF, U+2028, and U+2029.
+ * It does not treat U+0085 as a line terminator.
+ *
+ * @example
+ * ```ts
+ * import { EcmaScriptLineTerminator } from "@noldova/context.text";
+ *
+ * const terminator = new EcmaScriptLineTerminator();
+ * terminator.getLength("a\r\nb", 1); // 2: CRLF.
+ * terminator.getLength("a\r\nb", 2); // 1: LF at the requested position.
+ * terminator.getLength("", 0); // 0: end of text.
+ * terminator.isLineTerminator("\u2028"); // true
+ * terminator.isLineTerminator("\r\n"); // false: two code units.
+ * ```
+ */
+export declare class EcmaScriptLineTerminator extends LineTerminator {
+  /**
+   * Recognizes a line-terminator sequence at the requested position.
+   *
+   * @param value The complete text to inspect without modifying it.
+   * @param index The zero-based UTF-16 offset. An offset equal to the string's
+   * length is valid and represents the end of text.
+   * @returns Two for CRLF; one for CR, LF, U+2028, or U+2029; otherwise zero.
+   * Recognition starts exactly at `index` and does not look behind it.
+   * @throws {ArgumentOutOfRangeException} Synchronously, when the index is
+   * non-integer, negative, or greater than the string's length.
+   * @example
+   * ```ts
+   * import { EcmaScriptLineTerminator } from "@noldova/context.text";
+   *
+   * const terminator = new EcmaScriptLineTerminator();
+   * terminator.getLength("a\rb", 1); // 1: CR alone.
+   * terminator.getLength("a", 1); // 0: the end of text.
+   * terminator.getLength("a", 2); // Throws ArgumentOutOfRangeException.
+   * ```
+   */
+  public override getLength(value: string, index: number): 0 | 1 | 2;
+
+  /**
+   * Classifies a single ECMAScript line-terminator code unit.
+   *
+   * @param character The whole string to classify. It is not trimmed,
+   * split, or normalized.
+   * @returns True only for CR, LF, U+2028, or U+2029. In particular, CRLF
+   * returns false here; use {@link EcmaScriptLineTerminator.getLength} for sequences.
+   * @example
+   * ```ts
+   * import { EcmaScriptLineTerminator } from "@noldova/context.text";
+   *
+   * const terminator = new EcmaScriptLineTerminator();
+   * terminator.isLineTerminator(""); // true
+   * terminator.isLineTerminator("\u0085"); // false: NEL is not an ECMAScript line terminator.
+   * ```
+   */
+  public override isLineTerminator(character: string): boolean;
+}
+
+/**
+ * An immutable UTF-16 view backed by an existing string.
+ *
+ * Creating or slicing a span creates a view object without copying its
+ * represented characters. The view retains its backing source string, even
+ * when it represents only a small or empty range of a large source.
+ * Indexes and lengths count code units, not Unicode code points or displayed
+ * characters; a view may include only one half of a surrogate pair.
+ *
+ * @example
+ * ```ts
+ * import { ReadOnlyStringSpan } from "@noldova/context.text";
+ *
+ * const span = new ReadOnlyStringSpan("hello world", 6, 5);
+ * span.toString(); // "world"
+ * span.get(0); // "w": indexes are relative to the span.
+ * span.slice(1, 3).toString(); // "orl"
+ * span.slice(span.length).isEmpty; // true
+ * new ReadOnlyStringSpan("😀").length; // 2 UTF-16 code units.
+ * ```
+ */
+export declare class ReadOnlyStringSpan {
+  /**
+   * A reusable zero-length span backed by an empty string.
+   */
+  public static readonly empty: ReadOnlyStringSpan;
+
+  /**
+   * The number of UTF-16 code units visible through this span.
+   */
+  public readonly length: number;
+
+  /**
+   * Whether this span has zero visible code units.
+   */
+  public readonly isEmpty: boolean;
+
+  /**
+   * Creates a view of the complete source or one contained range.
+   *
+   * @param source The backing string retained by this span. Empty strings
+   * and unpaired UTF-16 surrogate code units are allowed.
+   * @param start The zero-based source offset in code units; defaults to zero.
+   * An offset equal to `source.length` is valid for an empty view.
+   * @param length The number of code units in the view; defaults to all
+   * remaining source units from `start`. Zero is allowed.
+   * @throws {ArgumentOutOfRangeException} Synchronously, when start or length
+   * is non-integer or negative, start exceeds the source length, or the range
+   * extends past its end.
+   * @example
+   * ```ts
+   * import { ReadOnlyStringSpan } from "@noldova/context.text";
+   *
+   * new ReadOnlyStringSpan("hello").toString(); // "hello"
+   * new ReadOnlyStringSpan("hello", 1, 3).toString(); // "ell"
+   * new ReadOnlyStringSpan("hello", 5).isEmpty; // true
+   * new ReadOnlyStringSpan("hello", 2, 4); // Throws ArgumentOutOfRangeException.
+   * ```
+   */
+  public constructor(source: string, start?: number, length?: number);
+
+  /**
+   * Reads one code unit relative to this span.
+   *
+   * @param index The zero-based span offset, from zero through
+   * `length - 1`. No index is valid for an empty span.
+   * @returns A string containing exactly one UTF-16 code unit. A surrogate
+   * is returned as that code unit, without combining it with its neighbor.
+   * @throws {IndexOutOfRangeException} Synchronously, when the index is
+   * non-integer, negative, or greater than or equal to the span's length.
+   * @example
+   * ```ts
+   * import { ReadOnlyStringSpan } from "@noldova/context.text";
+   *
+   * const span = new ReadOnlyStringSpan("hello", 1, 3);
+   * span.get(0); // "e": indexes are relative to the span.
+   * span.get(3); // Throws IndexOutOfRangeException.
+   * ```
+   */
+  public get(index: number): string;
+
+  /**
+   * Creates a new view contained within this span.
+   *
+   * @param start The zero-based offset relative to this span, not its backing
+   * source. An offset equal to `length` is valid for an empty slice.
+   * @param length The number of code units to expose; defaults to the remainder
+   * of this span. Zero is allowed.
+   * @returns A new span sharing the original backing string. The current span
+   * is unchanged, and the result cannot expose text outside its parent.
+   * @throws {ArgumentOutOfRangeException} Synchronously, when start or length
+   * is non-integer or negative, or the requested range is outside this span.
+   * @example
+   * ```ts
+   * import { ReadOnlyStringSpan } from "@noldova/context.text";
+   *
+   * const span = new ReadOnlyStringSpan("hello world", 6);
+   * span.slice(1, 3).toString(); // "orl"
+   * span.slice(span.length).isEmpty; // true
+   * span.slice(4, 2); // Throws ArgumentOutOfRangeException.
+   * ```
+   */
+  public slice(start: number, length?: number): ReadOnlyStringSpan;
+
+  /**
+   * Produces the text represented by the view.
+   *
+   * @returns The visible code units in order, or an empty string for an empty
+   * span. The operation does not consume or alter the span.
+   * @example
+   * ```ts
+   * import { ReadOnlyStringSpan } from "@noldova/context.text";
+   *
+   * new ReadOnlyStringSpan("hello world", 6, 5).toString(); // "world"
+   * ReadOnlyStringSpan.empty.toString(); // ""
+   * ```
+   */
+  public toString(): string;
+}
+
+/**
+ * Collects string fragments and materializes their combined UTF-16 text on demand.
+ * Fragments remain retained until {@link StringBuilder.clear} or the builder
+ * itself becomes unreachable. Materializing a string does not clear the builder.
+ *
+ * @example
+ * ```ts
+ * import { StringBuilder } from "@noldova/context.text";
+ *
+ * const builder = new StringBuilder();
+ * builder.append("hello").append(" ").append("world");
+ * builder.length; // 11
+ * const first = builder.toString(); // "hello world"
+ * builder.append("!");
+ * builder.toString(); // "hello world!"
+ * first; // Still "hello world".
+ * builder.clear();
+ * builder.length; // 0
+ * builder.toString(); // ""
+ * builder.append("again").toString(); // "again": the builder is reusable.
+ * ```
+ */
+export declare class StringBuilder {
+  /**
+   * The total number of UTF-16 code units in the retained fragments.
+   */
+  public get length(): number;
+
+  /**
+   * Appends a string exactly as supplied.
+   *
+   * @param value The entire fragment to retain. Empty strings have no effect.
+   * Newlines and surrogate code units are neither inserted, replaced, nor normalized.
+   * @returns This same builder, allowing further appends to be chained.
+   *
+   * @example
+   * ```ts
+   * import { StringBuilder } from "@noldova/context.text";
+   *
+   * const builder = new StringBuilder();
+   * builder.append("a\r").append("\nb");
+   * builder.toString(); // "a\r\nb": preserves the exact supplied newline.
+   * ```
+   */
+  public append(value: string): this;
+
+  /**
+   * Releases this builder's references to its fragments and sets its length to zero.
+   * The builder can be reused, and strings previously returned by
+   * {@link StringBuilder.toString} remain unchanged.
+   *
+   * @example
+   * ```ts
+   * import { StringBuilder } from "@noldova/context.text";
+   *
+   * const builder = new StringBuilder().append("draft");
+   * builder.clear();
+   * builder.length; // 0
+   * builder.append("final").toString(); // "final"
+   * ```
+   */
+  public clear(): void;
+
+  /**
+   * Joins the retained fragments without consuming them.
+   *
+   * @returns The combined code units, or an empty string when no content has
+   * been appended. Subsequent changes to the builder do not change this string.
+   *
+   * @remarks
+   * Each call joins the current fragments again; the result is not cached.
+   * Materialize after accumulation rather than after every append.
+   * @example
+   * ```ts
+   * import { StringBuilder } from "@noldova/context.text";
+   *
+   * const builder = new StringBuilder();
+   * builder.toString(); // ""
+   * builder.append("a").append("b").toString(); // "ab"
+   * ```
+   */
+  public toString(): string;
+}
+
+/**
+ * Classifies numeric code points using the pinned Unicode 15.1 identifier data.
+ * This is Unicode classification, not a complete language-identifier policy:
+ * a language may add characters such as ECMAScript's dollar sign.
+ * The host's Unicode version does not select these results.
+ *
+ * @example
+ * ```ts
+ * import { UnicodeCodePointService } from "@noldova/context.text";
+ *
+ * UnicodeCodePointService.isIdentifierStart(0x41); // true: A.
+ * UnicodeCodePointService.isIdentifierStart(0x30); // false: 0.
+ * UnicodeCodePointService.isIdentifierContinue(0x30); // true: 0 can continue.
+ * UnicodeCodePointService.isIdentifierStart(0x24); // false: dollar sign.
+ * UnicodeCodePointService.isIdentifierStart(0x2EBF0); // true: Unicode 15.1 addition.
+ * UnicodeCodePointService.isIdentifierStart(0x10D50); // false: absent from this profile.
+ * UnicodeCodePointService.isIdentifierContinue(Number.NaN); // false
+ * ```
+ */
+export declare class UnicodeCodePointService {
+  /**
+   * Tests the Unicode 15.1 `ID_Start` property, including its
+   * `Other_ID_Start` contributions.
+   *
+   * @param value The numeric code point to classify, not a string index.
+   * @returns True for a code point in the pinned start set. Non-integers,
+   * negative values, values above U+10FFFF, and all other code points return false.
+   * @example
+   * ```ts
+   * import { UnicodeCodePointService } from "@noldova/context.text";
+   *
+   * UnicodeCodePointService.isIdentifierStart(0x41); // true: A.
+   * UnicodeCodePointService.isIdentifierStart(0x30); // false: 0.
+   * UnicodeCodePointService.isIdentifierStart(0x110000); // false: past U+10FFFF.
+   * ```
+   */
+  public static isIdentifierStart(value: number): boolean;
+
+  /**
+   * Tests the Unicode 15.1 `ID_Continue` property.
+   *
+   * @param value The numeric code point to classify, not a string index.
+   * @returns True for a code point in the pinned continuation set. Non-integers,
+   * negative values, values above U+10FFFF, and all other code points return false.
+   * @example
+   * ```ts
+   * import { UnicodeCodePointService } from "@noldova/context.text";
+   *
+   * UnicodeCodePointService.isIdentifierContinue(0x30); // true: 0 can continue.
+   * UnicodeCodePointService.isIdentifierContinue(0x2D); // false: hyphen-minus.
+   * UnicodeCodePointService.isIdentifierContinue(1.5); // false: not an integer.
+   * ```
+   */
+  public static isIdentifierContinue(value: number): boolean;
+
+  /**
+   * Identifies a UTF-16 leading-surrogate code unit by its numeric value.
+   *
+   * @param value The integer code-unit value to classify.
+   * @returns True from U+D800 through U+DBFF, inclusive; false for every other
+   * value, including non-integers. Surrogates are not Unicode scalar values.
+   *
+   * @example
+   * ```ts
+   * import { UnicodeCodePointService } from "@noldova/context.text";
+   *
+   * UnicodeCodePointService.isLeadingSurrogate(0xD83D); // true
+   * UnicodeCodePointService.isTrailingSurrogate(0xDE00); // true
+   * UnicodeCodePointService.isLeadingSurrogate(0xDE00); // false
+   * UnicodeCodePointService.isTrailingSurrogate(0xE000); // false: past the range.
+   * ```
+   */
+  public static isLeadingSurrogate(value: number): boolean;
+
+  /**
+   * Identifies a UTF-16 trailing-surrogate code unit by its numeric value.
+   *
+   * @param value The integer code-unit value to classify.
+   * @returns True from U+DC00 through U+DFFF, inclusive; false for every other
+   * value, including non-integers. Surrogates are not Unicode scalar values.
+   * @example
+   * ```ts
+   * import { UnicodeCodePointService } from "@noldova/context.text";
+   *
+   * UnicodeCodePointService.isTrailingSurrogate(0xDE00); // true
+   * UnicodeCodePointService.isTrailingSurrogate(0xD83D); // false: a leading surrogate.
+   * ```
+   */
+  public static isTrailingSurrogate(value: number): boolean;
+}

package/api/index.js

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright (c) Noldova.
+ *
+ * This source code is licensed under the license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import "../extensions/string.extensions.js";
+export { ReadOnlyStringSpan } from "../models/read-only-string-span.js";
+export { EcmaScriptLineTerminator } from "../services/line-terminators/ecma-script-line-terminator.js";
+export { LineTerminator } from "../services/line-terminators/line-terminator.js";
+export { StringBuilder } from "../services/string-builder.js";
+export { UnicodeCodePointService } from "../services/unicode-code-point.service.js";
+//# sourceMappingURL=index.js.map

package/api/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/noldova.context.text/src/api/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,oCAAoC,CAAC;AAE5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,6DAA6D,CAAC;AACvG,OAAO,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC"}

package/extensions/string.extensions.js

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright (c) Noldova.
+ *
+ * This source code is licensed under the license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { nameof } from "@noldova/context.core";
+import { Resources } from "../resources.js";
+function isAsciiBinaryDigit(character) {
+    return character === Resources.asciiDigitZero || character === Resources.asciiDigitOne;
+}
+function isAsciiOctalDigit(character) {
+    if (character.length !== 1)
+        return false;
+    return character >= Resources.asciiDigitZero && character <= Resources.asciiDigitSeven;
+}
+Object.defineProperty(String, nameof(t => t.isAsciiBinaryDigit), { value: isAsciiBinaryDigit, writable: false, enumerable: false, configurable: false });
+Object.defineProperty(String, nameof(t => t.isAsciiOctalDigit), { value: isAsciiOctalDigit, writable: false, enumerable: false, configurable: false });
+export {};
+//# sourceMappingURL=string.extensions.js.map

package/extensions/string.extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.extensions.js","sourceRoot":"","sources":["../../../../src/noldova.context.text/src/extensions/string.extensions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAS5C,SAAS,kBAAkB,CAAC,SAAiB;IAC3C,OAAO,SAAS,KAAK,SAAS,CAAC,cAAc,IAAI,SAAS,KAAK,SAAS,CAAC,aAAa,CAAC;AACzF,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAiB;IAC1C,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QACxB,OAAO,KAAK,CAAC;IAEf,OAAO,SAAS,IAAI,SAAS,CAAC,cAAc,IAAI,SAAS,IAAI,SAAS,CAAC,eAAe,CAAC;AACzF,CAAC;AAED,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,kBAAkB,CAAC,EAAE,EAAE,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5K,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAoB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;AAE1K,OAAO,EAAG,CAAC"}

package/models/read-only-string-span.js

@@ -0,0 +1,47 @@
+/**
+ * @license
+ * Copyright (c) Noldova.
+ *
+ * This source code is licensed under the license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import "@noldova/context.core";
+import { ArgumentOutOfRangeException, IndexOutOfRangeException } from "@noldova/context.exceptions";
+import { Resources } from "../resources.js";
+export class ReadOnlyStringSpan {
+    static empty = new ReadOnlyStringSpan(String.empty);
+    source;
+    start;
+    length;
+    isEmpty;
+    constructor(source, start = 0, length) {
+        const spanLength = length ?? source.length - start;
+        ReadOnlyStringSpan.validateRange(start, spanLength, source.length);
+        this.source = source;
+        this.start = start;
+        this.length = spanLength;
+        this.isEmpty = this.length === 0;
+    }
+    get(index) {
+        if (!Number.isInteger(index) || index < 0 || index >= this.length)
+            throw new IndexOutOfRangeException(Resources.indexOutOfRange);
+        return this.source.charAt(this.start + index);
+    }
+    slice(start, length) {
+        const spanLength = length ?? this.length - start;
+        ReadOnlyStringSpan.validateRange(start, spanLength, this.length);
+        return new ReadOnlyStringSpan(this.source, this.start + start, spanLength);
+    }
+    toString() {
+        return this.source.slice(this.start, this.start + this.length);
+    }
+    static validateRange(start, length, sourceLength) {
+        if (!Number.isInteger(start) || start < 0 || start > sourceLength)
+            throw new ArgumentOutOfRangeException(Resources.startParameterName, start, Resources.startInvalid);
+        if (!Number.isInteger(length) || length < 0)
+            throw new ArgumentOutOfRangeException(Resources.lengthParameterName, length, Resources.lengthInvalid);
+        if (start + length > sourceLength)
+            throw new ArgumentOutOfRangeException(Resources.lengthParameterName, length, Resources.spanOutOfRange);
+    }
+}
+//# sourceMappingURL=read-only-string-span.js.map

package/models/read-only-string-span.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-only-string-span.js","sourceRoot":"","sources":["../../../../src/noldova.context.text/src/models/read-only-string-span.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,uBAAuB,CAAC;AAC/B,OAAO,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAEpG,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,OAAO,kBAAkB;IACtB,MAAM,CAAU,KAAK,GAAuB,IAAI,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEvE,MAAM,CAAS;IACf,KAAK,CAAS;IAEf,MAAM,CAAS;IACf,OAAO,CAAU;IAEjC,YAAmB,MAAc,EAAE,KAAK,GAAW,CAAC,EAAE,MAAe;QACnE,MAAM,UAAU,GAAG,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC;QACnD,kBAAkB,CAAC,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAEnE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC;IACnC,CAAC;IAEM,GAAG,CAAC,KAAa;QACtB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,IAAI,CAAC,MAAM;YAC/D,MAAM,IAAI,wBAAwB,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QAEhE,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC;IAChD,CAAC;IAEM,KAAK,CAAC,KAAa,EAAE,MAAe;QACzC,MAAM,UAAU,GAAG,MAAM,IAAI,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACjD,kBAAkB,CAAC,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAEjE,OAAO,IAAI,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,GAAG,KAAK,EAAE,UAAU,CAAC,CAAC;IAC7E,CAAC;IAEM,QAAQ;QACb,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IACjE,CAAC;IAEO,MAAM,CAAC,aAAa,CAAC,KAAa,EAAE,MAAc,EAAE,YAAoB;QAC9E,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,GAAG,YAAY;YAC/D,MAAM,IAAI,2BAA2B,CAAC,SAAS,CAAC,kBAAkB,EAAE,KAAK,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;QAErG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC;YACzC,MAAM,IAAI,2BAA2B,CAAC,SAAS,CAAC,mBAAmB,EAAE,MAAM,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC;QAExG,IAAI,KAAK,GAAG,MAAM,GAAG,YAAY;YAC/B,MAAM,IAAI,2BAA2B,CAAC,SAAS,CAAC,mBAAmB,EAAE,MAAM,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;IAC3G,CAAC;CACF"}

package/package.json

@@ -1,6 +1,26 @@
 {
   "name": "@noldova/context.text",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.2",
+  "type": "module",
+  "main": "api/index.js",
+  "types": "api/index.d.ts",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/noldova-com/context.git",
+    "directory": "src/noldova.context.text"
+  },
+  "homepage": "https://github.com/noldova-com/context#readme",
+  "bugs": {
+    "url": "https://github.com/noldova-com/context/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@noldova/context.collections": "0.0.2",
+    "@noldova/context.core": "0.0.2",
+    "@noldova/context.exceptions": "0.0.2"
+  }
+}