gcyphrq 0.12.6

package/dist/types/cypher.d.ts

@@ -0,0 +1,139 @@
+export type CypherLiteral = string | number | boolean | null;
+export interface CypherNode {
+    id: string;
+    label?: string;
+    [key: string]: CypherLiteral | undefined;
+}
+export interface CypherEdge {
+    id: string;
+    type?: string;
+    [key: string]: CypherLiteral | undefined;
+}
+/**
+ * Pre-computed indexes for fast node/edge lookup during query execution.
+ * Built once at graph construction time, used by the engine to avoid
+ * full-graph scans during MATCH, WHERE, and traversal.
+ *
+ * Note: property values are coerced to strings via `String(value)`, so
+ * `true`/`false` become `"true"`/`"false"` and `0` becomes `"0"`.
+ */
+export interface GraphIndexes {
+    /** label → set of node IDs */
+    labelIndex: Map<string, Set<string>>;
+    /** propertyKey → propertyValue → set of node IDs (values are string-coerced) */
+    propertyIndex: Map<string, Map<string, Set<string>>>;
+    /**
+     * Edge-type adjacency index.
+     * out[type][source] = set of { target, edgeId } for outgoing edges
+     * in[type][target] = set of { source, edgeId } for incoming edges
+     */
+    edgeTypeIndex: {
+        out: Map<string, Map<string, Array<{
+            target: string;
+            edgeId: string;
+        }>>>;
+        in: Map<string, Map<string, Array<{
+            source: string;
+            edgeId: string;
+        }>>>;
+    };
+}
+export type CypherValue = CypherNode | CypherEdge[] | CypherLiteral | null | undefined;
+export type Direction = 'OUT' | 'IN' | 'UNDIRECTED';
+export interface NodePattern {
+    variable: string;
+    label: string | undefined;
+    properties: Record<string, CypherLiteral> | undefined;
+}
+export interface RelationPattern {
+    variable: string | undefined;
+    type: string | undefined;
+    minDepth: number | undefined;
+    maxDepth: number | undefined;
+    direction: Direction;
+}
+export interface MatchClause {
+    optional: boolean;
+    hasChains: boolean;
+    sourcePattern: NodePattern;
+    relationPattern: RelationPattern;
+    targetPattern: NodePattern;
+}
+export interface CreateClause {
+    type: 'CREATE';
+    variable: string;
+    label: string | undefined;
+    properties: Record<string, CypherLiteral> | undefined;
+}
+export interface DeleteClause {
+    type: 'DELETE';
+    variable: string;
+}
+export interface SetClause {
+    type: 'SET';
+    variable: string;
+    property: string;
+    value: CypherLiteral;
+}
+export type WriteClause = CreateClause | DeleteClause | SetClause;
+export interface PropertyAccessExpression {
+    type: 'PropertyAccess';
+    variable: string;
+    property: string | undefined;
+}
+export interface LiteralExpression {
+    type: 'Literal';
+    value: CypherLiteral;
+}
+export interface AggregationExpression {
+    type: 'Aggregation';
+    aggregationType: 'COUNT' | 'SUM' | 'AVG' | 'MIN' | 'MAX';
+    variable: string;
+    property: string | undefined;
+}
+export type Expression = PropertyAccessExpression | LiteralExpression | AggregationExpression;
+export interface BinaryExpression {
+    type: 'BinaryExpression';
+    operator: '>' | '<' | '=' | 'CONTAINS';
+    left: Expression;
+    right: Expression;
+}
+export interface Projection {
+    expression: Expression;
+    alias: string;
+}
+export interface WithClause {
+    projections: Projection[];
+    where: BinaryExpression | undefined;
+    orderBy: OrderByItem[] | undefined;
+    skip: number | undefined;
+    limit: number | undefined;
+}
+export interface OrderByItem {
+    expression: Expression;
+    direction: 'ASC' | 'DESC';
+}
+export interface ReturnClause {
+    projections: Projection[];
+    orderBy: OrderByItem[] | undefined;
+    skip: number | undefined;
+    limit: number | undefined;
+}
+export type Stage = {
+    type: 'MATCH';
+    clause: MatchClause;
+} | {
+    type: 'WITH';
+    clause: WithClause;
+} | {
+    type: 'WRITE';
+    clause: WriteClause;
+};
+export interface AdvancedCypherAST {
+    type: 'Query';
+    stages: Stage[];
+    return: ReturnClause | undefined;
+}
+export type QueryContext = Record<string, CypherNode | CypherEdge[] | CypherLiteral | null | undefined>;
+export type ResultRow = Record<string, CypherNode | CypherEdge[] | CypherLiteral | null | undefined>;
+//# sourceMappingURL=cypher.d.ts.map

package/dist/types/cypher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cypher.d.ts","sourceRoot":"","sources":["../../src/types/cypher.ts"],"names":[],"mappings":"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"}

package/docs/404.md

@@ -0,0 +1,11 @@
+---
+layout: default
+title: 404 – Page Not Found
+permalink: /404/
+---
+
+# 404 – Page Not Found
+
+The page you're looking for doesn't exist or has been moved.
+
+<a href="{{ '/' | relative_url }}" class="btn btn-primary">Back to Home →</a>

package/docs/_config.yml

@@ -0,0 +1,42 @@
+title: gcyphrq
+description: A Cypher graph query engine for in-memory graphs built on Graphology. Available as a CLI tool and Node.js library.
+url: "https://plelevier.github.io"
+baseurl: "/gcyphrq"
+repository: "plelevier/gcyphrq"
+
+permalink: pretty
+
+markdown: kramdown
+kramdown:
+  syntax_highlighter: rouge
+  syntax_highlighter_opts:
+    css_class: 'highlight'
+    span:
+      line_numbers: false
+    block:
+      line_numbers: false
+      start_line: 1
+
+plugins: []
+
+# Navigation
+nav:
+  - title: Getting Started
+    url: /getting-started/
+  - title: CLI Reference
+    url: /cli/
+  - title: Library API
+    url: /library-api/
+  - title: Query Guide
+    url: /query-guide/
+  - title: Examples
+    url: /examples/
+  - title: Skill Guide
+    url: /skill/
+  - title: GitHub
+    url: https://github.com/plelevier/gcyphrq
+    external: true
+
+# Site settings
+version: 0.11.0
+node_version: ">=20"

package/docs/_includes/footer.html

@@ -0,0 +1,6 @@
+<footer class="site-footer">
+  <div class="container">
+    <p>{{ site.title }} is released under the <a href="https://github.com/{{ site.repository }}/blob/main/LICENSE">MIT License</a>.</p>
+    <p>Built with <a href="https://graphology.github.io/">Graphology</a> and <a href="https://www.antlr.org/">ANTLR4</a>.</p>
+  </div>
+</footer>

package/docs/_includes/head.html

@@ -0,0 +1,13 @@
+<meta name="description" content="{{ page.description | default: site.description }}">
+<link rel="icon" href="{{ '/assets/favicon.svg' | relative_url }}" type="image/svg+xml">
+
+<!-- Open Graph -->
+<meta property="og:title" content="{% if page.title %}{{ page.title }} – {% endif %}{{ site.title }}">
+<meta property="og:description" content="{{ page.description | default: site.description }}">
+<meta property="og:type" content="website">
+<meta property="og:url" content="{{ page.url | absolute_url }}">
+
+<!-- Twitter -->
+<meta name="twitter:card" content="summary">
+<meta name="twitter:title" content="{% if page.title %}{{ page.title }} – {% endif %}{{ site.title }}">
+<meta name="twitter:description" content="{{ page.description | default: site.description }}">

package/docs/_includes/nav.html

@@ -0,0 +1,23 @@
+<header class="site-header">
+  <div class="container">
+    <a href="{{ '/' | relative_url }}" class="logo">
+      <span class="logo-icon">◈</span>
+      <span class="logo-text">{{ site.title }} <small>v{{ site.version }}</small></span>
+    </a>
+    <nav class="main-nav">
+      <input type="checkbox" id="nav-toggle" class="nav-toggle">
+      <label for="nav-toggle" class="nav-toggle-label" aria-label="Toggle navigation">
+        <span></span><span></span><span></span>
+      </label>
+      <ul>
+        {% for item in site.nav %}
+        <li>
+          <a href="{{ item.url | relative_url }}" {% if item.external %}target="_blank" rel="noopener noreferrer"{% endif %} class="{% if page.url == item.url | relative_url %}active{% endif %}">
+            {{ item.title }}{% if item.external %} <span class="external-icon">↗</span>{% endif %}
+          </a>
+        </li>
+        {% endfor %}
+      </ul>
+    </nav>
+  </div>
+</header>

package/docs/_layouts/default.html

@@ -0,0 +1,20 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>{% if page.title %}{{ page.title }} – {% endif %}{{ site.title }}</title>
+  <link rel="stylesheet" href="{{ '/assets/main.css' | relative_url }}">
+  {% include head.html %}
+</head>
+<body>
+  {% include nav.html %}
+  <main class="content">
+    <div class="container">
+      {{ content }}
+    </div>
+  </main>
+  {% include footer.html %}
+  <script src="{{ '/assets/cypher-highlight.js' | relative_url }}"></script>
+</body>
+</html>

package/docs/assets/cypher-highlight.js

@@ -0,0 +1,171 @@
+// Lightweight Cypher keyword highlighter + copy buttons for code blocks
+document.addEventListener('DOMContentLoaded', () => {
+  // Highlight Cypher keywords
+  // Rouge wraps code blocks: div.language-cypher > div.highlight > pre.highlight > code
+  // We must only replace the <code> innerHTML to preserve the .highlight wrapper (background + CSS)
+  document.querySelectorAll('.language-cypher').forEach(el => {
+    const code = el.querySelector('code');
+    if (!code) return;
+    const text = code.textContent;
+    const tokens = tokenize(text);
+    code.innerHTML = tokens.map(t => {
+      if (t.type === 'keyword') return `<span class="cy-kw">${t.text}</span>`;
+      if (t.type === 'function') return `<span class="cy-fn">${t.text}</span>`;
+      if (t.type === 'label') return `<span class="cy-label">${t.text}</span>`;
+      if (t.type === 'reltype') return `<span class="cy-rel">${t.text}</span>`;
+      if (t.type === 'string') return `<span class="cy-str">${t.text}</span>`;
+      if (t.type === 'number') return `<span class="cy-num">${t.text}</span>`;
+      if (t.type === 'comment') return `<span class="cy-cmt">${t.text}</span>`;
+      return escapeHtml(t.text);
+    }).join('');
+  });
+
+  // Add copy button to every code block
+  // Target the outermost .highlight div (the one that is a direct child of .highlighter-rouge)
+  document.querySelectorAll('.highlighter-rouge > .highlight').forEach(block => {
+    const btn = document.createElement('button');
+    btn.className = 'code-copy-btn';
+    btn.type = 'button';
+    btn.title = 'Copy';
+    btn.innerHTML = `<svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><rect x="9" y="9" width="13" height="13" rx="2"/><path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1"/></svg>`;
+
+    // Wrap block + btn in a relative container
+    const wrapper = document.createElement('div');
+    wrapper.className = 'code-block-wrapper';
+    block.parentNode.replaceChild(wrapper, block);
+    wrapper.appendChild(block);
+    wrapper.appendChild(btn);
+
+    btn.addEventListener('click', () => {
+      const code = block.querySelector('code') || block;
+      const text = code.textContent.trim();
+      if (navigator.clipboard && navigator.clipboard.writeText) {
+        navigator.clipboard.writeText(text).then(() => {
+          btn.classList.add('copied');
+          setTimeout(() => btn.classList.remove('copied'), 1500);
+        });
+      } else {
+        // Fallback for non-HTTPS (local dev)
+        const ta = document.createElement('textarea');
+        ta.value = text;
+        ta.style.position = 'fixed';
+        ta.style.opacity = '0';
+        document.body.appendChild(ta);
+        ta.select();
+        document.execCommand('copy');
+        document.body.removeChild(ta);
+        btn.classList.add('copied');
+        setTimeout(() => btn.classList.remove('copied'), 1500);
+      }
+    });
+  });
+});
+
+function tokenize(src) {
+  const tokens = [];
+  const keywords = new Set([
+    'MATCH', 'OPTIONAL', 'UNWIND', 'RETURN', 'WITH', 'WHERE',
+    'CREATE', 'MERGE', 'SET', 'DELETE', 'REMOVE', 'FOREACH',
+    'ORDER', 'BY', 'ASC', 'DESC', 'SKIP', 'LIMIT',
+    'ON', 'UPDATE',
+    'AND', 'OR', 'XOR', 'NOT', 'IN', 'IS', 'NULL', 'TRUE', 'FALSE',
+    'AS', 'CASE', 'WHEN', 'THEN', 'ELSE', 'END',
+    'STARTS', 'ENDS', 'CONTAINS',
+  ]);
+  const functions = new Set([
+    'count', 'sum', 'min', 'max', 'avg', 'collect',
+    'head', 'tail', 'size', 'id', 'labels', 'properties',
+    'type', 'nodes', 'relationships',
+    'toString', 'toInt', 'toFloat', 'toBoolean',
+    'coalesce', 'exists',
+  ]);
+
+  let i = 0;
+  while (i < src.length) {
+    // Comments
+    if (src[i] === '/' && src[i + 1] === '/') {
+      let end = src.indexOf('\n', i);
+      if (end === -1) end = src.length;
+      tokens.push({ type: 'comment', text: src.slice(i, end) });
+      i = end;
+      continue;
+    }
+
+    // Strings (single or double quoted)
+    if (src[i] === "'" || src[i] === '"') {
+      const quote = src[i];
+      let j = i + 1;
+      while (j < src.length && src[j] !== quote) {
+        if (src[j] === '\\') j++; // skip escaped char
+        j++;
+      }
+      j++; // closing quote
+      tokens.push({ type: 'string', text: src.slice(i, j) });
+      i = j;
+      continue;
+    }
+
+    // Numbers
+    if (/[0-9]/.test(src[i]) && (i === 0 || /[\s(,<>!=+\-*\/]/.test(src[i - 1]))) {
+      let j = i;
+      while (j < src.length && /[0-9.]/.test(src[j])) j++;
+      tokens.push({ type: 'number', text: src.slice(i, j) });
+      i = j;
+      continue;
+    }
+
+    // Labels :Label
+    if (src[i] === ':' && i + 1 < src.length && /[A-Za-z_]/.test(src[i + 1])) {
+      let j = i + 1;
+      while (j < src.length && /[A-Za-z_0-9]/.test(src[j])) j++;
+      tokens.push({ type: 'label', text: src.slice(i, j) });
+      i = j;
+      continue;
+    }
+
+    // Relationship types -[TYPE]-> or :TYPE
+    if (src[i] === '-' && src[i + 1] === '[') {
+      // Find the relationship type
+      let j = i + 2;
+      // skip whitespace
+      while (j < src.length && /\s/.test(src[j])) j++;
+      if (j < src.length && (src[j] === '>' || src[j] === '<' || /[A-Za-z_]/.test(src[j]))) {
+        if (/[A-Za-z_]/.test(src[j])) {
+          let k = j;
+          while (k < src.length && /[A-Za-z_0-9]/.test(src[k])) k++;
+          tokens.push({ type: 'text', text: src.slice(i, j) });
+          tokens.push({ type: 'reltype', text: src.slice(j, k) });
+          i = k;
+          continue;
+        }
+      }
+    }
+
+    // Identifiers / keywords / functions
+    if (/[A-Za-z_]/.test(src[i])) {
+      let j = i;
+      while (j < src.length && /[A-Za-z_0-9]/.test(src[j])) j++;
+      const word = src.slice(i, j);
+      const upper = word.toUpperCase();
+      if (keywords.has(upper)) {
+        tokens.push({ type: 'keyword', text: word });
+      } else if (functions.has(word.toLowerCase()) && j < src.length && src[j] === '(') {
+        tokens.push({ type: 'function', text: word });
+      } else {
+        tokens.push({ type: 'text', text: word });
+      }
+      i = j;
+      continue;
+    }
+
+    // Everything else
+    tokens.push({ type: 'text', text: src[i] });
+    i++;
+  }
+
+  return tokens;
+}
+
+function escapeHtml(s) {
+  return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}

package/docs/assets/favicon.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 32 32">
+  <rect width="32" height="32" rx="6" fill="#4f46e5"/>
+  <text x="16" y="23" text-anchor="middle" fill="#fff" font-family="sans-serif" font-size="20" font-weight="bold">◈</text>
+</svg>