@mfeflow/core 0.1.0 → 0.3.0

package/dist/features/tailwind-prefix.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The Tailwind class prefix of an app. Tailwind 4 accepts lowercase letters only, so a name made of
+ * letters is its own prefix (`cart:flex`); any other name keeps its letters and gets four more from a hash
+ * of the whole name, so `cart_b` and `cartb` (and `cart1` and `cart2`) never share one.
+ */
+export declare function tailwindPrefix(name: string): string;
+/** Throws if two apps map to the same prefix, which would bring back the collision the prefix prevents. */
+export declare function assertUniqueTailwindPrefixes(names: readonly string[], prefixOf?: (name: string) => string): void;

package/dist/index.js

@@ -1921,6 +1921,7 @@ function assertThirdPartyContent(manifest, label) {
     if (manifest.name.startsWith('@mfeflow/') || !manifest.name.startsWith('@')) throw new MfeflowError('E203', `${label}: third-party features must be namespaced and cannot use @mfeflow`);
     for (const file of manifest.files ?? []){
         if (void 0 !== file.from) throw new MfeflowError('E203', `${label}: "${file.to}" reads a local file (from); use inline content`);
+        if (file.atRoot) throw new MfeflowError('E203', `${label}: "${file.to}" uses atRoot, which is first-party only`);
         assertThirdPartyPath(file.to, file.to);
     }
     for (const t of manifest.transforms ?? []){
@@ -1929,7 +1930,10 @@ function assertThirdPartyContent(manifest, label) {
         ];
         for (const file of files)assertThirdPartyPath(file, file);
     }
-    for (const dep of manifest.dependencies ?? [])if (!isRegistryRange(dep.range)) throw new MfeflowError('E203', `${label}: ${dep.name}@${dep.range} is not a registry version range`);
+    for (const dep of manifest.dependencies ?? []){
+        if (dep.name.includes('{{')) throw new MfeflowError('E203', `${label}: ${dep.name} names a package in the project's scope`);
+        if (!isRegistryRange(dep.range)) throw new MfeflowError('E203', `${label}: ${dep.name}@${dep.range} is not a registry version range`);
+    }
     for (const t of manifest.transforms ?? [])assertThirdPartyTransform(t, label);
     for (const script of manifest.scripts ?? [])assertPlainScript(script.name, label);
 }
@@ -2018,6 +2022,31 @@ async function listLocalFeatures(featuresDir, ops = realFs) {
     const checked = await Promise.all(dirs.map(async (dir)=>await readIfExists(ops, node_path.join(featuresDir, dir, 'feature.json')) === void 0 ? void 0 : dir));
     return checked.filter((d)=>void 0 !== d).toSorted((a, b)=>a.localeCompare(b));
 }
+const LETTERS = 'abcdefghijklmnopqrstuvwxyz';
+function shortHash(text) {
+    let hash = 0x811c9dc5;
+    for (const char of text)hash = Math.imul(hash ^ char.codePointAt(0), 0x01000193) >>> 0;
+    let out = '';
+    for(let i = 0; i < 4; i++){
+        out += LETTERS[hash % 26];
+        hash = Math.floor(hash / 26);
+    }
+    return out;
+}
+function tailwindPrefix(name) {
+    if (/^[a-z]+$/.test(name)) return name;
+    const letters = name.replace(/[^a-z]/g, '') || 'app';
+    return letters + shortHash(name);
+}
+function assertUniqueTailwindPrefixes(names, prefixOf = tailwindPrefix) {
+    const seen = new Map();
+    for (const name of names){
+        const prefix = prefixOf(name);
+        const other = seen.get(prefix);
+        if (void 0 !== other) throw new MfeflowError('E208', `the apps "${other}" and "${name}" would both use the Tailwind prefix "${prefix}"; rename one of them`);
+        seen.set(prefix, name);
+    }
+}
 const TURBO_FILE = 'turbo.json';
 const EXACT_APP = 'app:';
 function placesFor(target, project) {
@@ -2068,6 +2097,9 @@ function resolveOptions(manifest, given = {}) {
 function applies(part, options, present) {
     return Object.entries(part.when ?? {}).every(([name, value])=>name.startsWith(FEATURE_CONDITION) ? present.has(name.slice(FEATURE_CONDITION.length)) === value : options[name] === value);
 }
+function fill(text, data, label) {
+    return text.includes('{{') ? substitute(text, data, label) : text;
+}
 function resolve_assertWritable(file, relative, trusted) {
     if (!isSafeRelativePath(file)) throw new MfeflowError('E105', `"${file}"`);
     if (trusted) assertWritable(file);
@@ -2095,6 +2127,7 @@ async function resolveFeature(input) {
     for (const other of manifest.conflicts ?? [])if (present.has(other)) throw new MfeflowError('E205', `${manifest.name} and ${other}`);
     for (const needed of manifest.requires ?? [])if (!present.has(needed)) throw new MfeflowError('E206', `${manifest.name} needs ${needed}`);
     const options = resolveOptions(manifest, input.options);
+    if ('tailwind' === manifest.name) assertUniqueTailwindPrefixes(Object.keys(project.apps));
     const dataFor = (place)=>({
             scope: project.scope,
             topology: project.topology,
@@ -2108,18 +2141,26 @@ async function resolveFeature(input) {
                 name: place.name,
                 kind: place.kind,
                 path: place.dir,
-                port: place.port
+                port: place.port,
+                tailwindPrefix: tailwindPrefix(place.name)
             }
         });
     const steps = [];
-    for (const file of (manifest.files ?? []).filter((f)=>applies(f, options, present)))for (const place of placesFor(file.target, project)){
-        const to = joinPosix(place.dir, file.to);
-        resolve_assertWritable(to, file.to, trusted);
-        steps.push(async ()=>builder.create(to, await contentOf(file, feature, dataFor(place))));
+    for (const file of (manifest.files ?? []).filter((f)=>applies(f, options, present))){
+        if (file.atRoot && !trusted) throw new MfeflowError('E203', `${manifest.name}: "${file.to}" uses atRoot, which only features that ship with mfeflow may`);
+        for (const place of placesFor(file.target, project)){
+            const data = dataFor(place);
+            const relative = fill(file.to, data, `${manifest.name}:${file.to}`);
+            const to = file.atRoot ? relative : joinPosix(place.dir, relative);
+            resolve_assertWritable(to, relative, trusted);
+            steps.push(async ()=>builder.create(to, await contentOf(file, feature, data)));
+        }
     }
     for (const dep of (manifest.dependencies ?? []).filter((d)=>applies(d, options, present)))for (const place of placesFor(dep.target, project)){
         const pkg = joinPosix(place.dir, 'package.json');
-        steps.push(()=>builder.addDependency(pkg, dep.name, dep.range, dep.dev));
+        if (!trusted && dep.name.includes('{{')) throw new MfeflowError('E203', `${manifest.name}: ${dep.name} is for first-party features`);
+        const name = fill(dep.name, dataFor(place), `${manifest.name}:${dep.name}`);
+        steps.push(()=>builder.addDependency(pkg, name, dep.range, dep.dev));
     }
     for (const script of (manifest.scripts ?? []).filter((x)=>applies(x, options, present)))for (const place of placesFor(script.target, project)){
         const pkg = joinPosix(place.dir, 'package.json');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mfeflow/core",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "The engine behind the mfeflow CLI: project model, change plans with diffs, atomic apply with rollback, and feature resolution.",
   "keywords": [
     "micro-frontend",
@@ -45,7 +45,7 @@
   "dependencies": {
     "@babel/parser": "8.0.10",
     "@babel/types": "8.0.10",
-    "@mfeflow/contracts": "0.1.0",
+    "@mfeflow/contracts": "0.3.0",
     "diff": "9.0.0",
     "eta": "4.6.0",
     "semver": "7.8.5",