feat: initial commit

Author: StephanMeijer

.github/workflows/ci.yml

@@ -0,0 +1,65 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: lts/*
+          cache: npm
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Build
+        run: npm run build
+
+  release-please:
+    runs-on: ubuntu-latest
+    needs: build
+    if: github.event_name == 'push'
+    permissions:
+      contents: write
+      pull-requests: write
+    outputs:
+      release_created: ${{ steps.release.outputs.release_created }}
+    steps:
+      - uses: googleapis/release-please-action@v4
+        id: release
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+  publish:
+    runs-on: ubuntu-latest
+    needs: release-please
+    if: needs.release-please.outputs.release_created == 'true'
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: lts/*
+          registry-url: https://registry.npmjs.org
+          cache: npm
+
+      - name: Install dependencies
+        run: npm install
+
+      - name: Build
+        run: npm run build
+
+      - name: Publish to npm
+        run: npm publish --provenance --access public

.gitignore

@@ -0,0 +1 @@
+node_modules/

.npmignore

@@ -0,0 +1,3 @@
+.github/
+.release-please-manifest.json
+release-please-config.json

.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.0.1"
+}

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Stephan Meijer and Contributors
+
+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,34 @@
+# @typespecs/elixir-ast
+
+[TypeSpec](https://typespec.io) definitions for a JSON-friendly Elixir expression AST.
+
+## Installation
+
+```sh
+npm install @typespecs/elixir-ast
+```
+
+Requires `@typespec/compiler ~1.9.0` as a peer dependency:
+
+```sh
+npm install --save-dev @typespec/compiler
+```
+
+## Usage
+
+Import the library in your TypeSpec file:
+
+```tsp
+import "@typespecs/elixir-ast";
+
+using Elixir.Ast;
+```
+
+## Releases
+
+This package uses [release-please](https://github.com/googleapis/release-please) with Conventional Commits.
+Use conventional commit messages (for example, `feat: add tuple helpers` or `fix: correct map key typing`) so automated versioning and changelog generation work correctly.
+
+## License
+
+[MIT](./LICENSE)

lib/main.tsp

@@ -0,0 +1,136 @@
+import "@typespec/json-schema";
+
+using TypeSpec.JsonSchema;
+
+@jsonSchema
+namespace Elixir.Ast;
+
+/**
+ * Discriminator enum for all Elixir expression kinds
+ */
+enum ElixirExpressionKind {
+  atom,
+  string,
+  number,
+  boolean,
+  nil,
+  module_ref,
+  list,
+  tuple,
+  keyword,
+  call,
+}
+
+/**
+ * A keyword list entry with atom key and expression value
+ */
+model KeywordEntry {
+  key: string;
+  value: ElixirExpression;
+}
+
+/**
+ * Atom expression
+ */
+@discriminator("kind")
+model AtomExpression {
+  kind: ElixirExpressionKind.atom;
+  value: string;
+}
+
+/**
+ * String literal expression
+ */
+@discriminator("kind")
+model StringExpression {
+  kind: ElixirExpressionKind.string;
+  value: string;
+}
+
+/**
+ * Number literal expression
+ */
+@discriminator("kind")
+model NumberExpression {
+  kind: ElixirExpressionKind.number;
+  value: numeric;
+}
+
+/**
+ * Boolean literal expression
+ */
+@discriminator("kind")
+model BooleanExpression {
+  kind: ElixirExpressionKind.boolean;
+  value: boolean;
+}
+
+/**
+ * Nil literal expression
+ */
+@discriminator("kind")
+model NilExpression {
+  kind: ElixirExpressionKind.nil;
+}
+
+/**
+ * Module reference expression
+ */
+@discriminator("kind")
+model ModuleRefExpression {
+  kind: ElixirExpressionKind.module_ref;
+  value: string;
+}
+
+/**
+ * List expression
+ */
+@discriminator("kind")
+model ListExpression {
+  kind: ElixirExpressionKind.list;
+  items: ElixirExpression[];
+}
+
+/**
+ * Tuple expression
+ */
+@discriminator("kind")
+model TupleExpression {
+  kind: ElixirExpressionKind.tuple;
+  items: ElixirExpression[];
+}
+
+/**
+ * Keyword list expression
+ */
+@discriminator("kind")
+model KeywordExpression {
+  kind: ElixirExpressionKind.keyword;
+  entries: KeywordEntry[];
+}
+
+/**
+ * Function or macro call expression
+ */
+@discriminator("kind")
+model CallExpression {
+  kind: ElixirExpressionKind.call;
+  name: string;
+  args: ElixirExpression[];
+}
+
+/**
+ * All Elixir expression types
+ */
+union ElixirExpression {
+  AtomExpression,
+  StringExpression,
+  NumberExpression,
+  BooleanExpression,
+  NilExpression,
+  ModuleRefExpression,
+  ListExpression,
+  TupleExpression,
+  KeywordExpression,
+  CallExpression,
+}