Codebase Refactoring (#4)

* remove unused function

* remove imports from next

* dedupe isStringOrURL

* remove any in resolveArray

* prefer _metaFilter

* rename functions in utils

* fix naming inconsistency

* remove next dependency

* remove React type

* remove any

* add tests for normalize

* add more tests for normalize

* add AGENTS.md

* update README.md

* changeset

* add sharp-baboons-rest.md

Author: morinokami

.changeset/README.md

@@ -0,0 +1,8 @@
+# Changesets
+
+Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
+with multi-package repos, or single-package repos to help you version and publish your code. You can
+find the full documentation for it [in our repository](https://github.com/changesets/changesets)
+
+We have a quick list of common questions to get you started engaging with this project in
+[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md)

.changeset/config.json

@@ -0,0 +1,14 @@
+{
+	"$schema": "https://unpkg.com/@changesets/config@3.1.1/schema.json",
+	"changelog": [
+		"@changesets/changelog-github",
+		{ "repo": "morinokami/tanstack-meta" }
+	],
+	"commit": false,
+	"fixed": [],
+	"linked": [],
+	"access": "public",
+	"baseBranch": "main",
+	"updateInternalDependencies": "patch",
+	"ignore": ["playground"]
+}

.changeset/sharp-baboons-rest.md

@@ -0,0 +1,5 @@
+---
+"tanstack-meta": patch
+---
+
+Codebase Refactoring

.github/workflows/ci.yml

@@ -25,6 +25,12 @@ jobs:
       - name: Install dependencies
         run: bun install --frozen-lockfile
 
+      - name: Type check
+        run: bun meta typecheck
+
+      - name: Lint
+        run: bun meta lint
+
       - name: Test
         run: bun test
 

.github/workflows/release.yml

@@ -0,0 +1,41 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  id-token: write
+  contents: write
+  pull-requests: write
+
+jobs:
+  release:
+    name: Release
+    if: ${{ github.repository_owner == 'morinokami' }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v5
+
+      - name: Install Bun
+        uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        run: bun install --frozen-lockfile
+
+      - name: Build
+        run: bun meta build
+
+      - name: Create Release Pull Request
+        uses: changesets/action@v1
+        with:
+          version: bunx changeset version
+          publish: bunx changeset publish
+          commit: "[ci] release"
+          title: "[ci] release"
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

AGENTS.md

@@ -0,0 +1,36 @@
+# Repository Guidelines
+
+This repo is a Bun workspace for `tanstack-meta`, a TypeScript utility that turns structured metadata into TanStack Router/Start-compatible head tags. Use the notes below to stay consistent and ship safe changes.
+
+## Project Structure & Module Organization
+- Root manages workspaces; primary package lives in `packages/meta`.
+- Library source is in `packages/meta/src` with focused folders such as `generate`, `normalize`, and `types`; unit tests sit next to implementations as `.test.ts`.
+- Built artifacts are written to `packages/meta/dist` via `tsdown` and are the only exported files.
+- `playground/` is a TanStack Start app wired to the workspace build for manual validation; keep it in sync when changing public APIs.
+
+## Build, Test, and Development Commands
+```bash
+bun install                # install all workspace deps
+bun meta build             # bundle to dist/ with tsdown
+bun test                   # run bun:test suite in src/**
+bun meta lint              # biome lint + format check
+bun meta typecheck         # tsc via tsgo --noEmit
+bun meta publint           # sanity-check published surface
+
+bun playground dev         # optional: preview changes in the demo app
+```
+
+## Coding Style & Naming Conventions
+- Biome enforces tabs for indentation and double quotes; run `bun run lint` before pushing.
+- Code is TypeScript-first; prefer typed helpers over `any`, keep exports small and pure, and mirror the existing `generate*` and `normalize*` naming patterns.
+- Tests follow `bun:test`’s `describe/test/expect` style and reside beside the code they cover.
+
+## Testing Guidelines
+- Add or update `*.test.ts` alongside new logic; extend existing fixtures in `src/generate`/`src/normalize` to cover edge cases.
+- Favor deterministic inputs and explicit expectations; ensure new behavior is exercised in both metadata generation and normalization paths when relevant.
+- Run `bun test` locally; for public API changes, also sanity-check the playground to catch integration regressions.
+
+## Commit & Pull Request Guidelines
+- Use short, imperative commits (e.g., “add more tests for normalize” as seen in the log); group unrelated changes separately.
+- PRs should include a clear summary, rationale, and scope of impact; link issues when applicable.
+- Demonstrate safety: include test results, note playground updates or screenshots for UI-facing tweaks, and update docs when the API or behavior changes.

bun.lock

@@ -13,6 +13,8 @@
 	},
 	"devDependencies": {
 		"@biomejs/biome": "2.3.7",
+		"@changesets/changelog-github": "0.5.1",
+		"@changesets/cli": "2.29.7",
 		"@types/bun": "1.3.3",
 		"pkg-pr-new": "0.0.60"
 	}

package.json

@@ -7,7 +7,7 @@ While it makes the code slightly longer, it improves readability and clarity, an
 
 | Without `tanstack-meta` | With `tanstack-meta` |
 | ----------------------- | -------------------- |
-| ![Screenshot](./.github/assets/before.webp) | ![Screenshot](./.github/assets/after.webp) |
+| ![Screenshot](https://github.com/morinokami/tanstack-meta/blob/main/.github/assets/before.webp?raw=true) | ![Screenshot](https://github.com/morinokami/tanstack-meta/blob/main/.github/assets/after.webp?raw=true) |
 
 ## Usage
 

packages/meta/README.md

@@ -28,11 +28,13 @@
 	],
 	"scripts": {
 		"build": "tsdown",
+		"lint": "biome ci",
+		"typecheck": "tsgo --noEmit",
 		"publint": "publint"
 	},
 	"devDependencies": {
 		"@tanstack/react-router": "1.139.3",
-		"next": "16.0.3",
+		"@typescript/native-preview": "7.0.0-dev.20251125.1",
 		"publint": "0.3.15",
 		"tsdown": "0.16.6"
 	}