@_linked/cli 1.30.1 → 1.32.0

package/CHANGELOG.md

@@ -1,5 +1,74 @@
 # Changelog
 
+## 1.32.0
+
+### Minor Changes
+
+- [#181](https://github.com/linked-fw/cli/pull/181) [`adb992a`](https://github.com/linked-fw/cli/commit/adb992aad55399ff8daee4888cff97c01302e7fc) Thanks [@flyon](https://github.com/flyon)! - `linked build` now enforces the shape-registration standard: every package registers its whole
+  shape set through `src/shapes/index.ts`, and apps load it with `import '<pkg>/shapes/index'`.
+
+  Two new build steps, after "Checking shape references":
+
+  - **Checking shapes/index** loads `lib/esm/shapes/index.js` on its own in a fresh process and fails
+    when it misses any of the package's shapes that its shape modules register when each is loaded
+    alone (the per-module loads are shared with the shape-references check, not repeated). It also
+    fails when the package has shapes but no `shapes/index`, or when the index throws on load. The
+    error lists the missing shapes and the exact `import './X.js';` lines to add. A package without
+    shapes passes.
+  - **Checking sideEffects** fails when `package.json` `sideEffects` is `false`, or is a list that
+    does not match every `lib/esm/shapes/**/*.js`: a bundler drops a side-effect-only import of a
+    module declared side-effect-free, so the index would register nothing in production. The error
+    names the uncovered modules and what to write instead (omit the field, or
+    `["lib/esm/shapes/index.js", "lib/esm/shapes/*.js"]`).
+
+  `linked create-shape` now writes to the `src/shapes/index.ts` next to the source folder it created
+  the shape in, rather than the one under the current directory. The package template's
+  `shapes/index.ts` states the side-effect-imports-only rule, and the React Native template's shapes
+  package gains a `src/shapes/index.ts` that its entry imports.
+
+  The shape-references check no longer tolerates `@_linked/core`'s `PropertyShape.in -> List`: core
+  now registers `List` wherever `PropertyShape` is registered, so the known-unresolved list is empty
+  and that reference fails the build like any other.
+
+## 1.31.0
+
+### Minor Changes
+
+- [#157](https://github.com/linked-fw/cli/pull/157) [`5197e61`](https://github.com/linked-fw/cli/commit/5197e61dc3226ba89402adf34b9ca445631424be) Thanks [@flyon](https://github.com/flyon)! - `create-package` now produces a package that is correct the moment it exists.
+
+  Three defects, fixed together because fixing one alone turns a silent defect into a hard
+  build failure:
+
+  - **The ontology register sibling was never wired up.** The template's `src/index.ts`
+    imported the terms module rather than `<name>.register.js`, and `createPackage` omitted
+    `example-ontology.register.ts` from both its substitution list and its rename list. A new
+    package therefore kept a stray `example-ontology.register.ts` full of unsubstituted
+    `${...}` placeholders, and nothing imported either register file — so `linkedOntology()`
+    never ran and the ontology was never registered. `createOntology` now adds the register
+    import to the index too.
+  - **The template still shipped an entry-graph compile** (`files: [types.ts, index.ts]`,
+    `include: [backend.ts]`). It now uses the whole-folder shape the fleet converged on:
+    `files: ["./src/index.ts"]`, `include: ["./src/**/*.ts", "./src/backend.ts"]`, with tests
+    excluded. This had to follow the fix above: a whole-folder compile would otherwise reach
+    the unsubstituted placeholder and fail.
+  - **A new package had no `.gitignore`**, so `lib/` and `node_modules/` were committable from
+    minute one. The template now ships `gitignore.template` (`lib`, `node_modules`,
+    `*.tsbuildinfo`), renamed by the existing dotfile pass.
+
+  - **`"types"` produced a double mapping.** The template declared
+    `"types": "lib/esm/index.d.ts"` alongside `typesVersions: {"*":{"*":["lib/esm/*"]}}`,
+    which TypeScript applies to the `types` field too — so it asked for
+    `lib/esm/lib/esm/index.d.ts` and `node10` resolution failed outright. Restored to
+    `"types": "index.d.ts"`, the convention the shipped packages already use, with a `//types`
+    note in the file saying why it is correct as written.
+
+  Also fixes the `data.defauilt` typo in the example ontology's ESM JSON import, which made
+  `loadData()` resolve to `undefined` under ESM.
+
+  A new gated suite, `tests/template/package.full.test.ts` (`npm run test:template`),
+  scaffolds with the built CLI, installs, builds, and asserts each of these as a property
+  rather than a claim.
+
 ## 1.30.1
 
 ### Patch Changes

package/defaults/app-react-native/packages/app-shapes/src/index.ts

@@ -1,2 +1,4 @@
 import './package';
+// Registers every shape in the package.
+import './shapes/index';
 export * from './shapes/Example';

package/defaults/app-react-native/packages/app-shapes/src/shapes/index.ts

@@ -0,0 +1,5 @@
+// Shape registry: one side-effect import per shape module, so loading this file
+// registers every shape in the package. Imports only — no exports. `linked build`
+// fails when a shape module is missing from this list.
+// Extensionless on purpose: Metro does not map `.js` specifiers to `.ts` source.
+import './Example';

package/defaults/package/gitignore.template

@@ -0,0 +1,3 @@
+lib
+node_modules
+*.tsbuildinfo

package/defaults/package/package.json

@@ -14,7 +14,8 @@
   "linkedPackage": true,
   "main": "lib/cjs/index.js",
   "module": "lib/esm/index.js",
-  "types": "lib/esm/index.d.ts",
+  "//types": "Correct as written, do not 'fix' it: typesVersions below is applied to the types field too, so \"index.d.ts\" resolves to lib/esm/index.d.ts. Writing that literal path applies the mapping twice (lib/esm/lib/esm/index.d.ts) and breaks node10 resolution. Verify with ts.resolveModuleName under node10 AND bundler, not by looking for the file on disk.",
+  "types": "index.d.ts",
   "license": "ISC",
   "scripts": {
     "start": "linked dev",

package/defaults/package/src/index.ts

@@ -1,5 +1,9 @@
 import './types.js';
-import './ontologies/${hyphen_name}.js';
+// Registers the ontology. This MUST be the `.register.js` sibling, not the terms module
+// itself: importing the terms module alone never calls `linkedOntology()`, so the ontology
+// is silently never registered. See the comment in the register file for why registration
+// cannot live in the terms module.
+import './ontologies/${hyphen_name}.register.js';
 
 //SHAPES FIRST — all shapes register via the barrel
 import './shapes/index.js';

package/defaults/package/src/ontologies/example-ontology.ts

@@ -11,7 +11,7 @@ export var loadData = () => {
   } else {
     // ESM import
     //@ts-ignore
-    return import('../data/${hyphen_name}.json',{ with: { type: "json" } }).then((data) => data.defauilt);
+    return import('../data/${hyphen_name}.json',{ with: { type: "json" } }).then((data) => data.default);
   }
 };
 

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

@@ -1,5 +1,7 @@
 // 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.
+// entry. Apps load the whole set with `import '<package>/shapes/index'`.
+// Side-effect imports only: no exports, components or providers. `linked create-shape`
+// maintains the list below, and `linked build` fails when a shape module is missing.
 //SHAPES

package/defaults/package/tsconfig.json

@@ -9,10 +9,22 @@
     "resolveJsonModule": true,
     "esModuleInterop": true,
     "pretty": true,
+    "skipLibCheck": true,
     "jsx": "react",
     "types": ["node"]
   },
   "files": [
-    "./src/types.ts","./src/index.ts"],
-  "include": ["./src/backend.ts"]
+    "./src/index.ts"
+  ],
+  "include": [
+    "./src/**/*.ts",
+    "./src/backend.ts"
+  ],
+  "exclude": [
+    "**/*.test.ts",
+    "**/*.test.tsx",
+    "./src/__tests__/**",
+    "./src/tests/**",
+    "./src/test-helpers/**"
+  ]
 }

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

@@ -20,7 +20,8 @@ import { planPackageSetup } from './utils/packageSetup.js';
 import { detectPackageManager, execBinCommand, runScriptCommand, } from './utils/packageManager.js';
 import { rewriteExtensionlessImports } from './utils/esmSpecifiers.js';
 import { checkShapeNames } from './utils/shapeNames.js';
-import { checkShapeReferences } from './utils/shapeReferences.js';
+import { checkShapeReferences, inspectShapeReferences, } from './utils/shapeReferences.js';
+import { checkShapesIndex, checkShapesSideEffects } from './utils/shapesIndex.js';
 import { spawn as spawnChild } from 'child_process';
 import { findNearestPackageJson } from 'find-nearest-package-json';
 import { statSync } from 'fs';
@@ -1065,15 +1066,21 @@ export const createOntology = (prefix_1, uriBase_1, ...args_1) => __awaiter(void
     //if this is not a lincd app (but a lincd package instead)
     if (!sourceFolder.includes('frontend')) {
         //then also add an import to index
-        let indexPath = addLineToIndex(`import './ontologies/${hyphenName}.js';`, 'ontologies');
+        // Import the register sibling, not the terms module: only the sibling calls
+        // linkedOntology(). See the comment in example-ontology.register.ts.
+        let indexPath = addLineToIndex(`import './ontologies/${hyphenName}.register.js';`, 'ontologies');
         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.
+// It holds side-effect imports only (no exports), in packages and apps alike: apps load a
+// package's whole set with `import '<pkg>/shapes/index'`, and `linked build` fails a
+// package whose shapes/index misses one of its shapes.
 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` +
+    `// the shape registers on both boot paths (backend materialization + frontend).\n` +
+    `// Side-effect imports only: no exports, components or providers. \`linked\n` +
     `// create-shape\` maintains this list.\n//SHAPES\n`;
 const ensureBackendImportsShapes = function (root = process.cwd()) {
     const backendPath = path.join(root, 'src', 'backend.ts');
@@ -1264,7 +1271,9 @@ export const createShape = (name_1, ...args_1) => __awaiter(void 0, [name_1, ...
     // 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.
-    const barrelPath = addShapeToBarrel(hyphenName);
+    // The barrel sits next to the shape: in the source folder's parent, not the cwd, which
+    // is only the same folder when the command runs from the package or app root.
+    const barrelPath = addShapeToBarrel(hyphenName, path.dirname(sourceFolder));
     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()) {
@@ -1865,6 +1874,7 @@ export const createPackage = (name_1, uriBase_1, ...args_1) => __awaiter(void 0,
         'Gruntfile.js',
         'src/package.ts',
         'src/ontologies/example-ontology.ts',
+        'src/ontologies/example-ontology.register.ts',
         'src/data/example-ontology.json',
     ]
         .map((f) => path.join(targetFolder, f))
@@ -1874,6 +1884,10 @@ export const createPackage = (name_1, uriBase_1, ...args_1) => __awaiter(void 0,
     //rename these to a file name similar to the pkg name
     [
         'src/ontologies/example-ontology.ts',
+        // The register sibling is what index.ts imports; without it here the scaffold keeps a
+        // literal `example-ontology.register.ts` full of unsubstituted `${...}` placeholders and
+        // nothing ever calls linkedOntology().
+        'src/ontologies/example-ontology.register.ts',
         'src/data/example-ontology.json',
         'src/data/example-ontology.json.d.ts',
     ].forEach((f) => {
@@ -2162,130 +2176,149 @@ const loadServerClass = () => __awaiter(void 0, void 0, void 0, function* () {
             `Install it, or run the frontend only.\nCause: ${err instanceof Error ? err.message : err}`);
     }
 });
-export const planBuildSteps = (pkgJson, packagePath) => [
-    {
-        name: 'Checking imports',
-        apply: () => checkImports(packagePath + '/src'),
-    },
-    {
-        name: 'Compiling ESM',
-        apply: () => __awaiter(void 0, void 0, void 0, function* () {
-            return compilePackageESM(packagePath);
-        }),
-    },
-    {
-        name: 'Compiling CJS',
-        apply: () => __awaiter(void 0, void 0, void 0, function* () {
-            return compilePackageCJS(packagePath);
-        }),
-    },
-    {
-        name: 'Copying files to lib folder',
-        apply: () => __awaiter(void 0, void 0, void 0, function* () {
-            const files = yield glob(packagePath + '/src/**/*.{json,d.ts,css,scss}');
-            let cjsPublished = false;
-            try {
-                cjsPublished = packagePublishesCjs(JSON.parse(fs.readFileSync(path.join(packagePath, 'package.json'), 'utf8')));
-            }
-            catch (_a) { }
-            return Promise.all(files.map((file) => __awaiter(void 0, void 0, void 0, function* () {
+export const planBuildSteps = (pkgJson, packagePath) => {
+    // Loading every shape module in a child process of its own is the slow part of
+    // a build; the shape checks below share one run, started by the first to ask.
+    let inspection;
+    const inspectShapes = () => (inspection !== null && inspection !== void 0 ? inspection : (inspection = inspectShapeReferences(packagePath)));
+    return [
+        {
+            name: 'Checking imports',
+            apply: () => checkImports(packagePath + '/src'),
+        },
+        {
+            name: 'Compiling ESM',
+            apply: () => __awaiter(void 0, void 0, void 0, function* () {
+                return compilePackageESM(packagePath);
+            }),
+        },
+        {
+            name: 'Compiling CJS',
+            apply: () => __awaiter(void 0, void 0, void 0, function* () {
+                return compilePackageCJS(packagePath);
+            }),
+        },
+        {
+            name: 'Copying files to lib folder',
+            apply: () => __awaiter(void 0, void 0, void 0, function* () {
+                const files = yield glob(packagePath + '/src/**/*.{json,d.ts,css,scss}');
+                let cjsPublished = false;
                 try {
-                    yield fs.copy(file, packagePath +
-                        '/lib/esm/' +
-                        file.replace(packagePath + '/src/', ''));
-                    // Only mirror into lib/cjs when there is a CJS build to mirror.
-                    if (cjsPublished) {
+                    cjsPublished = packagePublishesCjs(JSON.parse(fs.readFileSync(path.join(packagePath, 'package.json'), 'utf8')));
+                }
+                catch (_a) { }
+                return Promise.all(files.map((file) => __awaiter(void 0, void 0, void 0, function* () {
+                    try {
                         yield fs.copy(file, packagePath +
-                            '/lib/cjs/' +
+                            '/lib/esm/' +
                             file.replace(packagePath + '/src/', ''));
+                        // Only mirror into lib/cjs when there is a CJS build to mirror.
+                        if (cjsPublished) {
+                            yield fs.copy(file, packagePath +
+                                '/lib/cjs/' +
+                                file.replace(packagePath + '/src/', ''));
+                        }
+                        return true;
+                    }
+                    catch (err) {
+                        console.warn(err);
+                        return false;
                     }
+                }))).then((allResults) => {
+                    return allResults.every((r) => r === true);
+                });
+            }),
+        },
+        {
+            name: 'Dual package support',
+            apply: () => {
+                // Skip if no tsconfig files (e.g. pure-CSS packages).
+                if (!fs.existsSync(path.join(packagePath, 'tsconfig-esm.json')) ||
+                    !fs.existsSync(path.join(packagePath, 'tsconfig-cjs.json'))) {
+                    return Promise.resolve(true);
+                }
+                // Nothing to make dual when only one format is published — otherwise this
+                // leaves a lib/cjs holding a lone `{"type":"commonjs"}` marker and no code.
+                try {
+                    if (!packagePublishesCjs(JSON.parse(fs.readFileSync(path.join(packagePath, 'package.json'), 'utf8')))) {
+                        return Promise.resolve(true);
+                    }
+                }
+                catch (_a) { }
+                // Resolve the binary from the nearest node_modules (supports both
+                // per-package and workspace-root installs of tsconfig-to-dual-package).
+                return execPromise('npx tsconfig-to-dual-package ./tsconfig-cjs.json ./tsconfig-esm.json', false, false, { cwd: packagePath }).then((res) => {
+                    return res === '';
+                });
+            },
+        },
+        {
+            name: 'Removing old files from lib folder',
+            apply: () => __awaiter(void 0, void 0, void 0, function* () {
+                return removeOldFiles(packagePath);
+            }),
+        },
+        {
+            // MUST run after 'Copying files to lib folder' and after 'Removing old
+            // files from lib folder', because the rewrite resolves each specifier
+            // against the files actually present in lib/esm:
+            // - the copy step brings in the assets (`./x.scss`) and hand-written
+            //   `.d.ts` from src; before it, an asset import looks unresolvable (a
+            //   spurious "build with warnings") and a copied `.d.ts` is never rewritten;
+            // - the cleanup step deletes stale output; before it, a leftover `x.js`
+            //   makes './x' resolve to './x.js' and the cleanup then removes the file
+            //   the specifier now points at.
+            name: 'Rewriting ESM import specifiers',
+            apply: () => __awaiter(void 0, void 0, void 0, function* () {
+                // No tsconfig-esm.json means the ESM compile was skipped (e.g. pure-CSS
+                // packages), so there is nothing to rewrite and nothing to fail over.
+                if (!fs.existsSync(path.join(packagePath, 'tsconfig-esm.json'))) {
                     return true;
                 }
-                catch (err) {
-                    console.warn(err);
-                    return false;
+                const libEsm = path.join(packagePath, 'lib', 'esm');
+                if (!fs.existsSync(libEsm)) {
+                    return {
+                        error: 'lib/esm was not emitted while tsconfig-esm.json is present. Check the ESM compile.',
+                    };
                 }
-            }))).then((allResults) => {
-                return allResults.every((r) => r === true);
-            });
-        }),
-    },
-    {
-        name: 'Dual package support',
-        apply: () => {
-            // Skip if no tsconfig files (e.g. pure-CSS packages).
-            if (!fs.existsSync(path.join(packagePath, 'tsconfig-esm.json')) ||
-                !fs.existsSync(path.join(packagePath, 'tsconfig-cjs.json'))) {
-                return Promise.resolve(true);
-            }
-            // Nothing to make dual when only one format is published — otherwise this
-            // leaves a lib/cjs holding a lone `{"type":"commonjs"}` marker and no code.
-            try {
-                if (!packagePublishesCjs(JSON.parse(fs.readFileSync(path.join(packagePath, 'package.json'), 'utf8')))) {
-                    return Promise.resolve(true);
+                const { changed, unresolved } = yield rewriteExtensionlessImports(libEsm);
+                if (unresolved.length > 0) {
+                    return `could not resolve ${unresolved.length} import(s), left unchanged: ${unresolved.join(', ')}`;
                 }
-            }
-            catch (_a) { }
-            // Resolve the binary from the nearest node_modules (supports both
-            // per-package and workspace-root installs of tsconfig-to-dual-package).
-            return execPromise('npx tsconfig-to-dual-package ./tsconfig-cjs.json ./tsconfig-esm.json', false, false, { cwd: packagePath }).then((res) => {
-                return res === '';
-            });
+                return changed > 0 ? { info: `rewrote ${changed} file(s)` } : true;
+            }),
         },
-    },
-    {
-        name: 'Removing old files from lib folder',
-        apply: () => __awaiter(void 0, void 0, void 0, function* () {
-            return removeOldFiles(packagePath);
-        }),
-    },
-    {
-        // MUST run after 'Copying files to lib folder' and after 'Removing old
-        // files from lib folder', because the rewrite resolves each specifier
-        // against the files actually present in lib/esm:
-        // - the copy step brings in the assets (`./x.scss`) and hand-written
-        //   `.d.ts` from src; before it, an asset import looks unresolvable (a
-        //   spurious "build with warnings") and a copied `.d.ts` is never rewritten;
-        // - the cleanup step deletes stale output; before it, a leftover `x.js`
-        //   makes './x' resolve to './x.js' and the cleanup then removes the file
-        //   the specifier now points at.
-        name: 'Rewriting ESM import specifiers',
-        apply: () => __awaiter(void 0, void 0, void 0, function* () {
-            // No tsconfig-esm.json means the ESM compile was skipped (e.g. pure-CSS
-            // packages), so there is nothing to rewrite and nothing to fail over.
-            if (!fs.existsSync(path.join(packagePath, 'tsconfig-esm.json'))) {
-                return true;
-            }
-            const libEsm = path.join(packagePath, 'lib', 'esm');
-            if (!fs.existsSync(libEsm)) {
-                return {
-                    error: 'lib/esm was not emitted while tsconfig-esm.json is present. Check the ESM compile.',
-                };
-            }
-            const { changed, unresolved } = yield rewriteExtensionlessImports(libEsm);
-            if (unresolved.length > 0) {
-                return `could not resolve ${unresolved.length} import(s), left unchanged: ${unresolved.join(', ')}`;
-            }
-            return changed > 0 ? { info: `rewrote ${changed} file(s)` } : true;
-        }),
-    },
-    {
-        // Reads the emitted lib/esm, so it runs after everything that writes it.
-        name: 'Checking shape names',
-        apply: () => checkShapeNames(packagePath),
-    },
-    {
-        // Loads each compiled shape module on its own, so it needs the final
-        // lib/esm too. Fails the build: an unresolved reference is a query that
-        // throws "Shape class not found" in a consumer's bundle.
-        name: 'Checking shape references',
-        apply: () => checkShapeReferences(packagePath),
-    },
-    {
-        name: 'Checking dependencies',
-        apply: () => depCheck(packagePath),
-    },
-];
+        {
+            // Reads the emitted lib/esm, so it runs after everything that writes it.
+            name: 'Checking shape names',
+            apply: () => checkShapeNames(packagePath),
+        },
+        {
+            // Loads each compiled shape module on its own, so it needs the final
+            // lib/esm too. Fails the build: an unresolved reference is a query that
+            // throws "Shape class not found" in a consumer's bundle.
+            name: 'Checking shape references',
+            apply: () => checkShapeReferences(packagePath, undefined, inspectShapes()),
+        },
+        {
+            // Same per-module loads: loading lib/esm/shapes/index.js alone must register
+            // every shape of this package that its shape modules register one by one,
+            // because apps load a package's shapes with `import '<pkg>/shapes/index'`.
+            name: 'Checking shapes/index',
+            apply: () => checkShapesIndex(packagePath, undefined, inspectShapes()),
+        },
+        {
+            // A bundler drops the side-effect-only imports in shapes/index of a module
+            // package.json calls side-effect-free.
+            name: 'Checking sideEffects',
+            apply: () => __awaiter(void 0, void 0, void 0, function* () { return checkShapesSideEffects(packagePath); }),
+        },
+        {
+            name: 'Checking dependencies',
+            apply: () => depCheck(packagePath),
+        },
+    ];
+};
 export const compilePackage = (...args_1) => __awaiter(void 0, [...args_1], void 0, function* (packagePath = process.cwd()) {
     //echo 'compiling CJS' && tsc -p tsconfig-cjs.json && echo 'compiling ESM' && tsc -p tsconfig-esm.json
     // let cjsConfig = fs.existsSync(path.join(packagePath,'tsconfig-cjs.json'));