@wojciechpiskorz/astroix 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Woji Piskorz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,38 @@
+# Astroix
+
+A visual builder for Astro projects — a dev-only integration where an AI agent does ~90% of the work, and you finish the last 10% (content tweaks, CSS polish) in a GUI instead of hunting through an unfamiliar codebase.
+
+**Status: scaffold.** The package structure, toolchain, CI, and the e2e fixture are in place; feature implementation is starting. Docs remain the source of truth.
+
+## What it will do
+
+- **Content tab** — edit Astro Content Collections through forms generated from zod schemas; markdown body editing; writes real `.md` files.
+- **CSS tab** — click any element on the live canvas (same-origin iframe), see which rules style it and **where they live in your repo** (file + line), edit them in place (declaration widgets or raw CSS), and have changes written back to the source files with minimal diffs. Live bidirectional sync with your IDE.
+
+Core principle: **repo-mapping, not a parallel world** — the builder reads and writes the same files an agent would, so the repo stays coherent for both humans and AI.
+
+## Docs
+
+- [`docs/spec.md`](docs/spec.md) — product spec: problem, solution, user stories, implementation decisions, testing strategy
+- [`docs/stack.md`](docs/stack.md) — technology stack and the reasoning behind each choice
+- [`docs/core-reuse.md`](docs/core-reuse.md) — inventory of Astro/Vite core APIs reused instead of rebuilt
+
+## Scope
+
+Targets the latest Astro major only (`astro ^7`, Vite 8, zod 4) — built for new projects and their maintenance, not for legacy support.
+
+## Development
+
+Requires [bun](https://bun.sh) and Node >= 22.12.
+
+```sh
+bun install                        # also in e2e/fixture/
+bun run check && bun run typecheck # Biome + tsc
+bun run test                       # vitest (unit)
+bun run test:e2e                   # Playwright (boots e2e/fixture on :4312)
+bun run build                      # tsup → dist
+```
+
+## License
+
+[MIT](LICENSE)

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import { AstroIntegration } from 'astro';
+
+/**
+ * Astroix — dev-only visual builder integration (scaffold stage).
+ *
+ * Registers no hooks yet; the Vite plugin, `?builder=1` middleware, virtual
+ * chrome module and watcher land with the integration tasks — see docs/spec.md
+ * and docs/core-reuse.md for the agreed mechanics.
+ */
+declare function astroix(): AstroIntegration;
+
+export { astroix as default };

package/dist/index.js

@@ -0,0 +1,12 @@
+// src/node/index.ts
+function astroix() {
+  return {
+    name: "astroix",
+    hooks: {}
+  };
+}
+var node_default = astroix;
+export {
+  node_default as default
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/node/index.ts"],"sourcesContent":["import type { AstroIntegration } from 'astro';\n\n/**\n * Astroix — dev-only visual builder integration (scaffold stage).\n *\n * Registers no hooks yet; the Vite plugin, `?builder=1` middleware, virtual\n * chrome module and watcher land with the integration tasks — see docs/spec.md\n * and docs/core-reuse.md for the agreed mechanics.\n */\nfunction astroix(): AstroIntegration {\n  return {\n    name: 'astroix',\n    hooks: {},\n  };\n}\n\nexport default astroix;\n"],"mappings":";AASA,SAAS,UAA4B;AACnC,SAAO;AAAA,IACL,MAAM;AAAA,IACN,OAAO,CAAC;AAAA,EACV;AACF;AAEA,IAAO,eAAQ;","names":[]}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@wojciechpiskorz/astroix",
+  "version": "0.0.1",
+  "description": "Dev-only Astro 7 integration — a visual builder for Content Collections content and repo-mapped CSS",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wojtekpiskorz/astroix.git"
+  },
+  "keywords": [
+    "astro",
+    "astro-integration",
+    "visual-builder",
+    "devtools",
+    "css"
+  ],
+  "engines": {
+    "node": ">=22.12"
+  },
+  "packageManager": "bun@1.3.14",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "check": "biome check .",
+    "check:write": "biome check --write .",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:e2e": "playwright test",
+    "changeset": "changeset"
+  },
+  "peerDependencies": {
+    "astro": "^7.0.0",
+    "vite": "^8.0.0"
+  },
+  "dependencies": {
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.5.10",
+    "@changesets/cli": "^3.0.1",
+    "@playwright/test": "^1.62.1",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.5",
+    "astro": "^7.2.7",
+    "happy-dom": "^20.11.6",
+    "tsup": "^8.5.1",
+    "typescript": "~5.9.3",
+    "vite": "^8.2.2",
+    "vitest": "^4.1.11"
+  }
+}