@blcklab/yuirinx 0.1.1

package/dist/types/core/types.d.ts

@@ -0,0 +1,134 @@
+/** A registered language identifier or alias. */
+export type LanguageId = string;
+/** A registered theme identifier. */
+export type ThemeId = string;
+/** A semantic token classification such as `keyword` or `string.escape`. */
+export type TokenType = string;
+/** A named lexical state inside a grammar. */
+export type StateName = string;
+/** A source token. Offsets use JavaScript UTF-16 string indices. */
+export interface Token {
+    readonly type: TokenType;
+    readonly value: string;
+    readonly start: number;
+    readonly end: number;
+}
+/** One active lexical state exposed to rule resolver callbacks. */
+export interface TokenizerState {
+    readonly name: StateName;
+    readonly language: LanguageId;
+}
+/** Read-only context passed to dynamic grammar rule resolvers. */
+export interface TokenizerContext {
+    readonly language: LanguageId;
+    readonly state: StateName;
+    readonly stack: readonly TokenizerState[];
+    readonly offset: number;
+}
+/** Static token type or a resolver based on the current regex match. */
+export type TokenTypeResolver = TokenType | ((match: RegExpExecArray, context: TokenizerContext) => TokenType);
+/** Static state name or a resolver based on the current regex match. */
+export type StateResolver = StateName | ((match: RegExpExecArray, context: TokenizerContext) => StateName);
+/** A matching grammar rule. Patterns are automatically made sticky. */
+export interface MatchRule {
+    readonly pattern: RegExp;
+    readonly type?: TokenTypeResolver;
+    readonly push?: StateResolver;
+    readonly next?: StateResolver;
+    readonly pop?: boolean | number;
+}
+/** Includes another state’s rules at the current precedence position. */
+export interface IncludeRule {
+    readonly include: StateName;
+}
+/** One ordered grammar rule. */
+export type GrammarRule = MatchRule | IncludeRule;
+/** A lexical state and its ordered rules. */
+export interface GrammarState {
+    readonly rules: readonly GrammarRule[];
+    readonly fallbackType?: TokenType;
+}
+/** A complete language grammar. */
+export interface Grammar {
+    readonly id: LanguageId;
+    readonly aliases?: readonly LanguageId[];
+    readonly initialState?: StateName;
+    readonly states: Readonly<Record<StateName, GrammarState>>;
+}
+/** Allowed visual style fields for a token. */
+export interface TokenStyle {
+    readonly color?: string;
+    readonly backgroundColor?: string;
+    readonly fontStyle?: "normal" | "italic";
+    readonly fontWeight?: "normal" | "medium" | "semibold" | "bold";
+    readonly textDecoration?: "none" | "underline" | "line-through";
+}
+/** A serializable syntax highlighting theme. */
+export interface Theme {
+    readonly id: ThemeId;
+    readonly name: string;
+    readonly type: "light" | "dark";
+    readonly foreground: string;
+    readonly background: string;
+    readonly selection?: string;
+    readonly lineHighlight?: string;
+    /** Curated colors used by the optional deterministic line-color fallback. */
+    readonly fallbackPalette?: readonly string[];
+    readonly tokens: Readonly<Record<TokenType, TokenStyle>>;
+}
+/** HTML rendering strategy. */
+export type RenderMode = "inline" | "classes";
+/** Behavior used when a requested language is unavailable. */
+export type FallbackMode = "plaintext" | "color-lines";
+/** Options for highlighting source code. */
+export interface HighlightOptions {
+    readonly lang?: LanguageId | Grammar;
+    readonly theme?: ThemeId | Theme;
+    /** Unknown-language behavior. Defaults to `plaintext`. */
+    readonly fallback?: FallbackMode;
+    readonly mode?: RenderMode;
+    readonly wrap?: boolean;
+    readonly classPrefix?: string;
+    readonly preClass?: string;
+    readonly codeClass?: string;
+}
+/** Options for rendering an existing token array. */
+export interface RenderOptions {
+    readonly theme?: ThemeId | Theme;
+    readonly mode?: RenderMode;
+    readonly wrap?: boolean;
+    readonly classPrefix?: string;
+    readonly language?: LanguageId;
+    readonly preClass?: string;
+    readonly codeClass?: string;
+}
+/** Options for converting a theme object to CSS classes. */
+export interface ThemeCssOptions {
+    readonly selector?: string;
+    readonly classPrefix?: string;
+    readonly includeContainer?: boolean;
+}
+/** Initial configuration for an isolated highlighter. */
+export interface HighlighterOptions {
+    readonly languages?: readonly Grammar[];
+    readonly themes?: readonly Theme[];
+    readonly defaultLanguage?: LanguageId;
+    readonly defaultTheme?: ThemeId;
+    /** Default behavior for unavailable language IDs. */
+    readonly defaultFallback?: FallbackMode;
+    readonly maxStateDepth?: number;
+}
+/** Isolated registry, tokenizer, and renderer facade. */
+export interface Highlighter {
+    highlight(code: string, options: HighlightOptions): string;
+    tokenize(code: string, language: LanguageId | Grammar): Token[];
+    render(tokens: readonly Token[], options?: RenderOptions): string;
+    registerLanguage(grammar: Grammar): void;
+    registerTheme(theme: Theme): void;
+    hasLanguage(language: LanguageId): boolean;
+    hasTheme(theme: ThemeId): boolean;
+    getLanguage(language: LanguageId): Grammar | undefined;
+    getTheme(theme: ThemeId): Theme | undefined;
+    listLanguages(): readonly LanguageId[];
+    listThemes(): readonly ThemeId[];
+}

package/dist/types/index.d.cts

@@ -0,0 +1,2 @@
+export * from "./core/index.cjs";
+export { highlight, registerLanguage, registerTheme, render, tokenize, } from "./singleton.cjs";

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./core/index.js";
+export { highlight, registerLanguage, registerTheme, render, tokenize, } from "./singleton.js";

package/dist/types/languages/bash.d.cts

@@ -0,0 +1,3 @@
+import type { Grammar } from "../core/types.cjs";
+/** Bash and POSIX-like shell grammar. */
+export declare const bash: Grammar;

package/dist/types/languages/bash.d.ts

@@ -0,0 +1,3 @@
+import type { Grammar } from "../core/types.js";
+/** Bash and POSIX-like shell grammar. */
+export declare const bash: Grammar;

package/dist/types/languages/c.d.cts

@@ -0,0 +1,2 @@
+/** C grammar. */
+export declare const c: import("../index.js").Grammar;

package/dist/types/languages/c.d.ts

@@ -0,0 +1,2 @@
+/** C grammar. */
+export declare const c: import("../index.js").Grammar;

package/dist/types/languages/cpp.d.cts

@@ -0,0 +1,2 @@
+/** Cpp grammar. */
+export declare const cpp: import("../index.js").Grammar;

package/dist/types/languages/cpp.d.ts

@@ -0,0 +1,2 @@
+/** Cpp grammar. */
+export declare const cpp: import("../index.js").Grammar;

package/dist/types/languages/csharp.d.cts

@@ -0,0 +1,2 @@
+/** Csharp grammar. */
+export declare const csharp: import("../index.js").Grammar;

package/dist/types/languages/csharp.d.ts

@@ -0,0 +1,2 @@
+/** Csharp grammar. */
+export declare const csharp: import("../index.js").Grammar;

package/dist/types/languages/css.d.cts

@@ -0,0 +1,2 @@
+/** CSS grammar. */
+export declare const css: import("../index.js").Grammar;

package/dist/types/languages/css.d.ts

@@ -0,0 +1,2 @@
+/** CSS grammar. */
+export declare const css: import("../index.js").Grammar;

package/dist/types/languages/dart.d.cts

@@ -0,0 +1,2 @@
+/** Dart grammar. */
+export declare const dart: import("../index.js").Grammar;

package/dist/types/languages/dart.d.ts

@@ -0,0 +1,2 @@
+/** Dart grammar. */
+export declare const dart: import("../index.js").Grammar;

package/dist/types/languages/dockerfile.d.cts

@@ -0,0 +1,3 @@
+import type { Grammar } from "../core/types.cjs";
+/** Dockerfile grammar. */
+export declare const dockerfile: Grammar;

package/dist/types/languages/dockerfile.d.ts

@@ -0,0 +1,3 @@
+import type { Grammar } from "../core/types.js";
+/** Dockerfile grammar. */
+export declare const dockerfile: Grammar;

package/dist/types/languages/go.d.cts

@@ -0,0 +1,2 @@
+/** Go grammar. */
+export declare const go: import("../index.js").Grammar;

package/dist/types/languages/go.d.ts

@@ -0,0 +1,2 @@
+/** Go grammar. */
+export declare const go: import("../index.js").Grammar;

package/dist/types/languages/graphql.d.cts

@@ -0,0 +1,3 @@
+import type { Grammar } from "../core/types.cjs";
+/** GraphQL schema and operation grammar. */
+export declare const graphql: Grammar;

package/dist/types/languages/graphql.d.ts

@@ -0,0 +1,3 @@
+import type { Grammar } from "../core/types.js";
+/** GraphQL schema and operation grammar. */
+export declare const graphql: Grammar;

package/dist/types/languages/html.d.cts

@@ -0,0 +1,2 @@
+/** HTML grammar. Embedded script/style bodies remain safely lexical/plain. */
+export declare const html: import("../index.js").Grammar;

package/dist/types/languages/html.d.ts

@@ -0,0 +1,2 @@
+/** HTML grammar. Embedded script/style bodies remain safely lexical/plain. */
+export declare const html: import("../index.js").Grammar;

package/dist/types/languages/ini.d.cts

@@ -0,0 +1,3 @@
+import type { Grammar } from "../core/types.cjs";
+/** INI and dotenv-style configuration grammar. */
+export declare const ini: Grammar;

package/dist/types/languages/ini.d.ts

@@ -0,0 +1,3 @@
+import type { Grammar } from "../core/types.js";
+/** INI and dotenv-style configuration grammar. */
+export declare const ini: Grammar;

package/dist/types/languages/java.d.cts

@@ -0,0 +1,2 @@
+/** Java grammar. */
+export declare const java: import("../index.js").Grammar;

package/dist/types/languages/java.d.ts

@@ -0,0 +1,2 @@
+/** Java grammar. */
+export declare const java: import("../index.js").Grammar;

package/dist/types/languages/javascript.d.cts

@@ -0,0 +1,2 @@
+/** JavaScript grammar. */
+export declare const javascript: import("../index.js").Grammar;

package/dist/types/languages/javascript.d.ts

@@ -0,0 +1,2 @@
+/** JavaScript grammar. */
+export declare const javascript: import("../index.js").Grammar;

package/dist/types/languages/json.d.cts

@@ -0,0 +1,3 @@
+import type { Grammar } from "../core/types.cjs";
+/** JSON grammar with property-name distinction. */
+export declare const json: Grammar;

package/dist/types/languages/json.d.ts

@@ -0,0 +1,3 @@
+import type { Grammar } from "../core/types.js";
+/** JSON grammar with property-name distinction. */
+export declare const json: Grammar;

package/dist/types/languages/jsx.d.cts

@@ -0,0 +1,2 @@
+/** JSX grammar. */
+export declare const jsx: import("../index.js").Grammar;

package/dist/types/languages/jsx.d.ts

@@ -0,0 +1,2 @@
+/** JSX grammar. */
+export declare const jsx: import("../index.js").Grammar;

package/dist/types/languages/kotlin.d.cts

@@ -0,0 +1,2 @@
+/** Kotlin grammar. */
+export declare const kotlin: import("../index.js").Grammar;

package/dist/types/languages/kotlin.d.ts

@@ -0,0 +1,2 @@
+/** Kotlin grammar. */
+export declare const kotlin: import("../index.js").Grammar;

package/dist/types/languages/markdown.d.cts

@@ -0,0 +1,3 @@
+import type { Grammar } from "../core/types.cjs";
+/** Markdown grammar with fenced-code state handling. */
+export declare const markdown: Grammar;

package/dist/types/languages/markdown.d.ts

@@ -0,0 +1,3 @@
+import type { Grammar } from "../core/types.js";
+/** Markdown grammar with fenced-code state handling. */
+export declare const markdown: Grammar;

package/dist/types/languages/nginx.d.cts

@@ -0,0 +1,3 @@
+import type { Grammar } from "../core/types.cjs";
+/** Nginx configuration grammar. */
+export declare const nginx: Grammar;

package/dist/types/languages/nginx.d.ts

@@ -0,0 +1,3 @@
+import type { Grammar } from "../core/types.js";
+/** Nginx configuration grammar. */
+export declare const nginx: Grammar;

package/dist/types/languages/php.d.cts

@@ -0,0 +1,3 @@
+import type { Grammar } from "../core/types.cjs";
+/** PHP lexical grammar. */
+export declare const php: Grammar;

package/dist/types/languages/php.d.ts

@@ -0,0 +1,3 @@
+import type { Grammar } from "../core/types.js";
+/** PHP lexical grammar. */
+export declare const php: Grammar;

package/dist/types/languages/plaintext.d.cts

@@ -0,0 +1,3 @@
+import type { Grammar } from "../core/types.cjs";
+/** Plain text fallback grammar. */
+export declare const plaintext: Grammar;

package/dist/types/languages/plaintext.d.ts

@@ -0,0 +1,3 @@
+import type { Grammar } from "../core/types.js";
+/** Plain text fallback grammar. */
+export declare const plaintext: Grammar;

package/dist/types/languages/python.d.cts

@@ -0,0 +1,3 @@
+import type { Grammar } from "../core/types.cjs";
+/** Python grammar with triple-quoted string handling. */
+export declare const python: Grammar;

package/dist/types/languages/python.d.ts

@@ -0,0 +1,3 @@
+import type { Grammar } from "../core/types.js";
+/** Python grammar with triple-quoted string handling. */
+export declare const python: Grammar;

package/dist/types/languages/ruby.d.cts

@@ -0,0 +1,3 @@
+import type { Grammar } from "../core/types.cjs";
+/** Ruby grammar. */
+export declare const ruby: Grammar;

package/dist/types/languages/ruby.d.ts

@@ -0,0 +1,3 @@
+import type { Grammar } from "../core/types.js";
+/** Ruby grammar. */
+export declare const ruby: Grammar;

package/dist/types/languages/rust.d.cts

@@ -0,0 +1,2 @@
+/** Rust grammar. */
+export declare const rust: import("../index.js").Grammar;

package/dist/types/languages/rust.d.ts

@@ -0,0 +1,2 @@
+/** Rust grammar. */
+export declare const rust: import("../index.js").Grammar;

package/dist/types/languages/scss.d.cts

@@ -0,0 +1,2 @@
+/** SCSS grammar. */
+export declare const scss: import("../index.js").Grammar;

package/dist/types/languages/scss.d.ts

@@ -0,0 +1,2 @@
+/** SCSS grammar. */
+export declare const scss: import("../index.js").Grammar;

package/dist/types/languages/shell.d.cts

@@ -0,0 +1 @@
+export { bash as shell } from "./bash.cjs";

package/dist/types/languages/shell.d.ts

@@ -0,0 +1 @@
+export { bash as shell } from "./bash.js";

package/dist/types/languages/sql.d.cts

@@ -0,0 +1,3 @@
+import type { Grammar } from "../core/types.cjs";
+/** SQL grammar with common dialect keywords and functions. */
+export declare const sql: Grammar;

package/dist/types/languages/sql.d.ts

@@ -0,0 +1,3 @@
+import type { Grammar } from "../core/types.js";
+/** SQL grammar with common dialect keywords and functions. */
+export declare const sql: Grammar;

package/dist/types/languages/svelte.d.cts

@@ -0,0 +1,2 @@
+/** Svelte component markup grammar. */
+export declare const svelte: import("../index.js").Grammar;

package/dist/types/languages/svelte.d.ts

@@ -0,0 +1,2 @@
+/** Svelte component markup grammar. */
+export declare const svelte: import("../index.js").Grammar;

package/dist/types/languages/swift.d.cts

@@ -0,0 +1,2 @@
+/** Swift grammar. */
+export declare const swift: import("../index.js").Grammar;

package/dist/types/languages/swift.d.ts

@@ -0,0 +1,2 @@
+/** Swift grammar. */
+export declare const swift: import("../index.js").Grammar;

package/dist/types/languages/toml.d.cts

@@ -0,0 +1,3 @@
+import type { Grammar } from "../core/types.cjs";
+/** TOML grammar. */
+export declare const toml: Grammar;

package/dist/types/languages/toml.d.ts

@@ -0,0 +1,3 @@
+import type { Grammar } from "../core/types.js";
+/** TOML grammar. */
+export declare const toml: Grammar;

package/dist/types/languages/tsx.d.cts

@@ -0,0 +1,2 @@
+/** TSX grammar. */
+export declare const tsx: import("../index.js").Grammar;

package/dist/types/languages/tsx.d.ts

@@ -0,0 +1,2 @@
+/** TSX grammar. */
+export declare const tsx: import("../index.js").Grammar;

package/dist/types/languages/typescript.d.cts

@@ -0,0 +1,2 @@
+/** TypeScript grammar. */
+export declare const typescript: import("../index.js").Grammar;

package/dist/types/languages/typescript.d.ts

@@ -0,0 +1,2 @@
+/** TypeScript grammar. */
+export declare const typescript: import("../index.js").Grammar;

package/dist/types/languages/vue.d.cts

@@ -0,0 +1,2 @@
+/** Vue single-file component markup grammar. */
+export declare const vue: import("../index.js").Grammar;

package/dist/types/languages/vue.d.ts

@@ -0,0 +1,2 @@
+/** Vue single-file component markup grammar. */
+export declare const vue: import("../index.js").Grammar;

package/dist/types/languages/xml.d.cts

@@ -0,0 +1,2 @@
+/** XML grammar. */
+export declare const xml: import("../index.js").Grammar;

package/dist/types/languages/xml.d.ts

@@ -0,0 +1,2 @@
+/** XML grammar. */
+export declare const xml: import("../index.js").Grammar;

package/dist/types/languages/yaml.d.cts

@@ -0,0 +1,3 @@
+import type { Grammar } from "../core/types.cjs";
+/** YAML grammar focused on configuration readability. */
+export declare const yaml: Grammar;

package/dist/types/languages/yaml.d.ts

@@ -0,0 +1,3 @@
+import type { Grammar } from "../core/types.js";
+/** YAML grammar focused on configuration readability. */
+export declare const yaml: Grammar;

package/dist/types/singleton.d.cts

@@ -0,0 +1,11 @@
+import type { Grammar, HighlightOptions, RenderOptions, Theme, Token } from "./core/types.cjs";
+/** Highlights code through Yuirinx's convenience singleton registry. */
+export declare function highlight(code: string, options: HighlightOptions): string;
+/** Tokenizes code through Yuirinx's convenience singleton registry. */
+export declare function tokenize(code: string, language: string | Grammar): Token[];
+/** Renders tokens through Yuirinx's convenience singleton registry. */
+export declare function render(tokens: readonly Token[], options?: RenderOptions): string;
+/** Registers a language in the convenience singleton registry. */
+export declare function registerLanguage(grammar: Grammar): void;
+/** Registers a theme in the convenience singleton registry. */
+export declare function registerTheme(theme: Theme): void;

package/dist/types/singleton.d.ts

@@ -0,0 +1,11 @@
+import type { Grammar, HighlightOptions, RenderOptions, Theme, Token } from "./core/types.js";
+/** Highlights code through Yuirinx's convenience singleton registry. */
+export declare function highlight(code: string, options: HighlightOptions): string;
+/** Tokenizes code through Yuirinx's convenience singleton registry. */
+export declare function tokenize(code: string, language: string | Grammar): Token[];
+/** Renders tokens through Yuirinx's convenience singleton registry. */
+export declare function render(tokens: readonly Token[], options?: RenderOptions): string;
+/** Registers a language in the convenience singleton registry. */
+export declare function registerLanguage(grammar: Grammar): void;
+/** Registers a theme in the convenience singleton registry. */
+export declare function registerTheme(theme: Theme): void;

package/dist/types/themes/index.d.cts

@@ -0,0 +1,3 @@
+export { yuirinxAurora } from "./yuirinx-aurora.cjs";
+export { yuirinxNoir } from "./yuirinx-noir.cjs";
+export { yuirinxPearl } from "./yuirinx-pearl.cjs";

package/dist/types/themes/index.d.ts

@@ -0,0 +1,3 @@
+export { yuirinxAurora } from "./yuirinx-aurora.js";
+export { yuirinxNoir } from "./yuirinx-noir.js";
+export { yuirinxPearl } from "./yuirinx-pearl.js";

package/dist/types/themes/yuirinx-aurora.d.cts

@@ -0,0 +1,3 @@
+import type { Theme } from "../core/types.cjs";
+/** Expressive showcase theme with aurora-inspired accents and balanced contrast. */
+export declare const yuirinxAurora: Theme;

package/dist/types/themes/yuirinx-aurora.d.ts

@@ -0,0 +1,3 @@
+import type { Theme } from "../core/types.js";
+/** Expressive showcase theme with aurora-inspired accents and balanced contrast. */
+export declare const yuirinxAurora: Theme;

package/dist/types/themes/yuirinx-noir.d.cts

@@ -0,0 +1,3 @@
+import type { Theme } from "../core/types.cjs";
+/** Premium dark theme inspired by ink, glass, and restrained editor contrast. */
+export declare const yuirinxNoir: Theme;

package/dist/types/themes/yuirinx-noir.d.ts

@@ -0,0 +1,3 @@
+import type { Theme } from "../core/types.js";
+/** Premium dark theme inspired by ink, glass, and restrained editor contrast. */
+export declare const yuirinxNoir: Theme;

package/dist/types/themes/yuirinx-pearl.d.cts

@@ -0,0 +1,3 @@
+import type { Theme } from "../core/types.cjs";
+/** Warm, refined light theme designed for documentation and screenshots. */
+export declare const yuirinxPearl: Theme;

package/dist/types/themes/yuirinx-pearl.d.ts

@@ -0,0 +1,3 @@
+import type { Theme } from "../core/types.js";
+/** Warm, refined light theme designed for documentation and screenshots. */
+export declare const yuirinxPearl: Theme;