slicejs-cli 3.5.1 → 3.6.1

package/CODE_OF_CONDUCT.md

@@ -1,126 +0,0 @@
-# Contributor Covenant Code of Conduct
-
-## Our Pledge
-
-We as members, contributors, and leaders pledge to make participation in our
-community a harassment-free experience for everyone, regardless of age, body
-size, visible or invisible disability, ethnicity, sex characteristics, gender
-identity and expression, level of experience, education, socio-economic status,
-nationality, personal appearance, race, caste, color, religion, or sexual
-identity and orientation.
-
-We pledge to act and interact in ways that contribute to an open, welcoming,
-diverse, inclusive, and healthy community.
-
-## Our Standards
-
-Examples of behavior that contributes to a positive environment for our
-community include:
-
-* Demonstrating empathy and kindness toward other people
-* Being respectful of differing opinions, viewpoints, and experiences
-* Giving and gracefully accepting constructive feedback
-* Accepting responsibility and apologizing to those affected by our mistakes,
-  and learning from the experience
-* Focusing on what is best not just for us as individuals, but for the
-  overall community
-
-Examples of unacceptable behavior include:
-
-* The use of sexualized language or imagery, and sexual attention or
-  advances of any kind
-* Trolling, insulting or derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or email
-  address, without their explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
-  professional setting
-
-## Enforcement Responsibilities
-
-Community leaders are responsible for clarifying and enforcing our standards of
-acceptable behavior and will take appropriate and fair corrective action in
-response to any behavior that they deem inappropriate, threatening, offensive,
-or harmful.
-
-Community leaders have the right and responsibility to remove, edit, or reject
-comments, commits, code, wiki edits, issues, and other contributions that are
-not aligned to this Code of Conduct, and will communicate reasons for moderation
-decisions when appropriate.
-
-## Scope
-
-This Code of Conduct applies within all community spaces, and also applies when
-an individual is officially representing the community in public spaces.
-Examples of representing our community include using an official e-mail address,
-posting via an official social media account, or acting as an appointed
-representative at an online or offline event.
-
-## Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported to Victor Kneider at vkneider.dev@gmail.com or via LinkedIn
-(https://www.linkedin.com/in/vkneider/). All complaints will be reviewed and investigated
-promptly and fairly.
-
-All community leaders are obligated to respect the privacy and security of the
-reporter of any incident.
-
-## Enforcement Guidelines
-
-Community leaders will follow these Community Impact Guidelines in determining
-the consequences for any action they deem in violation of this Code of Conduct:
-
-### 1. Correction
-
-**Community Impact**: Use of inappropriate language or other behavior deemed
-unprofessional or unwelcome in the community.
-
-**Consequence**: A private, written warning from community leaders, providing
-clarity around the nature of the violation and an explanation of why the
-behavior was inappropriate. A public apology may be requested.
-
-### 2. Warning
-
-**Community Impact**: A violation through a single incident or series of
-actions.
-
-**Consequence**: A warning with consequences for continued behavior. No
-interaction with the people involved, including unsolicited interaction with
-those enforcing the Code of Conduct, for a specified period of time. This
-includes avoiding interactions in community spaces as well as external channels
-like social media. Violating these terms may lead to a temporary or permanent
-ban.
-
-### 3. Temporary Ban
-
-**Community Impact**: A serious violation of community standards, including
-sustained inappropriate behavior.
-
-**Consequence**: A temporary ban from any sort of interaction or public
-communication with the community for a specified period of time. No public or
-private interaction with the people involved, including unsolicited interaction
-with those enforcing the Code of Conduct, is allowed during this period.
-Violating these terms may lead to a permanent ban.
-
-### 4. Permanent Ban
-
-**Community Impact**: Demonstrating a pattern of violation of community
-standards, including sustained inappropriate behavior, harassment of an
-individual, or aggression toward or disparagement of classes of individuals.
-
-**Consequence**: A permanent ban from any sort of public interaction within
-the community.
-
-## Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org),
-version 2.1, available at
-https://www.contributor-covenant.org/version/2/1/code_of_conduct.html.
-
-Community Impact Guidelines were inspired by [Mozilla's code of conduct
-enforcement ladder](https://github.com/mozilla/diversity).
-
-For answers to common questions about this code of conduct, see the FAQ at
-https://www.contributor-covenant.org/faq. Translations are available at
-https://www.contributor-covenant.org/translations.

package/ECOSYSTEM.md

@@ -1,9 +0,0 @@
-# Slice.js Ecosystem
-
-| Repository | Description | URL |
-|---|---|---|
-| slice.js | Core web framework | https://github.com/VKneider/slice.js |
-| slice-cli | CLI tool for project management | https://github.com/VKneider/slicejs-cli |
-| slice.js_visual_library | Official visual components and docs | https://github.com/VKneider/slice.js_visual_library |
-| sliceDocs | Framework documentation site | https://github.com/VKneider/slicejs_docs |
-| PortfolioVK2 | Portfolio and demo app | https://github.com/VKneider/portfolio |

package/docs/superpowers/specs/2026-05-10-pwa-generate-design.md

@@ -1,182 +0,0 @@
-# Design of `slice generate-pwa` (V1)
-
-## Objective
-
-Add a dedicated CLI command, `slice generate-pwa`, that converts a Slice build into an offline-capable PWA, with configurable cache strategy and explicit backend domain exclusion to prevent accidental REST API caching.
-
-The command must be post-bundle, operate on `dist/`, and maintain a simple V1 experience.
-
-## V1 Scope
-
-- New `slice generate-pwa` command.
-- Automatically run `build` before the PWA process.
-- Generate `manifest.json` in `dist/`.
-- Generate `sw.js` in `dist/`.
-- Register Service Worker in the entry HTML of `dist`.
-- Support strategies: `hybrid` (default), `offline-first`, `network-first`.
-- Persist and read configuration from `src/sliceConfig.json` in:
-  - `pwa.cache.excludeDomains`.
-- Apply effective exclusion of `localhost` and `127.0.0.1` in development.
-
-## Out of V1 Scope
-
-- Exclusion by paths or headers (`excludePaths`, `excludeHeaders`).
-- Advanced interactive UI for creating PWA icons.
-- Support for push notifications, background sync, or advanced runtime caching by API type.
-- Formal plugin system; left prepared for future evolution.
-
-## Command UX
-
-### Syntax
-
-```bash
-slice generate-pwa
-slice generate-pwa --strategy hybrid
-slice generate-pwa --strategy offline-first
-slice generate-pwa --strategy network-first
-slice generate-pwa --name "My App" --short-name "MyApp"
-```
-
-### V1 Flags
-
-- `--strategy <hybrid|offline-first|network-first>` (default: `hybrid`)
-- `--name <string>`
-- `--short-name <string>`
-
-### Execution flow
-
-1. Run production build.
-2. Read and normalize PWA configuration from `src/sliceConfig.json`.
-3. Generate asset manifest for precache from `dist/`.
-4. Generate `dist/manifest.json`.
-5. Generate `dist/sw.js` with the selected strategy.
-6. Inject (or ensure) SW registration in entry HTML of `dist`.
-7. Print final summary:
-   - strategy used,
-   - number of precached assets,
-   - effective excluded domains.
-
-## Configuration in `sliceConfig.json`
-
-V1 minimal section:
-
-```json
-{
-  "pwa": {
-    "cache": {
-      "excludeDomains": []
-    }
-  }
-}
-```
-
-Rules:
-
-- If `pwa` does not exist, the command creates the section without breaking existing configuration.
-- `excludeDomains` accepts exact hosts (e.g., `api.mydomain.com`).
-- In development execution, `localhost` and `127.0.0.1` are effectively added (not necessarily persisted).
-
-## Proposed Architecture
-
-### CLI Integration
-
-- Add command in `client.js`:
-  - `generate-pwa`
-  - `--strategy` option
-  - name options for manifest
-
-### New Modules
-
-- `commands/pwa/generatePwa.js`
-  - Orchestrator of the complete flow.
-- `commands/pwa/ConfigResolver.js`
-  - Reads/creates/normalizes `pwa.cache.excludeDomains`.
-- `commands/pwa/AssetManifestBuilder.js`
-  - Iterates `dist/` and builds precache list.
-- `commands/pwa/ManifestGenerator.js`
-  - Generates `manifest.json` with defaults and flag overrides.
-- `commands/pwa/ServiceWorkerGenerator.js`
-  - Generates `sw.js` with selected strategy and exclusions.
-
-## Cache Design
-
-### Global Rules
-
-- Intercept only `GET` requests.
-- If the host is in `excludeDomains`, do a direct `fetch` (no cache).
-- Cache versioning by build id (timestamp or build hash).
-- On new SW activation, automatically clean old caches.
-
-### Strategies
-
-- `hybrid` (default):
-  - static assets -> `cache-first`.
-  - HTML navigation -> `network-first` with offline fallback.
-- `offline-first`:
-  - navigation + static -> `cache-first`.
-  - background update when online.
-- `network-first`:
-  - navigation -> `network-first`.
-  - precached static assets as fallback.
-
-## REST API and Security Handling
-
-To prevent unwanted backend caching:
-
-- Domain exclusion via `excludeDomains` (main V1 rule).
-- Limit runtime cache to frontend assets and navigation per strategy.
-- Do not cache methods other than `GET`.
-
-Result: client assets are accelerated offline, but the backend stays out of the cache via explicit configuration.
-
-## Error handling
-
-- If build fails, abort `generate-pwa` with a clear message.
-- If `dist/` does not exist after build, abort with diagnostics.
-- If `sliceConfig.json` is invalid, show error with repair suggestion.
-- If SW registration cannot be injected into HTML, report warning and target path.
-
-## Testing
-
-### Unit tests
-
-- `ConfigResolver`:
-  - creates `pwa.cache.excludeDomains` section when it does not exist,
-  - respects existing config.
-- `AssetManifestBuilder`:
-  - includes expected assets,
-  - excludes unsuitable files.
-- `ServiceWorkerGenerator`:
-  - generates correct logic per strategy,
-  - respects `excludeDomains`.
-
-### Integration
-
-- `slice generate-pwa` runs build and creates `dist/manifest.json` + `dist/sw.js`.
-- SW registration present in output HTML.
-- domain exclusions applied in generated code.
-
-### Minimal E2E manual
-
-- Build + generate-pwa.
-- Open app, validate installability (manifest).
-- Turn off network, validate offline navigation in `hybrid`.
-- Verify that requests to excluded domain are not served from SW cache.
-
-## Evolution Plan (post V1)
-
-- `excludePaths` and `excludeHeaders`.
-- Assisted PWA icon and shortcut support.
-- Per-route strategy (e.g., `/api/*` network-only).
-- Extract reusable postbundle pipeline for other features.
-
-## Acceptance Criteria
-
-- Functional `slice generate-pwa` command exists.
-- Runs build before generating PWA artifacts.
-- Generates `manifest.json` and `sw.js` in `dist/`.
-- Registers SW in main output HTML.
-- `hybrid` is default with HTML `network-first` and offline fallback.
-- Reads/writes `pwa.cache.excludeDomains` in `src/sliceConfig.json`.
-- Excludes configured domains from runtime cache.
-- Shows a readable final summary to the user.

package/playwright.config.js

@@ -1,51 +0,0 @@
-import { defineConfig, devices } from '@playwright/test';
-
-const PORT = process.env.E2E_PORT ? Number(process.env.E2E_PORT) : 3210;
-const UNMIN_PORT = PORT + 4;
-const BASE_URL = `http://127.0.0.1:${PORT}`;
-const UNMIN_URL = `http://127.0.0.1:${UNMIN_PORT}`;
-
-export default defineConfig({
-  testDir: './tests/e2e',
-  testMatch: '**/*.spec.js',
-  fullyParallel: false,
-  workers: 1,
-  timeout: 30_000,
-  expect: { timeout: 10_000 },
-  reporter: process.env.CI ? [['list'], ['html', { open: 'never' }]] : [['list']],
-  use: {
-    trace: 'retain-on-failure',
-  },
-  projects: [
-    {
-      name: 'chromium',
-      testIgnore: '**/unminified.spec.js',
-      use: { ...devices['Desktop Chrome'], baseURL: BASE_URL },
-    },
-    {
-      name: 'chromium-unminified',
-      testMatch: '**/unminified.spec.js',
-      use: { ...devices['Desktop Chrome'], baseURL: UNMIN_URL },
-    },
-  ],
-  webServer: [
-    {
-      command: 'node tests/e2e/serve.mjs',
-      url: `${BASE_URL}/slice-env.json`,
-      env: { E2E_PORT: String(PORT) },
-      timeout: 120_000,
-      reuseExistingServer: !process.env.CI,
-      stdout: 'pipe',
-      stderr: 'pipe',
-    },
-    {
-      command: 'node tests/e2e/serve.mjs',
-      url: `${UNMIN_URL}/slice-env.json`,
-      env: { E2E_PORT: String(UNMIN_PORT), E2E_MINIFY: 'false' },
-      timeout: 120_000,
-      reuseExistingServer: !process.env.CI,
-      stdout: 'pipe',
-      stderr: 'pipe',
-    },
-  ],
-});

package/tests/build-command-integration.test.js

@@ -1,87 +0,0 @@
-import { test, describe } from 'node:test';
-import assert from 'node:assert/strict';
-import fs from 'fs-extra';
-import path from 'node:path';
-import { parse } from '@babel/parser';
-import { withTestProject } from './helpers/setup.js';
-import build from '../commands/build/build.js';
-import { cleanBundles, bundleInfo } from '../commands/bundle/bundle.js';
-
-const MODULE_URL = import.meta.url;
-
-describe('slice build (full pipeline: buildProduction + bundle -> dist)', () => {
-  test('produces a dist/ with parseable bundles', async () => {
-    await withTestProject(async (root) => {
-      const ok = await build({ minify: false, obfuscate: false });
-      assert.equal(ok, true);
-
-      const dist = path.join(root, 'dist');
-      assert.ok(await fs.pathExists(path.join(dist, 'App', 'index.js')));
-
-      const bundlesDir = path.join(dist, 'bundles');
-      assert.ok(await fs.pathExists(bundlesDir), 'dist/bundles should exist');
-
-      const bundleFiles = (await fs.readdir(bundlesDir)).filter(
-        (f) => f.startsWith('slice-bundle.') && f.endsWith('.js')
-      );
-      assert.ok(bundleFiles.length > 0, 'at least one bundle in dist/bundles');
-
-      for (const f of bundleFiles) {
-        const code = await fs.readFile(path.join(bundlesDir, f), 'utf8');
-        assert.doesNotThrow(
-          () => parse(code, { sourceType: 'module', plugins: ['jsx'] }),
-          `dist bundle ${f} is not valid JS`
-        );
-      }
-    });
-  });
-});
-
-describe('bundle clean / info subcommands', () => {
-  test('cleanBundles removes slice-bundle.* files and the config', async () => {
-    await withTestProject(async (root) => {
-      const src = path.join(root, 'src');
-      await fs.writeFile(path.join(src, 'slice-bundle.critical.js'), '// x');
-      await fs.writeFile(path.join(src, 'slice-bundle.home.js'), '// x');
-      await fs.writeFile(path.join(src, 'bundle.config.json'), '{}');
-
-      await cleanBundles();
-
-      assert.equal(await fs.pathExists(path.join(src, 'slice-bundle.critical.js')), false);
-      assert.equal(await fs.pathExists(path.join(src, 'slice-bundle.home.js')), false);
-      assert.equal(await fs.pathExists(path.join(src, 'bundle.config.json')), false);
-    });
-  });
-
-  test('cleanBundles is a no-op (no throw) when there are no bundles', async () => {
-    await withTestProject(async () => {
-      await assert.doesNotReject(() => cleanBundles());
-    });
-  });
-
-  test('bundleInfo does not throw when a config exists', async () => {
-    await withTestProject(async (root) => {
-      const cfg = {
-        version: '2.0.0',
-        strategy: 'hybrid',
-        generated: '2025-01-01T00:00:00.000Z',
-        stats: {
-          totalComponents: 3,
-          totalRoutes: 2,
-          sharedComponents: 1,
-          sharedPercentage: 33,
-          totalSize: 2048,
-        },
-        bundles: { critical: { components: ['A'], size: 1024 }, routes: {} },
-      };
-      await fs.writeJson(path.join(root, 'src', 'bundle.config.json'), cfg);
-      await assert.doesNotReject(() => bundleInfo());
-    });
-  });
-
-  test('bundleInfo warns (no throw) when config is missing', async () => {
-    await withTestProject(async () => {
-      await assert.doesNotReject(() => bundleInfo());
-    });
-  });
-});

package/tests/build-production-e2e.test.js

@@ -1,140 +0,0 @@
-import { test, describe } from 'node:test';
-import assert from 'node:assert/strict';
-import fs from 'fs-extra';
-import path from 'node:path';
-import { parse } from '@babel/parser';
-import { withTestProject } from './helpers/setup.js';
-import buildProduction from '../commands/buildProduction/buildProduction.js';
-
-const MODULE_URL = import.meta.url;
-
-async function writeSrc(root, rel, content) {
-  const p = path.join(root, 'src', rel);
-  await fs.ensureDir(path.dirname(p));
-  await fs.writeFile(p, content, 'utf8');
-  return p;
-}
-
-describe('buildProduction end-to-end', () => {
-  test('produces a dist/ that preserves the Slice.js critical files', async () => {
-    await withTestProject(async (root) => {
-      const ok = await buildProduction({ minify: false });
-      assert.equal(ok, true, 'build should succeed on the starter project');
-
-      const dist = path.join(root, 'dist');
-      assert.ok(await fs.pathExists(path.join(dist, 'sliceConfig.json')));
-      assert.ok(await fs.pathExists(path.join(dist, 'Components', 'components.js')));
-      assert.ok(await fs.pathExists(path.join(dist, 'App', 'index.js')));
-    });
-  });
-
-  test('sliceConfig.json is copied verbatim (never minified)', async () => {
-    await withTestProject(async (root) => {
-      await buildProduction({ minify: true });
-      const srcCfg = await fs.readFile(path.join(root, 'src', 'sliceConfig.json'), 'utf8');
-      const distCfg = await fs.readFile(path.join(root, 'dist', 'sliceConfig.json'), 'utf8');
-      assert.equal(distCfg, srcCfg);
-    });
-  });
-
-  test('components.js keeps its registry structure after minification', async () => {
-    await withTestProject(async (root) => {
-      await buildProduction({ minify: true });
-      const built = await fs.readFile(path.join(root, 'dist', 'Components', 'components.js'), 'utf8');
-      assert.match(built, /const components/);
-      assert.match(built, /export default/);
-      assert.doesNotThrow(() => parse(built, { sourceType: 'module' }));
-    });
-  });
-
-  test('--no-minify copies JS byte-for-byte', async () => {
-    await withTestProject(async (root) => {
-      const original = 'export function probe() {\n  return 1 + 1;\n}\n';
-      await writeSrc(root, 'App/probe.js', original);
-      await buildProduction({ minify: false });
-      const built = await fs.readFile(path.join(root, 'dist', 'App', 'probe.js'), 'utf8');
-      assert.equal(built, original);
-    });
-  });
-
-  test('minification preserves reserved Slice identifiers', async () => {
-    await withTestProject(async (root) => {
-      await writeSrc(
-        root,
-        'App/probe.js',
-        `export function probe() {\n` +
-          `  const aVeryLongLocalNameThatShouldBeMangled = slice.build('Foo');\n` +
-          `  return aVeryLongLocalNameThatShouldBeMangled;\n` +
-          `}\nclass Controller {}\n`
-      );
-      await buildProduction({ minify: true });
-      const built = await fs.readFile(path.join(root, 'dist', 'App', 'probe.js'), 'utf8');
-      assert.match(built, /slice\.build/, 'reserved global "slice" must survive minification');
-      assert.match(built, /Controller/, 'reserved class name "Controller" must survive');
-      assert.doesNotThrow(() => parse(built, { sourceType: 'module' }));
-    });
-  });
-
-  test('CSS is minified (whitespace collapsed)', async () => {
-    await withTestProject(async (root) => {
-      await writeSrc(root, 'Styles/probe.css', '.a {\n   color:  red;\n   margin: 0;\n}\n');
-      await buildProduction({ minify: true });
-      const built = await fs.readFile(path.join(root, 'dist', 'Styles', 'probe.css'), 'utf8');
-      assert.ok(built.length < 30, `expected minified css, got: ${JSON.stringify(built)}`);
-      assert.match(built, /\.a\{/);
-    });
-  });
-
-  test('HTML minification preserves slice-* attributes', async () => {
-    await withTestProject(async (root) => {
-      await writeSrc(
-        root,
-        'App/probe.html',
-        '<!DOCTYPE html>\n<html>\n  <body>\n    <div   slice-id="my-component"  >hi</div>\n  </body>\n</html>\n'
-      );
-      await buildProduction({ minify: true });
-      const built = await fs.readFile(path.join(root, 'dist', 'App', 'probe.html'), 'utf8');
-      assert.match(built, /slice-id="my-component"/, 'slice-* attribute must be preserved');
-    });
-  });
-
-  describe('clean / skip-clean semantics', () => {
-    test('a stale dist file is removed by default', async () => {
-      await withTestProject(async (root) => {
-        const stale = path.join(root, 'dist', 'STALE_ARTIFACT.txt');
-        await fs.ensureDir(path.dirname(stale));
-        await fs.writeFile(stale, 'old');
-        await buildProduction({ minify: false });
-        assert.equal(await fs.pathExists(stale), false, 'stale dist file should be cleaned');
-      });
-    });
-
-    test('--skip-clean keeps a stale dist file', async () => {
-      await withTestProject(async (root) => {
-        const stale = path.join(root, 'dist', 'STALE_ARTIFACT.txt');
-        await fs.ensureDir(path.dirname(stale));
-        await fs.writeFile(stale, 'old');
-        await buildProduction({ minify: false, skipClean: true });
-        assert.equal(await fs.pathExists(stale), true, 'stale dist file should survive --skip-clean');
-      });
-    });
-  });
-
-  test('build fails (returns false) when a critical file is missing', async () => {
-    await withTestProject(async (root) => {
-      await fs.remove(path.join(root, 'src', 'App', 'index.js'));
-      const ok = await buildProduction({ minify: false });
-      assert.equal(ok, false, 'missing App/index.js must abort the build');
-    });
-  });
-
-  test('bundle.config inside a bundles/ folder is renamed to bundle.build.config', async () => {
-    await withTestProject(async (root) => {
-      await writeSrc(root, 'bundles/bundle.config.json', '{"production":true}');
-      await buildProduction({ minify: false });
-      const dist = path.join(root, 'dist', 'bundles');
-      assert.equal(await fs.pathExists(path.join(dist, 'bundle.build.config.json')), true);
-      assert.equal(await fs.pathExists(path.join(dist, 'bundle.config.json')), false);
-    });
-  });
-});