@fairfox/polly 0.40.0 → 0.47.0

package/dist/src/polly-ui/registry.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Public registry surface for `@fairfox/polly/ui`.
+ *
+ * The actual data is generated from polly-ui's canonical sources by
+ * `scripts/build-polly-ui-registry.ts` into `registry.generated.ts`.
+ * This file pins the public re-export so the generator can refresh
+ * `registry.generated.ts` without changing the import path consumers
+ * use.
+ *
+ * Tokens and components are exposed as `readonly` arrays. Adding a
+ * token to `theme.css` (or a component to `index.ts`) shows up here
+ * after the next `bun run build:lib` pass; the surface is intended as
+ * the source of truth for downstream conformance checks like
+ * `polly-ui:css-vars` and `polly-ui:shared-components`.
+ */
+export { type PollyUiComponent, type PollyUiToken, type PollyUiTokenCategory, pollyUiComponents, pollyUiTokens, } from "./registry.generated";

package/dist/src/polly-ui/registry.generated.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Generated by scripts/build-polly-ui-registry.ts.
+ *
+ * Do not edit by hand. Edit src/polly-ui/theme.css, src/polly-ui/index.ts,
+ * or tools/quality/src/check-shared-components.ts and re-run the
+ * generator to refresh this file.
+ */
+export type PollyUiTokenCategory = "color" | "spacing" | "radius" | "typography" | "motion" | "sizing" | "shadow" | "z-index" | "other";
+export type PollyUiToken = {
+    name: string;
+    category: PollyUiTokenCategory;
+    default: string;
+};
+export type PollyUiComponent = {
+    name: string;
+    replaces: string[];
+    importPath: string;
+};
+export declare const pollyUiTokens: readonly PollyUiToken[];
+export declare const pollyUiComponents: readonly PollyUiComponent[];

package/dist/tools/quality/src/attest.d.ts

@@ -0,0 +1,55 @@
+/**
+ * `polly quality attest` — sign a passing run and post a GitHub commit status.
+ *
+ * The flow:
+ *   1. Refuse on a dirty working tree (porcelain non-empty).
+ *   2. Resolve the current commit sha and the gh user.
+ *   3. Run every registered check via the cache. A red result aborts
+ *      with no status posted.
+ *   4. Compute a digest of the commit sha plus a sorted summary of
+ *      check results.
+ *   5. Post a GitHub commit status named `polly/attested/<user>` to
+ *      that sha via the local `gh` CLI (which carries the user's
+ *      existing authentication).
+ *   6. Cache the signed entry at
+ *      `.cache/polly-quality/attest/<commit>.json` so a re-invocation
+ *      on the same commit short-circuits to a status refresh.
+ *
+ * Auth lives in the user's `gh` CLI install rather than a `GITHUB_TOKEN`
+ * env var: every contributor running `polly quality attest` already
+ * authenticated `gh` for issue and PR work, and shelling out keeps the
+ * dependency surface zero.
+ */
+import { type RegisteredCheck } from "./host";
+import type { CheckRunResult, QualityRunConfig, RunReport } from "./types";
+export type AttestOptions = {
+    rootDir: string;
+    registry: Map<string, RegisteredCheck>;
+    runConfig: QualityRunConfig;
+    /**
+     * When set, the deploy preflight command (read from
+     * `runConfig.attestDeploy`) runs before the post and the status
+     * name becomes `polly/deploy-attested/<user>`.
+     */
+    deploy?: boolean;
+    /** Override for the `polly` segment of the status context. */
+    contextPrefix?: string;
+};
+export type AttestResult = {
+    ok: boolean;
+    /** Posted (or would-have-posted) status context. */
+    context: string;
+    /** Commit sha the status was attached to. */
+    sha: string;
+    /** Fingerprint of the run. */
+    digest: string;
+    /** Summary lines for the CLI reporter. */
+    messages: string[];
+    /** When non-empty, attest aborted before posting. */
+    error?: string;
+    /** Underlying check report for downstream display. */
+    report?: RunReport;
+};
+export declare function summariseRunReport(report: RunReport): string;
+export declare function digestRun(sha: string, results: CheckRunResult[]): string;
+export declare function runAttest(opts: AttestOptions): Promise<AttestResult>;

package/dist/tools/quality/src/cache.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Content-hash cache for the quality plugin host.
+ *
+ * Each check declares the files and extras that determine its result.
+ * The cache hashes those into a key, looks up `.cache/polly-quality/<id>.json`,
+ * and returns the prior result on hit. A miss re-runs the check body and
+ * writes a fresh entry.
+ *
+ * Files that are missing on disk hash as the literal string `<absent>`
+ * so removing a declared input invalidates the entry deterministically.
+ * Atomic writes go through a temp file + rename so a process crashing
+ * mid-write cannot leave a partial JSON behind that later parses to a
+ * malformed entry. A corrupt entry is treated as a miss with a warning;
+ * the check re-runs and overwrites it.
+ */
+import type { CheckOutcome } from "./types";
+export type CacheInputs = {
+    files: string[];
+    extras?: Record<string, string>;
+};
+export type CacheEntry = {
+    hash: string;
+    outcome: CheckOutcome;
+    /** Wall-clock time the entry was written; useful for debugging stale caches. */
+    writtenAt: string;
+};
+/**
+ * Compute a deterministic SHA-256 over (sorted file paths + content hashes
+ * + sorted extras). Identical inputs in any order produce the same hash;
+ * adding, removing, renaming, or modifying any input changes it.
+ */
+export declare function computeInputsHash(inputs: CacheInputs, rootDir: string): Promise<string>;
+export declare function getCachedOutcome(rootDir: string, checkId: string, hash: string): Promise<CheckOutcome | null>;
+export declare function setCachedOutcome(rootDir: string, checkId: string, hash: string, outcome: CheckOutcome): Promise<void>;