[pull] master from rstacruz:master

.eslintrc.cjs

@@ -0,0 +1,37 @@
+/* eslint-env node */
+module.exports = {
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/recommended',
+    'plugin:astro/recommended',
+    'prettier'
+  ],
+  env: {
+    browser: true // enables window, document, etc
+  },
+  parser: '@typescript-eslint/parser',
+  plugins: ['@typescript-eslint'],
+  root: true,
+  ignorePatterns: ['dist/**'],
+
+  overrides: [
+    {
+      files: ['*.test.ts'],
+      rules: {
+        '@typescript-eslint/no-explicit-any': 'off'
+      }
+    },
+    {
+      files: ['*.astro'],
+      parser: 'astro-eslint-parser',
+      parserOptions: {
+        parser: '@typescript-eslint/parser',
+        extraFileExtensions: ['.astro']
+      }
+      // rules: {
+      // override/add rules settings here, such as:
+      // "astro/no-set-html-directive": "error"
+      // },
+    }
+  ]
+}

.github/workflows/build.yml

@@ -1,50 +1,39 @@
-name: Build and test
-on: push
-
+name: Run tests
+on:
+  push:
+    branches: [main, master]
+  pull_request:
+    branches: [main, master]
 jobs:
   build:
     runs-on: ubuntu-latest
-
     steps:
-      - uses: actions/checkout@v2
-
-      # https://github.com/actions/cache/blob/master/examples.md#node---yarn
-      - name: "Cache: Get yarn cache directory path"
-        id: yarn-cache-dir-path
-        run: echo "::set-output name=dir::$(yarn cache dir)"
-
-      - name: "Cache: Set up yarn cache"
-        uses: actions/cache@v2
-        id: yarn-cache
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
         with:
-          path: ${{ steps.yarn-cache-dir-path.outputs.dir }}
-          key: ${{ runner.os }}-yarn-${{ hashFiles('**/yarn.lock') }}
-          restore-keys: |
-            ${{ runner.os }}-yarn-
-
-      # https://github.com/actions/cache/blob/master/examples.md#ruby---bundler
-      - name: "Cache: Set up bundler cache"
-        uses: actions/cache@v2
+          bundler-cache: true
+      - uses: actions/setup-node@v4
         with:
-          path: vendor/bundle
-          key: ${{ runner.os }}-gems-${{ hashFiles('**/Gemfile.lock') }}
-          restore-keys: |
-            ${{ runner.os }}-gems-
-
-      - name: Use Node.js
-        uses: actions/setup-node@v1
-        with: { node-version: '12.x' }
-
-      - name: Use Ruby
-        uses: actions/setup-ruby@v1
-        with: { ruby-version: '2.7' }
+          node-version-file: .node-version
+      - uses: pnpm/action-setup@v3
+        with: { run_install: false }
 
-      - name: Setup dependencies
+      # https://github.com/pnpm/action-setup?tab=readme-ov-file#use-cache-to-reduce-installation-time
+      - name: Get pnpm store directory
+        shell: bash
         run: |
-          yarn --frozen-lockfile
-          bundle config path vendor/bundle
-          bundle install --jobs 4 --retry 3
-
-      - run: yarn build
-      - run: yarn test
-      - run: yarn test:smoke
+          echo "STORE_PATH=$(pnpm store path --silent)" >> $GITHUB_ENV
+      - uses: actions/cache@v4
+        name: Setup pnpm cache
+        with:
+          path: ${{ env.STORE_PATH }}
+          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
+          restore-keys: |
+            ${{ runner.os }}-pnpm-store-
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+      - name: Install playwright browsers
+        run: pnpm playwright install --with-deps chromium
+      - name: Run tests
+        run: pnpm run ci

.gitignore

@@ -1,10 +1,26 @@
-_output
-_site
-.jekyll-metadata
-/node_modules
-/vendor
-.idea/
-
-# Generated by 'yarn dev'
-/_includes/2017/critical/*
-/assets/packed/*
+# build output
+dist/
+# generated types
+.astro/
+
+# dependencies
+node_modules/
+
+# logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+
+# environment variables
+.env
+.env.production
+
+# macOS-specific files
+.DS_Store
+
+.cache
+
+# playwright
+test-results

.node-version

@@ -0,0 +1 @@
+22.21.1

.prettierignore

@@ -0,0 +1,6 @@
+src/sass/vendor
+vendor
+.cache
+dist
+*.md
+pnpm-lock.yaml

.prettierrc

@@ -1,6 +1,6 @@
 {
   "semi": false,
   "singleQuote": true,
-  "jsxSingleQuote": true,
-  "trailingComma": "none"
+  "trailingComma": "none",
+  "plugins": ["prettier-plugin-astro"]
 }

.ruby-version

@@ -0,0 +1 @@
+3.2.2

.vscode/extensions.json

@@ -0,0 +1,4 @@
+{
+  "recommendations": ["astro-build.astro-vscode"],
+  "unwantedRecommendations": []
+}

.vscode/launch.json

@@ -0,0 +1,11 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "command": "./node_modules/.bin/astro dev",
+      "name": "Development server",
+      "request": "launch",
+      "type": "node-terminal"
+    }
+  ]
+}

.vscode/markdown.code-snippets

@@ -0,0 +1,8 @@
+{
+  "Test snip": {
+    "prefix": ["about"],
+    "body": "Copyright. Foo Corp 2028",
+    "description": "Adds copyright...",
+    "scope": "markdown"
+  }
+}

101.md

@@ -1,7 +1,6 @@
 ---
 title: 101
 category: JavaScript libraries
-layout: 2017/sheet
 updated: 2017-09-21
 intro: |
   [101](https://www.npmjs.com/package/101) is a JavaScript library for dealing with immutable data in a functional manner.

AGENTS.md

@@ -0,0 +1,25 @@
+# Agent guidelines for devhints.io
+
+## Commands
+
+- **Dev server**: `pnpm dev` (requires Ruby for markdown caching)
+- **Build**: `pnpm build`
+- **Test**: `pnpm test` (runs Vitest in watch mode)
+- **Run single test**: `pnpm vitest run <file-path>` or `pnpm vitest <file-path>` (watch mode)
+- **All tests (CI)**: `pnpm ci` (runs all linters, tests, and build)
+- **Lint**: `pnpm eslint:check` or `pnpm prettier:check`
+- **Format**: `pnpm format` (runs both ESLint and Prettier fixes)
+
+## Code style
+
+- **Package manager**: pnpm (v8.15.4+)
+- **Framework**: Astro with TypeScript (strict mode), Tailwind CSS
+- **Imports**: Use `~/` alias for `src/` directory; Prettier organizes imports automatically
+- **Types**: Use Zod schemas for runtime validation (see `SheetFrontmatter.ts`); TypeScript strict mode enabled
+- **Naming**: camelCase for variables/functions, PascalCase for components/types
+- **Error handling**: Distinguish operational (expected) vs unexpected errors; return error objects for operational errors
+- **Testing**: Vitest with globals enabled; use `it.each()` for repeated test cases; prefer object constants over helper functions
+
+## Markdown files
+
+Consult @_docs/writing-guidelines.md for formatting *.md files.