Initial commit

.editorconfig

@@ -0,0 +1,9 @@
+root = true
+
+[*]
+charset = utf-8
+indent_style = space
+indent_size = 2
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true

.github/dependabot.yml

@@ -0,0 +1,11 @@
+version: 2
+updates:
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "daily"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "daily"

.github/workflows/build.yml

@@ -0,0 +1,43 @@
+name: 'Build on CI'
+
+on: [pull_request, push, workflow_dispatch]
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  build:
+    name: 'Build Documentation'
+    runs-on: ubuntu-22.04
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Cache npm dependencies
+        uses: actions/cache@v4
+        with:
+          path: ~/.npm
+          key: npm-cache-${{ runner.os }}-${{ hashFiles('**/package-lock.json') }}
+          restore-keys: |
+            npm-cache-${{ runner.os }}-
+
+      - name: Install Dependencies
+        run: npm install
+
+      - name: Build Project
+        run: npm run build-head
+
+      - name: Archive "out" Directory
+        uses: actions/upload-artifact@v4
+        with:
+          name: documentation-snapshot
+          path: ./out

.github/workflows/deploy.yml

@@ -0,0 +1,58 @@
+name: 'Build and Deploy Documentation'
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  build:
+    name: 'Build Documentation'
+    runs-on: ubuntu-22.04
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v4
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Cache npm dependencies
+        uses: actions/cache@v4
+        with:
+          path: ~/.npm
+          key: npm-cache-${{ runner.os }}-${{ hashFiles('**/package-lock.json') }}
+          restore-keys: |
+            npm-cache-${{ runner.os }}-
+
+      - name: Install Dependencies
+        run: npm install
+
+      - name: Build Project
+        run: npm run build-only
+
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./out
+
+  deploy:
+    name: Deploy Documentation
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      pages: write
+      id-token: write
+
+    steps:
+      - name: Deploy to GitHub Pages
+        uses: actions/deploy-pages@v4

.gitignore

@@ -0,0 +1,9 @@
+node_modules/
+out/
+vendor/esmeta
+test*.js
+aspell.txt
+
+# lockfiles we don't use are ignored
+npm-shrinkwrap.json
+yarn.lock

.nvmrc

@@ -0,0 +1 @@
+v20.14.0

README.md

@@ -1,2 +1,30 @@
-# ECMA-xxx-TEA
-This repository will be renamed once an ECMA identifier is assigned to the standard.
+# ECMA-xxx-PURL (Package-URL Specification)
+
+This repository hosts the work-in-progress technical specification for **Package-URL (PURL)**, which is being developed under Ecma International's **Technical Committee 54 (TC54)**. PURL provides a lightweight, URL-based syntax for identifying software packages across diverse ecosystems, enabling interoperability, traceability, and improved supply chain management.
+
+## Purpose of the Repository
+
+The repository serves as the collaborative workspace for drafting, reviewing, and refining the PURL specification. Contributions from TC54 and its task groups (e.g., TG2) ensure that the specification aligns with international standardization goals and reflects the needs of global stakeholders.
+
+### Key Objectives
+- To develop the normative specification for the PURL syntax, its required components, and conformance requirements.
+- To provide a clear, authoritative reference for implementers, developers, and organisations adopting PURL.
+- To maintain transparency and encourage participation from all stakeholders.
+
+### Important Note on Repository Name
+
+This repository is currently named `ECMA-xxx-PURL` as a placeholder. Upon ratification of the PURL specification as an Ecma International standard, the repository will be renamed to **`ECMA-xxx`**, where `xxx` represents the number assigned by Ecma to the standard.
+
+## Contributing
+
+Contributions to this specification are managed by TC54. If you are part of the TC54 community or have been invited to collaborate, please follow the contribution guidelines outlined in this repository.
+
+For general inquiries or feedback, you may contact Ecma International or TC54 through the official Ecma channels.
+
+## License
+
+This work is licensed under the terms defined by Ecma International, ensuring free access and adoption of the finalised specification.
+
+## Acknowledgements
+
+We thank Ecma International’s TC39 for their development of **Ecmarkup**, which TC54 has successfully adopted for preparing and maintaining this specification.