accel2spa 0.0.0-stage → 0.1.0

package/dist/scanners/properties.d.ts

@@ -0,0 +1,15 @@
+/** Parser for Java .properties files and Accelerator `base_<lang>.properties` bundles. */
+export interface PropertyEntry {
+    value: string;
+    line: number;
+}
+/** Parse .properties text: comments, `=`/`:`/space separators, line continuations, unicode escapes. */
+export declare function parseProperties(text: string): Map<string, PropertyEntry>;
+export interface Bundle {
+    /** Language code (`en`, `de`, `pt_BR`) or `default` for the unsuffixed file. */
+    lang: string;
+    file: string;
+    entries: Map<string, PropertyEntry>;
+}
+/** Returns the language for a `base_<lang>.properties` file name, `default` for `base.properties`, else undefined. */
+export declare function bundleLang(fileName: string): string | undefined;

package/dist/scanners/properties.js

@@ -0,0 +1,54 @@
+/** Parser for Java .properties files and Accelerator `base_<lang>.properties` bundles. */
+function unescape(s) {
+    return s.replace(/\\(u[0-9a-fA-F]{4}|[tnrf]|.)/g, (_m, g) => {
+        if (g[0] === 'u' && g.length === 5)
+            return String.fromCharCode(parseInt(g.slice(1), 16));
+        switch (g) {
+            case 't': return '\t';
+            case 'n': return '\n';
+            case 'r': return '\r';
+            case 'f': return '\f';
+            default: return g;
+        }
+    });
+}
+/** Parse .properties text: comments, `=`/`:`/space separators, line continuations, unicode escapes. */
+export function parseProperties(text) {
+    const result = new Map();
+    const rawLines = text.replace(/^/, '').split(/\r?\n/);
+    for (let i = 0; i < rawLines.length; i++) {
+        const startLine = i + 1;
+        let line = rawLines[i].replace(/^\s+/, '');
+        if (!line || line.startsWith('#') || line.startsWith('!'))
+            continue;
+        // Continuation: odd number of trailing backslashes.
+        while (/(?:^|[^\\])(?:\\\\)*\\$/.test(line) && i + 1 < rawLines.length) {
+            line = line.slice(0, -1) + rawLines[++i].replace(/^\s+/, '');
+        }
+        let k = 0;
+        while (k < line.length) {
+            const ch = line[k];
+            if (ch === '\\') {
+                k += 2;
+                continue;
+            }
+            if (ch === '=' || ch === ':' || ch === ' ' || ch === '\t')
+                break;
+            k++;
+        }
+        const key = unescape(line.slice(0, k));
+        let rest = line.slice(k).replace(/^[ \t]*[=:]?[ \t]*/, '');
+        if (!key)
+            continue;
+        rest = unescape(rest);
+        result.set(key, { value: rest, line: startLine });
+    }
+    return result;
+}
+/** Returns the language for a `base_<lang>.properties` file name, `default` for `base.properties`, else undefined. */
+export function bundleLang(fileName) {
+    const m = /^base(?:_([A-Za-z]{2,3}(?:_[A-Za-z]{2})?))?\.properties$/.exec(fileName);
+    if (!m)
+        return undefined;
+    return m[1] ?? 'default';
+}

package/dist/util.d.ts

@@ -0,0 +1,12 @@
+/** Maps character offsets to 1-based line numbers. */
+export declare class LineMap {
+    private starts;
+    constructor(text: string);
+    lineAt(offset: number): number;
+}
+/** Replace every non-newline character with a space (keeps offsets and line numbers stable). */
+export declare const blank: (s: string) => string;
+export declare const toPosix: (p: string) => string;
+export declare function kebab(s: string): string;
+/** Recursively list files (posix paths relative to root). Never throws. */
+export declare function walkFiles(root: string, warn: (m: string) => void): string[];

package/dist/util.js

@@ -0,0 +1,61 @@
+import { readdirSync } from 'node:fs';
+import path from 'node:path';
+/** Maps character offsets to 1-based line numbers. */
+export class LineMap {
+    starts = [0];
+    constructor(text) {
+        for (let i = 0; i < text.length; i++) {
+            if (text.charCodeAt(i) === 10)
+                this.starts.push(i + 1);
+        }
+    }
+    lineAt(offset) {
+        let lo = 0;
+        let hi = this.starts.length - 1;
+        while (lo < hi) {
+            const mid = (lo + hi + 1) >> 1;
+            if (this.starts[mid] <= offset)
+                lo = mid;
+            else
+                hi = mid - 1;
+        }
+        return lo + 1;
+    }
+}
+/** Replace every non-newline character with a space (keeps offsets and line numbers stable). */
+export const blank = (s) => s.replace(/[^\r\n]/g, ' ');
+export const toPosix = (p) => p.split(path.sep).join('/');
+export function kebab(s) {
+    return s
+        .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
+        .replace(/[^A-Za-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .toLowerCase();
+}
+const IGNORED_DIRS = new Set(['node_modules', 'dist', 'out']);
+/** Recursively list files (posix paths relative to root). Never throws. */
+export function walkFiles(root, warn) {
+    const result = [];
+    const visit = (dir) => {
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch (e) {
+            warn(`Cannot read directory ${toPosix(path.relative(root, dir)) || '.'}: ${e.message}`);
+            return;
+        }
+        entries.sort((a, b) => a.name.localeCompare(b.name));
+        for (const entry of entries) {
+            if (entry.name.startsWith('.') || IGNORED_DIRS.has(entry.name))
+                continue;
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory())
+                visit(full);
+            else if (entry.isFile())
+                result.push(toPosix(path.relative(root, full)));
+        }
+    };
+    visit(root);
+    return result;
+}

package/package.json

@@ -1,6 +1,50 @@
 {
   "name": "accel2spa",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Reads a SAP Commerce Accelerator storefront and writes one migration spec per page for Spartacus (Composable Storefront): conditional rules, i18n gaps, data OCC does not expose, missing endpoints.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/andreescocard/accel2spa.git"
+  },
+  "homepage": "https://github.com/andreescocard/accel2spa#readme",
+  "bugs": {
+    "url": "https://github.com/andreescocard/accel2spa/issues"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "accel2spa": "dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node scripts/copy-assets.mjs",
+    "test": "vitest run",
+    "visuals": "python scripts/visuals/gen.py",
+    "analyze:fixture": "node dist/cli.js analyze fixtures/acme-storefront --out out"
+  },
+  "keywords": [
+    "sap-commerce",
+    "spartacus",
+    "composable-storefront",
+    "hybris",
+    "migration",
+    "accelerator",
+    "occ",
+    "jsp"
+  ],
+  "dependencies": {
+    "yaml": "^2.9.1"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.6",
+    "typescript": "^7.0.2",
+    "vitest": "^5.1.0"
+  }
+}