@bridge-ds/core 0.15.0 → 0.17.0

package/dist/repo-model.d.ts

@@ -14,6 +14,8 @@ export declare const REPO_MODEL_DEFAULTS: {
     readonly componentSpecs: "packages/react/component-specs.json";
     /** Optional token usage notes (group -> sentence), relative to tokens.root, when tokens.usage is not set. */
     readonly tokensUsage: "usage.json";
+    /** Most global stylesheets read (components.styles): a broad glob never turns into hundreds of reads. */
+    readonly maxStylesheets: 50;
     readonly repo: {
         readonly owner: "peterbono";
         readonly repo: "ai-design-system-demo";
@@ -62,6 +64,30 @@ export declare function siteRepoFromConfig(config: BridgeConfig, raw?: unknown,
     repo: string;
     defaultBranch: string;
 }): SiteRepo;
+/**
+ * The global stylesheet globs of a config: components.styles, else every .css file under the styles/ and theme/
+ * folders next to the components folder (packages/react/src/styles, packages/react/src/theme here).
+ */
+export declare function styleGlobs(config: BridgeConfig): string[];
+/** The folder to list for a glob: its segments before the first wildcard ('' for the whole repository). */
+export declare function globBase(glob: string): string;
+/**
+ * The global stylesheets of a repository (styleGlobs): one listing per glob folder, files under the components folder
+ * left to the component scan, at most REPO_MODEL_DEFAULTS.maxStylesheets (a problem says when more match).
+ */
+export declare function listStylesheets(source: RepoSource, config: BridgeConfig): Promise<{
+    globs: string[];
+    paths: string[];
+    problems: string[];
+}>;
+/**
+ * The global stylesheets of a repository with the CSS custom properties each reads: what RepoModel.styles holds.
+ * loadRepoModel reads them with everything else; a model computed without them (an older snapshot) can be completed
+ * with this alone.
+ */
+export declare function readStylesheets(source: RepoSource, config: BridgeConfig, concurrency?: number): Promise<RepoModel['styles'] & {
+    problems: string[];
+}>;
 /** The config the model uses when the repo has no bridge.config.json (or an invalid one): the defaults above. */
 export declare const defaultModelConfig: () => BridgeConfig;
 /** bridge.config.json text -> config, parsed once. Never throws: problems are returned and the defaults stand in. */
@@ -104,6 +130,14 @@ export interface RepoModel {
         }[];
         list: ScannedComponent[];
     } | null;
+    /**
+     * Global stylesheets of the library (components.styles): the globs read, and each matching file with the CSS custom
+     * properties it reads (`var(--x)`), so a token read only by base styles counts as in use.
+     */
+    styles: {
+        globs: string[];
+        vars: Record<string, string[]>;
+    };
     specs: {
         path: string;
         /** Parsed component-specs.json, null when missing or of another version. */
@@ -122,7 +156,7 @@ export interface RepoModelOptions {
     /**
      * Hears how far the read has gone, in real file counts: once with every phase's total before the first body is
      * read, then once per file settled. Phases run in order: tokens (token files, contrast checks, usage notes), then
-     * components (code, styles, stories, the index and the Figma specs), then docs (each component's docs file).
+     * components (code, styles, stories, the index, the global stylesheets and the Figma specs), then docs (each component's docs file).
      */
     onProgress?: (progress: RepoModelProgress) => void;
 }