@papit/create 0.0.1

package/asset/package-templates/browser/tests/playwright.config.ts

@@ -0,0 +1,81 @@
+import { Arguments } from "@papit/arguments";
+import { Information, PackageGraph } from "@papit/information";
+import { defineConfig, devices } from '@playwright/test';
+import path from "node:path";
+
+const dirname = path.join(PackageGraph.get("VARIABLE_FULL_NAME").location, "tests");
+// const relative = path.relative(Information.root.location, PackageGraph.get("@papit/web-component").location);
+
+export default defineConfig({
+    // Look for test files in the "tests" directory, relative to this configuration file.
+    testDir: dirname,
+
+    // Run all tests in parallel.
+    fullyParallel: true,
+
+    // Fail the build on CI if you accidentally left test.only in the source code.
+    forbidOnly: !!process.env.CI,
+
+    // Retry on CI only.
+    retries: 0,
+
+    // Opt out of parallel tests on CI.
+    workers: !!process.env.CI ? 1 : undefined,
+
+    // reporter, with output path for HTML reports.
+    reporter: [[
+        !!process.env.CI ? "github" : "html",
+        {
+            open: "never",
+            outputFolder: path.join(dirname, "test-reports"),
+        }
+    ]],
+
+    outputDir: path.join(dirname, "test-results"),
+
+    snapshotPathTemplate: '{testDir}/snapshots/{projectName}/{testFilePath}/{arg}-{platform}{ext}',
+
+    use: {
+        // Base URL to use in actions like `await page.goto('/')`.
+        baseURL: process.env.LOCATION ? `http://localhost:3500/${process.env.LOCATION}/` : 'http://localhost:3500/',
+
+        // Collect trace when retrying the failed test.
+        trace: 'on-first-retry',
+        screenshot: 'only-on-failure',
+    },
+
+
+    expect: {
+        toHaveScreenshot: {
+            maxDiffPixels: 100,
+            maxDiffPixelRatio: 0.2,
+        },
+    },
+    testIgnore: process.env.SKIP_SNAPSHOTS === "true"
+        ? ["**/snapshot.test.ts"]
+        : [],
+
+    // Configure projects for major browsers.
+    projects: [
+        {
+            name: 'chromium',
+            use: { ...devices['Desktop Chrome'] },
+        },
+        {
+            name: 'firefox',
+            use: { ...devices['Desktop Firefox'] },
+        },
+        {
+            name: 'webkit',
+            use: { ...devices['Desktop Safari'] },
+        },
+    ],
+    // running web-server before starting tests 
+    webServer: {
+        command: 'npx @papit/server --serve --port=3500 --bundle',
+        url: 'http://localhost:3500',
+        reuseExistingServer: true,
+        stdout: 'pipe',
+        stderr: 'pipe'
+    },
+});

package/asset/package-templates/browser/tests/tsconfig.json

@@ -0,0 +1,9 @@
+{
+    "extends": "../tsconfig.json",
+    "compilerOptions": {
+        "rootDir": ".."
+    },
+    "include": [
+        "."
+    ]
+}

package/asset/package-templates/browser/tsconfig.json

@@ -0,0 +1,41 @@
+{
+    "compilerOptions": {
+        "target": "es2018",
+        "module": "esnext",
+        "moduleResolution": "bundler",
+        // "moduleDetection": "force",
+        "noEmitOnError": true,
+        "skipLibCheck": true,
+        "lib": [
+            "es2020",
+            "dom",
+            "dom.iterable",
+            "esnext"
+        ],
+        "strict": true,
+        "verbatimModuleSyntax": false,
+        "noUncheckedIndexedAccess": false, // use me for strict array/object access checks
+        "esModuleInterop": true,
+        "allowSyntheticDefaultImports": true,
+        "experimentalDecorators": true,
+        "useDefineForClassFields": false,
+        "outDir": "lib",
+        "rootDir": "src",
+        "declaration": true,
+        "resolveJsonModule": true,
+        "allowJs": true,
+        "baseUrl": "src",
+        "paths": {
+            "VARIABLE_FULL_NAME": [
+                "./index"
+            ]
+        },
+        "sourceMap": true,
+        "inlineSources": true,
+        "incremental": true,
+        "tsBuildInfoFile": ".temp/build/tsconfig.tsbuildinfo",
+    },
+    "include": [
+        "src"
+    ]
+}

package/asset/package-templates/browser/tsconfig.prod.json

@@ -0,0 +1,9 @@
+{
+    "extends": "./tsconfig.json",
+    "compilerOptions": {
+        "sourceMap": false,
+        "inlineSources": false,
+        "declarationMap": false,
+        "incremental": false
+    }
+}

package/asset/package-templates/game/README.md

@@ -0,0 +1,40 @@
+# VARIABLE_FULL_NAME
+
+VARIABLE_DESCRIPTION
+
+![Logo](VARIABLE_GITHUB_REPO/blob/main/asset/logo.svg)
+
+---
+
+![Type](https://img.shields.io/badge/Type-VARIABLE_LAYER_FOLDER-orange)
+[![Tests](VARIABLE_GITHUB_REPO/actions/workflows/pull-request.yml/badge.svg)](VARIABLE_GITHUB_REPO/actions/workflows/pull-request.yml)
+[![NPM version](https://img.shields.io/npm/v/VARIABLE_FULL_NAME.svg?logo=npm)](https://www.npmjs.com/package/VARIABLE_FULL_NAME)
+
+---
+
+## installation
+
+```bash
+npm install VARIABLE_FULL_NAME
+```
+
+## Contributing
+
+Contributions are welcome! Please follow the development guidelines above and ensure all tests pass before submitting a pull request.
+
+## License
+
+Licensed under the @Papit License 1.0 - Copyright (c) 2024 Henry Pap (@onkelhoy)
+
+**Key points:**
+
+- ✅ Free to use in commercial projects
+- ✅ Free to modify and distribute
+- ✅ Attribution required
+- ❌ Cannot resell the component itself as a standalone product
+
+See the [LICENSE](https://github.com/onkelhoy/papit/blob/main/LICENSE) file for full details.
+
+## Support
+
+For issues, questions, or contributions, please visit the [GitHub repository](https://github.com/onkelhoy/papit).

package/asset/package-templates/game/asset/translations/en.json

@@ -0,0 +1,7 @@
+{
+  "meta": {
+    "region": "GB",
+    "language": "en-UK"
+  },
+  "VARIABLE_NAME": "VARIABLE_NAME"
+}

package/asset/package-templates/game/package.json

@@ -0,0 +1,78 @@
+{
+    "name": "VARIABLE_FULL_NAME",
+    "description": "VARIABLE_DESCRIPTION",
+    "keywords": [
+        "papit",
+        "game",
+        "typescript",
+        "VARIABLE_NAME"
+    ],
+    "version": "0.0.1",
+    "scripts": {
+        "build": "npx @papit/build -- --error --ancestors",
+        "watch": "tsc -w",
+        "start": "npx @papit/server --info --live",
+        "test": "npx playwright test -c tests/playwright.config.ts $@",
+        "preversion": "papit-version",
+        "postversion": "papit-version",
+        "component": "npm create @papit -- --component",
+        "test:update-snapshots": "npx playwright test --update-snapshots -c tests/playwright.config.ts",
+        "test:chrome": "npm test -- --project=chromium"
+    },
+    "main": "./lib/bundle.js",
+    "types": "./lib/bundle.d.ts",
+    "type": "module",
+    "files": [
+        "asset/",
+        "lib/"
+    ],
+    "exports": {
+        ".": {
+            "import": "./lib/bundle.js",
+            "types": "./lib/bundle.d.ts"
+        }
+    },
+    "author": "VARIABLE_USER",
+    "private": false,
+    "publishConfig": {
+        "access": "public",
+        "registry": "https://registry.npmjs.org/"
+    },
+    "license": "VARIABLE_PROJECTLICENSE",
+    "homepage": "VARIABLE_GITHUB_REPO/tree/main/VARIABLE_LOCAL_DESTINATION",
+    "bugs": {
+        "url": "VARIABLE_GITHUB_REPO/issues"
+    },
+    "repository": {
+        "type": "git",
+        "url": "VARIABLE_GITHUB_REPO.git",
+        "directory": "VARIABLE_LOCAL_DESTINATION"
+    },
+    "sideEffects": true,
+    "engines": {
+        "node": ">=18"
+    },
+    "dependencies": {},
+    "devDependencies": {
+        "@playwright/test": "1.58.0",
+        "playwright": "1.58.0",
+        "typescript": "5.9.3",
+        "@papit/theme": "*",
+        "@papit/translator": "*",
+        "@papit/codeblock": "*",
+        "@papit/game-engine": "*",
+        "@papit/game-input-events": "*",
+        "@papit/game-vector": "*"
+    },
+    "browserslist": [
+        "defaults",
+        "not IE 11",
+        "not dead"
+    ],
+    "papit": {
+        "publish": true,
+        "type": "game",
+        "main": "VARIABLE_NAME",
+        "components": {}
+    }
+}

package/asset/package-templates/game/tests/playwright.config.ts

@@ -0,0 +1,80 @@
+import { defineConfig, devices } from '@playwright/test';
+import path from "node:path";
+import { fileURLToPath } from 'node:url';
+
+// Resolve the directory name and base path for ES modules
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+export default defineConfig({
+  // Look for test files in the "tests" directory, relative to this configuration file.
+  testDir: __dirname,
+
+  // Run all tests in parallel.
+  fullyParallel: true,
+
+  // Fail the build on CI if you accidentally left test.only in the source code.
+  forbidOnly: !!process.env.CI,
+
+  // Retry on CI only.
+  retries: 0,
+
+  // Opt out of parallel tests on CI.
+  workers: process.env.CI ? 1 : undefined,
+
+  // reporter, with output path for HTML reports.
+  reporter: [
+    process.env.CI ? ['github', {
+      open: 'never',
+      outputFolder: path.join(__dirname, 'test-reports'),
+    }] : ['html', {
+      open: 'never',
+      outputFolder: path.join(__dirname, 'test-reports'),
+    }],
+  ],
+
+  outputDir: path.join(__dirname, "test-results"),
+
+  snapshotPathTemplate: '{testDir}/snapshots/{projectName}/{testFilePath}/{arg}-{platform}{ext}',
+
+  use: {
+    // Base URL to use in actions like `await page.goto('/')`.
+    baseURL: process.env.CI ? `http://localhost:3500/${process.env.LAYER_FOLDER}/${process.env.NAME}/tests/` : 'http://localhost:3500/',
+
+    // Collect trace when retrying the failed test.
+    trace: 'on-first-retry',
+    screenshot: 'only-on-failure',
+  },
+
+
+  expect: {
+    toHaveScreenshot: {
+      maxDiffPixels: 100,
+      maxDiffPixelRatio: 0.2,
+    },
+  },
+
+  // Configure projects for major browsers.
+  projects: [
+    {
+      name: 'chromium',
+      use: { ...devices['Desktop Chrome'] },
+    },
+    {
+      name: 'firefox',
+      use: { ...devices['Desktop Firefox'] },
+    },
+    {
+      name: 'webkit',
+      use: { ...devices['Desktop Safari'] },
+    },
+  ],
+  // running web-server before starting tests 
+  webServer: {
+    command: 'npm run server --include-workspace-root=true --workspace="$(npm prefix)" -- --rootdir="$(npm prefix)" --log-level=debug --location=$(pwd) --nosig --port=3500',
+    url: 'http://localhost:3500',
+    reuseExistingServer: true,
+    stdout: 'ignore',
+    stderr: 'pipe'
+  },
+});

package/asset/package-templates/game/tests/tsconfig.json

@@ -0,0 +1,9 @@
+{
+    "extends": "../tsconfig.json",
+    "compilerOptions": {
+        "rootDir": ".."
+    },
+    "include": [
+        "."
+    ]
+}

package/asset/package-templates/game/tsconfig.json

@@ -0,0 +1,41 @@
+{
+    "compilerOptions": {
+        "target": "es2018",
+        "module": "esnext",
+        "moduleResolution": "bundler",
+        // "moduleDetection": "force",
+        "noEmitOnError": true,
+        "skipLibCheck": true,
+        "lib": [
+            "es2020",
+            "dom",
+            "dom.iterable",
+            "esnext"
+        ],
+        "strict": true,
+        "verbatimModuleSyntax": false,
+        "noUncheckedIndexedAccess": false, // use me for strict array/object access checks
+        "esModuleInterop": true,
+        "allowSyntheticDefaultImports": true,
+        "experimentalDecorators": true,
+        "useDefineForClassFields": false,
+        "outDir": "lib",
+        "rootDir": "src",
+        "declaration": true,
+        "resolveJsonModule": true,
+        "allowJs": true,
+        "baseUrl": "src",
+        "paths": {
+            "VARIABLE_FULL_NAME": [
+                "./index"
+            ]
+        },
+        "sourceMap": true,
+        "inlineSources": true,
+        "incremental": true,
+        "tsBuildInfoFile": ".temp/build/tsconfig.tsbuildinfo",
+    },
+    "include": [
+        "src"
+    ]
+}

package/asset/package-templates/game/tsconfig.prod.json

@@ -0,0 +1,9 @@
+{
+    "extends": "./tsconfig.json",
+    "compilerOptions": {
+        "sourceMap": false,
+        "inlineSources": false,
+        "declarationMap": false,
+        "incremental": false
+    }
+}

package/asset/package-templates/game/views/tsconfig.json

@@ -0,0 +1,9 @@
+{
+    "extends": "../tsconfig.json",
+    "compilerOptions": {
+        "rootDir": ".."
+    },
+    "include": [
+        "."
+    ]
+}

package/asset/package-templates/node/README.md

@@ -0,0 +1,40 @@
+# VARIABLE_FULL_NAME
+
+VARIABLE_DESCRIPTION
+
+![Logo](VARIABLE_GITHUB_REPO/blob/main/asset/logo.svg)
+
+---
+
+![Type](https://img.shields.io/badge/Type-VARIABLE_LAYER_FOLDER-orange)
+[![Tests](VARIABLE_GITHUB_REPO/actions/workflows/pull-request.yml/badge.svg)](VARIABLE_GITHUB_REPO/actions/workflows/pull-request.yml)
+[![NPM version](https://img.shields.io/npm/v/VARIABLE_FULL_NAME.svg?logo=npm)](https://www.npmjs.com/package/VARIABLE_FULL_NAME)
+
+---
+
+## installation
+
+```bash
+npm install VARIABLE_FULL_NAME
+```
+
+## Contributing
+
+Contributions are welcome! Please follow the development guidelines above and ensure all tests pass before submitting a pull request.
+
+## License
+
+Licensed under the @Papit License 1.0 - Copyright (c) 2024 Henry Pap (@onkelhoy)
+
+**Key points:**
+
+- ✅ Free to use in commercial projects
+- ✅ Free to modify and distribute
+- ✅ Attribution required
+- ❌ Cannot resell the component itself as a standalone product
+
+See the [LICENSE](https://github.com/onkelhoy/papit/blob/main/LICENSE) file for full details.
+
+## Support
+
+For issues, questions, or contributions, please visit the [GitHub repository](https://github.com/onkelhoy/papit).

package/asset/package-templates/node/asset/translations/en.json

@@ -0,0 +1,7 @@
+{
+  "meta": {
+    "region": "GB",
+    "language": "en-UK"
+  },
+  "VARIABLE_NAME": "VARIABLE_NAME"
+}

package/asset/package-templates/node/package.json

@@ -0,0 +1,70 @@
+{
+    "name": "VARIABLE_FULL_NAME",
+    "description": "VARIABLE_DESCRIPTION",
+    "keywords": [
+        "papit",
+        "node",
+        "typescript",
+        "VARIABLE_NAME"
+    ],
+    "version": "0.0.1",
+    "scripts": {
+        "build": "npx @papit/build --error",
+        "watch": "tsc -w",
+        "start": "npm run build -- --dev && node ./lib/bundle.js",
+        "test": "node --test tests/**/*.test.js",
+        "test:only": "node --test --test-only tests/**/*.test.js",
+        "preversion": "papit-version",
+        "postversion": "papit-version",
+        "component": "npm create @papit -- --component"
+    },
+    "main": "./lib/bundle.js",
+    "types": "./lib/bundle.d.ts",
+    "type": "module",
+    "files": [
+        "asset/",
+        "lib/"
+    ],
+    "exports": {
+        ".": {
+            "import": "./lib/bundle.js",
+            "types": "./lib/bundle.d.ts"
+        }
+    },
+    "author": "VARIABLE_USER",
+    "private": false,
+    "publishConfig": {
+        "access": "public",
+        "registry": "https://registry.npmjs.org/"
+    },
+    "license": "VARIABLE_PROJECTLICENSE",
+    "homepage": "VARIABLE_GITHUB_REPO/tree/main/VARIABLE_LOCAL_DESTINATION",
+    "bugs": {
+        "url": "VARIABLE_GITHUB_REPO/issues"
+    },
+    "repository": {
+        "type": "git",
+        "url": "VARIABLE_GITHUB_REPO.git",
+        "directory": "VARIABLE_LOCAL_DESTINATION"
+    },
+    "sideEffects": true,
+    "engines": {
+        "node": ">=18"
+    },
+    "dependencies": {},
+    "devDependencies": {
+        "@types/node": "22.10.2",
+        "typescript": "5.9.3"
+    },
+    "browserslist": [
+        "defaults",
+        "not IE 11",
+        "not dead"
+    ],
+    "papit": {
+        "publish": true,
+        "type": "node",
+        "main": "VARIABLE_NAME",
+        "components": {}
+    }
+}

package/asset/package-templates/node/tests/tsconfig.json

@@ -0,0 +1,9 @@
+{
+    "extends": "../tsconfig.json",
+    "compilerOptions": {
+        "rootDir": ".."
+    },
+    "include": [
+        "."
+    ]
+}

package/asset/package-templates/node/tsconfig.json

@@ -0,0 +1,38 @@
+{
+    "compilerOptions": {
+        "target": "es2022",
+        "module": "esnext",
+        "moduleResolution": "bundler",
+        // "moduleDetection": "force",
+        "noEmitOnError": true,
+        "skipLibCheck": true,
+        "lib": [
+            "es2022"
+        ],
+        "strict": true,
+        "verbatimModuleSyntax": false,
+        "noUncheckedIndexedAccess": false, // use me for strict array/object access checks
+        "esModuleInterop": true,
+        "allowSyntheticDefaultImports": true,
+        "experimentalDecorators": true,
+        "useDefineForClassFields": false,
+        "outDir": "lib",
+        "rootDir": "src",
+        "declaration": true,
+        "resolveJsonModule": true,
+        "allowJs": true,
+        "baseUrl": "src",
+        "paths": {
+            "VARIABLE_FULL_NAME": [
+                "./index"
+            ]
+        },
+        "sourceMap": true,
+        "inlineSources": true,
+        "incremental": true,
+        "tsBuildInfoFile": ".temp/build/tsconfig.tsbuildinfo",
+    },
+    "include": [
+        "src"
+    ]
+}

package/asset/package-templates/node/tsconfig.prod.json

@@ -0,0 +1,9 @@
+{
+    "extends": "./tsconfig.json",
+    "compilerOptions": {
+        "sourceMap": false,
+        "inlineSources": false,
+        "declarationMap": false,
+        "incremental": false
+    }
+}

package/asset/package-templates/theme/README.md

@@ -0,0 +1,44 @@
+# VARIABLE_FULL_NAME
+
+VARIABLE_DESCRIPTION
+
+![Logo](VARIABLE_GITHUB_REPO/blob/main/asset/logo.svg)
+
+---
+
+![Type](https://img.shields.io/badge/Type-VARIABLE_LAYER_FOLDER-orange)
+[![Tests](VARIABLE_GITHUB_REPO/actions/workflows/pull-request.yml/badge.svg)](VARIABLE_GITHUB_REPO/actions/workflows/pull-request.yml)
+[![NPM version](https://img.shields.io/npm/v/VARIABLE_FULL_NAME.svg?logo=npm)](https://www.npmjs.com/package/VARIABLE_FULL_NAME)
+
+---
+
+## installation
+
+```bash
+npm install VARIABLE_FULL_NAME
+```
+
+## Contributing
+
+Contributions are welcome! Please follow the development guidelines above and ensure all tests pass before submitting a pull request.
+
+## License
+
+Licensed under the @Papit License 1.0 - Copyright (c) 2024 Henry Pap (@onkelhoy)
+
+**Key points:**
+
+- ✅ Free to use in commercial projects
+- ✅ Free to modify and distribute
+- ✅ Attribution required
+- ❌ Cannot resell the component itself as a standalone product
+
+See the [LICENSE](https://github.com/onkelhoy/papit/blob/main/LICENSE) file for full details.
+
+## Related Components
+
+- [@papit/web-component](https://github.com/onkelhoy/papit/tree/main/packages/system/core): Core utilities, decorators, and base component class
+
+## Support
+
+For issues, questions, or contributions, please visit the [GitHub repository](https://github.com/onkelhoy/papit).