@kirana-style/angular 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,33 @@
-# Temporary Holding Version
+# @kirana-style/angular
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Kirana for Angular: the `[sx]` directive for templates, a Vite plugin for Analog, and builders for
+the Angular CLI ([11-integrations](../../../../spec/11-integrations.md), D-068).
+
+```ts
+// a component
+import { Component } from "@angular/core"
+import { SxDirective } from "@kirana-style/angular"
+import { css } from "@kirana-style/core"
+
+const styles = { card: css({ padding: "1rem" }) }
+
+@Component({
+  selector: "app-card",
+  imports: [SxDirective],
+  template: `<div [sx]="styles.card"></div>`,
+})
+export class Card {
+  protected readonly styles = styles
+}
+```
+
+- **`SxDirective`** merges the handles with Kirana's runtime and adds and removes only the classes
+  and custom properties it set. `provideKirana({ prefix })` matches a `names.prefix` other than `k`.
+- **Analog.** `kiranaAngular()` from `@kirana-style/angular/vite`, after `analog()`, compiles the JavaScript
+  Angular emits. Import `@kirana-style/core/stylesheet.css` from `src/main.ts`.
+- **Angular CLI.** In `angular.json`, `@kirana-style/angular:application` and `@kirana-style/angular:dev-server`
+  replace `@angular/build:application` and `:dev-server`, with the same options. They compile the
+  source root into `.kirana/` (ignore it), hand Angular the copy through `fileReplacements`, and add
+  `.kirana/kirana.css` to `styles`.
+
+`kirana init` sets up either. How it works and what it costs: `design-notes/angular.md`.

package/builders.json

@@ -0,0 +1,14 @@
+{
+  "builders": {
+    "application": {
+      "implementation": "./src/application.js",
+      "schema": "./schemas/application.json",
+      "description": "Angular's application builder, with Kirana's compiled sources and stylesheet."
+    },
+    "dev-server": {
+      "implementation": "./src/dev-server.js",
+      "schema": "./schemas/dev-server.json",
+      "description": "Angular's development server, with Kirana's compiled sources and stylesheet."
+    }
+  }
+}

package/package.json

@@ -1,6 +1,64 @@
 {
   "name": "@kirana-style/angular",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Kirana for Angular: the [sx] directive, the Analog (Vite) plugin and Angular CLI builders.",
+  "license": "MIT",
+  "author": "The Kirana authors",
+  "homepage": "https://kirana.style",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kirana-style/kirana.git",
+    "directory": "packages/kirana/npm/angular"
+  },
+  "bugs": {
+    "url": "https://github.com/kirana-style/kirana/issues"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "default": "./src/index.js"
+    },
+    "./vite": {
+      "types": "./src/vite.d.ts",
+      "default": "./src/vite.js"
+    },
+    "./package.json": "./package.json",
+    "./builders.json": "./builders.json"
+  },
+  "dependencies": {
+    "@kirana-style/compiler": "0.1.0",
+    "@kirana-style/core": "0.1.0"
+  },
+  "peerDependencies": {
+    "@angular/core": ">=20.0.0",
+    "@angular/build": ">=20.0.0",
+    "@angular-devkit/architect": ">=0.2000.0",
+    "@kirana-style/vite": "0.1.0"
+  },
+  "builders": "./builders.json",
+  "peerDependenciesMeta": {
+    "@angular/build": {
+      "optional": true
+    },
+    "@angular-devkit/architect": {
+      "optional": true
+    },
+    "@kirana-style/vite": {
+      "optional": true
+    }
+  },
+  "files": [
+    "src",
+    "bin",
+    "*.d.ts",
+    "*.css",
+    "README.md",
+    "builders.json",
+    "schemas",
+    "gatsby-node.mjs",
+    "rules",
+    "recommended.json",
+    "strict.json"
+  ]
+}