vite integration (#77)

* explicit type imports

* vite integration

* example vite project

* update labeler github action

* docs updates

Author: theoephraim

.changeset/empty-seals-fail.md

@@ -0,0 +1,6 @@
+---
+"@varlock/vite-integration": patch
+"varlock": patch
+---
+
+vite integration

.github/config/labeler.yaml

@@ -11,8 +11,14 @@ parser:
 vscode-plugin:
 - changed-files:
   - any-glob-to-any-file: 'packages/vscode-plugin/*'
+nextjs-integration:
+- changed-files:
+  - any-glob-to-any-file: 'packages/integrations/nextjs/*'
+vite-integration:
+- changed-files:
+  - any-glob-to-any-file: 'packages/integrations/vite/*'
 
 ## website + docs
 docs:
 - changed-files:
-  - any-glob-to-any-file: 'packages/varlock-website/*'
+  - any-glob-to-any-file: 'packages/varlock-website/*'

README.md

@@ -1,24 +1,51 @@
-# Varlock
-
-![og-image](/packages/varlock-website/public/default-og-image.png)
-
-> See https://varlock.dev for docs and examples. 
+<p align="center">
+  <a href="https://varlock.dev" target="_blank" rel="noopener noreferrer">
+    <img src="/packages/varlock-website/public/default-og-image.png" alt="Varlock banner">
+  </a>
+</p>
+<br/>
+<p align="center">
+  <a href="https://npmjs.com/package/varlock"><img src="https://img.shields.io/npm/v/varlock.svg" alt="npm package"></a>
+  <a href="/LICENSE.md"><img src="https://img.shields.io/npm/l/varlock.svg" alt="license"></a>
+  <a href="https://nodejs.org/en/about/previous-releases"><img src="https://img.shields.io/node/v/varlock.svg" alt="node compatibility"></a>
+  <a href="https://github.com/dmno-dev/varlock/actions/workflows/test.yaml"><img src="https://img.shields.io/github/actions/workflow/status/dmno-dev/varlock/test.yaml?style=flat&logo=github&label=CI" alt="build status"></a>
+  <a href="https://chat.dmno.dev"><img src="https://img.shields.io/badge/chat-discord-5865F2?style=flat&logo=discord" alt="discord chat"></a>
+</p>
+<br/>
+
+## Varlock
+> add declarative schema to your .env files using @env-spec decorator comments
+
+- 🛡️ validation, coercion, type safety
+- 🔏 protection for sensitive config values (log redaction, leak prevention)
+- 🌐 flexible multi-environment management
+- 📦 composition of values
+
+### Published Packages
+| Package | Published listing page |
+| --- | --- |
+| [varlock](packages/varlock) | [![npm version](https://img.shields.io/npm/v/varlock.svg)](https://npmjs.com/package/varlock) |
+| [@env-spec/parser](packages/env-spec-parser) | [![npm version](https://img.shields.io/npm/v/@env-spec/parser.svg)](https://npmjs.com/package/@env-spec/parser) |
+| [@env-spec VSCode extension](packages/vscode-plugin) | [VSCode Marketplace](https://marketplace.visualstudio.com/items?itemName=varlock.env-spec-language), [Open VSX Registry](https://open-vsx.org/extension/varlock/env-spec-language) |
+| [@varlock/nextjs-integration](packages/integrations/nextjs) | [![npm version](https://img.shields.io/npm/v/@varlock/nextjs-integration.svg)](https://npmjs.com/package/@varlock/nextjs-integration) |
+
+By adding these comments to a `.env.schema` that lives within version control, you can safely share this with your team.
 
 _A sample `.env.schema`_: 
 ```bash
-# @envFlag=APP_ENV
+# @defaultSensitive=false @defaultRequired=infer @envFlag=APP_ENV
 # ---
-
-# @type=enum(development, staging, production)
-APP_ENV=development #sets default value
+# our environment flag, will control loading of `.env.xxx` files
+# @type=enum(development, preview, production, test
+APP_ENV=development # default value, can override
 
 # API port
 # @type=port @example=3000
 API_PORT= 
 
 # API url including expansion of another env var
 # @required @type=url
-API_URL=localhost:${API_PORT} 
+API_URL=http://localhost:${API_PORT} 
 
 # API key with validation, securely fetched from 1Password
 # @required @sensitive @type=string(startsWith=sk-)
@@ -70,6 +97,6 @@ Varlock is built on top of @env-spec, a new DSL for attaching a schema and addit
 - @env-spec [RFC](https://github.com/dmno-dev/varlock/discussions/17)
 
 
-## Development
+## Development & Contribution
 
-See [CONTRIBUTING.md](CONTRIBUTING.md) for more information.
+See [CONTRIBUTING.md](CONTRIBUTING.md) for more information.

example-repo/.env.development …monorepo/packages/basic/.env.developmentexample-repo/.env.development renamed to example-monorepo/packages/basic/.env.development example-repo/.env.development renamed to example-monorepo/packages/basic/.env.development

@@ -14,12 +14,12 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
-    "dotenv": "link:../packages/varlock",
+    "dotenv": "link:../../../packages/varlock",
     "openai": "^5.5.1",
-    "varlock": "link:../packages/varlock"
+    "varlock": "link:../../../packages/varlock"
   },
   "packageManager": "pnpm@10.8.1",
   "devDependencies": {
-    "@types/node": "^22.14.1"
+    "@types/node": "catalog:"
   }
 }