docs: describe shared build-specific snapshot publishing

Co-Authored-By: Codex <noreply@openai.com>

.circleci/config.yml

@@ -0,0 +1,14 @@
+version: 2.1
+setup: true
+orbs:
+  qqq-orb: kingsrook/qqq-orb@0.8
+workflows:
+  setup:
+    jobs:
+    - qqq-orb/generate_pipeline:
+        orb_version: '0.8'
+        filters:
+          branches:
+            ignore: automation/qbit-rc-pending
+          tags:
+            only: /.*/

.eslintignore

@@ -1,4 +1,3 @@
 node_modules
 lib
 coverage
-lib-cjs

.gitea/workflows/build.yaml

@@ -1,17 +0,0 @@
-name: build
-on:
-  push:
-jobs:
-  node:
-    # @main until the owner moves ci-workflows v1 onto the publishing node.yaml; then back to @v1.
-    uses: self:KofTwentyTwo/ci-workflows/.gitea/workflows/node.yaml@v1
-    secrets: inherit
-    with:
-      node-version: '24'
-      commands: |
-        npm run lint
-        npm test
-        npm run prepublishOnly
-      # A vX.Y.Z[-RC.N] tag equal to package.json publishes @qrunio/qqq-frontend-core to the
-      # QRun-IO Gitea npm registry (RC -> dist-tag next). Branches only verify.
-      publish: true

.gitignore

@@ -17,4 +17,3 @@ lib
 # Claude Code local settings
 .claude/
 
-lib-cjs

.qqq-ci.yml

@@ -0,0 +1,4 @@
+profile: frontend-core
+orb_version: '0.8'
+default_branch: develop
+node_version: '24.21'

README.md

@@ -35,17 +35,6 @@ If you want a ready-to-use admin UI, use [qqq-frontend-material-dashboard](https
 npm install @qrunio/qqq-frontend-core
 ```
 
-Releases are published to the QRun-IO Gitea npm registry (release candidates under the `next`
-dist-tag). Point the scope there in `.npmrc`:
-
-```ini
-@qrunio:registry=https://git.kof22.com/api/packages/QRun-IO/npm/
-//git.kof22.com/api/packages/QRun-IO/npm/:_authToken=${GITEA_TOKEN}
-```
-
-To release: set the version (`npm version 0.41.0-RC.1 --no-git-tag-version`), merge, and tag the
-merge commit `v<version>`; CI verifies the tag equals `package.json`, runs the checks and publishes.
-
 ```typescript
 import { QController } from '@qrunio/qqq-frontend-core';
 

package-lock.json

@@ -1,12 +1,12 @@
 {
    "name": "@qrunio/qqq-frontend-core",
-   "version": "0.40.27-RC.1",
+   "version": "0.40.21-SNAPSHOT",
    "lockfileVersion": 3,
    "requires": true,
    "packages": {
       "": {
          "name": "@qrunio/qqq-frontend-core",
-         "version": "0.40.27-RC.1",
+         "version": "0.40.21-SNAPSHOT",
          "license": "Apache-2.0",
          "dependencies": {
             "axios": "0.34.0",

package.json

@@ -1,16 +1,15 @@
 {
    "name": "@qrunio/qqq-frontend-core",
-   "version": "0.40.27-RC.1",
+   "version": "0.40.27-SNAPSHOT",
    "description": "",
-   "main": "lib-cjs/qqq-frontend-core.js",
-   "module": "lib/qqq-frontend-core.js",
-   "types": "lib/qqq-frontend-core.d.ts",
+   "main": "qqq-frontend-core.js",
+   "module": "lib/qqq-frontend-core.esm.js",
    "scripts": {
       "delete-modules": "rm -rf node_modules; rm package-lock.json",
       "lint": "eslint . --ext .ts",
       "npm-install": "npm install",
       "clean-and-install": "npm ci && npm run prepublishOnly",
-      "prepublishOnly": "node scripts/clean-build.cjs && tsc -p ./ --outDir lib/ && tsc -p ./ --module commonjs --outDir lib-cjs/",
+      "prepublishOnly": "rm -rf lib/ && tsc -p ./ --outDir lib/",
       "test": "jest",
       "yalc-push": "npm run prepublishOnly && yalc push --private",
       "yalc-watch": "yalc-watch"
@@ -22,7 +21,6 @@
    "keywords": [],
    "files": [
       "lib",
-      "lib-cjs",
       "package.json",
       "NOTICE"
    ],
@@ -33,7 +31,7 @@
       "url": "https://github.com/QRun-IO/qqq-frontend-core"
    },
    "publishConfig": {
-      "registry": "https://git.kof22.com/api/packages/QRun-IO/npm/"
+      "registry": "https://registry.npmjs.org/"
    },
    "devDependencies": {
       "@types/jest": "^27.0.2",

scripts/clean-build.cjs

@@ -1,7 +0,0 @@
-const {rmSync} = require("node:fs");
-const {resolve} = require("node:path");
-
-// Resolve only these build outputs relative to the repository, never the caller's cwd.
-for (const directory of ["lib", "lib-cjs"]) {
-   rmSync(resolve(__dirname, "..", directory), {recursive: true, force: true});
-}

src/qqq-frontend-core.ts

@@ -23,7 +23,7 @@ import {QFieldMetaData} from "./model/metaData/QFieldMetaData";
 import {QFieldType} from "./model/metaData/QFieldType";
 import {QTableMetaData} from "./model/metaData/QTableMetaData";
 
-export {
+module.exports = {
    QController,
    QTableMetaData,
    QFieldMetaData,

tests/PackageExports.test.ts

@@ -1,32 +0,0 @@
-/*
- * QQQ - Low-code Application Framework for Engineers.
- * Copyright (C) 2021-2022.  Kingsrook, LLC
- * 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
- * contact@kingsrook.com
- * https://github.com/Kingsrook/
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     https://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-import {QController, QFieldMetaData, QFieldType, QTableMetaData} from "../src/qqq-frontend-core";
-
-describe("public package exports", () =>
-{
-   it("exposes the controller and metadata constructors", () =>
-   {
-      expect(typeof QController).toBe("function");
-      expect(typeof QTableMetaData).toBe("function");
-      expect(new QFieldMetaData({name: "id", type: QFieldType.INTEGER}).name).toBe("id");
-      expect(QFieldType.INTEGER).toBeDefined();
-   });
-});