release: v1.0.0

Author: etienne-dldc

.github/workflows/publish.yml

@@ -0,0 +1,22 @@
+name: Publish
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: denoland/setup-deno@v1
+        with:
+          deno-version: v2.x
+
+      - run: deno task check
+
+      - run: npx jsr publish

.gitignore

@@ -0,0 +1,18 @@
+.DS_Store
+
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+
+*.tsbuildinfo
+coverage
+node_modules/
+jspm_packages/
+.env
+.env.test
+
+dist

.vscode/settings.json

@@ -0,0 +1,8 @@
+{
+  "deno.enable": true,
+  "editor.defaultFormatter": "denoland.vscode-deno",
+  "npm.autoDetect": "off",
+  "[typescript]": {
+    "editor.defaultFormatter": "denoland.vscode-deno"
+  }
+}

LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2026 Etienne Dldc
+
+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.

README.md

@@ -0,0 +1,42 @@
+# Stachine
+
+> A TypeScript state machine with events and effects
+
+```
+deno add @dldc/stachine
+```
+
+## Gist
+
+```ts
+import { createStachine } from "@dldc/stachine";
+
+type State = { state: "Home" } | { state: "Bed" } | { state: "Work" } | {
+  state: "Error";
+};
+type Action = { action: "Commute" } | { action: "Wake" } | { action: "Sleep" };
+
+const machine = createStachine<State, Action>({
+  initialState: { state: "Home" },
+  createErrorState: () => ({ state: "Error" }),
+  states: {
+    Home: {
+      actions: {
+        Commute: () => ({ state: "Work" }),
+        Sleep: () => ({ state: "Bed" }),
+      },
+    },
+    Work: {
+      actions: {
+        Commute: () => ({ state: "Home" }),
+      },
+    },
+    Bed: {
+      actions: {
+        Wake: () => ({ state: "Home" }),
+      },
+    },
+    Error: {},
+  },
+});
+```

deno.json

@@ -0,0 +1,30 @@
+{
+  "name": "@dldc/css-builder",
+  "version": "1.0.0",
+  "exports": {
+    ".": "./mod.ts",
+    "./ast": "./src/ast.ts",
+    "./builder": "./src/builder.ts",
+    "./create": "./src/create.ts",
+    "./serialize": "./src/serialize.ts"
+  },
+  "imports": {
+    "@std/expect": "jsr:@std/expect@^1.0.16"
+  },
+  "tasks": {
+    "test:run": "deno test -A",
+    "test:watch": "deno test --watch",
+    "bump": "deno run -A jsr:@mys/bump@1",
+    "deps:outdated": "deno outdated",
+    "deps:update": "deno outdated --update --latest --interactive",
+    "check": "deno fmt --check . && deno lint . && deno check **/*.ts && deno task test:run",
+    "test:coverage": "deno test -A --coverage=coverage && deno coverage coverage --html"
+  },
+  "lint": {
+    "rules": {
+      "exclude": [
+        "no-explicit-any"
+      ]
+    }
+  }
+}

deno.lock

@@ -0,0 +1,6 @@
+import type * as Ast from "./src/ast.ts";
+import * as create from "./src/create.ts";
+
+export * from "./src/builder.ts";
+export * from "./src/serialize.ts";
+export { type Ast, create };

mod.ts

@@ -0,0 +1,145 @@
+export type Syntax_PlusSign<T> = readonly [T, ...T[]];
+export type Syntax_Asterisk<T> = readonly T[];
+export type Syntax_HashMark<T> = readonly [
+  T,
+  ...(readonly (readonly [
+    { readonly kind: "token"; readonly value: "," },
+    T,
+  ])[]),
+];
+export type Syntax_QuestionMark<T> = T | null;
+
+export type Min = {
+  readonly kind: "min";
+  readonly value: [
+    { readonly kind: "function"; readonly value: "min" },
+    { readonly kind: "token"; readonly value: "(" },
+    Syntax_HashMark<CalcSum>,
+    { readonly kind: "token"; readonly value: ")" },
+  ];
+};
+
+export type Max = {
+  readonly kind: "max";
+  readonly value: [
+    { readonly kind: "function"; readonly value: "max" },
+    { readonly kind: "token"; readonly value: "(" },
+    Syntax_HashMark<CalcSum>,
+    { readonly kind: "token"; readonly value: ")" },
+  ];
+};
+
+export type Clamp = {
+  readonly kind: "clamp";
+  readonly value: [
+    { readonly kind: "function"; readonly value: "clamp" },
+    { readonly kind: "token"; readonly value: "(" },
+    CalcSum | { readonly kind: "keyword"; readonly value: "none" },
+    { readonly kind: "token"; readonly value: "," },
+    CalcSum,
+    { readonly kind: "token"; readonly value: "," },
+    CalcSum | { readonly kind: "keyword"; readonly value: "none" },
+    { readonly kind: "token"; readonly value: ")" },
+  ];
+};
+
+export type Var = {
+  readonly kind: "var";
+  readonly value: readonly [
+    { readonly kind: "function"; readonly value: "var" },
+    { readonly kind: "token"; readonly value: "(" },
+    { readonly kind: "custom-property"; readonly value: string },
+    Syntax_QuestionMark<
+      readonly [{ readonly kind: "token"; readonly value: "," }, CalcSum]
+    >,
+    { readonly kind: "token"; readonly value: ")" },
+  ];
+};
+
+export type Calc = {
+  readonly kind: "calc";
+  readonly value: [
+    { readonly kind: "function"; readonly value: "calc" },
+    { readonly kind: "token"; readonly value: "(" },
+    CalcSum,
+    { readonly kind: "token"; readonly value: ")" },
+  ];
+};
+
+export type Exp = {
+  readonly kind: "exp";
+  readonly value: [
+    { readonly kind: "function"; readonly value: "exp" },
+    { readonly kind: "token"; readonly value: "(" },
+    CalcSum,
+    { readonly kind: "token"; readonly value: ")" },
+  ];
+};
+
+export type CalcSum =
+  | CalcProduct
+  | {
+    readonly kind: "calc-sum";
+    readonly value: readonly [
+      CalcProduct,
+      Syntax_Asterisk<
+        [{ readonly kind: "token"; readonly value: " + " | " - " }, CalcProduct]
+      >,
+    ];
+  };
+
+export type CalcProduct =
+  | CalcValue
+  | {
+    readonly kind: "calc-product";
+    readonly value: readonly [
+      CalcValue,
+      Syntax_Asterisk<
+        [{ readonly kind: "token"; readonly value: "*" | "/" }, CalcValue]
+      >,
+    ];
+  };
+
+export type CalcValue =
+  | {
+    readonly kind: "number";
+    readonly value: string;
+  }
+  | {
+    readonly kind: "dimension";
+    readonly value: readonly [
+      { readonly kind: "dimension-number"; readonly value: string },
+      { readonly kind: "dimension-unit"; readonly value: string },
+    ];
+  }
+  | {
+    readonly kind: "percentage";
+    readonly value: [
+      { readonly kind: "percentage-number"; readonly value: string },
+      { readonly kind: "token"; readonly value: "%" },
+    ];
+  }
+  | {
+    readonly kind: "keyword";
+    readonly value: CalcKeyword;
+  }
+  | {
+    readonly kind: "raw";
+    readonly value: string;
+  }
+  | {
+    readonly kind: "group";
+    readonly value: readonly [
+      { readonly kind: "token"; readonly value: "(" },
+      CalcSum,
+      { readonly kind: "token"; readonly value: ")" },
+    ];
+  }
+  | Min
+  | Max
+  | Clamp
+  | Calc
+  | Exp
+  | Var;
+
+export type CalcKeyword = "e" | "pi" | "infinity" | "-infinity" | "NaN";