youiyoux 0.1.2 → 0.1.4

package/dist/chunks/{chunk-ZLRFD5JI.js → chunk-NYDJYMID.js}

@@ -1,10 +1,10 @@
-import { createRequire as __youiRequire } from "node:module"; const require = __youiRequire(import.meta.url);
+import { createRequire as __youiRequire } from "node:module"; import { dirname as __youiDir } from "node:path"; import { fileURLToPath as __youiPath } from "node:url"; const require = __youiRequire(import.meta.url); const __youiDirname = __youiDir(__youiPath(import.meta.url));
 import {
   __commonJS,
   __export,
   __require,
   __toESM
-} from "./chunk-E4HNK7VF.js";
+} from "./chunk-WNTS7ZO4.js";
 
 // ../../node_modules/.pnpm/yaml@2.9.1/node_modules/yaml/dist/nodes/identity.js
 var require_identity = __commonJS({
@@ -7336,6 +7336,9 @@ var require_dist = __commonJS({
   }
 });
 
+// ../core/src/detect.ts
+import { posix } from "node:path";
+
 // ../../node_modules/.pnpm/zod@4.6.5/node_modules/zod/v4/classic/external.js
 var external_exports = {};
 __export(external_exports, {
@@ -27005,7 +27008,6 @@ function date4(params) {
 }
 
 // ../core/src/detect.ts
-import { posix } from "node:path";
 var IsoTime = external_exports.string().datetime({ offset: true });
 var ShotPath = external_exports.string().min(1).refine((p) => !p.startsWith("/") && !posix.normalize(p.replace(/\\/g, "/")).split("/").includes(".."), "expected a path relative to the report, without ..");
 var DETECT_CONFIDENCE = ["high", "medium", "low"];
@@ -27094,6 +27096,34 @@ var DetectReport = external_exports.object({
   notes: external_exports.array(external_exports.string()).default([])
 });
 
+// ../core/src/detect-draft.ts
+function sourceSlug(name) {
+  const slug = name.toLowerCase().replace(/^www\./, "").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+  if (!slug) return "site";
+  return /^[a-z]/.test(slug) ? slug : `site-${slug}`;
+}
+function nameSlug(text) {
+  return text.toLowerCase().replace(/[^a-z0-9.]+/g, "-").replace(/^-+|-+$/g, "") || "item";
+}
+var capital = (word) => word.charAt(0).toUpperCase() + word.slice(1);
+function draftLibraryItem(report, element, ingestedAt = (/* @__PURE__ */ new Date()).toISOString()) {
+  const site = report.target.name;
+  const library = report.libraries.find((l) => l.id === element.library) ?? { id: element.library, name: element.library };
+  const url2 = element.page ?? report.pages.find((p) => p.status === "ok")?.url ?? (report.target.kind === "site" ? report.target.inputs[0] : void 0);
+  const summary = `Seen on ${site}, likely ${library.name}`;
+  return {
+    schema: "youi.library/v1",
+    id: `lib:${sourceSlug(site)}/component/${nameSlug(`${library.id}-${element.type}`)}`,
+    name: `${library.name} ${capital(element.type)}`,
+    kind: "component",
+    stage: "library",
+    summary: summary.length > 200 ? `${summary.slice(0, 199)}\u2026` : summary,
+    source: { name: site, ...url2 && /^https?:\/\//.test(url2) ? { url: url2 } : {}, ingestedAt },
+    categories: [element.type, `detected:${element.confidence}`],
+    swapsWith: []
+  };
+}
+
 // ../core/src/diff.ts
 function lcsOps(a, b, aStart, bStart) {
   const n = a.length;
@@ -27278,6 +27308,64 @@ async function readTextOrNull(file2) {
   }
 }
 
+// ../core/src/gaps.ts
+var IsoTime2 = external_exports.string().datetime({ offset: true });
+var GAP_STATUSES = ["system", "library", "hand-built", "missing"];
+var GapCandidate = external_exports.object({
+  /** The Discover id (`lib:shadcn/component/calendar`). */
+  id: external_exports.string(),
+  name: external_exports.string(),
+  /** Its registry or `npm`. */
+  source: external_exports.string(),
+  /** An SPDX id; unknown licences are never offered. */
+  licence: external_exports.string(),
+  /** GPL or AGPL: shipping it releases your code under the same licence. */
+  copyleft: external_exports.boolean(),
+  install: external_exports.string().nullable()
+});
+var GapConcept = external_exports.object({
+  /** Discover's concept id (`date-picker`). */
+  concept: external_exports.string(),
+  /** How people call it (`date picker`). */
+  name: external_exports.string(),
+  status: external_exports.enum(GAP_STATUSES),
+  /** The System's components for it. */
+  system: external_exports.array(external_exports.string()),
+  /** The packages that provide it: imported, or declared for it in package.json. */
+  packages: external_exports.array(external_exports.string()),
+  /** The project's own components named for it, first few. */
+  definitions: external_exports.array(external_exports.object({ name: external_exports.string(), file: external_exports.string(), line: external_exports.number().int().positive() })),
+  /** Components named for it, and the looks they and styled native elements of its kind render. */
+  count: external_exports.number().int().nonnegative(),
+  uses: external_exports.number().int().nonnegative(),
+  files: external_exports.number().int().nonnegative(),
+  /** For what is hand-built or missing; null when the Discover index is not synced (never "none"). */
+  candidates: external_exports.array(GapCandidate).nullable()
+});
+var GapsProject = external_exports.object({
+  id: external_exports.string(),
+  /** False when the inventory could not read every file: hand-built counts are then a lower bound. */
+  complete: external_exports.boolean(),
+  /** Whether its package.json was read (its declared packages count as libraries). */
+  dependencies: external_exports.enum(["read", "unread"]),
+  /** Hand-built first (most uses first), then missing, from a library, in the System. */
+  concepts: external_exports.array(GapConcept)
+});
+var GapsReport = external_exports.object({
+  $schema: external_exports.string().optional(),
+  schema: external_exports.literal("youi.gaps/v1"),
+  generatedAt: IsoTime2,
+  /** The System the projects follow, when they follow one. */
+  system: external_exports.string().nullable(),
+  /** synced: candidates come from the local Discover index; not-synced: there are none to offer yet. */
+  discover: external_exports.enum(["synced", "not-synced"]),
+  /** The kinds a project is expected to have (the standard kit): only these are ever "missing". */
+  kit: external_exports.array(external_exports.string()),
+  projects: external_exports.array(GapsProject),
+  /** Kinds hand-built in more than one project, most uses first. */
+  across: external_exports.array(external_exports.object({ concept: external_exports.string(), name: external_exports.string(), projects: external_exports.array(external_exports.string()), uses: external_exports.number().int().nonnegative() }))
+});
+
 // ../core/src/hash.ts
 import { createHash } from "node:crypto";
 function sha256(content) {
@@ -27295,7 +27383,11 @@ function stableStringify(value) {
   });
 }
 
+// ../core/src/hierarchy.ts
+import { join as join2 } from "node:path";
+
 // ../core/src/ids.ts
+var ELEMENT_KINDS = ["token", "component", "rule", "migration"];
 var ID_PATTERN = /^youi:([a-z][a-z0-9-]*)\/(token|component|rule|migration)\/([a-z0-9][a-z0-9.\-]*)$/;
 var ElementId = external_exports.string().regex(ID_PATTERN, "expected youi:<system>/<kind>/<name>");
 function parseId(id) {
@@ -27303,6 +27395,10 @@ function parseId(id) {
   if (!match) return null;
   return { system: match[1], kind: match[2], name: match[3] };
 }
+var ruleSlug = (id) => id.slice(id.indexOf("/rule/") + 6);
+function formatId(system, kind, name) {
+  return `youi:${system}/${kind}/${name}`;
+}
 function matchesQuery(id, query) {
   const parsed = parseId(id);
   if (!parsed) return false;
@@ -27314,7 +27410,6 @@ function safeId(id) {
 }
 
 // ../core/src/hierarchy.ts
-import { join as join2 } from "node:path";
 var ELEMENT_STAGES = ["library", "candidate", "adopted", "in-use"];
 var ElementStage = external_exports.enum(ELEMENT_STAGES);
 var LIBRARY_STAGES = ["library", "candidate"];
@@ -27331,7 +27426,7 @@ var STAGE_MOVES = [
 function canMove(from, to, actor) {
   return STAGE_MOVES.some((move) => move.from === from && move.to === to && move.by.includes(actor));
 }
-var MCP_TOOLS = ["system_search", "system_get_component", "system_get_tokens", "system_get_rules", "system_where_used", "system_screen_bom", "system_check", "system_plan", "library_search", "library_request", "discover_search", "discover_show", "index_where_used", "index_swap_impact", "index_rule_covers", "ui_find_component", "ui_render"];
+var MCP_TOOLS = ["system_search", "system_get_component", "system_get_tokens", "system_get_rules", "system_where_used", "system_screen_bom", "system_check", "system_plan", "library_search", "library_request", "discover_search", "discover_show", "index_where_used", "index_swap_impact", "index_rule_covers", "ui_find_component", "ui_render", "requests_list", "request_reply", "request_addressed", "screens_capture"];
 var LIBRARY_KINDS = ["component", "token", "pattern"];
 var LIBRARY_ID_PATTERN = /^lib:([a-z][a-z0-9-]*)\/(component|token|pattern)\/([a-z0-9][a-z0-9.\-]*)$/;
 var LibraryId = external_exports.string().regex(LIBRARY_ID_PATTERN, "expected lib:<source>/<kind>/<name>");
@@ -27406,6 +27501,64 @@ async function loadLibrary(root) {
   return { entries };
 }
 
+// ../core/src/licence.ts
+function copyleft(spdx) {
+  const strong = (part) => part.split(/\s+(?:AND|WITH)\s+/).some((id) => /^A?GPL-/.test(id.replace(/[()]/g, "").trim()));
+  return spdx.split(/\s+OR\s+/).every(strong);
+}
+
+// ../core/src/requests.ts
+var IsoTime3 = external_exports.string().datetime({ offset: true });
+var REQUEST_ID = /^r-[0-9a-f]{10}$/;
+var REQUEST_STATUSES = ["open", "addressed", "closed"];
+var RequestAuthor = external_exports.object({ kind: external_exports.enum(["person", "agent"]), name: external_exports.string().min(1).max(100) });
+var Box = external_exports.object({ x: external_exports.number(), y: external_exports.number(), width: external_exports.number().nonnegative(), height: external_exports.number().nonnegative() });
+var Size = external_exports.object({ width: external_exports.number().positive(), height: external_exports.number().positive() });
+var RequestTarget = external_exports.object({
+  /** The route as the usage map names it (`/settings`, `*` for the app shell). */
+  route: external_exports.string().min(1).max(300),
+  /** here: this one, on this screen; element: every place the element is used. */
+  scope: external_exports.enum(["here", "element"]),
+  /** The component's name as it rendered (`Button`). */
+  name: external_exports.string().min(1).max(200),
+  /** The System element it is, or the one a lookalike stands in for. */
+  element: ElementId.optional(),
+  lookalike: external_exports.boolean().optional(),
+  /** Project-relative, and the line that rendered it, when the capture found them. */
+  file: external_exports.string().min(1).max(500).optional(),
+  line: external_exports.number().int().positive().optional(),
+  box: Box.optional(),
+  page: Size.optional()
+});
+var RequestEntry = external_exports.object({
+  author: RequestAuthor,
+  at: IsoTime3,
+  body: external_exports.string().max(4e3),
+  /** A status change this entry made, if any. */
+  status: external_exports.enum(REQUEST_STATUSES).optional()
+});
+var RequestDoc = external_exports.object({
+  $schema: external_exports.string().optional(),
+  schema: external_exports.literal("youi.request/v1"),
+  id: external_exports.string().regex(REQUEST_ID, "expected r-<10 hex>"),
+  /** The project id from youi.project.json. */
+  project: external_exports.string().min(1).max(200),
+  /** comment: a note; change: something to do. */
+  kind: external_exports.enum(["comment", "change"]),
+  status: external_exports.enum(REQUEST_STATUSES),
+  body: external_exports.string().min(1).max(4e3),
+  author: RequestAuthor,
+  createdAt: IsoTime3,
+  updatedAt: IsoTime3,
+  target: RequestTarget,
+  /** The screen as it was when this was filed (`<id>.before.webp` beside it), to compare with after a change. */
+  before: external_exports.string().regex(/^r-[0-9a-f]{10}\.before\.webp$/).optional(),
+  thread: external_exports.array(RequestEntry).max(500)
+});
+
+// ../core/src/schemas.ts
+import { posix as posix2 } from "node:path";
+
 // ../core/src/tokens.ts
 var TOKEN_ALIAS = /^\{([^{}]+)\}$/;
 var ALIAS_MESSAGE = "expected an alias like {color.brand}";
@@ -27564,10 +27717,8 @@ function describeIssues(error62) {
 function tokenValueProblems(type, value) {
   if (type === void 0) return ["no $type (on the token or an enclosing group)"];
   if (!isTokenType(type)) return [`unknown $type "${type}"; expected one of ${TOKEN_TYPES.join(", ")}`];
-  const result = tokenValueSchema(type).safeParse(value);
-  if (result.success) return [];
-  const valueResult = TOKEN_VALUE_SCHEMAS[type].safeParse(value);
-  return valueResult.success ? [] : describeIssues(valueResult.error);
+  if (tokenValueSchema(type).safeParse(value).success) return [];
+  return describeIssues(TOKEN_VALUE_SCHEMAS[type].safeParse(value).error);
 }
 function validateTokenSets(sources) {
   const problems = [];
@@ -27611,13 +27762,12 @@ function findCycles(edges) {
 }
 
 // ../core/src/schemas.ts
-import { posix as posix2 } from "node:path";
 var SemVer = external_exports.string().regex(/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/, "expected semver x.y.z");
 function normalizeRelPath(path) {
   return posix2.normalize(path.replace(/\\/g, "/")).replace(/^\.\//, "").replace(/\/+$/, "") || ".";
 }
 var RelPath = external_exports.string().min(1).refine((p) => !p.startsWith("/") && !normalizeRelPath(p).split("/").includes(".."), "expected a path relative to its root, without ..");
-var IsoTime2 = external_exports.string().datetime({ offset: true });
+var IsoTime4 = external_exports.string().datetime({ offset: true });
 var SystemConfig = external_exports.object({
   id: external_exports.string().regex(/^[a-z][a-z0-9-]*$/, { error: ({ input: input2 }) => safeId(input2) === null ? `Invalid system id ${JSON.stringify(input2)}: use a plain name without ".." or path separators` : `Invalid system id ${JSON.stringify(input2)}: use lowercase letters, digits and hyphens, starting with a letter` }),
   name: external_exports.string().min(1),
@@ -27875,7 +28025,7 @@ var ScanReport = external_exports.object({
     /** Files checked from supplied text (unsaved edits, candidate code) rather than disk. */
     overrides: external_exports.array(external_exports.string())
   }).optional(),
-  generatedAt: IsoTime2,
+  generatedAt: IsoTime4,
   durationMs: external_exports.number(),
   status: external_exports.enum(["complete", "partial"]),
   coverage: external_exports.object({
@@ -27918,7 +28068,7 @@ var Baseline = external_exports.object({
   $schema: external_exports.string().optional(),
   schema: external_exports.literal("youi.baseline/v1"),
   project: external_exports.string(),
-  recordedAt: IsoTime2,
+  recordedAt: IsoTime4,
   identity: CheckIdentity,
   totals: external_exports.object({ errors: external_exports.number().int(), warnings: external_exports.number().int() }),
   entries: external_exports.array(BaselineEntry)
@@ -27940,7 +28090,7 @@ var LockFile = external_exports.object({
   system: external_exports.string(),
   systemVersion: SemVer,
   sourceCommit: external_exports.string().nullable(),
-  syncedAt: IsoTime2,
+  syncedAt: IsoTime4,
   files: external_exports.record(external_exports.string(), LockEntry)
 });
 var INVENTORY_ROLES = ["button", "link-as-button", "input", "card", "badge", "dialog", "tabs"];
@@ -28092,7 +28242,7 @@ var InventoryReport = external_exports.object({
   $schema: external_exports.string().optional(),
   schema: external_exports.literal("youi.inventory/v1"),
   scanner: external_exports.string(),
-  generatedAt: IsoTime2,
+  generatedAt: IsoTime4,
   durationMs: external_exports.number(),
   /** Two looks share a family only when every dimension is within these (px; weight in units) of every other look's. */
   tolerance: external_exports.object({ height: external_exports.number(), padding: external_exports.number(), radius: external_exports.number(), fontSize: external_exports.number(), fontWeight: external_exports.number() }),
@@ -28126,7 +28276,9 @@ var PUBLISHED_SCHEMAS = {
   "youi.baseline.schema.json": Baseline,
   "youi.inventory.schema.json": InventoryReport,
   "youi.detect.schema.json": DetectReport,
-  "youi.tokens.schema.json": TokenDocument
+  "youi.tokens.schema.json": TokenDocument,
+  "youi.request.schema.json": RequestDoc,
+  "youi.gaps.schema.json": GapsReport
 };
 function normalizeProjectConfig(config2) {
   const n = normalizeRelPath;
@@ -28297,55 +28449,150 @@ export {
   preprocess,
   iso_exports,
   external_exports,
+  DETECT_CONFIDENCE,
+  DetectConfidence,
+  DETECT_ELEMENT_TYPES,
+  DetectElementType,
+  EVIDENCE_KINDS,
+  DetectEvidence,
+  DetectLibrary,
+  DetectElement,
+  DetectUnused,
+  DetectPage,
+  DetectFont,
   DetectReport,
+  sourceSlug,
+  draftLibraryItem,
   unifiedDiff,
   DefinitionError,
   toPosix,
   relPath,
+  globRegExp,
   matchesAny,
+  walkGlob,
   findFiles,
+  parseDefinition,
   readDefinition,
   writeFileAtomic,
   readTextOrNull,
+  GAP_STATUSES,
+  GapCandidate,
+  GapConcept,
+  GapsProject,
+  GapsReport,
   sha256,
   shortHash,
   stableStringify,
+  ELEMENT_KINDS,
   ElementId,
   parseId,
+  ruleSlug,
+  formatId,
   matchesQuery,
   safeId,
+  ELEMENT_STAGES,
+  ElementStage,
   systemStage,
   canMove,
   MCP_TOOLS,
+  LIBRARY_KINDS,
+  LibraryId,
   isLibraryId,
+  FamilyId,
   isFamilyId,
   LIBRARY_SOURCE_KINDS,
+  LibraryLicense,
   LibraryEntry,
   LIBRARY_DIR,
   loadLibrary,
+  copyleft,
+  REQUEST_ID,
+  REQUEST_STATUSES,
+  RequestAuthor,
+  RequestTarget,
+  RequestEntry,
+  RequestDoc,
   TOKEN_ALIAS,
+  TokenAlias,
+  ColorValue,
+  DimensionValue,
+  DurationValue,
+  CubicBezierValue,
+  FONT_FAMILY_NAME,
+  FONT_FAMILY_LIST,
+  FontFamilyValue,
+  FontWeightValue,
+  StrokeStyleValue,
+  BorderValue,
+  TransitionValue,
+  ShadowLayer,
+  ShadowValue,
+  GradientValue,
+  TypographyValue,
+  SpringValue,
+  FocusRingValue,
+  TOKEN_VALUE_SCHEMAS,
+  TOKEN_TYPES,
+  isTokenType,
+  tokenValueSchema,
+  TokenDocument,
   CSS_SAFE_NAME,
+  flattenTokens,
   aliasesIn,
   tokenValueProblems,
   validateTokenSets,
   normalizeRelPath,
+  SystemConfig,
+  DesignConfig,
+  RouteMapEntry,
   RouteConfig,
+  DarkSelector,
+  DEFAULT_DARK_SELECTORS,
+  TailwindConfig,
   OutputConfig,
+  AgentConfig,
   ProjectConfig,
+  PropSpec,
   COMPONENT_STATES,
   ComponentContract,
   RuleCheck,
   RuleRollout,
   RuleSpec,
+  MigrationChange,
   MigrationSpec,
+  PropValue,
+  Position,
+  RouteAttribution,
+  UsageSite,
+  UnknownSite,
+  Lookalike,
+  Violation,
+  RuleRun,
   ScanReport,
+  CheckIdentity,
+  BaselineEntry,
   Baseline,
+  LockEntry,
   LockFile,
   INVENTORY_ROLES,
+  InventoryRole,
   SHAPE_DIMENSIONS,
+  InventoryShape,
+  InventoryProject,
+  InventoryDefinition,
+  InventoryKit,
+  InventoryPrimitive,
+  InventoryRecipeWrapper,
+  InventoryRecipe,
+  InventoryLook,
+  InventoryFamily,
+  InventoryFlag,
   InventoryReport,
+  PUBLISHED_SCHEMAS,
   normalizeProjectConfig,
+  jsonSchemaFor,
   renderJsonSchemas,
+  DESIGN_CONFIG_FILE,
   loadDesignRepo,
   getSystem,
   BUILT_IN_CHECKS,