rescript-lang · jderochervlk · Apr 17, 2026 · Apr 17, 2026 · Apr 17, 2026 · Apr 17, 2026
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -10,7 +10,8 @@ on:
 
 permissions:
   contents: read
-  pages: write
+  # pages: write
+  # Docs publishing is paused until the alpha docs/tag naming is settled.
   id-token: write
 
 jobs:
@@ -39,14 +40,16 @@ jobs:
       - name: Run tests
         run: npm test
 
-      - name: Build documentation
-        run: npm run build:docs
-
-      - name: Upload documentation
-        uses: actions/upload-pages-artifact@v4
-        if: github.ref == 'refs/heads/main' && github.event_name == 'push'
-        with:
-          path: ./dist
+      # - name: Build documentation
+      #   run: npm run build:docs
+      #
+      # - name: Upload documentation
+      #   uses: actions/upload-pages-artifact@v4
+      #   if: github.ref == 'refs/heads/main' && github.event_name == 'push'
+      #   with:
+      #     path: ./dist
+      #
+      # Docs publishing is paused until the alpha docs/tag naming is settled.
 
       - name: get-npm-version
         id: package-version
@@ -57,7 +60,7 @@ jobs:
         run: echo "COMMIT_HASH=$(git rev-parse --short HEAD)" >> $GITHUB_ENV
 
       - name: Update version to -<commit-hash>
-        run: npm version --no-git-tag-version "${{ steps.package-version.outputs.current-version }}-experimental-${{ env.COMMIT_HASH }}"
+        run: npm version --no-git-tag-version "${{ steps.package-version.outputs.current-version }}-pre-alpha-${{ env.COMMIT_HASH }}"
 
       - name: Package npm project
         run: npm pack
@@ -72,16 +75,18 @@ jobs:
         if: github.ref == 'refs/heads/main' && github.event_name == 'push'
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NODE_AUTH_TOKEN }}
-        run: npm publish --access public ./*.tgz --tag experimental
-
-  deploy-docs:
-    needs: build
-    runs-on: ubuntu-latest
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    if: github.ref == 'refs/heads/main' && github.event_name == 'push'
-    steps:
-      - name: Deploy to GitHub Pages
-        id: deployment
-        uses: actions/deploy-pages@v5
+        run: npm publish --access public ./*.tgz --tag pre-alpha
+
+  # deploy-docs:
+  #   needs: build
+  #   runs-on: ubuntu-latest
+  #   environment:
+  #     name: github-pages
+  #     url: ${{ steps.deployment.outputs.page_url }}
+  #   if: github.ref == 'refs/heads/main' && github.event_name == 'push'
+  #   steps:
+  #     - name: Deploy to GitHub Pages
+  #       id: deployment
+  #       uses: actions/deploy-pages@v5
+  #
+  # Docs publishing is paused until the alpha docs/tag naming is settled.
diff --git a/docs/content/docs/contributing/api-modelling.mdx b/docs/content/docs/contributing/api-modelling.mdx
@@ -83,14 +83,14 @@ mutable fillStyle: fillStyle
 }
 `;
 
-<Code code={fillStyleDef} title="DOMAPI.res" lang="ReScript"></Code>
+<Code code={fillStyleDef} title="DOM.res" lang="ReScript"></Code>
 
 When we wish to read and write the `fillStyle` property, we can use a helper module to lift the type to an actual ReScript variant:
 
 export const fillStyleModule = `
 open Prelude
-open CanvasAPI
-open DOMAPI
+open Canvas
+open DOM
 
 external fromString: string => fillStyle = "%identity"
 external fromCanvasGradient: canvasGradient => fillStyle = "%identity"
@@ -112,7 +112,7 @@ String(unsafeConversation(t))
 }
 `
 
-<Code code={fillStyleModule} title="DOMAPI/FillStyle.res" lang="ReScript"></Code>
+<Code code={fillStyleModule} title="DOM/FillStyle.res" lang="ReScript"></Code>
 
 We can now use `FillStyle.decode` to get the actual value of the `fillStyle` property.  
 And use `FillStyle.fromString`, `FillStyle.fromCanvasGradient`, and `FillStyle.fromCanvasPattern` to set the value.

diff --git a/docs/content/docs/contributing/api-module-structure.mdx b/docs/content/docs/contributing/api-module-structure.mdx
@@ -7,14 +7,14 @@ slug: "02-api-module-structure"
 import { Aside } from "@astrojs/starlight/components";
 import { FileTree } from "@astrojs/starlight/components";
 
-The bindings are organized by the Web API they represent. Each API has its interfaces and auxiliary types in a module named after the API, suffixed with `API` to prevent collisions with the type module.
+The bindings are organized by the Web API they represent. Each API has its interfaces and auxiliary types in a module named after the API.
 
 <FileTree>
 
 - package.json
 - src
-  - DOMAPI.res
-  - DOMAPI
+  - DOM.res
+  - DOM
     - HTMLElement.res
 
 </FileTree>

diff --git a/docs/content/docs/contributing/module-type-structure.mdx b/docs/content/docs/contributing/module-type-structure.mdx
@@ -19,7 +19,7 @@ Under normal circumstances, the type module only contains `@send` bindings where
 
 <FileTree>
 
-- DOMAPI
+- DOM
   - HTMLButtonElement.res
 
 </FileTree>
@@ -40,7 +40,7 @@ When an interface inherits from another interface, the base interface methods ca
 All methods from [HTMLElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement#instance_methods) should also be available on [HTMLButtonElement](https://developer.mozilla.org/en-US/docs/Web/API/HTMLButtonElement#instance_methods).
 
 export const htmlElementModule = `
-open DOMAPI
+open DOM
 
 // A concrete type for \`T.t\` is passed later using the \`include\` keyword.
 module Impl = (T: { type t }) => {
@@ -56,10 +56,10 @@ external focus: (T.t, ~options: focusOptions=?) => unit = "focus"
 include Impl({ type t = htmlElement })
 `;
 
-<Code code={htmlElementModule} title="DOMAPI/HTMLElement.res" lang="ReScript"></Code>
+<Code code={htmlElementModule} title="DOM/HTMLElement.res" lang="ReScript"></Code>
 
 export const buttonModule = `
-open DOMAPI
+open DOM
 
 // Include all the methods from HTMLElement
 include HTMLElement.Impl({ type t = htmlButtonElement })
@@ -74,4 +74,4 @@ _/
 external checkValidity: htmlButtonElement => bool = "checkValidity"
 `;
 
-<Code code={buttonModule} title="DOMAPI/HTMLButtonElement.res" lang="ReScript"></Code>
+<Code code={buttonModule} title="DOM/HTMLButtonElement.res" lang="ReScript"></Code>
diff --git a/docs/content/docs/contributing/testing.mdx b/docs/content/docs/contributing/testing.mdx
@@ -16,11 +16,11 @@ Create a new help in the `test` folder with the same name as the module you want
 <FileTree>
 
 - src
-  - DOMAPI.res
-  - DOMAPI
+  - DOM.res
+  - DOM
     - HTMLCanvasElement.res
 - tests
-  - DOMAPI
+  - DOM
     - HTMLCanvasElement_test.res
 
 </FileTree>

diff --git a/docs/content/docs/philosophy.mdx b/docs/content/docs/philosophy.mdx
@@ -16,11 +16,11 @@ The bindings are generated from the [MDN Web API documentation](https://develope
 
 In other words, if you are searching for a specific JavaScript binding, begin your journey at the [MDN Web API documentation](https://developer.mozilla.org/en-US/docs/Web/API) and determine which module contains your sample. Ensure that the module is available in the bindings by checking the specific API. Please [open an issue](https://github.com/rescript-lang/experimental-rescript-webapi/issues/new/choose) if you require an API that is not yet present.
 
-Each API will have its interface and auxiliary types in a module named after the API, suffixed with `API` to prevent collisions with the type module.
+Each API will have its interface and auxiliary types in a module named after the API.
 
 ```ReScript
 open WebAPI.Global
-open WebAPI.DOMAPI
+open WebAPI.DOM
 
 let myElement: element = document->Document.createElement( ~localName = "div")
 ```

diff --git a/src/CSSFontLoadingAPI.js → src/CSSFontLoading.js b/src/CSSFontLoadingAPI.js → src/CSSFontLoading.js
diff --git a/src/CSSFontLoadingAPI.res → src/CSSFontLoading.res b/src/CSSFontLoadingAPI.res → src/CSSFontLoading.res
@@ -1,6 +1,6 @@
 @@warning("-30")
 
-open EventAPI
+open Event
 
 type fontDisplay =
   | @as("auto") Auto

diff --git a/src/CSSFontLoadingAPI/FontFace.js → src/CSSFontLoading/FontFace.js b/src/CSSFontLoadingAPI/FontFace.js → src/CSSFontLoading/FontFace.js
diff --git a/src/CSSFontLoadingAPI/FontFace.res → src/CSSFontLoading/FontFace.res b/src/CSSFontLoadingAPI/FontFace.res → src/CSSFontLoading/FontFace.res
@@ -1,4 +1,4 @@
-open CSSFontLoadingAPI
+open CSSFontLoading
 
 /**
 [Read more on MDN](https://developer.mozilla.org/docs/Web/API/FontFace)

diff --git a/src/CSSFontLoadingAPI/FontFaceSet.js → src/CSSFontLoading/FontFaceSet.js b/src/CSSFontLoadingAPI/FontFaceSet.js → src/CSSFontLoading/FontFaceSet.js
diff --git a/src/CSSFontLoadingAPI/FontFaceSet.res → src/CSSFontLoading/FontFaceSet.res b/src/CSSFontLoadingAPI/FontFaceSet.res → src/CSSFontLoading/FontFaceSet.res
@@ -1,4 +1,4 @@
-open CSSFontLoadingAPI
+open CSSFontLoading
 
 include EventTarget.Impl({type t = fontFaceSet})
 

diff --git a/src/CanvasAPI.js → src/Canvas.js b/src/CanvasAPI.js → src/Canvas.js
diff --git a/src/CanvasAPI.res → src/Canvas.res b/src/CanvasAPI.res → src/Canvas.res
@@ -1,7 +1,7 @@
 @@warning("-30")
 
 open Prelude
-open EventAPI
+open Event
 
 type offscreenRenderingContextId =
   | @as("2d") V2d

diff --git a/src/CanvasAPI/CanvasGradient.js → src/Canvas/CanvasGradient.js b/src/CanvasAPI/CanvasGradient.js → src/Canvas/CanvasGradient.js
diff --git a/src/CanvasAPI/CanvasGradient.res → src/Canvas/CanvasGradient.res b/src/CanvasAPI/CanvasGradient.res → src/Canvas/CanvasGradient.res
@@ -1,4 +1,4 @@
-open CanvasAPI
+open Canvas
 
 /**
 Adds a color stop with the given color to the gradient at the given offset. 0.0 is the offset at one end of the gradient, 1.0 is the offset at the other end.

diff --git a/src/CanvasAPI/CanvasPattern.js → src/Canvas/CanvasPattern.js b/src/CanvasAPI/CanvasPattern.js → src/Canvas/CanvasPattern.js
diff --git a/src/CanvasAPI/CanvasPattern.res → src/Canvas/CanvasPattern.res b/src/CanvasAPI/CanvasPattern.res → src/Canvas/CanvasPattern.res
@@ -1,5 +1,5 @@
-open DOMAPI
-open CanvasAPI
+open DOM
+open Canvas
 
 /**
 Sets the transformation matrix that will be used when rendering the pattern during a fill or stroke painting operation.

diff --git a/src/CanvasAPI/FillStyle.js → src/Canvas/FillStyle.js b/src/CanvasAPI/FillStyle.js → src/Canvas/FillStyle.js
diff --git a/src/CanvasAPI/FillStyle.res → src/Canvas/FillStyle.res b/src/CanvasAPI/FillStyle.res → src/Canvas/FillStyle.res
@@ -1,5 +1,5 @@
 open Prelude
-open CanvasAPI
+open Canvas
 
 external fromString: string => fillStyle = "%identity"
 external fromCanvasGradient: canvasGradient => fillStyle = "%identity"

diff --git a/src/CanvasAPI/ImageBitmap.js → src/Canvas/ImageBitmap.js b/src/CanvasAPI/ImageBitmap.js → src/Canvas/ImageBitmap.js
diff --git a/src/CanvasAPI/ImageBitmap.res → src/Canvas/ImageBitmap.res b/src/CanvasAPI/ImageBitmap.res → src/Canvas/ImageBitmap.res
@@ -1,4 +1,4 @@
-open CanvasAPI
+open Canvas
 
 /**
 Releases imageBitmap's underlying bitmap data.

diff --git a/src/CanvasAPI/ImageBitmapRenderingContext.js → src/Canvas/ImageBitmapRenderingContext.js b/src/CanvasAPI/ImageBitmapRenderingContext.js → src/Canvas/ImageBitmapRenderingContext.js
diff --git a/...CanvasAPI/ImageBitmapRenderingContext.res → src/Canvas/ImageBitmapRenderingContext.res b/...CanvasAPI/ImageBitmapRenderingContext.res → src/Canvas/ImageBitmapRenderingContext.res
@@ -1,4 +1,4 @@
-open CanvasAPI
+open Canvas
 
 /**
 Transfers the underlying bitmap data from imageBitmap to context, and the bitmap becomes the contents of the canvas element to which context is bound.

diff --git a/src/CanvasAPI/OffscreenCanvas.js → src/Canvas/OffscreenCanvas.js b/src/CanvasAPI/OffscreenCanvas.js → src/Canvas/OffscreenCanvas.js
diff --git a/src/CanvasAPI/OffscreenCanvas.res → src/Canvas/OffscreenCanvas.res b/src/CanvasAPI/OffscreenCanvas.res → src/Canvas/OffscreenCanvas.res
@@ -1,5 +1,5 @@
-open CanvasAPI
-open FileAPI
+open Canvas
+open File
 
 /**
 [Read more on MDN](https://developer.mozilla.org/docs/Web/API/OffscreenCanvas)

diff --git a/src/CanvasAPI/Path2D.js → src/Canvas/Path2D.js b/src/CanvasAPI/Path2D.js → src/Canvas/Path2D.js
diff --git a/src/CanvasAPI/Path2D.res → src/Canvas/Path2D.res b/src/CanvasAPI/Path2D.res → src/Canvas/Path2D.res
@@ -1,5 +1,5 @@
-open CanvasAPI
-open DOMAPI
+open Canvas
+open DOM
 
 /**
 [Read more on MDN](https://developer.mozilla.org/docs/Web/API/Path2D)

diff --git a/src/ChannelMessagingAPI.js → src/ChannelMessaging.js b/src/ChannelMessagingAPI.js → src/ChannelMessaging.js
diff --git a/src/ChannelMessagingAPI.res → src/ChannelMessaging.res b/src/ChannelMessagingAPI.res → src/ChannelMessaging.res
@@ -1,6 +1,6 @@
 @@warning("-30")
 
-open EventAPI
+open Event
 
 /**
 This Channel Messaging API interface represents one of the two ports of a MessageChannel, allowing messages to be sent from one port and listening out for them arriving at the other.

diff --git a/src/ChannelMessagingAPI/MessagePort.js → src/ChannelMessaging/MessagePort.js b/src/ChannelMessagingAPI/MessagePort.js → src/ChannelMessaging/MessagePort.js
diff --git a/src/ChannelMessagingAPI/MessagePort.res → src/ChannelMessaging/MessagePort.res b/src/ChannelMessagingAPI/MessagePort.res → src/ChannelMessaging/MessagePort.res
@@ -1,4 +1,4 @@
-open ChannelMessagingAPI
+open ChannelMessaging
 
 include EventTarget.Impl({type t = messagePort})
 

diff --git a/src/ClipboardAPI/Clipboard.js → src/Clipboard/Clipboard.js b/src/ClipboardAPI/Clipboard.js → src/Clipboard/Clipboard.js
diff --git a/src/ClipboardAPI/Clipboard.res → src/Clipboard/Clipboard.res b/src/ClipboardAPI/Clipboard.res → src/Clipboard/Clipboard.res
@@ -1,4 +1,4 @@
-open ClipboardAPI
+include ClipboardTypes
 
 include EventTarget.Impl({type t = clipboard})
 

diff --git a/src/ClipboardAPI/ClipboardItem.js → src/Clipboard/ClipboardItem.js b/src/ClipboardAPI/ClipboardItem.js → src/Clipboard/ClipboardItem.js
diff --git a/src/ClipboardAPI/ClipboardItem.res → src/Clipboard/ClipboardItem.res b/src/ClipboardAPI/ClipboardItem.res → src/Clipboard/ClipboardItem.res
@@ -1,5 +1,5 @@
-open FileAPI
-open ClipboardAPI
+open File
+open Clipboard
 open Prelude
 
 /**

diff --git a/src/ClipboardAPI.js → src/ClipboardTypes.js b/src/ClipboardAPI.js → src/ClipboardTypes.js
diff --git a/src/ClipboardAPI.res → src/ClipboardTypes.res b/src/ClipboardAPI.res → src/ClipboardTypes.res
@@ -1,6 +1,6 @@
 @@warning("-30")
 
-open EventAPI
+open Event
 
 type presentationStyle =
   | @as("attachment") Attachment

diff --git a/src/CredentialManagementAPI.js → src/CredentialManagement.js b/src/CredentialManagementAPI.js → src/CredentialManagement.js
diff --git a/src/CredentialManagementAPI.res → src/CredentialManagement.res b/src/CredentialManagementAPI.res → src/CredentialManagement.res
@@ -1,7 +1,7 @@
 @@warning("-30")
 
 open Prelude
-open EventAPI
+open Event
 
 type authenticatorTransport =
   | @as("ble") Ble

diff --git a/...tialManagementAPI/CredentialsContainer.js → ...dentialManagement/CredentialsContainer.js b/...tialManagementAPI/CredentialsContainer.js → ...dentialManagement/CredentialsContainer.js
diff --git a/...ialManagementAPI/CredentialsContainer.res → ...entialManagement/CredentialsContainer.res b/...ialManagementAPI/CredentialsContainer.res → ...entialManagement/CredentialsContainer.res
@@ -1,4 +1,4 @@
-open CredentialManagementAPI
+open CredentialManagement
 
 /**
 [Read more on MDN](https://developer.mozilla.org/docs/Web/API/CredentialsContainer/get)

diff --git a/src/DOMAPI.js → src/DOM.js b/src/DOMAPI.js → src/DOM.js