@miliastry/quasar 1.0.0

package/src/Types/queries.ts

@@ -0,0 +1,121 @@
+/**
+ * DocumentEngine — Query Types
+ *
+ * CSS-inspired query selectors for the document tree.
+ * Enables queries like: `paragraph > bold`, `quote text`, `[color]`
+ */
+
+import type { NodeKind, NodeAttributes } from './core'
+import type { RedNode } from '../Syntax/RedNode'
+
+// ─── Query ─────────────────────────────────────────────────────
+
+export type QuerySelector =
+  | { type: 'kind'; kind: NodeKind }
+  | { type: 'tag'; tag: string }
+  | { type: 'attribute'; name: string; value?: string }
+  | { type: 'has_attribute'; name: string }
+  | { type: 'text'; pattern: string }
+  | { type: 'has_child'; selector: QuerySelector }
+  | { type: 'has_descendant'; selector: QuerySelector }
+  | { type: 'nth_child'; n: number }
+  | { type: 'first_child' }
+  | { type: 'last_child' }
+  | { type: 'position'; min?: number; max?: number }
+  | { type: 'depth'; min?: number; max?: number }
+
+export type QueryCombinator =
+  | 'child'       // >  direct child
+  | 'descendant'  // (space) any descendant
+  | 'adjacent'    // +  next sibling
+  | 'sibling'     // ~  any sibling
+
+export interface QueryStep {
+  selector: QuerySelector[]
+  combinator: QueryCombinator | 'root'
+}
+
+export interface Query {
+  steps: QueryStep[]
+}
+
+export interface QueryMatch {
+  node: RedNode
+  /** How well this node matches (for sorting results) */
+  score: number
+  /** The specific selectors that matched */
+  matchedSelectors: string[]
+}
+
+// ─── Query Builder ─────────────────────────────────────────────
+
+export function query(selector: string): Query {
+  // Parse simple CSS-like selector syntax
+  const parts = selector.split(/\s+(?![^\[]*\])\s*/g).filter(Boolean)
+  const steps: QueryStep[] = []
+  let combinator: QueryCombinator | 'root' = 'root'
+
+  for (const part of parts) {
+    if (part === '>') {
+      combinator = 'child'
+      continue
+    }
+    if (part === '+') {
+      combinator = 'adjacent'
+      continue
+    }
+    if (part === '~') {
+      combinator = 'sibling'
+      continue
+    }
+
+    const selectors: QuerySelector[] = parseSimpleSelector(part)
+    steps.push({ selector: selectors, combinator })
+    combinator = 'descendant'
+  }
+
+  return { steps }
+}
+
+function parseSimpleSelector(part: string): QuerySelector[] {
+  const selectors: QuerySelector[] = []
+
+  // Tag/kind selector
+  const tagMatch = part.match(/^([a-zA-Z_*][a-zA-Z0-9_-]*)/)
+  if (tagMatch) {
+    selectors.push({ type: 'tag', tag: tagMatch[1] })
+  }
+
+  // Attribute selectors: [name], [name=value]
+  const attrRegex = /\[([^\]=]+)(?:=([^\]]*))?\]/g
+  let attrMatch
+  while ((attrMatch = attrRegex.exec(part)) !== null) {
+    if (attrMatch[2] !== undefined) {
+      selectors.push({ type: 'attribute', name: attrMatch[1], value: attrMatch[2] })
+    } else {
+      selectors.push({ type: 'has_attribute', name: attrMatch[1] })
+    }
+  }
+
+  // Pseudo-classes
+  if (part.includes(':first-child')) {
+    selectors.push({ type: 'first_child' })
+  }
+  if (part.includes(':last-child')) {
+    selectors.push({ type: 'last_child' })
+  }
+  const nthMatch = part.match(/:nth-child\((\d+)\)/)
+  if (nthMatch) {
+    selectors.push({ type: 'nth_child', n: parseInt(nthMatch[1], 10) })
+  }
+
+  return selectors
+}
+
+// ─── Query Result ─────────────────────────────────────────────
+
+export interface QueryResult {
+  matches: QueryMatch[]
+  total: number
+  time: number
+}

package/src/Types/symbols.ts

@@ -0,0 +1,69 @@
+/**
+ * DocumentEngine — Symbol Types
+ *
+ * Symbol system for definitions and references in BBCode documents.
+ * Enables: go-to-definition, find-all-references, rename, etc.
+ *
+ * Inspired by Language Server Protocol (LSP).
+ */
+
+import type { NodeId, NodeKind, SourceRange } from './core'
+
+// ─── Symbol Kind ───────────────────────────────────────────────
+
+export type SymbolKind =
+  | 'tag'
+  | 'id_definition'
+  | 'id_reference'
+  | 'class'
+  | 'property'
+  | 'variable'
+  | 'function'
+  | 'module'
+  | 'snippet'
+  | 'template'
+  | 'other'
+
+// ─── Symbol Info ───────────────────────────────────────────────
+
+export interface SymbolInfo {
+  /** Unique ID for this symbol */
+  id: string
+  /** Symbol name (e.g. 'hero', 'my-block') */
+  name: string
+  /** Symbol kind */
+  kind: SymbolKind
+  /** The node that defines this symbol */
+  definitionNodeId: NodeId
+  /** Source range of the definition */
+  definitionRange: SourceRange
+  /** Container node (e.g. the document) */
+  containerNodeId: NodeId
+  /** All references to this symbol */
+  references: Reference[]
+  /** Additional data */
+  data?: Record<string, unknown>
+}
+
+// ─── Reference ─────────────────────────────────────────────────
+
+export interface Reference {
+  nodeId: NodeId
+  range: SourceRange
+  kind: 'definition' | 'reference' | 'implementation'
+}
+
+// ─── Symbol Table ──────────────────────────────────────────────
+
+export interface SymbolTableData {
+  symbols: Map<string, SymbolInfo>
+  /** Quick lookup: node ID → symbol */
+  nodeToSymbol: Map<NodeId, string>
+}
+
+// ─── Symbol Search ─────────────────────────────────────────────
+
+export interface SymbolSearchResult {
+  symbol: SymbolInfo
+  score: number
+}

package/src/Types/tokens.ts

@@ -0,0 +1,186 @@
+/**
+ * DocumentEngine — Token & Trivia Types
+ *
+ * Tokens are the output of the Lexer and input to the Parser.
+ * Trivia is whitespace, newlines, formatting that is preserved
+ * but not semantically meaningful — inspired by Roslyn.
+ */
+
+// ─── Trivia ────────────────────────────────────────────────────
+
+export type TriviaKind =
+  | 'whitespace'
+  | 'newline'
+  | 'carriage_return'
+  | 'comment'
+  | 'line_continuation'
+
+export interface Trivia {
+  kind: TriviaKind
+  text: string
+  range: Range
+}
+
+// ─── Range ─────────────────────────────────────────────────────
+
+export interface Range {
+  start: number
+  end: number
+}
+
+export function range(start: number, end: number): Range {
+  return { start, end }
+}
+
+export function rangeLength(r: Range): number {
+  return r.end - r.start
+}
+
+export function rangeContains(r: Range, pos: number): boolean {
+  return pos >= r.start && pos < r.end
+}
+
+// ─── Token ─────────────────────────────────────────────────────
+
+export type TokenKind =
+  // Structural
+  | 'open_tag'
+  | 'close_tag'
+  | 'self_closing_tag'
+  | 'text'
+  | 'newline'
+  | 'whitespace'
+  // Attribute values (inside tags)
+  | 'attribute_name'
+  | 'attribute_value'
+  | 'equals'
+  | 'quote'
+  // Special
+  | 'end_of_file'
+  | 'error'
+
+export interface Token {
+  kind: TokenKind
+  text: string
+  range: Range
+
+  /** Tag name or attribute name if applicable */
+  name?: string
+
+  /** Full raw tag text including brackets: [b], [/color], [*] */
+  tagText?: string
+
+  /** Raw attribute string (everything between tag name and closing ]) */
+  attrs?: string
+
+  /** Trivia attached BEFORE this token (whitespace, newlines) */
+  leadingTrivia: Trivia[]
+
+  /** Trivia attached AFTER this token */
+  trailingTrivia: Trivia[]
+}
+
+// ─── Token Stream ──────────────────────────────────────────────
+
+export interface TokenStream {
+  /** Peek at the current token without consuming */
+  peek(): Token
+  /** Consume and return the current token, advance */
+  advance(): Token
+  /** Look ahead n tokens (0 = next) */
+  lookAhead(n: number): Token
+  /** Whether we've consumed all tokens */
+  isEof(): boolean
+  /** Get current position in the stream */
+  position(): number
+  /** Reset to a position */
+  seek(pos: number): void
+  /** Get all remaining tokens */
+  remaining(): Token[]
+  /** Get all tokens */
+  getAll(): Token[]
+}
+
+// ─── Token Factory ─────────────────────────────────────────────
+
+export function createToken(
+  kind: TokenKind,
+  text: string,
+  start: number,
+  end: number,
+  options?: {
+    name?: string
+    tagText?: string
+    attrs?: string
+    leadingTrivia?: Trivia[]
+    trailingTrivia?: Trivia[]
+  },
+): Token {
+  return {
+    kind,
+    text,
+    range: range(start, end),
+    name: options?.name,
+    tagText: options?.tagText,
+    attrs: options?.attrs,
+    leadingTrivia: options?.leadingTrivia ?? [],
+    trailingTrivia: options?.trailingTrivia ?? [],
+  }
+}
+
+export function createTrivia(kind: TriviaKind, text: string, start: number, end: number): Trivia {
+  return { kind, text, range: range(start, end) }
+}
+
+// ─── Token Stream Implementation ───────────────────────────────
+
+export class ArrayTokenStream implements TokenStream {
+  private tokens: Token[]
+  private pos: number
+
+  constructor(tokens: Token[]) {
+    this.tokens = tokens
+    this.pos = 0
+  }
+
+  peek(): Token {
+    if (this.pos >= this.tokens.length) {
+      return createToken('end_of_file', '', 0, 0)
+    }
+    return this.tokens[this.pos]
+  }
+
+  advance(): Token {
+    const token = this.peek()
+    this.pos++
+    return token
+  }
+
+  lookAhead(n: number): Token {
+    const idx = this.pos + n
+    if (idx >= this.tokens.length) {
+      return createToken('end_of_file', '', 0, 0)
+    }
+    return this.tokens[idx]
+  }
+
+  isEof(): boolean {
+    return this.pos >= this.tokens.length
+  }
+
+  position(): number {
+    return this.pos
+  }
+
+  seek(pos: number): void {
+    this.pos = Math.max(0, Math.min(pos, this.tokens.length))
+  }
+
+  remaining(): Token[] {
+    return this.tokens.slice(this.pos)
+  }
+
+  getAll(): Token[] {
+    return [...this.tokens]
+  }
+}

package/src/Utils/BBCodeGenerator.ts

@@ -0,0 +1,126 @@
+export type GeneratorTheme = 'forum_post' | 'beatmap_desc' | 'random_chat'
+
+export class BBCodeGenerator {
+  // ── Osu! Dictionaries ──
+  private nouns = ['beatmap', 'circles', 'sliders', 'streams', 'jumps', 'combo', 'PP', 'rank', 'choke', 'mods', 'FC', 'spinner', 'accuracy', 'cursor']
+  private adjectives = ['hard', 'insane', 'unranked', 'ranked', 'loved', 'fast', 'tricky', 'technical', 'smooth', 'impossible']
+  private verbs = ['click', 'hit', 'miss', 'retry', 'pass', 'fail', 'spin', 'farm']
+  private players = ['peppy', 'Cookiezi', 'mrekk', 'Vaxei', 'WhiteCat', 'BTMC']
+  private colors = ['red', 'blue', 'green', 'purple', '#FF5555', '#55FF55']
+
+  private randomInt(max: number): number {
+    return Math.floor(Math.random() * max)
+  }
+
+  private pick<T>(arr: T[]): T {
+    return arr[this.randomInt(arr.length)]
+  }
+
+  // ── Basic Text Generators ──
+
+  private generateSentence(): string {
+    const templates = [
+      `I just got a ${this.pick(this.adjectives)} ${this.pick(this.nouns)} on this map!`,
+      `Why are the ${this.pick(this.nouns)} so ${this.pick(this.adjectives)} here?`,
+      `Don't forget to ${this.pick(this.verbs)} the ${this.pick(this.nouns)}...`,
+      `${this.pick(this.players)} could probably ${this.pick(this.verbs)} this with HardRock.`,
+      `My ${this.pick(this.nouns)} is completely ruined after that ${this.pick(this.nouns)}.`
+    ]
+    return this.pick(templates)
+  }
+
+  private generateParagraph(sentences: number = 3): string {
+    let p = ''
+    for (let i = 0; i < sentences; i++) {
+      p += this.generateSentence() + ' '
+    }
+    return p.trim()
+  }
+
+  // ── Formatted Blocks ──
+
+  private generateHeading(level: 1 | 2 | 3 = 1): string {
+    const text = `${this.pick(this.adjectives)} ${this.pick(this.nouns)}!`
+    const size = level === 1 ? 150 : level === 2 ? 120 : 100
+    return `[size=${size}][b]${text.toUpperCase()}[/b][/size]`
+  }
+
+  private generateHighlight(): string {
+    return `[color=${this.pick(this.colors)}][b]${this.generateSentence()}[/b][/color]`
+  }
+
+  private generateList(items: number = 3): string {
+    let list = '[list]\n'
+    for (let i = 0; i < items; i++) {
+      list += `[*] ${this.pick(this.adjectives)} ${this.pick(this.nouns)}\n`
+    }
+    list += '[/list]'
+    return list
+  }
+
+  private generateNotice(): string {
+    return `[notice]\n[b]Update:[/b] ${this.generateSentence()}\n[/notice]`
+  }
+
+  private generateBox(): string {
+    return `[box=${this.pick(this.nouns)} details]\n${this.generateParagraph(2)}\n[/box]`
+  }
+
+  // ── High-Level Document Templates ──
+
+  public generate(theme: GeneratorTheme = 'forum_post'): string {
+    switch (theme) {
+      case 'forum_post': return this.generateForumPost()
+      case 'beatmap_desc': return this.generateBeatmapDesc()
+      case 'random_chat': return this.generateRandomChat()
+    }
+  }
+
+  private generateForumPost(): string {
+    return `
+${this.generateHeading(1)}
+
+Hey everyone! 
+${this.generateParagraph(3)}
+
+${this.generateHighlight()}
+
+Here is what I think about the ${this.pick(this.nouns)}:
+${this.generateList(4)}
+
+${this.generateBox()}
+
+Thanks for reading!
+[i]- ${this.pick(this.players)}[/i]
+    `.trim()
+  }
+
+  private generateBeatmapDesc(): string {
+    return `
+[center]
+${this.generateHeading(1)}
+[i]Mapped by ${this.pick(this.players)}[/i]
+[/center]
+
+${this.generateNotice()}
+
+[size=120][b]Difficulties[/b][/size]
+${this.generateList(3)}
+
+[size=120][b]Modding[/b][/size]
+${this.generateParagraph(2)}
+If you want to mod, please focus on the ${this.pick(this.adjectives)} ${this.pick(this.nouns)}.
+
+[color=#888888]Enjoy the map![/color]
+    `.trim()
+  }
+
+  private generateRandomChat(): string {
+    return `
+[b]PlayerA:[/b] omg I just had a ${this.pick(this.adjectives)} ${this.pick(this.nouns)}
+[b]PlayerB:[/b] lol really? did you ${this.pick(this.verbs)} it?
+[b]PlayerA:[/b] no... ${this.generateHighlight()}
+[b]PlayerB:[/b] rip your ${this.pick(this.nouns)}.
+    `.trim()
+  }
+}