Add initial version of layered standard spec

Signed-off-by: Pierre R. Mai <pmai@pmsf.de>

Author: pmai

.github/workflows/build.yml .github/workflows/build-examples.yml.github/workflows/build.yml renamed to .github/workflows/build-examples.yml

@@ -1,4 +1,4 @@
-name: Build
+name: Build Examples
 
 on:
   push:
@@ -38,13 +38,13 @@ jobs:
       - name: Upload FMU artefacts
         uses: actions/upload-artifact@v7
         with:
-          name: fmus
+          name: FMI-LS-WASM-example-fmus
           path: build/*.fmu
 
       - name: Upload runner binary artefacts
         uses: actions/upload-artifact@v7
         with:
-          name: runners
+          name: FMI-LS-WASM-example-runners
           path: |
             build/adder-fmu-c-runner-build/adder-fmu-c-runner
             build/adder-fmu-rust-runner-build/adder-fmu-rust-runner

.github/workflows/build-spec.yml

@@ -0,0 +1,60 @@
+name: Build Specification
+
+on:
+  push:
+    branches-ignore: [ 'temp/*' ]
+    tags: ['*']
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  build-spec:
+    runs-on: ubuntu-24.04
+
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v6
+      with:
+        submodules: recursive
+
+    - name: Generate revnumber
+      run: |
+        [[ $GITHUB_REF_TYPE == "tag" ]] && REVNUMBER=${GITHUB_REF:11} || REVNUMBER=${GITHUB_SHA:0:7}
+        echo "REVNUMBER=$REVNUMBER" >> $GITHUB_ENV
+
+    - name: Generate HTML
+      uses: avattathil/asciidoctor-action@master
+      with:
+        program: asciidoctor --attribute=revnumber=${{ env.REVNUMBER }} --attribute=revdate=$(date +%F) docs/index.adoc
+
+    - name: Copy license
+      run: cp LICENSE.txt docs
+
+    - name: Copy wit files
+      run: cp -r wit docs/
+
+    - name: Create ZIP archive
+      uses: actions/upload-artifact@v7
+      with:
+        name: FMI-LS-WASM-spec
+        path: |
+          docs/index.html
+          docs/LICENSE.txt
+          docs/wit/*
+          docs/theme/css/*.css
+          docs/theme/images/*.svg
+          docs/theme/js/*.js
+        if-no-files-found: error
+
+    - name: Extract branch name
+      id: extract_branch
+      shell: bash
+      run: echo "branch=$(echo ${GITHUB_REF#refs/heads/})" >> $GITHUB_OUTPUT
+
+    - name: Deploy to GitHub Pages
+      if: github.ref == 'refs/heads/main' && github.event_name == 'push'
+      uses: peaceiris/actions-gh-pages@v4
+      with:
+        github_token: ${{ secrets.GITHUB_TOKEN }}
+        publish_dir: docs
+        destination_dir: ${{ steps.extract_branch.outputs.branch }}

.gitmodules

@@ -1,3 +1,6 @@
 [submodule "examples/fmi-standard"]
 	path = examples/fmi-standard
 	url = https://github.com/modelica/fmi-standard.git
+[submodule "docs/theme"]
+	path = docs/theme
+	url = https://github.com/modelica/ma-asciidoctor-theme

README.md

@@ -1,14 +1,28 @@
-# FMI 3.0 → WebAssembly Component Model Mapping
+# FMI Layered Standard WebAssembly (FMI-LS-WASM)
 
-[![Build](https://github.com/modelica/fmi-ls-wasm/actions/workflows/build.yml/badge.svg)](https://github.com/modelica/fmi-ls-wasm/actions/workflows/build.yml)
+[![Build Specification](https://github.com/modelica/fmi-ls-wasm/actions/workflows/build-spec.yml/badge.svg)](https://github.com/modelica/fmi-ls-wasm/actions/workflows/build-spec.yml)
+[![Build Examples](https://github.com/modelica/fmi-ls-wasm/actions/workflows/build-examples.yml/badge.svg)](https://github.com/modelica/fmi-ls-wasm/actions/workflows/build-examples.yml)
 
-_Note that this repository contains working drafts for what might become an fmi-ls-wasm layered standard for a webassembly-based portable binary platform for FMI.
-Everything is unofficial and subject to change prior to any official release._
+This repository contains a current prototype draft for the FMI Layered
+Standard WebAssembly (fmi-ls-wasm) based on the [Functional Mock-up Interface][FMI]
+3.0 standard for the exchange of simulation models.
+It presents a mapping of the [FMI 3.0][FMI3] C API to the [WebAssembly Component Model](https://component-model.bytecodealliance.org/) interface description language (WIT).
 
-WIT definitions that map the [FMI 3.0](https://svn.modelica.org/fmi/branches/public/specifications/v3.0/) C API to the [WebAssembly Component Model](https://component-model.bytecodealliance.org/) interface description language (WIT).
+Note that this draft is being worked on actively, and thus is subject to change without notice.
 
-Also included are examples show-casing the WIT definitions, using Rust,
-C and WAT implementations.
+This is currently not normative, nor is this document to be considered
+officially endorsed by the Modelica Association or other involved
+organisations prior to official adoption.
+
+The [FMI 3.0 Layered Standard WebAssembly][spec] is currently maintained on
+[GitHub][githubspec] and is published [here][spec]. It is based on
+the [FMI][] standard.
+
+Also included are examples show-casing the WIT definitions, using Rust, C and WAT implementations.
+
+[FMI]: https://fmi-standard.org/
+[githubspec]: docs/index.adoc
+[spec]: https://modelica.github.io/fmi-ls-wasm/main/
 
 ## File layout