init monorepo

Author: azahnen

.changeset/config.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.1.3/schema.json",
+  "changelog": "@changesets/cli/changelog",
+  "commit": false,
+  "fixed": [],
+  "linked": [["@xtramaps/legend-symbols-maplibre", "@xtramaps/legend-symbols-maplibre-react", "@xtramaps/legend-symbols-maplibre-svelte", "@xtramaps/legend-symbols-maplibre-vue"]],
+  "access": "public",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}

.editorconfig

@@ -0,0 +1,9 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 2
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true

.github/workflows/ci.yml

@@ -0,0 +1,21 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version-file: .nvmrc
+          cache: npm
+      - run: npm ci
+      - run: npm run lint
+      - run: npm run build
+      - run: npm run typecheck

.github/workflows/release.yml

@@ -0,0 +1,30 @@
+name: Release
+
+on:
+  push:
+    branches: [main]
+
+concurrency: ${{ github.workflow }}-${{ github.ref }}
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version-file: .nvmrc
+          cache: npm
+          registry-url: https://registry.npmjs.org
+      - run: npm ci
+      - run: npm run build
+      - uses: changesets/action@v1
+        with:
+          publish: npm run release
+          version: npm run version-packages
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.gitignore

@@ -0,0 +1,7 @@
+node_modules
+dist
+*.tsbuildinfo
+.turbo
+.DS_Store
+.env*
+*.log

.npmrc

@@ -0,0 +1 @@
+save-exact=true

.nvmrc

@@ -0,0 +1 @@
+22

.vscode/extensions.json

@@ -0,0 +1,5 @@
+{
+  "recommendations": [
+    "biomejs.biome"
+  ]
+}

.vscode/settings.json

@@ -0,0 +1,7 @@
+{
+  "editor.defaultFormatter": "biomejs.biome",
+  "editor.formatOnSave": true,
+  "editor.codeActionsOnSave": {
+    "source.organizeImports.biome": "explicit"
+  }
+}

AGENTS.md

@@ -0,0 +1,58 @@
+# Agents
+
+Instructions for AI coding agents working on this repo.
+
+## Project
+
+TypeScript monorepo for libraries enhancing web map clients (`@xtramaps` scope) with framework-specific variants. Libraries are published to npm.
+
+## Structure
+
+```
+packages/
+  vite.config.base.ts  # Shared Vite lib config factory
+  core/<lib>/          # Plain TypeScript (no framework deps)
+  react/<lib>/         # React variant (depends on core, peers on react)
+  vue/<lib>/           # Vue variant (depends on core, peers on vue)
+  svelte/<lib>/        # Svelte variant (depends on core, peers on svelte)
+```
+
+Each library has: `package.json`, `tsconfig.json`, `vite.config.ts`, `src/index.ts`.
+
+## Naming
+
+- `@xtramaps/<lib>` — core package
+- `@xtramaps/<lib>-react` — React variant
+- `@xtramaps/<lib>-vue` — Vue variant
+- `@xtramaps/<lib>-svelte` — Svelte variant
+
+## Commands
+
+- `npm run build` — build all packages (via Turborepo)
+- `npm run lint` — lint and format check (Biome)
+- `npm run lint:fix` — auto-fix lint/format issues
+- `npm run typecheck` — type-check all packages
+
+## Key Conventions
+
+- All packages output ESM + CJS + `.d.ts` via Vite library mode
+- `vite.config.ts` uses `defineLibConfig()` from `packages/vite.config.base.ts`
+- `tsconfig.json` extends `tsconfig.base.json` (must specify `outDir`, `rootDir`, `include` locally)
+- Shared devDeps (`typescript`, `vite`, `vite-plugin-dts`) live in root only — do not add to individual packages
+- Framework deps (react, vue, svelte) are externalized and declared as `peerDependencies`
+- Core deps are listed in `dependencies` (not peers)
+- Biome handles formatting and linting — no Prettier or ESLint
+- Changesets for versioning — run `npx changeset` after changes
+
+## Adding a New Library
+
+1. Create `packages/core/<lib>/` with `package.json`, `tsconfig.json`, `vite.config.ts`, `src/index.ts`
+2. Create corresponding `packages/{react,vue,svelte}/<lib>/` variants
+3. Run `npm install` to link workspaces
+4. Run `npm run build` to verify
+
+## Checks Before Committing
+
+1. `npm run lint` passes
+2. `npm run build` succeeds
+3. `npm run typecheck` passes