@_linked/cli 1.11.1 → 1.12.0

package/defaults/package/src/shapes/index.ts

@@ -0,0 +1,5 @@
+// Shape registry — every shape in this package is imported here so its @linkedShape
+// decorator runs and the shape registers on BOTH boot paths: the backend entry
+// (src/backend.ts, which materializes shapes into app-data on boot) and the frontend
+// entry. `linked create-shape` maintains the list below.
+//SHAPES

package/defaults/package/src/types.ts

@@ -0,0 +1,4 @@
+declare module '*.module.css' {
+  const classes: {[key: string]: string};
+  export default classes;
+}

package/defaults/package/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "sourceMap": true,
+    "declaration": true,
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "downlevelIteration": true,
+    "resolveJsonModule": true,
+    "esModuleInterop": true,
+    "pretty": true,
+    "jsx": "react",
+    "types": ["node"]
+  },
+  "files": [
+    "./src/types.ts","./src/index.ts"],
+  "include": ["./src/backend.ts"]
+}

package/defaults/setup-publish/dual-branch/github/workflows/publish.yml

@@ -136,8 +136,8 @@ jobs:
           gh pr merge "$pr" --auto --merge \
             || echo "Auto-merge unavailable (disabled or conflicts) — PR #$pr left open for manual merge."
 
-  dev-release:
-    name: Publish Dev Release
+  dev-build:
+    name: Verify Dev Build
     if: github.ref == 'refs/heads/dev'
     runs-on: ubuntu-latest
     permissions:
@@ -158,19 +158,33 @@ jobs:
       - name: Build
         run: npm run build
 
-      - name: Publish next release
-        run: |
-          # Start from main's version so changesets apply on top of the latest stable
-          git fetch origin main --depth=1
-          MAIN_VERSION=$(git show origin/main:package.json | node -p "JSON.parse(require('fs').readFileSync(0,'utf8')).version")
-          npm version "$MAIN_VERSION" --no-git-tag-version --allow-same-version
-          # Apply pending changesets to get the next version
-          npx changeset version
-          NEXT_VERSION=$(node -p "require('./package.json').version")
-          # Append dev prerelease identifier
-          DEV_VERSION="${NEXT_VERSION}-next.$(date +%Y%m%d%H%M%S)"
-          npm version "$DEV_VERSION" --no-git-tag-version
-          npm publish --tag next
+      # Prerelease publishing is commented out, NOT deleted — the machinery is correct and
+      # the decision is reversible.
+      #
+      # It published `X.Y.Z-next.<timestamp>` under the `next` dist-tag on every push to `dev`.
+      # The org npm token is now stage-only, so `npm publish` cannot run at all; the nearest
+      # equivalent, `npm stage publish`, would queue a version for a maintainer's 2FA approval
+      # on EVERY push — an approval queue nobody can drain, mostly of artifacts nothing
+      # installs. A gate nobody keeps up with is a gate that gets skimmed, so the prerelease
+      # goes rather than the gate.
+      #
+      # To bring it back for a package that genuinely needs prereleases, uncomment and change
+      # the last line to `npm stage publish --tag next`. Better still, move this job to
+      # `workflow_dispatch` so a prerelease is cut deliberately rather than on every push.
+      #
+      # - name: Publish next release
+      #   run: |
+      #     # Start from main's version so changesets apply on top of the latest stable
+      #     git fetch origin main --depth=1
+      #     MAIN_VERSION=$(git show origin/main:package.json | node -p "JSON.parse(require('fs').readFileSync(0,'utf8')).version")
+      #     npm version "$MAIN_VERSION" --no-git-tag-version --allow-same-version
+      #     # Apply pending changesets to get the next version
+      #     npx changeset version
+      #     NEXT_VERSION=$(node -p "require('./package.json').version")
+      #     # Append dev prerelease identifier
+      #     DEV_VERSION="${NEXT_VERSION}-next.$(date +%Y%m%d%H%M%S)"
+      #     npm version "$DEV_VERSION" --no-git-tag-version
+      #     npm publish --tag next
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           NODE_AUTH_TOKEN: ${{ secrets.{{NPM_SECRET_NAME}} }}

package/lib/esm/cli-methods.d.ts

@@ -8,18 +8,52 @@ import type { PackageDetails } from './interfaces.js';
  */
 import { ensureEnvironmentLoaded, loadBackendStorageConfig, getLincdPackages } from './lifecycle.js';
 export { ensureEnvironmentLoaded, loadBackendStorageConfig, getLincdPackages };
+export type AppTemplate = 'web' | 'react-native';
+type AppIdentity = {
+    appName: string;
+    appPrefix: string;
+    appDomain: string;
+    hyphenName: string;
+};
 export declare const createApp: (name: any, basePath?: string, options?: {
     appName?: string;
     appPrefix?: string;
     appDomain?: string;
     skipInstall?: boolean;
+    template?: AppTemplate;
 }) => Promise<void>;
+/**
+ * iOS bundle identifier from the app domain and prefix:
+ * ('formaestudios.com', 'formae') -> 'com.formaestudios.formae'.
+ */
+export declare function reactNativeBundleId(appDomain: string, appPrefix: string): string;
+/**
+ * The prefix becomes a directory, an npm package name, a bundle-ID label and a
+ * literal inside a Jest regex; this form is valid in all four unescaped.
+ */
+export declare const RN_PREFIX_PATTERN: RegExp;
+/** Placeholder name of the shapes package in defaults/app-react-native. */
+export declare const RN_SHAPES_TOKEN = "app-shapes";
+/**
+ * Scaffold the React Native monorepo from defaults/app-react-native.
+ * Identity is stamped into named fields only; the global ${...} substitution
+ * (replaceVariablesInFolder) is never used, so template literals in TypeScript
+ * sources stay intact.
+ */
+export declare function scaffoldReactNativeApp(targetFolder: string, id: AppIdentity, options?: {
+    skipInstall?: boolean;
+    templateDir?: string;
+}): Promise<void>;
+export declare const reactNativeInternals: {
+    scaffoldReactNativeApp: typeof scaffoldReactNativeApp;
+};
 export declare function warn(...messages: any[]): void;
 export declare function logError(...errors: any[]): void;
 export declare function developPackage(target: any, mode: any): void;
 export declare function runOnPackagesGroupedByDependencies(lincdPackages: any, onBuildStack: (packageGroup: any, dependencies: any) => (pkg: PackageDetails) => Promise<any>, onStackEnd: any, sync?: boolean): Promise<void>;
 export declare function buildAll(options: any): void;
 export declare const createOntology: (prefix: any, uriBase?: any, basePath?: string) => Promise<void>;
+export declare const addShapeToBarrel: (shapeHyphenName: string, root?: string) => string;
 export declare const addLineToIndex: (line: any, insertMatchString: string, root?: string, insertAtStart?: boolean) => string;
 export declare const setNameVariables: (name: any) => {
     hyphenName: any;

package/lib/esm/cli-methods.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-methods.d.ts","sourceRoot":"","sources":["../../src/cli-methods.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli-methods.d.ts","sourceRoot":"","sources":["../../src/cli-methods.ts"],"names":[],"mappings":"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"}

package/lib/esm/cli-methods.js

@@ -15,6 +15,8 @@ import fs from 'fs-extra';
 import path, { dirname } from 'path';
 import { createInterface } from 'readline';
 import { debugInfo, execp, execPromise, getFileImports, getFiles, getLastCommitTime, getPackageJSON, isImportOutsideOfPackage, isImportWithMissingExtension, isInvalidLINCDImport, needsRebuilding, } from './utils.js';
+import { renameShippedDotfiles } from './utils/shippedDotfiles.js';
+import { planPackageSetup } from './utils/packageSetup.js';
 import { spawn as spawnChild } from 'child_process';
 import { findNearestPackageJson } from 'find-nearest-package-json';
 import { statSync } from 'fs';
@@ -60,6 +62,14 @@ function promptUser(question) {
     });
 }
 export const createApp = (name_1, ...args_1) => __awaiter(void 0, [name_1, ...args_1], void 0, function* (name, basePath = process.cwd(), options = {}) {
+    // Reject unknown templates before prompting or writing anything.
+    const template = options.template;
+    if (template !== undefined &&
+        template !== 'web' &&
+        template !== 'react-native') {
+        console.warn(chalk.red(`Unknown template "${template}". Use "web" or "react-native".`));
+        return;
+    }
     // If no name provided, prompt for folder name first
     if (!name) {
         console.log(chalk.blue('\n📁 Folder name for your app:\n'));
@@ -102,6 +112,11 @@ export const createApp = (name_1, ...args_1) => __awaiter(void 0, [name_1, ...ar
     setVariable('app_prefix', appPrefix);
     setVariable('app_domain', appDomain);
     let targetFolder = path.join(basePath, hyphenName);
+    if (template === 'react-native') {
+        // Called through reactNativeInternals so tests can stub the scaffold step.
+        yield reactNativeInternals.scaffoldReactNativeApp(targetFolder, { appName, appPrefix, appDomain, hyphenName }, { skipInstall: options.skipInstall });
+        return;
+    }
     if (!fs.existsSync(targetFolder)) {
         fs.mkdirSync(targetFolder);
     }
@@ -194,6 +209,155 @@ export const createApp = (name_1, ...args_1) => __awaiter(void 0, [name_1, ...ar
     const startCommand = pm === 'yarn' ? 'yarn start' : 'npm start';
     log(`Your Linked app is ready at ${chalk.blueBright(targetFolder)}`, `\nStorage: linked.backend.storage.ts wires aliases to stores; linked.backend.datasets.json holds endpoints.`, `Defaults to Fuseki at ${chalk.cyan('http://localhost:3030')} (auto-creates the dataset on first boot).`, `Make sure Fuseki is running, e.g.:`, `  ${chalk.blueBright('docker run -d --rm -p 3030:3030 --name fuseki stain/jena-fuseki')}`, `Edit ${chalk.cyan('linked.backend.datasets.json')} to change endpoints or credentials.`, `Mirror file for the frontend: ${chalk.cyan('src/linked.frontend.storage.ts')} + ${chalk.cyan('src/linked.frontend.datasets.json')}.`, `\nTo start:`, `  ${chalk.blueBright(`cd ${hyphenName} && ${startCommand}`)}`);
 });
+/**
+ * iOS bundle identifier from the app domain and prefix:
+ * ('formaestudios.com', 'formae') -> 'com.formaestudios.formae'.
+ */
+export function reactNativeBundleId(appDomain, appPrefix) {
+    const host = appDomain
+        .trim()
+        .toLowerCase()
+        .replace(/^[a-z][a-z0-9+.-]*:\/\//, '')
+        .split(/[/?#]/)[0]
+        .replace(/:\d*$/, '');
+    const hostLabels = host.split('.').filter(Boolean);
+    // A bare host such as `localhost` gets a `com` top level: com.localhost.<prefix>.
+    if (hostLabels.length === 1)
+        hostLabels.push('com');
+    return [...hostLabels.reverse(), appPrefix.toLowerCase()]
+        .map((label) => label.replace(/_/g, '-').replace(/[^a-z0-9-]/g, ''))
+        .filter(Boolean)
+        .join('.');
+}
+/**
+ * The prefix becomes a directory, an npm package name, a bundle-ID label and a
+ * literal inside a Jest regex; this form is valid in all four unescaped.
+ */
+export const RN_PREFIX_PATTERN = /^[a-z][a-z0-9-]*$/;
+/** Throws when the prefix is invalid or the target folder is non-empty. */
+function assertReactNativeScaffoldable(targetFolder, appPrefix) {
+    if (typeof appPrefix !== 'string' || !RN_PREFIX_PATTERN.test(appPrefix)) {
+        throw new Error(`Invalid app prefix "${appPrefix !== null && appPrefix !== void 0 ? appPrefix : ''}": it must match ${RN_PREFIX_PATTERN.source} ` +
+            '(start with a lowercase letter; only lowercase letters, digits and hyphens).');
+    }
+    if (fs.existsSync(targetFolder) && fs.readdirSync(targetFolder).length > 0) {
+        throw new Error(`Target folder ${targetFolder} already exists and is not empty. ` +
+            'Choose another name or remove the folder.');
+    }
+}
+/** Placeholder name of the shapes package in defaults/app-react-native. */
+export const RN_SHAPES_TOKEN = 'app-shapes';
+/**
+ * Replace every occurrence of `token` in the text files under `folder`
+ * (node_modules and files containing a NUL byte are skipped). A literal token
+ * replacement, not the ${...} variable substitution.
+ */
+function replaceTokenInTextFiles(folder, token, value) {
+    if (token === value)
+        return;
+    for (const entry of fs.readdirSync(folder, { withFileTypes: true })) {
+        const full = path.join(folder, entry.name);
+        if (entry.isDirectory()) {
+            if (entry.name !== 'node_modules' && entry.name !== '.git') {
+                replaceTokenInTextFiles(full, token, value);
+            }
+        }
+        else if (entry.isFile()) {
+            const buffer = fs.readFileSync(full);
+            if (buffer.includes(0))
+                continue;
+            const text = buffer.toString('utf8');
+            if (text.includes(token)) {
+                fs.writeFileSync(full, text.split(token).join(value));
+            }
+        }
+    }
+}
+const readJSON = (file) => JSON.parse(fs.readFileSync(file, 'utf8'));
+const writeJSON = (file, data) => fs.writeFileSync(file, JSON.stringify(data, null, 2) + '\n');
+/**
+ * Scaffold the React Native monorepo from defaults/app-react-native.
+ * Identity is stamped into named fields only; the global ${...} substitution
+ * (replaceVariablesInFolder) is never used, so template literals in TypeScript
+ * sources stay intact.
+ */
+export function scaffoldReactNativeApp(targetFolder_1, id_1) {
+    return __awaiter(this, arguments, void 0, function* (targetFolder, id, options = {}) {
+        const { appName, appPrefix, appDomain, hyphenName } = id;
+        // Validate before writing anything.
+        assertReactNativeScaffoldable(targetFolder, appPrefix);
+        // lib/esm/ (built) is two levels below the package root; src/ (Jest) is one.
+        const templateDir = options.templateDir ||
+            [
+                path.join(getScriptDir(), '..', '..', 'defaults', 'app-react-native'),
+                path.join(getScriptDir(), '..', 'defaults', 'app-react-native'),
+            ].find((dir) => fs.existsSync(dir));
+        if (!templateDir) {
+            throw new Error('React Native template not found (defaults/app-react-native)');
+        }
+        const shapesName = `${appPrefix}-shapes`;
+        log("Creating new Linked React Native app '" + appName + "'");
+        // 1. Copy the template.
+        fs.copySync(templateDir, targetFolder);
+        // 2. Restore dotfiles npm would strip from the CLI tarball.
+        renameShippedDotfiles(targetFolder);
+        // 3. Rename the shapes package directory.
+        const oldShapesDir = path.join(targetFolder, 'packages', RN_SHAPES_TOKEN);
+        const shapesDir = path.join(targetFolder, 'packages', shapesName);
+        if (fs.existsSync(oldShapesDir) && oldShapesDir !== shapesDir) {
+            fs.renameSync(oldShapesDir, shapesDir);
+        }
+        // 4a. Rename the shapes package token everywhere: workspaces, .gitignore
+        // negation, package names, dependency keys, Jest patterns, import specifiers,
+        // test expectations and docs. Only the literal `app-shapes` token is replaced.
+        replaceTokenInTextFiles(targetFolder, RN_SHAPES_TOKEN, shapesName);
+        // 4b. Stamp the identity fields that are not the shapes token.
+        const rootPkgPath = path.join(targetFolder, 'package.json');
+        if (fs.existsSync(rootPkgPath)) {
+            const rootPkg = readJSON(rootPkgPath);
+            rootPkg.name = `${hyphenName}-monorepo`;
+            writeJSON(rootPkgPath, rootPkg);
+        }
+        const mobileDir = path.join(targetFolder, 'apps', 'mobile');
+        const appJsonPath = path.join(mobileDir, 'app.json');
+        if (fs.existsSync(appJsonPath)) {
+            const appJson = readJSON(appJsonPath);
+            appJson.expo = appJson.expo || {};
+            appJson.expo.name = appName;
+            appJson.expo.slug = hyphenName;
+            appJson.expo.ios = appJson.expo.ios || {};
+            appJson.expo.ios.bundleIdentifier = reactNativeBundleId(appDomain, appPrefix);
+            writeJSON(appJsonPath, appJson);
+        }
+        // 5. Install with npm: the template is an npm workspaces monorepo.
+        if (!options.skipInstall) {
+            const spinner = ora({
+                text: 'Installing dependencies (npm)...',
+                spinner: 'dots',
+            }).start();
+            try {
+                yield execPromise('npm install', false, false, {
+                    cwd: targetFolder,
+                    maxBuffer: 50 * 1024 * 1024,
+                });
+                spinner.succeed('Dependencies installed (npm)');
+            }
+            catch (err) {
+                spinner.fail('Could not install dependencies');
+                if (err === null || err === void 0 ? void 0 : err.stdout)
+                    process.stdout.write(err.stdout);
+                if (err === null || err === void 0 ? void 0 : err.stderr)
+                    process.stderr.write(err.stderr);
+                throw new Error(`npm install failed. The files are in ${targetFolder}; ` +
+                    `run \`npm install\` there to retry.`);
+            }
+        }
+        // 6. Next steps.
+        log(`Your Linked React Native app is ready at ${chalk.blueBright(targetFolder)}`, `\nNext steps:`, `  ${chalk.blueBright(`cd ${path.basename(targetFolder)}`)}`, `  ${chalk.blueBright('npm test -w apps/mobile')}`, `  ${chalk.blueBright('cd apps/mobile && npx expo run:ios')}`);
+    });
+}
+// Indirection so tests can replace the scaffold step when exercising createApp.
+export const reactNativeInternals = { scaffoldReactNativeApp };
 /** Set or append a `KEY=value` line in a `.env`-style text blob. */
 function setEnvVar(envText, key, value) {
     const line = `${key}=${value}`;
@@ -961,6 +1125,42 @@ export const createOntology = (prefix_1, uriBase_1, ...args_1) => __awaiter(void
         log(`Added an import of this file from ${chalk.magenta(indexPath)}`);
     }
 });
+// The shapes barrel (src/shapes/index.ts) is imported by both the frontend index and
+// the backend entry, so every shape registers on both boot paths (and materializes into
+// app-data on boot). `create-shape` adds each new shape here — NOT to the main index.
+const SHAPES_BARREL_HEADER = `// Shape registry — every shape is imported here so its @linkedShape decorator runs and\n` +
+    `// the shape registers on both boot paths (backend materialization + frontend). \`linked\n` +
+    `// create-shape\` maintains this list.\n//SHAPES\n`;
+const ensureBackendImportsShapes = function (root = process.cwd()) {
+    const backendPath = path.join(root, 'src', 'backend.ts');
+    if (!fs.existsSync(backendPath))
+        return;
+    let contents = fs.readFileSync(backendPath, 'utf-8');
+    if (contents.includes('./shapes/index'))
+        return;
+    fs.writeFileSync(backendPath, `import './shapes/index.js';\n` + contents);
+};
+// Register a shape in the shapes barrel (src/shapes/index.ts), creating it if needed, and
+// make sure both the main index and backend.ts import the barrel. Idempotent.
+export const addShapeToBarrel = function (shapeHyphenName, root = process.cwd()) {
+    const shapesDir = path.join(root, 'src', 'shapes');
+    fs.ensureDirSync(shapesDir);
+    const barrelPath = path.join(shapesDir, 'index.ts');
+    let contents = fs.existsSync(barrelPath)
+        ? fs.readFileSync(barrelPath, 'utf-8')
+        : SHAPES_BARREL_HEADER;
+    const line = `import './${shapeHyphenName}.js';`;
+    if (!contents.split(/\n/g).some((l) => l.trim() === line.trim())) {
+        contents = contents.includes('//SHAPES')
+            ? contents.replace('//SHAPES', `//SHAPES\n${line}`)
+            : contents.replace(/\n*$/, '') + `\n${line}\n`;
+        fs.writeFileSync(barrelPath, contents);
+    }
+    // Both boot paths must load the barrel (idempotent).
+    addLineToIndex(`import './shapes/index.js';`, 'shapes', root);
+    ensureBackendImportsShapes(root);
+    return barrelPath;
+};
 // Exported for Shape-Builder reuse (plan-010 T1d.4): CodeShapeSyncService adds
 // the `import './shapes/<Shape>.js';` line to a generated app package's index.
 export const addLineToIndex = function (line, insertMatchString, root = process.cwd(), insertAtStart = false) {
@@ -1145,12 +1345,11 @@ export const createShape = (name_1, ...args_1) => __awaiter(void 0, [name_1, ...
     //replace variables in some of the copied files
     yield replaceVariablesInFiles(targetFile);
     log(`Created a new shape class template in ${chalk.magenta(targetFile.replace(basePath, ''))}`);
-    //if this is NOT a lincd app (but a lincd package)
-    let indexPath;
-    if (!sourceFolder.includes('frontend')) {
-        indexPath = addLineToIndex(`import './shapes/${hyphenName}.js';`, 'shapes');
-        log(`Added an import of this file from ${chalk.magenta(indexPath)}`);
-    }
+    // Register the shape in the shapes barrel (src/shapes/index.ts) — NOT the main index —
+    // and make sure the barrel is loaded on both boot paths. This is what makes the app
+    // materialize its own shapes on boot (plan-027 / plan-028 handover).
+    const barrelPath = addShapeToBarrel(hyphenName);
+    log(`Registered the shape in ${chalk.magenta(barrelPath.replace(basePath, ''))}`);
 });
 export const createSetComponent = (name_1, ...args_1) => __awaiter(void 0, [name_1, ...args_1], void 0, function* (name, basePath = process.cwd()) {
     let targetFolder = ensureFolderExists(basePath, 'src', 'components');
@@ -1866,6 +2065,7 @@ export const createPackage = (name_1, uriBase_1, ...args_1) => __awaiter(void 0,
     let { hyphenName, camelCaseName, underscoreName } = setNameVariables(cleanPackageName);
     log("Creating new LINCD package '" + name + "'");
     fs.copySync(path.join(getScriptDir(), '..', '..', 'defaults', 'package'), targetFolder);
+    renameShippedDotfiles(targetFolder);
     //replace variables in some of the copied files
     yield Promise.all([
         'src/index.ts',
@@ -1896,12 +2096,25 @@ export const createPackage = (name_1, uriBase_1, ...args_1) => __awaiter(void 0,
         console.log('yarn probably not working');
         return '';
     }));
-    let installCommand = version.toString().match(/[0-9]+/)
-        ? 'yarn install'
-        : 'npm install';
-    yield execp(`cd ${targetFolder} && ${installCommand} && npm exec lincd build`, true).catch((err) => {
-        console.warn('Could not install dependencies');
+    const setup = planPackageSetup(version.toString(), path.join(getScriptDir(), 'launch.js'));
+    if (setup.yarnrc) {
+        fs.writeFileSync(path.join(targetFolder, '.yarnrc.yml'), setup.yarnrc);
+    }
+    const installed = yield execp(setup.installCommand, true, false, {
+        cwd: targetFolder,
+    })
+        .then(() => true)
+        .catch(() => {
+        console.warn(`Could not install dependencies (${setup.installCommand})`);
+        process.exitCode = 1;
+        return false;
     });
+    if (installed) {
+        yield execp(setup.buildCommand, true, false, { cwd: targetFolder }).catch(() => {
+            console.warn('Dependencies installed, but the initial build failed');
+            process.exitCode = 1;
+        });
+    }
     log(`Prepared a new LINCD package in ${chalk.magenta(targetFolder)}`, `Run ${chalk.blueBright('yarn build')} from this directory to build once`, `Or ${chalk.blueBright('yarn dev')} to continuously rebuild on file changes`);
 });
 var getNextVersion = function (version) {