create-kerf-component 5.0.0-beta.53 → 5.0.0-beta.55

package/README.md

@@ -59,6 +59,17 @@ A ready-to-publish component package that encodes the rules from the kerf docs
   `["@kerfjs/ui:toolbar-control-group"]`), so the `ui-composition` lint treats
   it as that root. Every key must resolve to an entry generated in the same run
   or to an installed package's catalog.
+  Each `publicExports` item names a `package.json#exports` subpath that maps to
+  the `src/` file exporting it. A private, bundled application
+  (`package.json#private: true`) has no per-file `dist/` entries and is never
+  imported by package name, so its items may omit `subpath`
+  (`{ "name": "DemandSegmentsControl" }`); the checker then verifies the name
+  against the component's `source` file, which is how the UI lint resolves the
+  wrapper. A subpath it does declare is still checked against `exports`.
+  `private: true` is the only opt-in: a `.kerf-ui-profile.json` `scope` does
+  not change this. An application that is published to npm (an app shell), or
+  whose manifest omits `private`, either declares a real `subpath` for each
+  item or sets `"private": true`.
 
 ## Layout produced
 

package/catalog.js

@@ -532,6 +532,11 @@ function validateComponent(
     diagnostics.push(`${at}.source: file does not exist: ${component.source}`);
 
   const exports = packageJson.exports ?? {};
+  // A private application (package.json#private) is bundled, never imported
+  // by package name, and has no per-file dist entries. Its exports may omit
+  // `subpath`; each name is then verified against the component's own
+  // `source` file, which is how the Kerf UI rules resolve its wrappers.
+  const privateApplication = packageJson.private === true;
   if (
     !Array.isArray(component.publicExports) ||
     !component.publicExports.length
@@ -541,13 +546,34 @@ function validateComponent(
     const seen = new Set();
     for (const item of component.publicExports) {
       const exportAt = `${at}.publicExports`;
-      if (!item?.name || typeof item?.subpath !== 'string') {
-        diagnostics.push(`${exportAt}: every export requires name and subpath`);
+      const sourceOnly =
+        privateApplication &&
+        Boolean(item?.name) &&
+        !Object.hasOwn(item, 'subpath');
+      if (!item?.name || (!sourceOnly && typeof item?.subpath !== 'string')) {
+        diagnostics.push(
+          `${exportAt}: every export requires name and subpath (only a private application, package.json#private, may omit subpath)`,
+        );
         continue;
       }
-      const key = `${item.subpath}:${item.name}`;
-      if (seen.has(key)) diagnostics.push(`${exportAt}: duplicate ${key}`);
+      const key = sourceOnly
+        ? `source:${item.name}`
+        : `${item.subpath}:${item.name}`;
+      if (seen.has(key))
+        diagnostics.push(
+          `${exportAt}: duplicate ${sourceOnly ? item.name : key}`,
+        );
       seen.add(key);
+      if (sourceOnly) {
+        if (
+          existsSync(sourcePath) &&
+          !exportedNamesFromFile(sourcePath).has(item.name)
+        )
+          diagnostics.push(
+            `${exportAt}: ${item.name} is not exported by ${component.source}`,
+          );
+        continue;
+      }
       if (!(item.subpath in exports))
         diagnostics.push(
           `${exportAt}: package.json does not export subpath ${item.subpath}`,

package/component-catalog-v2.schema.json

@@ -137,10 +137,11 @@
         "kind": { "enum": ["component", "composition", "recipe"] },
         "purpose": { "type": "string", "minLength": 1 },
         "publicExports": {
+          "description": "Each export's name and the package.json#exports subpath that serves it. An entry from a private application omits subpath: the application is bundled, never imported by package name, so the name resolves through the entry's source file.",
           "type": "array",
           "items": {
             "type": "object",
-            "required": ["name", "subpath"],
+            "required": ["name"],
             "properties": {
               "name": { "type": "string", "minLength": 1 },
               "subpath": { "type": "string", "pattern": "^\\." }

package/component-metadata.schema.json

@@ -97,9 +97,10 @@
         "publicExports": {
           "type": "array",
           "minItems": 1,
+          "description": "Each export's name and package.json#exports subpath. A private application (package.json#private) may omit subpath; the name is then verified against the component's source file.",
           "items": {
             "type": "object",
-            "required": ["name", "subpath"],
+            "required": ["name"],
             "properties": {
               "name": { "type": "string", "minLength": 1 },
               "subpath": { "type": "string", "pattern": "^\\." }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-kerf-component",
-  "version": "5.0.0-beta.53",
+  "version": "5.0.0-beta.55",
   "description": "Scaffold a publishable kerf component package that already follows kerf's hard packaging rules.",
   "type": "module",
   "license": "MIT",

package/template/package.json

@@ -36,7 +36,7 @@
     "kerfjs": "^5.0.0-0"
   },
   "devDependencies": {
-    "kerfjs": "^5.0.0-beta.53",
+    "kerfjs": "^5.0.0-beta.55",
     "tsup": "^8",
     "typescript": "^5 || ^6"
   }