@teacss/astro 0.3.0

package/LICENSE

@@ -0,0 +1,22 @@
+# MIT License
+
+Copyright (c) 2021-PRESENT Anthony Fu <https://github.com/antfu>
+Copyright (c) 2026-PRESENT Billgo <hi@billgo.me>
+
+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,43 @@
+# @teacss/astro
+
+**Astro integration for TeaCSS.**
+
+## Purpose
+
+The integration registers the TeaCSS Vite plugin and injects the generated
+stylesheet into Astro pages.
+
+Use this package when an Astro application should configure TeaCSS through
+Astro's `integrations` array. It owns the Astro lifecycle and page injection
+around `@teacss/vite`; non-Astro Vite applications should use the Vite
+integration directly.
+
+## Usage
+
+```ts
+import { defineConfig } from "astro/config";
+import { pluginTeacss } from "teacss/astro";
+
+export default defineConfig({
+  integrations: [pluginTeacss()],
+});
+```
+
+Use `injectEntry: false` when you want to import `virtual:teacss.css` yourself.
+A string value fully replaces that default import, so it must import
+`virtual:teacss.css` itself when the generated stylesheet is still needed.
+Use `injectExtra` to keep the default and add other module statements:
+
+```ts
+pluginTeacss({
+  injectExtra: ['import "./src/styles.css";', 'import "./src/fonts.css";'],
+});
+```
+
+All string values are complete module statements, not bare paths.
+
+## Status
+
+Pre-1.0. Install `@teacss/astro` beside `teacss`, then use the stable
+`teacss/astro` facade subpath in applications. Integration authors may import
+`@teacss/astro` directly when they intentionally do not use the facade.

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+import { TeacssVitePluginConfig } from "@teacss/vite";
+import { UserConfigDefaults } from "@teacss/core";
+import { AstroIntegration } from "astro";
+//#region src/index.d.ts
+interface AstroIntegrationConfig<Theme extends object = object> extends TeacssVitePluginConfig<Theme> {
+  /**
+   * Inject the TeaCSS entry (`import "virtual:teacss.css"`) into every page.
+   * Pass complete module code to replace the default statement. A replacement
+   * must import `virtual:teacss.css` itself when the generated stylesheet is
+   * still needed; use `injectExtra` to add modules without replacing it.
+   *
+   * @default true
+   */
+  injectEntry?: boolean | string;
+  /**
+   * Extra module statements to inject into every page.
+   *
+   * @default []
+   */
+  injectExtra?: string[];
+}
+declare function pluginTeacss<Theme extends object>(options?: AstroIntegrationConfig<Theme>, defaults?: UserConfigDefaults): AstroIntegration;
+//#endregion
+export { AstroIntegrationConfig, pluginTeacss };

package/dist/index.js

@@ -0,0 +1,2 @@
+import{join as e}from"node:path";import{pluginTeacss as t}from"@teacss/vite";import{normalizePath as n}from"vite";const r=`teacss-astro`;function i(t){let i=t.join(`
+`),a,o;return{name:`teacss:astro`,enforce:`pre`,configResolved(e){a=e.root;let t=e.plugins.find(e=>e.name===`teacss:api`)?.api;if(!t)throw Error(`[@teacss/astro] Unable to find TeaCSS Vite plugin API`);o=t.getContext()},async resolveId(t,i){if(t===r)return t;let{RESOLVED_ID_RE:s}=await o.getVMPRegexes();if(s.test(t))return this.resolve(n(e(a,t)),i,{skipSelf:!0})},load(e){if(e===r)return i}}}function a(e={},n={}){let{injectEntry:a=!0,injectExtra:o=[],...s}=e,c=Object.keys(s).length?s:void 0,l=[];return a&&l.push(typeof a==`string`?a:`import "virtual:teacss.css";`),l.push(...o),{name:`@teacss/astro`,hooks:{"astro:config:setup":({updateConfig:e,injectScript:a})=>{e({vite:{plugins:[...t(c,n),i(l)]}}),l.length&&a(`page-ssr`,`import ${JSON.stringify(r)}`)}}}}export{a as pluginTeacss};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@teacss/astro",
+  "version": "0.3.0",
+  "description": "Astro integration for TeaCSS — registers the Vite plugin and injects the generated stylesheet.",
+  "homepage": "https://css.teasim.com",
+  "funding": "https://github.com/sponsors/billgo",
+  "license": "MIT",
+  "author": "Billgo <hi@billgo.me>",
+  "sideEffects": false,
+  "type": "module",
+  "exports": {
+    ".": "./dist/index.js",
+    "./package.json": "./package.json"
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "bunx tsdown --config tsdown.config.mts",
+    "dev": "tsdown --watch"
+  },
+  "dependencies": {
+    "@teacss/core": "0.3.0",
+    "@teacss/vite": "0.3.0"
+  },
+  "devDependencies": {
+    "astro": "^7.1.3",
+    "vite": "^8.1.5"
+  },
+  "peerDependencies": {
+    "astro": ">=7.0.0",
+    "vite": ">=8.0.0"
+  },
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}