@astryxdesign/cli 0.7.11 → 0.7.12-canary.ccb4a6d

package/api/build/kit/rank.mjs

@@ -41,7 +41,9 @@
  *   `settings`) is that family's default. A variant displaces it only with two
  *   matched terms of its own ("a small comparison note" does not make a
  *   dashboard the comparison dashboard), and a base too weak to start on its
- *   own displaces no variant ("a funnel for a dashboard" is the funnel).
+ *   own displaces no variant ("a funnel for a dashboard" is the funnel) —
+ *   unless the idea names its family in the head, which is start evidence on
+ *   its own ("saml login" stays the login page).
  */
 
 import {
@@ -219,7 +221,8 @@ export function rankPages(query, pages) {
         }
       }
       const familyNamed = namedFamilies.has(family);
-      if (headFamilies.has(family)) score += HEAD_FAMILY;
+      const headNamed = headFamilies.has(family);
+      if (headNamed) score += HEAD_FAMILY;
       else if (familyNamed) score += BODY_FAMILY;
       const base = normalized(page.name) === normalized(family);
       if (familyNamed && base) score += FAMILY_BASE;
@@ -228,6 +231,7 @@ export function rankPages(query, pages) {
         score,
         hits,
         familyNamed,
+        headNamed,
         containerMatched,
         family,
         base,
@@ -246,7 +250,14 @@ export function rankPages(query, pages) {
 /**
  * Put a named family's base template ahead of the variant that outranks it,
  * unless the variant matched START_TERMS terms the base did not, or the base
- * scores too little to start on its own.
+ * cannot start on its own: too little score, or too few matched terms. The
+ * head names the exception: a family word in the idea's head is start
+ * evidence on its own — the same evidence pickStart accepts in place of a
+ * second term — so a head-named one-term base can still take the lead ("saml
+ * login" is the login page, not the SSO flow). A base whose family the idea
+ * names only elsewhere still needs a second term: score alone drifts upward
+ * as the catalog grows (idf rises with page count) and would eventually let a
+ * one-term base displace its variant, while hits do not drift.
  * @param {RankedPage[]} ranked
  * @returns {RankedPage[]}
  */
@@ -254,7 +265,13 @@ function baseFirst(ranked) {
   const top = ranked[0];
   if (!top || top.base || !top.familyNamed) return ranked;
   const base = ranked.find(r => r.base && r.family === top.family);
-  if (!base || base.score < START_SCORE) return ranked;
+  if (
+    !base ||
+    base.score < START_SCORE ||
+    (base.hits < START_TERMS && !base.headNamed)
+  ) {
+    return ranked;
+  }
   const own = [...top.matched].filter(t => !base.matched.has(t)).length;
   return own >= START_TERMS
     ? ranked

package/api/build/kit/words.d.mts

@@ -64,6 +64,7 @@ export type RankedPage = {
     score: number;
     hits: number;
     familyNamed: boolean;
+    headNamed: boolean;
     containerMatched: boolean;
     family: string;
     base: boolean;

package/api/build/kit/words.mjs

@@ -163,7 +163,7 @@ export const SYNONYMS_OF = (() => {
 /**
  * @typedef {import('../_adapter.mjs').PageTemplate} PageTemplate
  * @typedef {import('../_adapter.mjs').ComponentWords} ComponentWords
- * @typedef {{name: string, score: number, hits: number, familyNamed: boolean, containerMatched: boolean, family: string, base: boolean, matched: Set<string>}} RankedPage
+ * @typedef {{name: string, score: number, hits: number, familyNamed: boolean, headNamed: boolean, containerMatched: boolean, family: string, base: boolean, matched: Set<string>}} RankedPage
  * @typedef {'page' | 'part' | 'edit'} IdeaKind
  */
 

package/api/icon/_adapter.d.mts

@@ -50,6 +50,7 @@ export { astryxIconDefinitions } from "../../foundation/discovery/icon-definitio
 export { iconSetKey } from "../../foundation/discovery/icon-set-discovery.mjs";
 export { setConfigString } from "../../foundation/config/config-writer.mjs";
 export { exportValueKind } from "../../foundation/discovery/module-exports.mjs";
-export { iconRecord, importLine, leadingReading, matchIcon, rankIcons, scoreIcon } from "../../foundation/discovery/icon-ranking.mjs";
-export { assertIconExport, checkNewDefinition, definitionFile, findLocalIconSet, writeDefinitionFile, iconIdOf, closestNames, libraryIcons, mappableDefinitions, resolveIconSource, generatedModulePath, generatedNamesOf, generatedOrigins, iconModulePackage, sameIconModule, iconExportName, iconNaming, modulePrefix, setModuleNote, variantExportName, writeGeneratedIcons, writeIconSetData, definitionNameOf, iconIdIn, iconsWithWord, localSourceNote, THEME_MAP_NAME } from "../../foundation/discovery/icon-set-writer.mjs";
+export { iconRecord, importLine, leadingReading, matchIcon, answeringMatches, rankIcons, scoreIcon } from "../../foundation/discovery/icon-ranking.mjs";
+export { assertIconExport, checkNewDefinition, definitionNameFromInput, definitionFile, findLocalIconSet, writeDefinitionFile, iconIdOf, closestNames, libraryIcons, mappableDefinitions, resolveIconSource, generatedModulePath, generatedNamesOf, generatedOrigins, iconModulePackage, sameIconModule, iconExportName, iconNaming, modulePrefix, moduleNaming, iconNamingWithoutLook, splitLook, setModuleNote, variantExportName, writeGeneratedIcons, writeIconSetData, definitionNameOf, iconIdIn, iconsWithWord, localSourceNote, THEME_MAP_NAME } from "../../foundation/discovery/icon-set-writer.mjs";
 export { addIconDefinition, addIconSet } from "./_authoring.mjs";
+export { checkVariantLook, drawnLooks } from "./_default-look.mjs";

package/api/icon/_adapter.mjs

@@ -6,8 +6,8 @@
  *
  * @position api/icon — adapter for api/icon/{search,detail,list,use,map,add,
  *   new-set,new-definition}; it also carries the icon ranking, the icon-set
- *   writer, the set and definition authoring writes, and the config writer
- *   the leaves use
+ *   writer, the set and definition authoring writes, the default-look
+ *   rule, and the config writer the leaves use
  */
 
 import * as fs from 'node:fs';
@@ -28,6 +28,7 @@ export {
   importLine,
   leadingReading,
   matchIcon,
+  answeringMatches,
   rankIcons,
   scoreIcon,
 } from '../../foundation/discovery/icon-ranking.mjs';
@@ -37,6 +38,7 @@ export {setConfigString} from '../../foundation/config/config-writer.mjs';
 export {
   assertIconExport,
   checkNewDefinition,
+  definitionNameFromInput,
   definitionFile,
   findLocalIconSet,
   writeDefinitionFile,
@@ -53,6 +55,9 @@ export {
   iconExportName,
   iconNaming,
   modulePrefix,
+  moduleNaming,
+  iconNamingWithoutLook,
+  splitLook,
   setModuleNote,
   variantExportName,
   writeGeneratedIcons,
@@ -65,6 +70,7 @@ export {
 } from '../../foundation/discovery/icon-set-writer.mjs';
 export {exportValueKind} from '../../foundation/discovery/module-exports.mjs';
 export {addIconDefinition, addIconSet} from './_authoring.mjs';
+export {checkVariantLook, drawnLooks} from './_default-look.mjs';
 
 /**
  * Refuse a command that writes to a project or package when `cwd` is outside

package/api/icon/_authoring.d.mts

@@ -44,3 +44,4 @@ export function addIconDefinition(name: string, options: {
     type: "integration.add";
     data: import("./icon.type.mjs").IconNewData;
 }>;
+export type Looks = import("./_default-look.mjs").Looks;