@peter.naydenov/url-pattern 1.0.0 → 1.0.2

package/types/main.d.ts

@@ -0,0 +1,200 @@
+export default UrlPattern;
+export type UrlPatternOptions = {
+    /**
+     * - Character used for escaping special characters
+     */
+    escapeChar?: string;
+    /**
+     * - Character that starts a named segment
+     */
+    segmentNameStartChar?: string;
+    /**
+     * - Characters allowed in segment names
+     */
+    segmentNameCharset?: string;
+    /**
+     * - Characters allowed in segment values
+     */
+    segmentValueCharset?: string;
+    /**
+     * - Character that starts an optional segment
+     */
+    optionalSegmentStartChar?: string;
+    /**
+     * - Character that ends an optional segment
+     */
+    optionalSegmentEndChar?: string;
+    /**
+     * - Character that denotes a wildcard
+     */
+    wildcardChar?: string;
+};
+export type ParsedSegment = {
+    /**
+     * - Segment name
+     */
+    name: string;
+    /**
+     * - Segment type ('named' | 'wildcard' | 'literal')
+     */
+    type: string;
+    /**
+     * - Whether the segment is optional
+     */
+    optional?: boolean;
+    /**
+     * - Compiled regex string
+     */
+    regex: string;
+};
+export type SegmentName = {
+    /**
+     * - Segment name
+     */
+    name: string;
+    /**
+     * - Capture group index
+     */
+    index: number;
+    /**
+     * - Segment type ('named' | 'wildcard')
+     */
+    type: string;
+};
+export type CompiledPattern = {
+    /**
+     * - Compiled regex string
+     */
+    regex: string;
+    /**
+     * - Compiled regex object
+     */
+    regexObj: RegExp;
+    /**
+     * - Parsed segments
+     */
+    segments: Array<ParsedSegment>;
+    /**
+     * - Segment name mappings
+     */
+    segmentNames: Array<SegmentName>;
+    /**
+     * - Options used
+     */
+    options: UrlPatternOptions;
+    /**
+     * - Whether pattern was created from regex
+     */
+    isRegex: boolean;
+    /**
+     * - Original pattern string
+     */
+    pattern?: string;
+    /**
+     * - Keys for regex patterns
+     */
+    keys?: Array<string>;
+};
+/**
+ * UrlPattern class for matching and generating URLs
+ */
+export class UrlPattern {
+    /**
+     * @param {string|RegExp} pattern - Pattern string or regex
+     * @param {UrlPatternOptions|Array<string>} [options={}] - Options or keys (for regex)
+     */
+    constructor(pattern: string | RegExp, options?: UrlPatternOptions | Array<string>);
+    /** @type {CompiledPattern} */
+    compiled: CompiledPattern;
+    /**
+     * Match a string against the pattern
+     * @param {string} str - String to match
+     * @returns {Object|null} Extracted values or null if no match
+     */
+    match(str: string): any | null;
+    /**
+     * Generate a string from the pattern
+     * @param {Object} [values={}] - Values to stringify
+     * @returns {string} Generated string
+     */
+    stringify(values?: any): string;
+}
+/**
+ * Creates a new UrlPattern instance (functional API)
+ * @param {string|RegExp} pattern - Pattern string or regex
+ * @param {UrlPatternOptions|Array<string>} [options={}] - Options or keys
+ * @returns {UrlPattern} UrlPattern instance
+ */
+export function urlPattern(pattern: string | RegExp, options?: UrlPatternOptions | Array<string>): UrlPattern;
+/**
+ * Creates a compiled pattern from a string
+ * @param {string} pattern - Pattern string
+ * @param {UrlPatternOptions} [options={}] - Options
+ * @returns {CompiledPattern} Compiled pattern
+ */
+export function makePattern(pattern: string, options?: UrlPatternOptions): CompiledPattern;
+/**
+ * Creates a compiled pattern from a regex
+ * @param {RegExp} regex - Regex pattern
+ * @param {Array<string>} [keys=[]] - Array of key names for captured groups
+ * @returns {CompiledPattern} Compiled pattern
+ */
+export function makePatternFromRegex(regex: RegExp, keys?: Array<string>): CompiledPattern;
+/**
+ * Matches a string against a compiled pattern
+ * @param {CompiledPattern} compiled - Compiled pattern
+ * @param {string} str - String to match
+ * @returns {Object|null} Extracted values or null if no match
+ */
+export function match(compiled: CompiledPattern, str: string): any | null;
+/**
+ * Stringifies a pattern with given values
+ * @param {CompiledPattern} compiled - Compiled pattern
+ * @param {Object} [values={}] - Values to stringify
+ * @returns {string} Generated string
+ * @throws {Error} If required values are missing
+ */
+export function stringify(compiled: CompiledPattern, values?: any): string;
+/**
+ * @fileoverview URL pattern matching library
+ * @module url-pattern
+ */
+/**
+ * @typedef {Object} UrlPatternOptions
+ * @property {string} [escapeChar='\\'] - Character used for escaping special characters
+ * @property {string} [segmentNameStartChar=':'] - Character that starts a named segment
+ * @property {string} [segmentNameCharset='a-zA-Z0-9'] - Characters allowed in segment names
+ * @property {string} [segmentValueCharset='a-zA-Z0-9-_~ %'] - Characters allowed in segment values
+ * @property {string} [optionalSegmentStartChar='('] - Character that starts an optional segment
+ * @property {string} [optionalSegmentEndChar=')'] - Character that ends an optional segment
+ * @property {string} [wildcardChar='*'] - Character that denotes a wildcard
+ */
+/**
+ * @typedef {Object} ParsedSegment
+ * @property {string} name - Segment name
+ * @property {string} type - Segment type ('named' | 'wildcard' | 'literal')
+ * @property {boolean} [optional=false] - Whether the segment is optional
+ * @property {string} regex - Compiled regex string
+ */
+/**
+ * @typedef {Object} SegmentName
+ * @property {string} name - Segment name
+ * @property {number} index - Capture group index
+ * @property {string} type - Segment type ('named' | 'wildcard')
+ */
+/**
+ * @typedef {Object} CompiledPattern
+ * @property {string} regex - Compiled regex string
+ * @property {RegExp} regexObj - Compiled regex object
+ * @property {Array<ParsedSegment>} segments - Parsed segments
+ * @property {Array<SegmentName>} segmentNames - Segment name mappings
+ * @property {UrlPatternOptions} options - Options used
+ * @property {boolean} isRegex - Whether pattern was created from regex
+ * @property {string} [pattern] - Original pattern string
+ * @property {Array<string>} [keys] - Keys for regex patterns
+ */
+/**
+ * Default options for URL pattern matching
+ * @type {UrlPatternOptions}
+ */
+export const DEFAULT_OPTIONS: UrlPatternOptions;

package/dist/index.d.ts

@@ -1,131 +0,0 @@
-/**
- * Options for customizing the pattern syntax
- */
-export interface UrlPatternOptions {
-  /** Character used for escaping special characters (default: '\\') */
-  escapeChar?: string;
-  /** Character that starts a named segment (default: ':') */
-  segmentNameStartChar?: string;
-  /** Characters allowed in segment names (default: 'a-zA-Z0-9') */
-  segmentNameCharset?: string;
-  /** Characters allowed in segment values (default: 'a-zA-Z0-9-_~ %') */
-  segmentValueCharset?: string;
-  /** Character that starts an optional segment (default: '(') */
-  optionalSegmentStartChar?: string;
-  /** Character that ends an optional segment (default: ')') */
-  optionalSegmentEndChar?: string;
-  /** Character that denotes a wildcard (default: '*') */
-  wildcardChar?: string;
-}
-
-/**
- * Result of matching a pattern against a string
- */
-export interface MatchResult {
-  [key: string]: string | string[] | null;
-}
-
-/**
- * Compiled pattern object
- */
-export interface CompiledPattern {
-  regex: string;
-  regexObj: RegExp;
-  segments: ParsedSegment[];
-  segmentNames: SegmentName[];
-  options: UrlPatternOptions;
-  isRegex: boolean;
-  pattern?: string;
-  keys?: string[];
-}
-
-/**
- * Parsed segment
- */
-export interface ParsedSegment {
-  name: string;
-  type: 'named' | 'wildcard' | 'literal';
-  optional?: boolean;
-  regex: string;
-}
-
-/**
- * Segment name mapping
- */
-export interface SegmentName {
-  name: string;
-  index: number;
-  type: 'named' | 'wildcard';
-}
-
-/**
- * UrlPattern class for matching and generating URLs
- */
-export class UrlPattern {
-  /**
-   * @param pattern - Pattern string or RegExp
-   * @param options - Options object or keys array (for regex patterns)
-   */
-  constructor(pattern: string | RegExp, options?: UrlPatternOptions | string[]);
-
-  /**
-   * Match a string against the pattern
-   * @param str - String to match
-   * @returns Extracted values or null if no match
-   */
-  match(str: string): MatchResult | null;
-
-  /**
-   * Generate a string from the pattern
-   * @param values - Values to stringify
-   * @returns Generated string
-   */
-  stringify(values?: Record<string, any>): string;
-}
-
-/**
- * Creates a new UrlPattern instance (functional API)
- * @param pattern - Pattern string or RegExp
- * @param options - Options object or keys array (for regex patterns)
- * @returns UrlPattern instance
- */
-export function urlPattern(pattern: string | RegExp, options?: UrlPatternOptions | string[]): UrlPattern;
-
-/**
- * Creates a compiled pattern from a string
- * @param pattern - Pattern string
- * @param options - Options
- * @returns Compiled pattern
- */
-export function makePattern(pattern: string, options?: UrlPatternOptions): CompiledPattern;
-
-/**
- * Creates a compiled pattern from a regex
- * @param regex - Regex pattern
- * @param keys - Array of key names for captured groups
- * @returns Compiled pattern
- */
-export function makePatternFromRegex(regex: RegExp, keys?: string[]): CompiledPattern;
-
-/**
- * Matches a string against a compiled pattern
- * @param compiled - Compiled pattern
- * @param str - String to match
- * @returns Extracted values or null
- */
-export function match(compiled: CompiledPattern, str: string): MatchResult | null;
-
-/**
- * Stringifies a pattern with given values
- * @param compiled - Compiled pattern
- * @param values - Values to stringify
- * @returns Generated string
- */
-export function stringify(compiled: CompiledPattern, values?: Record<string, any>): string;
-
-/**
- * Default options
- */
-export const DEFAULT_OPTIONS: UrlPatternOptions;
-
-export default UrlPattern;