@enjoys/context-engine 1.3.1 → 1.4.2

package/data/hover/dotenv.json

@@ -4,7 +4,7 @@
     "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."
+          "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."
         }
       ]
     },
@@ -18,7 +18,21 @@
     "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."
+          "value": "```bash\nSINGLE='literal $value'\nDOUBLE=\"expanded ${VAR}\"\nUNQUOTED=no-spaces-allowed\n```\n**Quoting** — Single quotes are literal. Double quotes expand variables. Unquoted values end at whitespace."
+        }
+      ]
+    },
+    "interpolation": {
+      "contents": [
+        {
+          "value": "```bash\nBASE_URL=https://api.example.com\nAPI_URL=${BASE_URL}/v1\nFULL_URL=${API_URL}/users\n```\n**Variable interpolation** uses `${VAR}` inside double-quoted or unquoted values. Not all dotenv libraries support this."
+        }
+      ]
+    },
+    "multiline": {
+      "contents": [
+        {
+          "value": "```bash\nPRIVATE_KEY=\"-----BEGIN RSA PRIVATE KEY-----\nMIIEpAIBAAKCAQEA...\n-----END RSA PRIVATE KEY-----\"\n```\n**Multiline values** use double quotes. Newlines inside quotes are preserved."
         }
       ]
     },
@@ -32,14 +46,238 @@
     "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."
+          "value": "```bash\n# .gitignore:\n.env\n.env.local\n.env.*.local\n\n# .env.example (commit this):\nDATABASE_URL=\nAPI_KEY=\n```\n**Security** — Never commit `.env` files with secrets. Use `.env.example` as a template."
         }
       ]
     },
     "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."
+          "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. System env vars usually take highest priority."
+        }
+      ]
+    },
+    "PORT": {
+      "contents": [
+        {
+          "value": "```bash\nPORT=3000\n```\n**PORT** specifies the network port for the application server. Common default: 3000 (Node), 8000 (Python), 8080 (Java)."
+        }
+      ]
+    },
+    "NODE_ENV": {
+      "contents": [
+        {
+          "value": "```bash\nNODE_ENV=development\nNODE_ENV=production\nNODE_ENV=test\n```\n**NODE_ENV** controls the Node.js runtime mode. `production` enables optimizations and disables dev tools."
+        }
+      ]
+    },
+    "API_KEY": {
+      "contents": [
+        {
+          "value": "```bash\nAPI_KEY=sk_live_abc123def456\nSTRIPE_SECRET_KEY=sk_test_...\n```\n**API_KEY** stores third-party service credentials. Never commit to version control."
+        }
+      ]
+    },
+    "SECRET_KEY": {
+      "contents": [
+        {
+          "value": "```bash\nSECRET_KEY=your-256-bit-secret\nJWT_SECRET=randomly-generated-string\n```\n**SECRET_KEY** is used for cryptographic signing (sessions, JWTs). Generate with a secure random method."
+        }
+      ]
+    },
+    "DEBUG": {
+      "contents": [
+        {
+          "value": "```bash\nDEBUG=true\nDEBUG=app:*,http\nDEBUG=false\n```\n**DEBUG** enables debug mode. Some frameworks use boolean, others use namespace patterns (e.g., Express debug module)."
+        }
+      ]
+    },
+    "LOG_LEVEL": {
+      "contents": [
+        {
+          "value": "```bash\nLOG_LEVEL=debug\nLOG_LEVEL=info\nLOG_LEVEL=warn\nLOG_LEVEL=error\n```\n**LOG_LEVEL** controls logging verbosity. Common levels: `debug`, `info`, `warn`, `error`, `fatal`."
+        }
+      ]
+    },
+    "HOST": {
+      "contents": [
+        {
+          "value": "```bash\nHOST=0.0.0.0\nHOST=localhost\nHOST=127.0.0.1\n```\n**HOST** specifies the network interface to bind. `0.0.0.0` listens on all interfaces, `localhost` only local."
+        }
+      ]
+    },
+    "REDIS_URL": {
+      "contents": [
+        {
+          "value": "```bash\nREDIS_URL=redis://localhost:6379\nREDIS_URL=redis://:password@host:6379/0\nREDIS_URL=rediss://host:6380  # TLS\n```\n**REDIS_URL** connection string for Redis. `rediss://` for TLS connections."
+        }
+      ]
+    },
+    "SMTP": {
+      "contents": [
+        {
+          "value": "```bash\nSMTP_HOST=smtp.gmail.com\nSMTP_PORT=587\nSMTP_USER=user@gmail.com\nSMTP_PASS=app-password\nSMTP_FROM=noreply@example.com\n```\n**SMTP** variables configure email sending. Use app-specific passwords, not account passwords."
+        }
+      ]
+    },
+    "AWS": {
+      "contents": [
+        {
+          "value": "```bash\nAWS_ACCESS_KEY_ID=AKIA...\nAWS_SECRET_ACCESS_KEY=...\nAWS_DEFAULT_REGION=us-east-1\nAWS_S3_BUCKET=my-bucket\n```\n**AWS** environment variables are recognized by the AWS SDK automatically. IAM roles are preferred for production."
+        }
+      ]
+    },
+    "CORS": {
+      "contents": [
+        {
+          "value": "```bash\nCORS_ORIGIN=https://example.com\nCORS_ORIGINS=https://example.com,https://app.example.com\nCORS_CREDENTIALS=true\n```\n**CORS** settings control Cross-Origin Resource Sharing. Comma-separated for multiple origins."
+        }
+      ]
+    },
+    "ALLOWED_HOSTS": {
+      "contents": [
+        {
+          "value": "```bash\nALLOWED_HOSTS=example.com,www.example.com\nALLOWED_HOSTS=*\n```\n**ALLOWED_HOSTS** (Django/similar) restricts which hostnames the server responds to. `*` allows all (insecure in production)."
+        }
+      ]
+    },
+    "TZ": {
+      "contents": [
+        {
+          "value": "```bash\nTZ=UTC\nTZ=America/New_York\nTZ=Europe/London\n```\n**TZ** sets the timezone. Use IANA timezone names. `UTC` is recommended for servers."
+        }
+      ]
+    },
+    "LANG": {
+      "contents": [
+        {
+          "value": "```bash\nLANG=en_US.UTF-8\n```\n**LANG** sets the locale for language and character encoding."
+        }
+      ]
+    },
+    "BASE_URL": {
+      "contents": [
+        {
+          "value": "```bash\nBASE_URL=https://api.example.com\nNEXT_PUBLIC_BASE_URL=https://example.com\nVITE_API_URL=https://api.example.com\n```\n**BASE_URL** is the root URL for the application. Prefix conventions: `NEXT_PUBLIC_` (Next.js), `VITE_` (Vite) for client-side exposure."
+        }
+      ]
+    },
+    "NEXT_PUBLIC": {
+      "contents": [
+        {
+          "value": "```bash\n# Exposed to browser (Next.js):\nNEXT_PUBLIC_API_URL=https://api.example.com\nNEXT_PUBLIC_GA_ID=G-XXXXXXX\n\n# Server-only (not exposed):\nDATABASE_URL=postgresql://...\n```\n**NEXT_PUBLIC_** prefix exposes variables to the browser in Next.js. Without prefix, variables are server-only."
+        }
+      ]
+    },
+    "VITE_prefix": {
+      "contents": [
+        {
+          "value": "```bash\n# Exposed to browser (Vite):\nVITE_API_URL=https://api.example.com\nVITE_APP_TITLE=My App\n\n# Server-only:\nDB_PASSWORD=secret\n```\n**VITE_** prefix exposes variables to the browser in Vite projects via `import.meta.env.VITE_*`."
+        }
+      ]
+    },
+    "REACT_APP": {
+      "contents": [
+        {
+          "value": "```bash\n# Create React App:\nREACT_APP_API_URL=https://api.example.com\nREACT_APP_VERSION=$npm_package_version\n```\n**REACT_APP_** prefix exposes variables in Create React App via `process.env.REACT_APP_*`."
+        }
+      ]
+    },
+    "empty_value": {
+      "contents": [
+        {
+          "value": "```bash\nVAR=          # empty string\nVAR=\"\"        # empty string (explicit)\n# VAR         # not set (commented)\n```\n**Empty values** — An empty value (`=` with nothing after) is different from an unset variable."
+        }
+      ]
+    },
+    "escape": {
+      "contents": [
+        {
+          "value": "```bash\nQUOTE_VAR=\"value with \\\"quotes\\\"\"\nNEWLINE_VAR=\"line1\\nline2\"\nDOLLAR_VAR='price is $5'\n```\n**Escape sequences** — Use `\\\"` for quotes in double-quoted values. Single quotes prevent all interpretation."
+        }
+      ]
+    },
+    "export": {
+      "contents": [
+        {
+          "value": "```bash\nexport DATABASE_URL=postgres://localhost/mydb\nexport API_KEY=abc123\n```\n**export** prefix is optional and ignored by most dotenv libraries. Included for shell compatibility."
+        }
+      ]
+    },
+    "dotenv_cli": {
+      "contents": [
+        {
+          "value": "```bash\n# Load .env and run command:\ndotenv run -- npm start\nnpx dotenv -e .env.local -- node app.js\nenv $(cat .env | xargs) node app.js\n```\n**dotenv CLI** loads .env files before executing a command. Useful for tools that don't load .env natively."
+        }
+      ]
+    },
+    "docker": {
+      "contents": [
+        {
+          "value": "```bash\n# docker-compose.yml:\n# env_file:\n#   - .env\n#   - .env.local\n\n# docker run --env-file .env myimage\n```\n**Docker** can load .env files directly via `--env-file` flag or `env_file` in compose."
+        }
+      ]
+    },
+    "override": {
+      "contents": [
+        {
+          "value": "```bash\n# System environment variables override .env:\n# export PORT=8080  (takes precedence)\n# .env: PORT=3000   (only used if not already set)\n```\n**Override behavior** — Most dotenv libraries don't replace existing env vars. System vars take precedence."
+        }
+      ]
+    },
+    "vault": {
+      "contents": [
+        {
+          "value": "```bash\n# Instead of .env files in production, use:\n# - HashiCorp Vault\n# - AWS Secrets Manager\n# - Azure Key Vault\n# - GCP Secret Manager\n# - 1Password CLI\nDATABASE_URL=op://vault/db/url  # 1Password reference\n```\n**Secret management** — In production, use dedicated secret managers instead of .env files."
+        }
+      ]
+    },
+    "encoding": {
+      "contents": [
+        {
+          "value": "```bash\n# .env files should be UTF-8 encoded\n# Most parsers expect Unix-style line endings (LF)\n# Windows CRLF is usually handled but can cause issues\n```\n**Encoding** — Use UTF-8 with LF line endings for maximum compatibility."
+        }
+      ]
+    },
+    "CI_CD": {
+      "contents": [
+        {
+          "value": "```bash\n# CI/CD variables (set in pipeline settings):\nCI=true\nCI_COMMIT_SHA=abc123\nGITHUB_TOKEN=ghp_...\nNPM_TOKEN=npm_...\n```\n**CI/CD variables** are set by the pipeline environment, not .env files. Never store CI secrets in .env."
+        }
+      ]
+    },
+    "SENTRY_DSN": {
+      "contents": [
+        {
+          "value": "```bash\nSENTRY_DSN=https://abc@sentry.io/123\n```\n**SENTRY_DSN** configures error tracking with Sentry. The DSN (Data Source Name) identifies your project."
+        }
+      ]
+    },
+    "GOOGLE_OAUTH": {
+      "contents": [
+        {
+          "value": "```bash\nGOOGLE_CLIENT_ID=xxx.apps.googleusercontent.com\nGOOGLE_CLIENT_SECRET=GOCSPX-...\nGOOGLE_CALLBACK_URL=http://localhost:3000/auth/callback\n```\n**OAuth credentials** for Google authentication. Keep client secret out of version control."
+        }
+      ]
+    },
+    "MONGO_URI": {
+      "contents": [
+        {
+          "value": "```bash\nMONGO_URI=mongodb://localhost:27017/mydb\nMONGO_URI=mongodb+srv://user:pass@cluster.mongodb.net/mydb\n```\n**MONGO_URI** connection string for MongoDB. `mongodb+srv://` for Atlas cloud clusters."
+        }
+      ]
+    },
+    "S3_ENDPOINT": {
+      "contents": [
+        {
+          "value": "```bash\nS3_BUCKET=my-bucket\nS3_REGION=us-east-1\nS3_ENDPOINT=https://s3.us-east-1.amazonaws.com\n```\n**S3 configuration** for file storage. Custom endpoint allows using S3-compatible services (MinIO, R2)."
+        }
+      ]
+    },
+    "SESSION_SECRET": {
+      "contents": [
+        {
+          "value": "```bash\nSESSION_SECRET=random-32-char-string-here\nCOOKIE_DOMAIN=.example.com\nCOOKIE_SECURE=true\n```\n**Session configuration** for server-side sessions. SECRET should be cryptographically random."
         }
       ]
     }

package/data/hover/graphql.json

@@ -4,42 +4,287 @@
     "type": {
       "contents": [
         {
-          "value": "```graphql\ntype User {\n  id: ID!\n  name: String!\n  email: String\n  posts: [Post!]!\n  role: Role!\n  createdAt: DateTime!\n}\n```\n**type** defines an object with fields. `!` means non-null, `[Type]` means list. Fields can have arguments."
+          "value": "```graphql\ntype User {\n  id: ID!\n  name: String!\n  email: String\n  posts: [Post!]!\n  role: Role!\n}\n```\n**type** defines an object with fields. `!` means non-null, `[Type]` means list."
         }
       ]
     },
     "query": {
       "contents": [
         {
-          "value": "```graphql\n# Schema definition:\ntype Query {\n  user(id: ID!): User\n  users(limit: Int = 10): [User!]!\n}\n\n# Client query:\nquery GetUser($id: ID!) {\n  user(id: $id) {\n    name\n    email\n    posts { title }\n  }\n}\n```\n**Query** is the read-only entry point. Variables prefixed with `$` are passed separately from the query."
+          "value": "```graphql\ntype Query {\n  user(id: ID!): User\n  users(limit: Int = 10): [User!]!\n}\n\nquery GetUser($id: ID!) {\n  user(id: $id) { name email }\n}\n```\n**Query** is the read-only entry point. Variables prefixed with `$` are passed separately."
         }
       ]
     },
     "mutation": {
       "contents": [
         {
-          "value": "```graphql\nmutation CreateUser($input: CreateUserInput!) {\n  createUser(input: $input) {\n    id\n    name\n  }\n}\n\n# Variables:\n# { \"input\": { \"name\": \"John\", \"email\": \"john@example.com\" } }\n```\n**Mutation** modifies server data. Use input types for complex arguments. Returns the modified data."
+          "value": "```graphql\nmutation CreateUser($input: CreateUserInput!) {\n  createUser(input: $input) {\n    id\n    name\n  }\n}\n```\n**Mutation** modifies server data. Use input types for complex arguments."
+        }
+      ]
+    },
+    "subscription": {
+      "contents": [
+        {
+          "value": "```graphql\ntype Subscription {\n  messageAdded(channelId: ID!): Message!\n  userStatusChanged: UserStatus!\n}\n\nsubscription OnMessage($channelId: ID!) {\n  messageAdded(channelId: $channelId) {\n    text\n    sender { name }\n  }\n}\n```\n**Subscription** receives real-time updates via WebSocket. Server pushes data when events occur."
         }
       ]
     },
     "fragment": {
       "contents": [
         {
-          "value": "```graphql\nfragment UserFields on User {\n  id\n  name\n  email\n}\n\nquery {\n  user(id: \"1\") { ...UserFields }\n  admin: user(id: \"2\") { ...UserFields }\n}\n```\n**fragment** avoids field duplication. Spread with `...FragmentName`. Inline fragments: `... on Type { }`."
+          "value": "```graphql\nfragment UserFields on User {\n  id\n  name\n  email\n}\n\nquery {\n  user(id: \"1\") { ...UserFields }\n  admin: user(id: \"2\") { ...UserFields }\n}\n```\n**fragment** avoids field duplication. Spread with `...FragmentName`."
         }
       ]
     },
     "directives": {
       "contents": [
         {
-          "value": "```graphql\n# Built-in directives:\nfield @deprecated(reason: \"Use newField\")\nfield @skip(if: $condition)\nfield @include(if: $condition)\n\n# Custom directive:\ndirective @auth(requires: Role = ADMIN) on FIELD_DEFINITION\n\ntype Mutation {\n  deleteUser(id: ID!): Boolean! @auth(requires: ADMIN)\n}\n```\n**Directives** add metadata. Built-in: `@deprecated`, `@skip`, `@include`. Custom directives extend functionality."
+          "value": "```graphql\nfield @deprecated(reason: \"Use newField\")\nfield @skip(if: $condition)\nfield @include(if: $condition)\n\ndirective @auth(requires: Role = ADMIN) on FIELD_DEFINITION\n```\n**Directives** add metadata. Built-in: `@deprecated`, `@skip`, `@include`. Custom directives extend functionality."
         }
       ]
     },
     "scalars": {
       "contents": [
         {
-          "value": "```graphql\n# Built-in scalars:\nID       # unique identifier (serialized as String)\nString   # UTF-8 text\nInt      # 32-bit signed integer\nFloat    # double-precision float\nBoolean  # true/false\n\n# Custom scalars:\nscalar DateTime\nscalar JSON\nscalar Upload\n```\n**Scalars** are leaf types. Custom scalars need resolver implementation on the server side."
+          "value": "```graphql\n# Built-in:\nID       # unique identifier\nString   # UTF-8 text\nInt      # 32-bit signed integer\nFloat    # double-precision float\nBoolean  # true/false\n\nscalar DateTime\nscalar JSON\n```\n**Scalars** are leaf types. Custom scalars need resolver implementation."
+        }
+      ]
+    },
+    "input": {
+      "contents": [
+        {
+          "value": "```graphql\ninput CreateUserInput {\n  name: String!\n  email: String!\n  role: Role = USER\n}\n\nmutation {\n  createUser(input: { name: \"John\", email: \"j@e.com\" }) { id }\n}\n```\n**input** types are used for mutation arguments. Can only contain scalars, enums, and other input types."
+        }
+      ]
+    },
+    "interface": {
+      "contents": [
+        {
+          "value": "```graphql\ninterface Node {\n  id: ID!\n}\n\ntype User implements Node {\n  id: ID!\n  name: String!\n}\n\ntype Post implements Node {\n  id: ID!\n  title: String!\n}\n```\n**interface** defines shared fields. Types that implement an interface must include all its fields."
+        }
+      ]
+    },
+    "union": {
+      "contents": [
+        {
+          "value": "```graphql\nunion SearchResult = User | Post | Comment\n\nquery {\n  search(term: \"hello\") {\n    ... on User { name }\n    ... on Post { title }\n    ... on Comment { text }\n  }\n}\n```\n**union** represents one of several types. Use inline fragments `... on Type` to select fields."
+        }
+      ]
+    },
+    "enum": {
+      "contents": [
+        {
+          "value": "```graphql\nenum Role {\n  ADMIN\n  USER\n  MODERATOR\n}\n\nenum SortOrder {\n  ASC\n  DESC\n}\n```\n**enum** defines a set of allowed values. Enums are serialized as strings."
+        }
+      ]
+    },
+    "schema": {
+      "contents": [
+        {
+          "value": "```graphql\nschema {\n  query: Query\n  mutation: Mutation\n  subscription: Subscription\n}\n```\n**schema** defines the root operation types. Optional if using the default names `Query`, `Mutation`, `Subscription`."
+        }
+      ]
+    },
+    "extend": {
+      "contents": [
+        {
+          "value": "```graphql\nextend type Query {\n  posts: [Post!]!\n}\n\nextend type User {\n  posts: [Post!]!\n}\n```\n**extend** adds fields to an existing type. Useful for modular schema design and federation."
+        }
+      ]
+    },
+    "implements": {
+      "contents": [
+        {
+          "value": "```graphql\ninterface Timestamped {\n  createdAt: DateTime!\n  updatedAt: DateTime!\n}\n\ntype Post implements Node & Timestamped {\n  id: ID!\n  createdAt: DateTime!\n  updatedAt: DateTime!\n}\n```\n**implements** declares that a type fulfills one or more interfaces. Use `&` for multiple."
+        }
+      ]
+    },
+    "arguments": {
+      "contents": [
+        {
+          "value": "```graphql\ntype Query {\n  users(\n    limit: Int = 10\n    offset: Int = 0\n    filter: UserFilter\n    sortBy: SortField = NAME\n  ): [User!]!\n}\n```\n**Arguments** can have default values and be of any input type. Every field can have arguments."
+        }
+      ]
+    },
+    "variables": {
+      "contents": [
+        {
+          "value": "```graphql\nquery GetUser($id: ID!, $includeEmail: Boolean = false) {\n  user(id: $id) {\n    name\n    email @include(if: $includeEmail)\n  }\n}\n\n# Variables: { \"id\": \"123\", \"includeEmail\": true }\n```\n**Variables** pass dynamic values. Declared with `$name: Type` in the operation, passed as JSON."
+        }
+      ]
+    },
+    "aliases": {
+      "contents": [
+        {
+          "value": "```graphql\nquery {\n  admin: user(id: \"1\") { name }\n  viewer: user(id: \"2\") { name }\n}\n```\n**Aliases** rename result fields. Required when querying the same field with different arguments."
+        }
+      ]
+    },
+    "inline_fragment": {
+      "contents": [
+        {
+          "value": "```graphql\nquery {\n  node(id: \"123\") {\n    id\n    ... on User { name email }\n    ... on Post { title body }\n  }\n}\n```\n**Inline fragments** `... on Type` select fields based on the concrete type. Used with unions and interfaces."
+        }
+      ]
+    },
+    "deprecated": {
+      "contents": [
+        {
+          "value": "```graphql\ntype User {\n  id: ID!\n  username: String @deprecated(reason: \"Use 'name' instead\")\n  name: String!\n}\n```\n**@deprecated** marks a field or enum value as deprecated. Reason is shown in introspection and tooling."
+        }
+      ]
+    },
+    "skip": {
+      "contents": [
+        {
+          "value": "```graphql\nquery GetUser($skipEmail: Boolean!) {\n  user(id: \"1\") {\n    name\n    email @skip(if: $skipEmail)\n  }\n}\n```\n**@skip** excludes a field when the condition is true. Opposite of `@include`."
+        }
+      ]
+    },
+    "include": {
+      "contents": [
+        {
+          "value": "```graphql\nquery GetUser($withPosts: Boolean!) {\n  user(id: \"1\") {\n    name\n    posts @include(if: $withPosts) { title }\n  }\n}\n```\n**@include** includes a field only when the condition is true."
+        }
+      ]
+    },
+    "non_null": {
+      "contents": [
+        {
+          "value": "```graphql\ntype User {\n  id: ID!           # non-null scalar\n  posts: [Post!]!   # non-null list of non-null posts\n  tags: [String]     # nullable list of nullable strings\n}\n```\n**Non-null** `!` means the field never returns null. `[Type!]!` = non-null list with non-null items."
+        }
+      ]
+    },
+    "pagination": {
+      "contents": [
+        {
+          "value": "```graphql\ntype Query {\n  users(first: Int, after: String): UserConnection!\n}\n\ntype UserConnection {\n  edges: [UserEdge!]!\n  pageInfo: PageInfo!\n}\n\ntype UserEdge {\n  node: User!\n  cursor: String!\n}\n\ntype PageInfo {\n  hasNextPage: Boolean!\n  endCursor: String\n}\n```\n**Relay-style pagination** uses connections, edges, and cursors. The standard pattern for paginated queries."
+        }
+      ]
+    },
+    "introspection": {
+      "contents": [
+        {
+          "value": "```graphql\nquery {\n  __schema {\n    types { name kind }\n  }\n  __type(name: \"User\") {\n    fields { name type { name } }\n  }\n}\n```\n**Introspection** queries the schema itself. `__schema` returns all types, `__type` returns details of one type."
+        }
+      ]
+    },
+    "resolver": {
+      "contents": [
+        {
+          "value": "```javascript\nconst resolvers = {\n  Query: {\n    user: (parent, args, context) => {\n      return context.db.users.findById(args.id);\n    }\n  },\n  User: {\n    posts: (user, args, context) => {\n      return context.db.posts.findByUserId(user.id);\n    }\n  }\n}\n```\n**Resolvers** are functions that fetch data for each field. Signature: `(parent, args, context, info)`."
+        }
+      ]
+    },
+    "context": {
+      "contents": [
+        {
+          "value": "```javascript\nconst server = new ApolloServer({\n  typeDefs,\n  resolvers,\n  context: ({ req }) => ({\n    user: getUser(req.headers.authorization),\n    db: database\n  })\n});\n```\n**Context** is shared across all resolvers in a request. Use for auth, database connections, and data loaders."
+        }
+      ]
+    },
+    "DataLoader": {
+      "contents": [
+        {
+          "value": "```javascript\nconst userLoader = new DataLoader(async (ids) => {\n  const users = await db.users.findByIds(ids);\n  return ids.map(id => users.find(u => u.id === id));\n});\n\n// In resolver:\nuser: (parent) => userLoader.load(parent.userId)\n```\n**DataLoader** batches and caches database requests to solve the N+1 query problem."
+        }
+      ]
+    },
+    "operation_name": {
+      "contents": [
+        {
+          "value": "```graphql\nquery GetUserProfile {\n  user(id: \"1\") { name }\n}\n\nmutation UpdateUser {\n  updateUser(id: \"1\", name: \"John\") { id }\n}\n```\n**Operation names** identify queries in logs and dev tools. Required when a document has multiple operations."
+        }
+      ]
+    },
+    "field_arguments": {
+      "contents": [
+        {
+          "value": "```graphql\ntype User {\n  profilePicture(size: Int = 100, format: ImageFormat = JPG): String!\n  friends(first: Int!, after: String): FriendConnection!\n}\n```\n**Field arguments** allow callers to customize field resolution. Support default values."
+        }
+      ]
+    },
+    "custom_directive": {
+      "contents": [
+        {
+          "value": "```graphql\ndirective @auth(requires: Role = ADMIN) on FIELD_DEFINITION\ndirective @cacheControl(maxAge: Int) on FIELD_DEFINITION\ndirective @deprecated(reason: String) on FIELD_DEFINITION | ENUM_VALUE\n```\n**Custom directives** extend schema behavior. Locations: `FIELD_DEFINITION`, `OBJECT`, `ARGUMENT_DEFINITION`, etc."
+        }
+      ]
+    },
+    "federation": {
+      "contents": [
+        {
+          "value": "```graphql\n# Service A\ntype User @key(fields: \"id\") {\n  id: ID!\n  name: String!\n}\n\n# Service B\nextend type User @key(fields: \"id\") {\n  id: ID! @external\n  orders: [Order!]!\n}\n```\n**Federation** splits a schema across multiple services. `@key` defines entity identifiers. Use Apollo Federation."
+        }
+      ]
+    },
+    "nullable": {
+      "contents": [
+        {
+          "value": "```graphql\ntype Query {\n  user(id: ID!): User          # may return null if not found\n  users: [User!]!              # never null, items never null\n  search(term: String): [Result] # nullable list, nullable items\n}\n```\n**Nullability** — without `!`, fields can return null. Design nullability based on error handling strategy."
+        }
+      ]
+    },
+    "ID": {
+      "contents": [
+        {
+          "value": "```graphql\ntype User {\n  id: ID!\n}\n\nquery {\n  user(id: \"abc123\") { name }\n}\n```\n**ID** is a unique identifier serialized as a String. Not meant for display. Arguments accepting IDs coerce strings and integers."
+        }
+      ]
+    },
+    "String": {
+      "contents": [
+        {
+          "value": "```graphql\ntype User {\n  name: String!\n  bio: String\n}\n```\n**String** is a UTF-8 character sequence. One of the five built-in scalar types."
+        }
+      ]
+    },
+    "Int": {
+      "contents": [
+        {
+          "value": "```graphql\ntype Post {\n  viewCount: Int!\n}\n```\n**Int** is a signed 32-bit integer. For larger values, use a custom scalar like `BigInt`."
+        }
+      ]
+    },
+    "Float": {
+      "contents": [
+        {
+          "value": "```graphql\ntype Product {\n  price: Float!\n}\n```\n**Float** is a signed double-precision floating-point value."
+        }
+      ]
+    },
+    "Boolean": {
+      "contents": [
+        {
+          "value": "```graphql\ntype Feature {\n  enabled: Boolean!\n}\n```\n**Boolean** represents `true` or `false`."
+        }
+      ]
+    },
+    "description": {
+      "contents": [
+        {
+          "value": "```graphql\n\"\"\"A registered user of the platform.\"\"\"\ntype User {\n  \"The unique identifier.\"\n  id: ID!\n  \"The user's display name.\"\n  name: String!\n}\n```\n**Descriptions** are doc strings using `\"\"\"block\"\"\"` or `\"inline\"` quotes. Shown in introspection and tooling."
+        }
+      ]
+    },
+    "input_list": {
+      "contents": [
+        {
+          "value": "```graphql\ninput FilterInput {\n  status: [Status!]\n  tags: [String!]\n  dateRange: DateRangeInput\n}\n\nquery {\n  posts(filter: { status: [PUBLISHED, DRAFT], tags: [\"tech\"] }) {\n    title\n  }\n}\n```\n**Input with lists** allows passing arrays of values for filtering and batch operations."
+        }
+      ]
+    },
+    "error_handling": {
+      "contents": [
+        {
+          "value": "```json\n{\n  \"data\": { \"user\": null },\n  \"errors\": [\n    {\n      \"message\": \"User not found\",\n      \"path\": [\"user\"],\n      \"extensions\": { \"code\": \"NOT_FOUND\" }\n    }\n  ]\n}\n```\n**Error responses** include both `data` and `errors`. Partial data is returned when possible. Use `extensions` for error codes."
+        }
+      ]
+    },
+    "batch_query": {
+      "contents": [
+        {
+          "value": "```graphql\nquery BatchQuery {\n  user1: user(id: \"1\") { name }\n  user2: user(id: \"2\") { name }\n  recentPosts: posts(limit: 5) { title }\n}\n```\n**Batching** — Multiple queries in a single request reduces round trips. Aliases distinguish repeated fields."
         }
       ]
     }