@enjoys/context-engine 1.3.1 → 1.4.2

package/data/hover/crontab.json

@@ -4,42 +4,287 @@
     "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`)."
+          "value": "```cron\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 plus a command. Supports `*`, ranges, lists, and steps."
         }
       ]
     },
     "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."
+          "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."
         }
       ]
     },
     "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."
+          "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."
         }
       ]
     },
     "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."
+          "value": "```cron\n# Log stdout and stderr:\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."
+          "value": "```cron\n# Cron has minimal PATH!\nPATH=/usr/local/bin:/usr/bin:/bin\n\n# Or use absolute paths:\n0 * * * * /usr/local/bin/node /opt/app/task.js\n```\n**PATH** — Cron's default PATH is minimal. Set PATH or use absolute command paths."
         }
       ]
     },
     "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."
+          "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. `-n` to skip if locked, `-w N` to wait."
+        }
+      ]
+    },
+    "minute": {
+      "contents": [
+        {
+          "value": "```cron\n# Minute field (0-59):\n0       # at minute 0 (top of hour)\n*/5     # every 5 minutes\n5,10,15 # at minutes 5, 10, and 15\n0-30    # every minute from 0 to 30\n```\n**Minute** is the first field (0-59). Determines which minute(s) of the hour the job runs."
+        }
+      ]
+    },
+    "hour": {
+      "contents": [
+        {
+          "value": "```cron\n# Hour field (0-23):\n0       # midnight\n9       # 9 AM\n*/6     # every 6 hours\n9-17    # 9 AM to 5 PM\n```\n**Hour** is the second field (0-23). Uses 24-hour format."
+        }
+      ]
+    },
+    "day_of_month": {
+      "contents": [
+        {
+          "value": "```cron\n# Day of month field (1-31):\n1       # first of month\n15      # 15th\n1,15    # 1st and 15th\n```\n**Day of month** is the third field (1-31). If month has fewer days, job won't run on invalid dates."
+        }
+      ]
+    },
+    "month": {
+      "contents": [
+        {
+          "value": "```cron\n# Month field (1-12 or jan-dec):\n1       # January\n*/3     # every 3 months\n6-8     # June through August\njan,jul # January and July\n```\n**Month** is the fourth field (1-12 or names). Names are case-insensitive."
+        }
+      ]
+    },
+    "day_of_week": {
+      "contents": [
+        {
+          "value": "```cron\n# Day of week (0-7 or sun-sat, 0 and 7 = Sunday):\n0       # Sunday\n1-5     # Monday through Friday\n6,0     # weekends\nmon,wed,fri\n```\n**Day of week** is the fifth field. Both 0 and 7 represent Sunday."
+        }
+      ]
+    },
+    "asterisk": {
+      "contents": [
+        {
+          "value": "```cron\n* * * * *   # every minute\n```\n**Asterisk** `*` matches every possible value for that field."
+        }
+      ]
+    },
+    "step": {
+      "contents": [
+        {
+          "value": "```cron\n*/5 * * * *    # every 5 minutes\n0 */2 * * *    # every 2 hours\n* * */3 * *    # every 3 days\n```\n**Step values** `*/N` run every N units. Can combine with ranges: `1-30/5` = 1,6,11,16,21,26."
+        }
+      ]
+    },
+    "range": {
+      "contents": [
+        {
+          "value": "```cron\n0 9-17 * * *   # every hour 9 AM to 5 PM\n0 0 * * 1-5    # weekdays at midnight\n```\n**Ranges** `N-M` match all values from N to M inclusive."
+        }
+      ]
+    },
+    "list": {
+      "contents": [
+        {
+          "value": "```cron\n0 0 1,15 * *     # 1st and 15th\n0 9 * * mon,wed  # Monday and Wednesday\n```\n**Lists** `A,B,C` match specific values. Combine with ranges: `1-5,10,15`."
+        }
+      ]
+    },
+    "MAILTO": {
+      "contents": [
+        {
+          "value": "```cron\nMAILTO=admin@example.com\n# Multiple recipients:\nMAILTO=admin@example.com,ops@example.com\n# Disable email:\nMAILTO=\"\"\n```\n**MAILTO** sets the email recipient for job output. Empty string disables email."
+        }
+      ]
+    },
+    "SHELL": {
+      "contents": [
+        {
+          "value": "```cron\nSHELL=/bin/bash\n# or\nSHELL=/bin/sh\n```\n**SHELL** sets the shell used to run commands. Default is `/bin/sh`. Set to `/bin/bash` for bash features."
+        }
+      ]
+    },
+    "HOME": {
+      "contents": [
+        {
+          "value": "```cron\nHOME=/opt/app\n0 * * * * ./run.sh\n```\n**HOME** sets the working directory for cron jobs. Affects relative paths in commands."
+        }
+      ]
+    },
+    "crontab_commands": {
+      "contents": [
+        {
+          "value": "```bash\ncrontab -e      # edit your crontab\ncrontab -l      # list your crontab\ncrontab -r      # remove your crontab\ncrontab -u user -l  # list another user's crontab\n```\n**crontab commands** manage per-user cron schedules."
+        }
+      ]
+    },
+    "system_crontab": {
+      "contents": [
+        {
+          "value": "```cron\n# /etc/crontab has an extra USER field:\n* * * * * root /usr/local/bin/check.sh\n0 2 * * * www-data /opt/cleanup.sh\n```\n**System crontab** (`/etc/crontab`) includes a username field between the time spec and command."
+        }
+      ]
+    },
+    "cron_d": {
+      "contents": [
+        {
+          "value": "```bash\n# Drop-in files: /etc/cron.d/myapp\n# Same format as /etc/crontab (with user field)\n0 * * * * appuser /opt/myapp/hourly.sh\n```\n**/etc/cron.d/** directory holds per-application cron files. Same format as system crontab."
+        }
+      ]
+    },
+    "cron_directories": {
+      "contents": [
+        {
+          "value": "```bash\n/etc/cron.hourly/   # scripts run hourly\n/etc/cron.daily/    # scripts run daily\n/etc/cron.weekly/   # scripts run weekly\n/etc/cron.monthly/  # scripts run monthly\n```\n**Periodic directories** run scripts at fixed intervals. Place executable scripts (no extension) in these dirs."
+        }
+      ]
+    },
+    "environment": {
+      "contents": [
+        {
+          "value": "```cron\n# Set variables at the top:\nPATH=/usr/local/bin:/usr/bin:/bin\nSHELL=/bin/bash\nMAILTO=admin@example.com\nHOME=/opt/app\n\n0 * * * * ./my-script.sh\n```\n**Environment variables** set at the top of crontab apply to all jobs below. Only simple `KEY=value` syntax."
+        }
+      ]
+    },
+    "anacron": {
+      "contents": [
+        {
+          "value": "```bash\n# /etc/anacrontab:\n# period  delay  identifier  command\n1         5      daily-task  /opt/daily.sh\n7         10     weekly-task /opt/weekly.sh\n```\n**anacron** runs missed jobs after system wake/boot. Useful for laptops and machines that aren't always on."
+        }
+      ]
+    },
+    "two_am_problem": {
+      "contents": [
+        {
+          "value": "```cron\n# DST problem: 2 AM may occur twice or not at all\n# Safer: use UTC in crontab\nTZ=UTC\n0 7 * * * /opt/task.sh  # 7 AM UTC\n```\n**DST/timezone** — Jobs at 2-3 AM may be skipped or run twice during DST changes. Use UTC to avoid this."
+        }
+      ]
+    },
+    "random_delay": {
+      "contents": [
+        {
+          "value": "```cron\n# Add random delay to avoid thundering herd:\n*/5 * * * * sleep $((RANDOM % 60)) && /opt/task.sh\n\n# Or use systemd timer RandomizedDelaySec\n```\n**Random delay** prevents many servers from hitting a service simultaneously."
+        }
+      ]
+    },
+    "timeout": {
+      "contents": [
+        {
+          "value": "```cron\n# Kill job if it runs too long:\n0 2 * * * timeout 3600 /opt/long-task.sh\n\n# timeout with signal:\n0 2 * * * timeout --signal=SIGKILL 3600 /opt/task.sh\n```\n**timeout** kills a cron job if it exceeds the specified duration. Prevents jobs from running indefinitely."
+        }
+      ]
+    },
+    "nice": {
+      "contents": [
+        {
+          "value": "```cron\n# Run with lower priority:\n0 2 * * * nice -n 19 /opt/heavy-task.sh\n\n# Also limit I/O:\n0 2 * * * ionice -c 3 nice -n 19 /opt/task.sh\n```\n**nice/ionice** reduce CPU and I/O priority for resource-intensive cron jobs."
+        }
+      ]
+    },
+    "chronic": {
+      "contents": [
+        {
+          "value": "```cron\n# chronic: only show output on error\n*/5 * * * * chronic /opt/check.sh\n\n# From moreutils package\n```\n**chronic** (from moreutils) suppresses output unless the command fails. Eliminates noisy success emails."
+        }
+      ]
+    },
+    "backup_pattern": {
+      "contents": [
+        {
+          "value": "```cron\n# Daily backup at 2 AM\n0 2 * * * /opt/backup.sh daily\n# Weekly backup Sunday at 3 AM\n0 3 * * 0 /opt/backup.sh weekly\n# Monthly backup 1st at 4 AM\n0 4 1 * * /opt/backup.sh monthly\n```\n**Backup pattern** — stagger daily, weekly, and monthly backups at different times."
+        }
+      ]
+    },
+    "logrotate": {
+      "contents": [
+        {
+          "value": "```cron\n# Rotate logs daily at midnight:\n0 0 * * * /usr/sbin/logrotate /etc/logrotate.conf\n\n# Or rely on system cron.daily\n```\n**Log rotation** is commonly scheduled via cron to prevent log files from filling disk."
+        }
+      ]
+    },
+    "certbot": {
+      "contents": [
+        {
+          "value": "```cron\n# Renew Let's Encrypt certificates twice daily:\n0 0,12 * * * certbot renew --quiet\n```\n**certbot renewal** — Check twice daily. Certbot only renews if expiry is within 30 days."
+        }
+      ]
+    },
+    "health_check": {
+      "contents": [
+        {
+          "value": "```cron\n# Check service health every minute:\n* * * * * curl -sf http://localhost:3000/health || systemctl restart myapp\n```\n**Health checks** use cron to monitor services and auto-restart on failure."
+        }
+      ]
+    },
+    "at_vs_cron": {
+      "contents": [
+        {
+          "value": "```bash\n# cron: recurring schedule\n0 9 * * * /opt/daily.sh\n\n# at: one-time execution\nat 9:00 AM tomorrow <<< '/opt/once.sh'\n```\n**cron vs at** — `cron` for recurring jobs, `at` for one-time scheduled tasks."
+        }
+      ]
+    },
+    "monitoring": {
+      "contents": [
+        {
+          "value": "```cron\n# Heartbeat monitoring with healthchecks.io:\n*/5 * * * * /opt/task.sh && curl -fsS --retry 3 https://hc-ping.com/uuid > /dev/null\n```\n**Monitoring** — Ping a health check URL after each run to detect failed or missed jobs."
+        }
+      ]
+    },
+    "cron_alternatives": {
+      "contents": [
+        {
+          "value": "```bash\n# systemd timer (modern Linux alternative):\n# /etc/systemd/system/mytask.timer\n# [Timer]\n# OnCalendar=*-*-* 02:00:00\n# Persistent=true\n```\n**systemd timers** are the modern alternative to cron on systemd-based systems. Support better logging and dependencies."
+        }
+      ]
+    },
+    "day_conflict": {
+      "contents": [
+        {
+          "value": "```cron\n# Day of month AND day of week: OR logic!\n0 0 1 * 5   # runs on 1st AND every Friday\n# NOT: 1st if it's a Friday\n```\n**Day conflict** — When both day-of-month and day-of-week are specified, the job runs when EITHER matches (OR logic)."
+        }
+      ]
+    },
+    "database_backup": {
+      "contents": [
+        {
+          "value": "```cron\n# PostgreSQL backup:\n0 2 * * * pg_dump -U postgres mydb | gzip > /backup/mydb_$(date +\\%Y\\%m\\%d).sql.gz\n\n# MySQL backup:\n0 2 * * * mysqldump -u root mydb | gzip > /backup/mydb_$(date +\\%Y\\%m\\%d).sql.gz\n```\n**Database backups** — Use `pg_dump`/`mysqldump` with gzip compression. Note: escape `%` as `\\%` in crontab."
+        }
+      ]
+    },
+    "percent_escape": {
+      "contents": [
+        {
+          "value": "```cron\n# % has special meaning in crontab (newline/stdin)\n# Must escape with backslash:\n0 2 * * * echo $(date +\\%Y-\\%m-\\%d) >> /var/log/date.log\n\n# Unescaped % splits command:\n0 * * * * /cmd%stdin data   # sends 'stdin data' as input\n```\n**Percent sign** `%` in crontab means newline and stdin. Always escape as `\\%` in date formats."
+        }
+      ]
+    },
+    "cleanup": {
+      "contents": [
+        {
+          "value": "```cron\n# Delete files older than 30 days:\n0 3 * * * find /tmp -type f -mtime +30 -delete\n\n# Delete old log files:\n0 3 * * * find /var/log/app -name '*.log' -mtime +7 -delete\n```\n**Cleanup jobs** use `find -mtime -delete` to remove old files. Always test the find command first."
+        }
+      ]
+    },
+    "user_permissions": {
+      "contents": [
+        {
+          "value": "```bash\n# Edit root's crontab:\nsudo crontab -e\n\n# Restrict cron access:\n# /etc/cron.allow - only listed users can use cron\n# /etc/cron.deny  - listed users are denied cron\n```\n**Permissions** — `/etc/cron.allow` and `/etc/cron.deny` control who can use crontab."
         }
       ]
     }

package/data/hover/css.json

@@ -63,6 +63,238 @@
     },
     "container-type": {
       "contents": [{ "value": "```css\ncontainer-type: normal | size | inline-size;\n```\n\nEstablishes an element as a containment context for container queries.\n\n- `normal` — no containment (default)\n- `inline-size` — containment on the inline axis only\n- `size` — containment on both axes\n\nUsed with `@container` queries:\n```css\n.card { container-type: inline-size; }\n@container (min-width: 400px) {\n  .card-body { display: flex; }\n}\n```" }]
+    },
+
+    "width": {
+      "contents": [{ "value": "```css\nwidth: <length> | <percentage> | auto | min-content | max-content | fit-content(<length>);\n```\n\nSets the width of an element's content box (or border box with `box-sizing: border-box`).\n\n- `auto` — determined by content and containment\n- `min-content` — shrink to narrowest content\n- `max-content` — expand to widest content\n- `fit-content()` — clamp between min-content and max-content" }]
+    },
+    "height": {
+      "contents": [{ "value": "```css\nheight: <length> | <percentage> | auto | min-content | max-content | fit-content(<length>);\n```\n\nSets the height of the element. Percentages resolve against the containing block's height.\n\n`height: 100vh` fills the full viewport height.\n`height: 100dvh` uses dynamic viewport height (adjusts for mobile browser chrome)." }]
+    },
+    "min-width": {
+      "contents": [{ "value": "```css\nmin-width: <length> | <percentage> | auto | min-content | max-content | fit-content(<length>);\n```\n\nSets the minimum width. The element will never be narrower than this value.\n\nOverrides `width` and `max-width` when they would result in a smaller value." }]
+    },
+    "max-width": {
+      "contents": [{ "value": "```css\nmax-width: <length> | <percentage> | none | min-content | max-content | fit-content(<length>);\n```\n\nSets the maximum width. The element will never be wider than this value.\n\nOverrides `width` but is overridden by `min-width`. Common pattern: `max-width: 1200px; margin: 0 auto;` for centered layouts." }]
+    },
+    "min-height": {
+      "contents": [{ "value": "```css\nmin-height: <length> | <percentage> | auto | min-content | max-content | fit-content(<length>);\n```\n\nSets the minimum height. Useful for ensuring content areas fill available space: `min-height: 100vh;` for full-page layouts." }]
+    },
+    "max-height": {
+      "contents": [{ "value": "```css\nmax-height: <length> | <percentage> | none | min-content | max-content;\n```\n\nSets the maximum height. Commonly used with `overflow: auto` for scrollable regions." }]
+    },
+    "top": {
+      "contents": [{ "value": "```css\ntop: <length> | <percentage> | auto;\n```\n\nSpecifies the vertical position of a positioned element. Behavior depends on `position`:\n- `relative` — offsets from normal position\n- `absolute` — distance from top edge of containing block\n- `fixed` — distance from top of viewport\n- `sticky` — threshold for sticking" }]
+    },
+    "right": {
+      "contents": [{ "value": "```css\nright: <length> | <percentage> | auto;\n```\n\nSpecifies the horizontal position from the right edge of a positioned element's containing block." }]
+    },
+    "bottom": {
+      "contents": [{ "value": "```css\nbottom: <length> | <percentage> | auto;\n```\n\nSpecifies the vertical position from the bottom edge of a positioned element's containing block." }]
+    },
+    "left": {
+      "contents": [{ "value": "```css\nleft: <length> | <percentage> | auto;\n```\n\nSpecifies the horizontal position from the left edge of a positioned element's containing block." }]
+    },
+    "inset": {
+      "contents": [{ "value": "```css\ninset: <length> | <percentage> | auto;\n/* Shorthand for: top right bottom left */\n```\n\nShorthand for `top`, `right`, `bottom`, `left`. Follows the same 1-to-4 value pattern as `margin`.\n\n`inset: 0;` fills the containing block completely (equivalent to `top: 0; right: 0; bottom: 0; left: 0;`)." }]
+    },
+    "flex-wrap": {
+      "contents": [{ "value": "```css\nflex-wrap: nowrap | wrap | wrap-reverse;\n```\n\n- `nowrap` (default) — all items on one line, may overflow\n- `wrap` — items wrap to new lines from top to bottom\n- `wrap-reverse` — items wrap from bottom to top\n\nWhen wrapping, `align-content` controls spacing between lines." }]
+    },
+    "flex-grow": {
+      "contents": [{ "value": "```css\nflex-grow: <number>;\n```\n\nSpecifies how much a flex item grows relative to siblings when positive free space is distributed.\n\n- `0` (default) — don't grow\n- `1` — grow equally\n- `2` — grow twice as much as items with `flex-grow: 1`" }]
+    },
+    "flex-shrink": {
+      "contents": [{ "value": "```css\nflex-shrink: <number>;\n```\n\nSpecifies how much a flex item shrinks relative to siblings when there isn't enough space.\n\n- `1` (default) — shrink equally\n- `0` — don't shrink (useful for fixed-width sidebars)" }]
+    },
+    "flex-basis": {
+      "contents": [{ "value": "```css\nflex-basis: <length> | <percentage> | auto | content;\n```\n\nSets the initial main size of a flex item before free space is distributed.\n\n- `auto` — uses `width`/`height` value\n- `0` — ignores content size, distributes all space via `flex-grow`\n- A specific length — sets an explicit starting size" }]
+    },
+    "align-content": {
+      "contents": [{ "value": "```css\nalign-content: stretch | flex-start | flex-end | center | space-between | space-around | space-evenly;\n```\n\nDistributes space between and around flex/grid lines along the cross axis.\n\nOnly applies when there are multiple lines (flex-wrap: wrap or grid with multiple rows)." }]
+    },
+    "align-self": {
+      "contents": [{ "value": "```css\nalign-self: auto | flex-start | flex-end | center | baseline | stretch;\n```\n\nOverrides `align-items` for a specific flex/grid item. Aligns this item independently on the cross axis." }]
+    },
+    "gap": {
+      "contents": [{ "value": "```css\ngap: <row-gap> <column-gap>?;\n```\n\nShorthand for `row-gap` and `column-gap`. Sets gutters between flex/grid items.\n\n- `gap: 1rem;` — uniform gap\n- `gap: 1rem 2rem;` — row gap | column gap\n\nReplaces the older `grid-gap` property. Works in both Flexbox and Grid." }]
+    },
+    "grid-template-rows": {
+      "contents": [{ "value": "```css\ngrid-template-rows: <track-size>+ | repeat(<count>, <track-size>) | auto;\n```\n\nDefines row sizes in a grid container.\n\nExamples:\n```css\ngrid-template-rows: auto 1fr auto;\ngrid-template-rows: repeat(3, minmax(100px, auto));\ngrid-template-rows: [header] auto [content] 1fr [footer] auto;\n```" }]
+    },
+    "grid-column": {
+      "contents": [{ "value": "```css\ngrid-column: <start-line> / <end-line>;\n```\n\nShorthand for `grid-column-start` / `grid-column-end`. Places a grid item horizontally.\n\nExamples:\n- `grid-column: 1 / 3;` — spans columns 1 and 2\n- `grid-column: 1 / -1;` — spans all columns\n- `grid-column: span 2;` — spans 2 columns from auto-placement" }]
+    },
+    "grid-row": {
+      "contents": [{ "value": "```css\ngrid-row: <start-line> / <end-line>;\n```\n\nShorthand for `grid-row-start` / `grid-row-end`. Places a grid item vertically.\n\nExamples:\n- `grid-row: 1 / 3;` — spans rows 1 and 2\n- `grid-row: span 2;` — spans 2 rows" }]
+    },
+    "grid-auto-flow": {
+      "contents": [{ "value": "```css\ngrid-auto-flow: row | column | dense | row dense | column dense;\n```\n\nControls how auto-placed items flow into the grid.\n\n- `row` (default) — fill rows first\n- `column` — fill columns first\n- `dense` — fill gaps in earlier cells (may reorder visually)" }]
+    },
+    "place-items": {
+      "contents": [{ "value": "```css\nplace-items: <align-items> <justify-items>?;\n```\n\nShorthand for `align-items` and `justify-items`. Centers grid/flex items:\n\n`place-items: center;` centers items both horizontally and vertically." }]
+    },
+    "place-content": {
+      "contents": [{ "value": "```css\nplace-content: <align-content> <justify-content>?;\n```\n\nShorthand for `align-content` and `justify-content`. Distributes space in both axes at once." }]
+    },
+
+    "font-size": {
+      "contents": [{ "value": "```css\nfont-size: <absolute> | <relative> | <length> | <percentage>;\n```\n\nAbsolute keywords: `xx-small`, `x-small`, `small`, `medium`, `large`, `x-large`, `xx-large`.\nRelative: `smaller`, `larger`.\n\nBest practice for responsive text: `font-size: clamp(1rem, 2.5vw, 2rem);`\n\n`em` is relative to parent font-size. `rem` is relative to root (`<html>`) font-size." }]
+    },
+    "font-weight": {
+      "contents": [{ "value": "```css\nfont-weight: normal | bold | bolder | lighter | 100-900;\n```\n\nNumeric scale (100–900 in increments of 100):\n- 100: Thin\n- 300: Light\n- 400: Normal (= `normal`)\n- 500: Medium\n- 700: Bold (= `bold`)\n- 900: Black\n\nVariable fonts support any integer in the 1–1000 range." }]
+    },
+    "font-family": {
+      "contents": [{ "value": "```css\nfont-family: <family-name> | <generic-family>;\n```\n\nGeneric families: `serif`, `sans-serif`, `monospace`, `cursive`, `fantasy`, `system-ui`, `ui-serif`, `ui-sans-serif`, `ui-monospace`.\n\nAlways end with a generic fallback:\n```css\nfont-family: 'Inter', 'Segoe UI', system-ui, sans-serif;\n```\n\nQuote family names containing spaces or special characters." }]
+    },
+    "line-height": {
+      "contents": [{ "value": "```css\nline-height: normal | <number> | <length> | <percentage>;\n```\n\nSets the height of a line box. Unitless values (like `1.5`) are recommended as they scale with font-size.\n\n- `normal` — browser default (~1.2)\n- `1.5` — 1.5× the font-size\n- `24px` — fixed line height\n\nAffects vertical rhythm and readability. WCAG recommends at least 1.5 for body text." }]
+    },
+    "letter-spacing": {
+      "contents": [{ "value": "```css\nletter-spacing: normal | <length>;\n```\n\nSets the space between characters. Negative values tighten text.\n\nCommon usage:\n- Headings: `letter-spacing: -0.025em;` (tighter)\n- Uppercase text: `letter-spacing: 0.05em;` (wider)\n- Body text: `letter-spacing: normal;`" }]
+    },
+    "text-align": {
+      "contents": [{ "value": "```css\ntext-align: left | right | center | justify | start | end;\n```\n\nAligns inline content within a block element.\n\n- `start`/`end` — logical values that respect writing direction (RTL-safe)\n- `justify` — stretches lines to fill width; last line is left-aligned" }]
+    },
+    "text-decoration": {
+      "contents": [{ "value": "```css\ntext-decoration: <line> <style>? <color>? <thickness>?;\n```\n\nShorthand for `text-decoration-line`, `text-decoration-style`, `text-decoration-color`, `text-decoration-thickness`.\n\nLines: `none`, `underline`, `overline`, `line-through`.\nStyles: `solid`, `double`, `dotted`, `dashed`, `wavy`.\n\n`text-underline-offset` adjusts position of underlines." }]
+    },
+    "text-transform": {
+      "contents": [{ "value": "```css\ntext-transform: none | capitalize | uppercase | lowercase | full-width;\n```\n\n- `capitalize` — first letter of each word uppercased\n- `uppercase` — all characters uppercased\n- `lowercase` — all characters lowercased\n\nNote: Doesn't change the actual content, only the visual presentation." }]
+    },
+    "text-overflow": {
+      "contents": [{ "value": "```css\ntext-overflow: clip | ellipsis;\n```\n\nSpecifies how overflowed text that is not displayed is signaled.\n\nRequires `overflow: hidden` and `white-space: nowrap` to take effect.\n\nClassic truncation pattern:\n```css\noverflow: hidden;\nwhite-space: nowrap;\ntext-overflow: ellipsis;\n```" }]
+    },
+    "white-space": {
+      "contents": [{ "value": "```css\nwhite-space: normal | nowrap | pre | pre-wrap | pre-line | break-spaces;\n```\n\n- `normal` — collapse whitespace, wrap at available width\n- `nowrap` — collapse whitespace, no wrapping\n- `pre` — preserve whitespace and newlines, no wrapping\n- `pre-wrap` — preserve whitespace, wrap at available width\n- `pre-line` — collapse whitespace, preserve newlines, wrap" }]
+    },
+    "word-break": {
+      "contents": [{ "value": "```css\nword-break: normal | break-all | keep-all | break-word;\n```\n\n- `normal` — break at allowed break points\n- `break-all` — break anywhere (for CJK text or long strings)\n- `keep-all` — don't break CJK characters\n- `break-word` — break at word boundaries, then anywhere if needed (deprecated, use `overflow-wrap: anywhere` instead)" }]
+    },
+    "overflow-wrap": {
+      "contents": [{ "value": "```css\noverflow-wrap: normal | break-word | anywhere;\n```\n\nAllows unbreakable strings to be broken to prevent overflow.\n\n- `break-word` — break long words at arbitrary points if needed\n- `anywhere` — like `break-word` but also considers soft wrap opportunities for min-content sizing" }]
+    },
+
+    "color": {
+      "contents": [{ "value": "```css\ncolor: <color>;\n```\n\nSets the foreground color for text content and text decorations.\n\nColor formats:\n- Named: `red`, `rebeccapurple`\n- Hex: `#ff0000`, `#f00`, `#ff000080`\n- RGB: `rgb(255 0 0)`, `rgb(255 0 0 / 50%)`\n- HSL: `hsl(0 100% 50%)`, `hsl(0 100% 50% / 50%)`\n- OKLCH: `oklch(70% 0.25 30)`\n- Keywords: `currentColor`, `transparent`, `inherit`" }]
+    },
+    "background-color": {
+      "contents": [{ "value": "```css\nbackground-color: <color>;\n```\n\nSets the background color. Painted behind `background-image`.\n\nSupports all color formats including alpha transparency:\n`background-color: rgb(0 0 0 / 50%);`" }]
+    },
+    "background-image": {
+      "contents": [{ "value": "```css\nbackground-image: none | <image>+;\n```\n\nSets one or more background images. Supports gradients as images.\n\nExamples:\n```css\nbackground-image: url('bg.jpg');\nbackground-image: linear-gradient(to right, #000, #fff);\nbackground-image: radial-gradient(circle, #000, transparent);\nbackground-image: conic-gradient(from 45deg, red, blue);\n```\n\nMultiple backgrounds are layered: first declared is on top." }]
+    },
+    "background-size": {
+      "contents": [{ "value": "```css\nbackground-size: auto | <length> | <percentage> | cover | contain;\n```\n\n- `cover` — scales image to fill element (may crop)\n- `contain` — scales image to fit entirely (may leave gaps)\n- `auto` — natural image dimensions\n\nTwo values: `background-size: width height;`" }]
+    },
+    "background-position": {
+      "contents": [{ "value": "```css\nbackground-position: <position>;\n```\n\nSets the initial position of a background image.\n\nKeywords: `top`, `right`, `bottom`, `left`, `center`.\nValues: `background-position: 50% 50%;` (centered)\nMulti-value: `background-position: right 10px bottom 20px;`" }]
+    },
+    "linear-gradient()": {
+      "contents": [{ "value": "```css\nlinear-gradient(<angle> | to <side>, <color-stop>, ...)\n```\n\nCreates a linear color transition.\n\nAngles: `0deg` (up), `90deg` (right), `180deg` (down), `270deg` (left).\nKeywords: `to right`, `to bottom right`, etc.\n\nExamples:\n```css\nlinear-gradient(135deg, #667eea 0%, #764ba2 100%);\nlinear-gradient(to right, red, transparent);\nlinear-gradient(to bottom, #000 0%, #000 50%, #fff 50%, #fff 100%);\n```" }]
+    },
+    "radial-gradient()": {
+      "contents": [{ "value": "```css\nradial-gradient(<shape> <size> at <position>, <color-stop>, ...)\n```\n\nCreates a radial color transition from a center point.\n\nShapes: `circle`, `ellipse` (default).\nSizes: `closest-side`, `farthest-side`, `closest-corner`, `farthest-corner`.\n\nExample: `radial-gradient(circle at top left, #667eea, transparent);`" }]
+    },
+
+    "border-width": {
+      "contents": [{ "value": "```css\nborder-width: <length>{1,4};\n```\n\nSets the width of all four borders. Uses the same 1-to-4 value shorthand as `margin`.\n\nKeywords: `thin` (~1px), `medium` (~3px), `thick` (~5px).\n\nIndividual sides: `border-top-width`, `border-right-width`, etc." }]
+    },
+    "border-style": {
+      "contents": [{ "value": "```css\nborder-style: none | solid | dashed | dotted | double | groove | ridge | inset | outset | hidden;\n```\n\nSets the line style of all four borders. `none` and `hidden` both render no border, but `hidden` wins in border-collapsing table cells." }]
+    },
+    "border-color": {
+      "contents": [{ "value": "```css\nborder-color: <color>{1,4};\n```\n\nSets the color of all four borders. Uses 1-to-4 value shorthand.\n\nDefaults to `currentColor` if not specified." }]
+    },
+    "outline": {
+      "contents": [{ "value": "```css\noutline: <width> <style> <color>;\n```\n\nDraws a line outside the element's border. Does NOT affect layout (no space taken).\n\nUnlike `border`, `outline` doesn't have corners — use `outline-offset` to push it away from the element.\n\n`outline: 2px solid blue;` is the default focus indicator in many browsers.\n`outline: none;` removes it (only do this with a visible alternative)." }]
+    },
+    "box-shadow": {
+      "contents": [{ "value": "```css\nbox-shadow: <inset>? <offset-x> <offset-y> <blur> <spread>? <color>;\n```\n\nAdds shadow effects. Supports multiple shadows separated by commas.\n\nExamples:\n```css\nbox-shadow: 0 1px 3px rgba(0,0,0,0.12), 0 1px 2px rgba(0,0,0,0.24);\nbox-shadow: inset 0 2px 4px rgba(0,0,0,0.1);\nbox-shadow: 0 0 0 3px rgba(66,153,225,0.5); /* ring effect */\n```" }]
+    },
+    "filter": {
+      "contents": [{ "value": "```css\nfilter: <filter-function>+;\n```\n\nFunctions: `blur()`, `brightness()`, `contrast()`, `grayscale()`, `hue-rotate()`, `invert()`, `opacity()`, `saturate()`, `sepia()`, `drop-shadow()`.\n\nExamples:\n```css\nfilter: blur(4px);\nfilter: grayscale(100%) brightness(0.8);\nfilter: drop-shadow(2px 4px 6px rgba(0,0,0,0.3));\n```\n\n`drop-shadow()` follows the alpha shape (unlike `box-shadow`)." }]
+    },
+    "backdrop-filter": {
+      "contents": [{ "value": "```css\nbackdrop-filter: <filter-function>+;\n```\n\nApplies filter effects to the area behind an element. Uses the same functions as `filter`.\n\nGlass morphism pattern:\n```css\nbackdrop-filter: blur(10px);\nbackground-color: rgba(255, 255, 255, 0.3);\n```\n\nRequires a transparent/semi-transparent background to be visible." }]
+    },
+    "mix-blend-mode": {
+      "contents": [{ "value": "```css\nmix-blend-mode: normal | multiply | screen | overlay | darken | lighten | color-dodge | color-burn | hard-light | soft-light | difference | exclusion | hue | saturation | color | luminosity;\n```\n\nDefines how an element's content blends with the content behind it.\n\n`isolation: isolate;` on a parent creates a new stacking context, preventing blend from affecting ancestors." }]
+    },
+    "object-fit": {
+      "contents": [{ "value": "```css\nobject-fit: fill | contain | cover | none | scale-down;\n```\n\nSets how `<img>`, `<video>`, or other replaced elements resize to fit their container.\n\n- `cover` — fill container, maintain aspect ratio (may crop)\n- `contain` — fit entirely, maintain aspect ratio (may letterbox)\n- `fill` — stretch to fill (may distort)\n- `none` — natural size\n- `scale-down` — `none` or `contain`, whichever is smaller\n\nUsed with `object-position` to control placement." }]
+    },
+    "object-position": {
+      "contents": [{ "value": "```css\nobject-position: <position>;\n```\n\nSets the alignment of replaced content within its box. Uses the same syntax as `background-position`.\n\nDefault: `50% 50%` (centered).\nExample: `object-position: top center;`" }]
+    },
+    "aspect-ratio": {
+      "contents": [{ "value": "```css\naspect-ratio: auto | <width> / <height>;\n```\n\nSets a preferred aspect ratio for the element's box.\n\nExamples:\n- `aspect-ratio: 16 / 9;` — widescreen video\n- `aspect-ratio: 1;` — square\n- `aspect-ratio: 4 / 3;` — classic photo\n\nWorks with `width: 100%;` to create responsive containers that maintain their ratio." }]
+    },
+    "overflow-x": {
+      "contents": [{ "value": "```css\noverflow-x: visible | hidden | clip | scroll | auto;\n```\n\nControls horizontal overflow behavior.\n`overflow-x: auto;` adds a scrollbar only when content overflows horizontally." }]
+    },
+    "overflow-y": {
+      "contents": [{ "value": "```css\noverflow-y: visible | hidden | clip | scroll | auto;\n```\n\nControls vertical overflow behavior.\n`overflow-y: auto;` adds a scrollbar only when content overflows vertically." }]
+    },
+    "visibility": {
+      "contents": [{ "value": "```css\nvisibility: visible | hidden | collapse;\n```\n\n- `visible` — element is visible\n- `hidden` — element is invisible but still occupies space (unlike `display: none`)\n- `collapse` — for table elements, removes row/column; behaves like `hidden` for others\n\nHidden elements still receive events and can be tab-focused." }]
+    },
+    "pointer-events": {
+      "contents": [{ "value": "```css\npointer-events: auto | none;\n```\n\n- `auto` — element responds to pointer events normally\n- `none` — element is \"transparent\" to pointer events; clicks pass through to elements below\n\nUseful for overlays, disabled states, and decorative elements." }]
+    },
+    "user-select": {
+      "contents": [{ "value": "```css\nuser-select: auto | text | none | all | contain;\n```\n\nControls whether text can be selected.\n\n- `none` — prevents text selection (useful for UI elements)\n- `all` — entire element selected on click (useful for code blocks)\n- `text` — text can be selected normally" }]
+    },
+    "resize": {
+      "contents": [{ "value": "```css\nresize: none | both | horizontal | vertical | block | inline;\n```\n\nSets whether an element is resizable by the user.\n\nRequires `overflow` other than `visible`. `<textarea>` is resizable by default." }]
+    },
+    "scroll-behavior": {
+      "contents": [{ "value": "```css\nscroll-behavior: auto | smooth;\n```\n\nSets whether scrolling is instant or animated.\n\n`html { scroll-behavior: smooth; }` enables smooth scrolling for all anchor links and `scrollTo()` calls." }]
+    },
+    "scroll-snap-type": {
+      "contents": [{ "value": "```css\nscroll-snap-type: none | <axis> <strictness>?;\n```\n\nAxis: `x`, `y`, `block`, `inline`, `both`.\nStrictness: `mandatory`, `proximity`.\n\nCarousel pattern:\n```css\n.container { scroll-snap-type: x mandatory; overflow-x: auto; }\n.item { scroll-snap-align: start; }\n```" }]
+    },
+    "will-change": {
+      "contents": [{ "value": "```css\nwill-change: auto | <property>+;\n```\n\nHints to the browser about upcoming changes for optimization.\n\nExamples:\n- `will-change: transform;` — optimizes for transform animations\n- `will-change: opacity;` — optimizes for opacity changes\n\nUse sparingly — add before animation, remove after. Excessive use wastes GPU memory." }]
+    },
+    "contain": {
+      "contents": [{ "value": "```css\ncontain: none | strict | content | size | layout | style | paint;\n```\n\nIndicates containment restrictions to the browser for performance optimization.\n\n- `layout` — element's layout is independent of the rest of the page\n- `paint` — descendants are not rendered outside the element's bounds\n- `size` — element's size is not affected by its descendants\n- `content` — shorthand for `layout paint style`\n- `strict` — shorthand for `layout paint size style`" }]
+    },
+    "accent-color": {
+      "contents": [{ "value": "```css\naccent-color: auto | <color>;\n```\n\nSets the accent color for form controls: checkboxes, radio buttons, range sliders, and progress bars.\n\n`accent-color: auto;` uses the browser/OS default.\n\nSimplifies form theming without custom styling." }]
+    },
+    "color-scheme": {
+      "contents": [{ "value": "```css\ncolor-scheme: normal | light | dark | light dark;\n```\n\nIndicates which color schemes the element supports.\n\n`:root { color-scheme: light dark; }` tells the browser both are supported, enabling native dark mode for form controls, scrollbars, and other UA-rendered elements." }]
+    },
+    "::placeholder": {
+      "contents": [{ "value": "```css\n::placeholder {\n  color: <color>;\n  opacity: <number>;\n  font-style: <style>;\n}\n```\n\nStyles the placeholder text of `<input>` and `<textarea>` elements.\n\nNote: Default opacity varies by browser (Firefox uses 0.54). Set `opacity: 1;` for consistent rendering." }]
+    },
+    "@container": {
+      "contents": [{ "value": "```css\n@container <name>? (<condition>) { ... }\n```\n\nApplies styles based on the size of a containing element (not the viewport).\n\nConditions: `min-width`, `max-width`, `min-height`, `max-height`, `width`, `inline-size`, `block-size`.\n\nRequires `container-type` on ancestor:\n```css\n.parent { container-type: inline-size; container-name: card; }\n@container card (min-width: 400px) { .child { flex-direction: row; } }\n```" }]
+    },
+    "@layer": {
+      "contents": [{ "value": "```css\n@layer <name>;\n@layer <name> { ... }\n@layer <name1>, <name2>, <name3>;\n```\n\nDeclares cascade layers to control specificity ordering.\n\n- Layers declared earlier have **lower** priority\n- Unlayered styles have **higher** priority than layered styles\n- Layers can be nested: `@layer framework.components { }`\n\nUseful for managing third-party CSS specificity conflicts." }]
+    },
+    "@supports": {
+      "contents": [{ "value": "```css\n@supports (<condition>) { ... }\n@supports not (<condition>) { ... }\n@supports (<condition>) and (<condition>) { ... }\n```\n\nFeature queries — conditionally applies styles based on browser support.\n\nExamples:\n```css\n@supports (display: grid) { .layout { display: grid; } }\n@supports selector(:has()) { .parent:has(.child) { color: red; } }\n@supports (backdrop-filter: blur(10px)) { .glass { backdrop-filter: blur(10px); } }\n```" }]
+    },
+    "@import": {
+      "contents": [{ "value": "```css\n@import url(<path>) <media>? <layer>?;\n```\n\nImports an external stylesheet. Must appear before all rules except `@charset` and `@layer`.\n\nExamples:\n```css\n@import url('reset.css');\n@import url('print.css') print;\n@import url('lib.css') layer(lib);\n@import url('dark.css') (prefers-color-scheme: dark);\n```\n\nNote: Multiple `@import` rules create sequential blocking requests. Consider bundling instead." }]
+    },
+    "min()": {
+      "contents": [{ "value": "```css\nmin(<value>, <value>, ...)\n```\n\nReturns the smallest value from a comma-separated list.\n\nExample: `width: min(100%, 600px);` — never exceeds 600px but also never exceeds parent width.\n\nEquivalent to `max-width`-like behavior without a separate property." }]
+    },
+    "max()": {
+      "contents": [{ "value": "```css\nmax(<value>, <value>, ...)\n```\n\nReturns the largest value from a comma-separated list.\n\nExample: `width: max(300px, 50%);` — at least 300px but grows with parent.\n\nEquivalent to `min-width`-like behavior without a separate property." }]
+    },
+    ":has()": {
+      "contents": [{ "value": "```css\n:has(<selector>)\n```\n\nThe \"parent selector\" — matches an element if any of its descendants match the argument selector.\n\nExamples:\n```css\n.card:has(img) { padding: 0; }\n.form:has(:invalid) { border-color: red; }\nh2:has(+ p) { margin-bottom: 0; } /* h2 followed by p */\n```\n\nHighly powerful but use carefully for performance — browser evaluates from the subject outward." }]
+    },
+    ":is()": {
+      "contents": [{ "value": "```css\n:is(<selector-list>)\n```\n\nMatches any element that can be matched by one of the selectors in the list. Simplifies complex selectors.\n\n```css\n:is(h1, h2, h3) { color: blue; }\n:is(.card, .panel) :is(h2, h3) { margin: 0; }\n```\n\nSpecificity: takes the **most specific** selector in the list. Use `:where()` for zero-specificity version." }]
+    },
+    ":where()": {
+      "contents": [{ "value": "```css\n:where(<selector-list>)\n```\n\nSame as `:is()` but with **zero specificity**. Ideal for default stylesheets that should be easily overridable.\n\n```css\n:where(.dialog, .modal) { margin: auto; }\n```" }]
     }
   }
 }