Merge branch 'main' into feat/server-api

# Conflicts:
#	v1/typescript-definitions/package-lock.json
#	v1/typescript-definitions/package.json
#	v1/typescript-definitions/src/main.ts

Author: nytamin

.github/workflows/publish-npm-nightly.yml

@@ -0,0 +1,55 @@
+name: Publish nightly to NPM
+
+on:
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+permissions:
+  id-token: write # Required for OIDC
+  contents: read
+
+jobs:
+  Publish:
+    name: Publish to NPM
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    defaults:
+      run:
+        working-directory: ./v1/typescript-definitions
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-node@v5
+        with:
+          node-version: 24
+          package-manager-cache: false
+          registry-url: "https://registry.npmjs.org"
+
+      # Ensure npm 11.5.1 or later is installed:
+      # - name: Update npm
+      #   run: npm install -g npm@latest
+
+      - name: Prepare Environment
+        # Install from package-lock.json:
+        run: npm ci
+        env:
+          CI: true
+
+      - name: Bump version to prerelease
+        run: |
+          PRERELEASE_TAG=nightly-$(echo "${{ github.ref_name }}" | sed -r 's/[^a-z0-9]+/-/gi')
+          npm version prerelease --preid $PRERELEASE_TAG-$COMMIT_DATE-$GIT_HASH
+
+      - name: Generate types
+        run: npm run generate-types
+        env:
+          CI: true
+
+      - name: Build
+        run: npm run build
+        env:
+          CI: true
+
+      - name: Publish to NPM
+        run: npm publish --tag nightly
+        env:
+          CI: true

.github/workflows/publish-npm.yml

@@ -0,0 +1,50 @@
+name: Publish to NPM
+
+on:
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+permissions:
+  id-token: write # Required for OIDC
+  contents: read
+
+jobs:
+  Publish:
+    name: Publish to NPM
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    defaults:
+      run:
+        working-directory: ./v1/typescript-definitions
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-node@v5
+        with:
+          node-version: 24
+          package-manager-cache: false
+          registry-url: "https://registry.npmjs.org"
+
+      # Ensure npm 11.5.1 or later is installed:
+      # - name: Update npm
+      #   run: npm install -g npm@latest
+
+      - name: Prepare Environment
+        # Install from package-lock.json:
+        run: npm ci
+        env:
+          CI: true
+
+      - name: Generate types
+        run: npm run generate-types
+        env:
+          CI: true
+
+      - name: Build
+        run: npm run build
+        env:
+          CI: true
+
+      - name: Publish to NPM
+        run: npm publish --tag latest
+        env:
+          CI: true

README.md

@@ -36,7 +36,7 @@ It allows for vendor interoperability between Graphics, Rendering systems and Co
 
 Useful resources:
 * [Examples of OGraf Graphics](https://github.com/ebu/ograf/tree/main/v1/examples).
-* [OGraf Specification](./v1/specification/docs/Specification).
+* [OGraf Specification](./v1/specification/docs/Specification.md).
 
 
 ### Tools

v1/typescript-definitions/README.md

@@ -66,8 +66,24 @@ The instructions below are for developers who want to work on the Typescript def
 ```bash
 
 npm install
+npm run generate-types # Run this if the Graphics API has changed
+npm run generate-server-types # Run this if the server API has changed
+
+
 npm run build
 # or
 npm run watch
 
 ```
+
+### Publish to NPM
+
+To publish a new version to NPM:
+
+1. Bump the version `npm version major|minor|patch`
+2. Commit and push to GitHub
+3. Go to the Actions tab and trigger the "Publish to NPM" workflow
+
+To publish a nightly build to NPM:
+
+1. Go to the Actions tab and trigger the "Publish nightly to NPM" workflow

v1/typescript-definitions/package-lock.json

@@ -1,10 +1,13 @@
 {
   "name": "ograf",
-  "version": "0.1.0-server-api.0",
+  "version": "1.0.0",
   "main": "dist/main.js",
   "types": "dist/main.d.ts",
   "license": "MIT",
   "description": "TypeScript definitions for Ograf graphics",
+  "repository": {
+    "url": "https://github.com/ebu/ograf"
+  },
   "homepage": "https://ograf.ebu.io",
   "keywords": [
     "ograf",
@@ -19,8 +22,7 @@
     "watch": "tsc --watch",
     "generate-types": "node scripts/generate-types.js",
     "generate-server-types": "openapi-typescript ../specification/open-api/server-api.yaml -o ./src/generated/server-api.d.ts --additional-properties=true && node scripts/post-generate-server-types.js",
-    "build-all": "npm run generate-types && npm run generate-server-types && npm run build",
-    "do:publish": "npm run build-all && npm publish --access public --tag next"
+    "build-all": "npm run generate-types && npm run generate-server-types && npm run build"
   },
   "devDependencies": {
     "json-schema-to-typescript": "^15.0.4",