@enjoys/context-engine 1.0.2 → 1.0.4

package/data/defination/xml.json

@@ -0,0 +1,83 @@
+{
+  "language": "xml",
+  "definitions": {
+    "element": {
+      "signature": "<tag>content</tag>",
+      "description": "An XML element is the basic building block. Elements can contain text, attributes, and other elements.",
+      "type": "structure",
+      "module": "XML 1.0"
+    },
+    "attribute": {
+      "signature": "name=\"value\"",
+      "description": "Attributes provide additional information about elements. Values must be quoted.",
+      "type": "syntax",
+      "module": "XML 1.0"
+    },
+    "namespace": {
+      "signature": "xmlns:prefix=\"URI\"",
+      "description": "XML namespaces prevent element name conflicts by qualifying names with a URI.",
+      "type": "syntax",
+      "module": "XML Namespaces"
+    },
+    "CDATA": {
+      "signature": "<![CDATA[ ... ]]>",
+      "description": "CDATA sections contain text that should not be parsed. Useful for embedding code or special characters.",
+      "type": "structure",
+      "module": "XML 1.0"
+    },
+    "comment": {
+      "signature": "<!-- comment -->",
+      "description": "XML comments are ignored by parsers. Cannot contain the sequence --.",
+      "type": "syntax",
+      "module": "XML 1.0"
+    },
+    "declaration": {
+      "signature": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>",
+      "description": "The XML declaration specifies the XML version and character encoding. Must be the first line.",
+      "type": "syntax",
+      "module": "XML 1.0"
+    },
+    "DOCTYPE": {
+      "signature": "<!DOCTYPE root SYSTEM \"file.dtd\">",
+      "description": "Document Type Declaration defines the document structure and can reference an external DTD.",
+      "type": "syntax",
+      "module": "XML 1.0"
+    },
+    "processing_instruction": {
+      "signature": "<?target data?>",
+      "description": "Processing instructions provide information to the application processing the XML.",
+      "type": "syntax",
+      "module": "XML 1.0"
+    },
+    "well_formed": {
+      "signature": "Well-formed XML rules",
+      "description": "XML must have a single root element, properly nested tags, quoted attributes, and case-sensitive tag names.",
+      "type": "concept",
+      "module": "XML 1.0"
+    },
+    "XPath": {
+      "signature": "//element[@attr='value']",
+      "description": "XPath is a query language for selecting nodes from an XML document. Supports axes, predicates, and functions.",
+      "type": "standard",
+      "module": "XPath 1.0"
+    },
+    "XSLT": {
+      "signature": "xsl:stylesheet",
+      "description": "XSLT is a language for transforming XML documents into other formats (HTML, text, other XML).",
+      "type": "standard",
+      "module": "XSLT 1.0"
+    },
+    "DTD": {
+      "signature": "Document Type Definition",
+      "description": "DTD defines the structure and legal elements/attributes of an XML document. Can be internal or external.",
+      "type": "standard",
+      "module": "XML 1.0"
+    },
+    "XSD": {
+      "signature": "XML Schema Definition",
+      "description": "XSD is an XML-based alternative to DTD for describing the structure of XML documents with data types.",
+      "type": "standard",
+      "module": "XML Schema"
+    }
+  }
+}

package/data/defination/zsh.json

@@ -0,0 +1,113 @@
+{
+  "language": "zsh",
+  "definitions": {
+    "alias": {
+      "signature": "alias name='command'",
+      "description": "Creates a shortcut for a command. Aliases are expanded before execution.",
+      "type": "builtin",
+      "module": "zsh"
+    },
+    "function": {
+      "signature": "fname() { ... }",
+      "description": "Defines a shell function. Functions can accept arguments accessed via $1, $2, etc.",
+      "type": "syntax",
+      "module": "zsh"
+    },
+    "export": {
+      "signature": "export NAME=value",
+      "description": "Sets and exports an environment variable, making it available to child processes.",
+      "type": "builtin",
+      "module": "zsh"
+    },
+    "source": {
+      "signature": "source file",
+      "description": "Read and execute commands from a file in the current shell environment. Also: . file",
+      "type": "builtin",
+      "module": "zsh"
+    },
+    "setopt": {
+      "signature": "setopt OPTION_NAME",
+      "description": "Enable a zsh shell option. Use unsetopt to disable.",
+      "type": "builtin",
+      "module": "zsh"
+    },
+    "autoload": {
+      "signature": "autoload -Uz function",
+      "description": "Mark a function for autoloading. -U suppresses alias expansion, -z forces zsh-style.",
+      "type": "builtin",
+      "module": "zsh"
+    },
+    "bindkey": {
+      "signature": "bindkey 'key' widget",
+      "description": "Bind a key sequence to a ZLE (Zsh Line Editor) widget.",
+      "type": "builtin",
+      "module": "zsh"
+    },
+    "zstyle": {
+      "signature": "zstyle ':pattern' key value",
+      "description": "Set context-sensitive style for the completion system and other modules.",
+      "type": "builtin",
+      "module": "zsh"
+    },
+    "compdef": {
+      "signature": "compdef function command",
+      "description": "Associate a completion function with a command.",
+      "type": "builtin",
+      "module": "zsh/compctl"
+    },
+    "PROMPT": {
+      "signature": "PROMPT='format'",
+      "description": "The primary prompt string. Supports escape sequences: %n (username), %m (hostname), %~ (cwd), %F{color}...%f.",
+      "type": "variable",
+      "module": "zsh"
+    },
+    "RPROMPT": {
+      "signature": "RPROMPT='format'",
+      "description": "Right-side prompt. Disappears when typing reaches it. Useful for git status, time, etc.",
+      "type": "variable",
+      "module": "zsh"
+    },
+    "HISTFILE": {
+      "signature": "HISTFILE=~/.zsh_history",
+      "description": "File where command history is saved.",
+      "type": "variable",
+      "module": "zsh"
+    },
+    "HISTSIZE": {
+      "signature": "HISTSIZE=10000",
+      "description": "Maximum number of history entries kept in memory.",
+      "type": "variable",
+      "module": "zsh"
+    },
+    "SAVEHIST": {
+      "signature": "SAVEHIST=10000",
+      "description": "Maximum number of history entries saved to HISTFILE.",
+      "type": "variable",
+      "module": "zsh"
+    },
+    "ZSH_THEME": {
+      "signature": "ZSH_THEME=\"theme_name\"",
+      "description": "Oh My Zsh theme selector. Set before sourcing oh-my-zsh.sh.",
+      "type": "variable",
+      "module": "Oh My Zsh"
+    },
+    "AUTO_CD": {
+      "signature": "setopt AUTO_CD",
+      "description": "If a command is a directory name, cd into it automatically.",
+      "type": "option",
+      "module": "zsh"
+    },
+    "GLOB_DOTS": {
+      "signature": "setopt GLOB_DOTS",
+      "description": "Include dotfiles in glob patterns without explicitly specifying the dot.",
+      "type": "option",
+      "module": "zsh"
+    },
+    "SHARE_HISTORY": {
+      "signature": "setopt SHARE_HISTORY",
+      "description": "Share history between all running zsh sessions.",
+      "type": "option",
+      "module": "zsh"
+    }
+  }
+}

package/data/hover/awk.json

@@ -0,0 +1,47 @@
+{
+  "language": "awk",
+  "hovers": {
+    "fields": {
+      "contents": [
+        {
+          "value": "```awk\n# input: \"John 30 Engineer\"\n#   $0 = \"John 30 Engineer\"  (whole line)\n#   $1 = \"John\"              (1st field)\n#   $2 = \"30\"                (2nd field)\n#   $NF = \"Engineer\"         (last field)\n#   NF = 3                   (field count)\n```\n**Fields** - Awk splits each line into fields by FS (default: whitespace). Access with `$1`, `$2`, etc."
+        }
+      ]
+    },
+    "pattern_action": {
+      "contents": [
+        {
+          "value": "```awk\n/error/  { print }          # regex match\n$3 > 100 { print $1, $3 }   # field condition\nNR == 1  { print \"Header:\", $0 }\nNR > 1   { sum += $2 }       # skip header\nEND      { print sum }       # final output\n```\n**pattern { action }** is the fundamental awk structure. If pattern matches, action executes. Omit pattern to match all lines."
+        }
+      ]
+    },
+    "arrays": {
+      "contents": [
+        {
+          "value": "```awk\n# Associative arrays (like hash maps)\n{ count[$1]++ }            # count occurrences\n{ total[$1] += $2 }        # sum by group\nEND {\n  for (k in count)\n    print k, count[k]\n}\n\n# Check existence:\nif (\"key\" in arr) ...\ndelete arr[\"key\"]\n```\n**Arrays** are associative (string-indexed). No declaration needed. Use `for (k in arr)` to iterate."
+        }
+      ]
+    },
+    "one_liners": {
+      "contents": [
+        {
+          "value": "```bash\n# Print 2nd column:\nawk '{print $2}' file.txt\n\n# Sum column:\nawk '{s+=$1} END{print s}' data.txt\n\n# CSV with header skip:\nawk -F, 'NR>1 {print $1}' data.csv\n\n# Unique values:\nawk '!seen[$0]++' file.txt\n\n# Replace text:\nawk '{gsub(/old/,\"new\")}1' file.txt\n```\n**One-liners** - awk excels as a command-line data processor. `-F` sets field separator."
+        }
+      ]
+    },
+    "printf": {
+      "contents": [
+        {
+          "value": "```awk\nprintf \"%-20s %5d %8.2f\\n\", $1, $2, $3\n\n# Format specifiers:\n# %s   string      %-20s  left-aligned, 20 wide\n# %d   integer     %5d    right-aligned, 5 wide\n# %f   float       %8.2f  8 wide, 2 decimal\n# %x   hex         %o     octal\n```\n**printf** provides C-style formatted output. Unlike print, it does NOT add a newline automatically."
+        }
+      ]
+    },
+    "built_in_vars": {
+      "contents": [
+        {
+          "value": "```awk\nNR     # total record (line) number\nFNR    # record number in current file\nNF     # number of fields in current line\nFS     # input field separator (default: space)\nOFS    # output field separator (default: space)\nRS     # input record separator (default: newline)\nORS    # output record separator (default: newline)\nFILENAME  # current input filename\n```\n**Built-in variables** control how awk reads and writes data."
+        }
+      ]
+    }
+  }
+}

package/data/hover/crontab.json

@@ -0,0 +1,47 @@
+{
+  "language": "crontab",
+  "hovers": {
+    "format": {
+      "contents": [
+        {
+          "value": "```\n# .---------------- minute (0-59)\n# |  .------------- hour (0-23)\n# |  |  .---------- day of month (1-31)\n# |  |  |  .------- month (1-12 or jan-dec)\n# |  |  |  |  .---- day of week (0-7 or sun-sat)\n# |  |  |  |  |\n  *  *  *  *  *  command\n```\n**Cron expression** has 5 time fields followed by the command. Fields support `*`, ranges (`1-5`), lists (`1,3,5`), and steps (`*/5`)."
+        }
+      ]
+    },
+    "examples": {
+      "contents": [
+        {
+          "value": "```cron\n*/5 * * * *     # every 5 minutes\n0 */2 * * *     # every 2 hours\n0 9 * * 1-5     # weekdays at 9 AM\n0 0 1 * *       # monthly (1st at midnight)\n0 0 * * 0       # weekly (Sunday midnight)\n30 2 * * *      # daily at 2:30 AM\n```\n**Common schedules** - The most frequently used cron patterns for server tasks."
+        }
+      ]
+    },
+    "special": {
+      "contents": [
+        {
+          "value": "```cron\n@reboot   command    # run once at startup\n@hourly   command    # 0 * * * *\n@daily    command    # 0 0 * * *\n@weekly   command    # 0 0 * * 0\n@monthly  command    # 0 0 1 * *\n@yearly   command    # 0 0 1 1 *\n```\n**Special strings** are shortcuts for common schedules. `@reboot` is particularly useful for startup tasks."
+        }
+      ]
+    },
+    "logging": {
+      "contents": [
+        {
+          "value": "```cron\n# Log stdout and stderr to file:\n0 2 * * * /opt/backup.sh >> /var/log/backup.log 2>&1\n\n# Silence output:\n0 * * * * /opt/check.sh > /dev/null 2>&1\n\n# Email output:\nMAILTO=admin@example.com\n```\n**Logging** - Redirect output to files. Without redirection, cron emails output to MAILTO."
+        }
+      ]
+    },
+    "PATH": {
+      "contents": [
+        {
+          "value": "```cron\n# Cron has minimal PATH by default!\n# Always set PATH or use absolute paths:\nPATH=/usr/local/bin:/usr/bin:/bin\n\n# Or use absolute command paths:\n0 * * * * /usr/local/bin/node /opt/app/task.js\n```\n**PATH** - Cron's default PATH is minimal. Commands that work in your shell may fail in cron without setting PATH."
+        }
+      ]
+    },
+    "flock": {
+      "contents": [
+        {
+          "value": "```cron\n# Prevent overlapping runs:\n*/5 * * * * flock -n /tmp/myjob.lock /opt/slow-task.sh\n\n# With timeout:\n*/5 * * * * flock -w 10 /tmp/myjob.lock /opt/task.sh\n```\n**flock** prevents concurrent execution. Use `-n` to skip if locked, `-w N` to wait up to N seconds."
+        }
+      ]
+    }
+  }
+}

package/data/hover/dotenv.json

@@ -0,0 +1,47 @@
+{
+  "language": "dotenv",
+  "hovers": {
+    "variable": {
+      "contents": [
+        {
+          "value": "```bash\nKEY=value\nDATABASE_URL=postgres://localhost/mydb\nPORT=3000\n```\n**Environment variables** are key-value pairs. No spaces around `=`. Values are strings by default. Apps parse types themselves."
+        }
+      ]
+    },
+    "comment": {
+      "contents": [
+        {
+          "value": "```bash\n# This is a comment\n# DATABASE_URL=old-value  # disabled\n```\n**Comments** start with `#`. Used for documentation and temporarily disabling variables."
+        }
+      ]
+    },
+    "quoted": {
+      "contents": [
+        {
+          "value": "```bash\nSINGLE='literal $value'\nDOUBLE=\"expanded ${VAR}\"\nUNQUOTED=no-spaces-allowed\n```\n**Quoting** rules: Single quotes are literal. Double quotes allow variable expansion. Unquoted values end at whitespace/newline."
+        }
+      ]
+    },
+    "DATABASE_URL": {
+      "contents": [
+        {
+          "value": "```bash\n# PostgreSQL\nDATABASE_URL=postgres://user:pass@host:5432/db\n# MySQL\nDATABASE_URL=mysql://user:pass@host:3306/db\n# SQLite\nDATABASE_URL=sqlite:///path/to/db.sqlite3\n```\n**DATABASE_URL** is the standard connection string format used by ORMs and database tools."
+        }
+      ]
+    },
+    "security": {
+      "contents": [
+        {
+          "value": "```bash\n# .gitignore:\n.env\n.env.local\n.env.*.local\n\n# .env.example (commit this):\nDATABASE_URL=\nAPI_KEY=\nSECRET_KEY=\n```\n**Security** - Never commit `.env` files with secrets. Use `.env.example` as a template for required variables."
+        }
+      ]
+    },
+    "loading": {
+      "contents": [
+        {
+          "value": "```bash\n# Load order (typical):\n# 1. .env              (shared defaults)\n# 2. .env.local        (local overrides)\n# 3. .env.development  (environment-specific)\n# 4. .env.development.local\n```\n**Loading priority** varies by framework. Later files override earlier ones. System env vars usually take highest priority."
+        }
+      ]
+    }
+  }
+}