@sketchscreens/core-schema 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Houston IT Developers
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/audit.d.ts

@@ -0,0 +1,28 @@
+import type { ProjectMap } from "./schema.js";
+import type { ValidationIssue } from "./validate.js";
+/**
+ * NODE-ONLY provenance audit. Separate from validate.ts (which stays
+ * browser-safe) because this touches the filesystem — only the CLI imports it.
+ *
+ * Verifies each screen's `sourceFile` actually exists under the repo root, so a
+ * hallucinated path can't masquerade as real provenance. Missing files are
+ * WARNINGS, not errors: a modal/dialog screen may legitimately have no file.
+ */
+export interface AuditResult {
+    /** Repo root the sourceFiles were resolved against. */
+    repoRoot: string;
+    /** How many screens declared a sourceFile. */
+    withSourceFile: number;
+    /** How many of those resolved to a real file. */
+    resolved: number;
+    /** sourceFiles that didn't resolve (repo-relative as written). */
+    missing: string[];
+    /** Warning issues (one per missing sourceFile). */
+    issues: ValidationIssue[];
+}
+/**
+ * Audit a map's `sourceFile`s against `repoRoot`. Pass the root from the map's
+ * `meta.repoRoot` (or the cwd the extraction ran in). `~` is expanded.
+ */
+export declare function auditSourceFiles(map: ProjectMap, repoRoot: string): AuditResult;
+//# sourceMappingURL=audit.d.ts.map

package/dist/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../src/audit.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD;;;;;;;GAOG;AAEH,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,cAAc,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,mDAAmD;IACnD,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW,CA0B/E"}

package/dist/audit.js

@@ -0,0 +1,42 @@
+import { existsSync, statSync } from "node:fs";
+import { isAbsolute, resolve } from "node:path";
+/**
+ * Audit a map's `sourceFile`s against `repoRoot`. Pass the root from the map's
+ * `meta.repoRoot` (or the cwd the extraction ran in). `~` is expanded.
+ */
+export function auditSourceFiles(map, repoRoot) {
+    const root = expandHome(repoRoot);
+    const missing = [];
+    const issues = [];
+    let withSourceFile = 0;
+    let resolved = 0;
+    for (const screen of map.screens) {
+        const sf = screen.sourceFile;
+        if (!sf)
+            continue;
+        withSourceFile++;
+        const abs = isAbsolute(sf) ? sf : resolve(root, sf);
+        if (existsSync(abs) && statSync(abs).isFile()) {
+            resolved++;
+        }
+        else {
+            missing.push(sf);
+            issues.push({
+                code: "sourcefile_missing",
+                severity: "warning",
+                message: `Screen "${screen.id}" sourceFile does not exist: ${sf}`,
+                path: `screens[id=${screen.id}].sourceFile`,
+            });
+        }
+    }
+    return { repoRoot: root, withSourceFile, resolved, missing, issues };
+}
+/** Expand a leading ~ to the user's home directory. */
+function expandHome(p) {
+    if (p === "~" || p.startsWith("~/")) {
+        const home = process.env.HOME || process.env.USERPROFILE || "";
+        return home + p.slice(1);
+    }
+    return p;
+}
+//# sourceMappingURL=audit.js.map

package/dist/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../src/audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0BhD;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAe,EAAE,QAAgB;IAChE,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,QAAQ,GAAG,CAAC,CAAC;IAEjB,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QACjC,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC;QAC7B,IAAI,CAAC,EAAE;YAAE,SAAS;QAClB,cAAc,EAAE,CAAC;QACjB,MAAM,GAAG,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpD,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;YAC9C,QAAQ,EAAE,CAAC;QACb,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjB,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI,EAAE,oBAAoB;gBAC1B,QAAQ,EAAE,SAAS;gBACnB,OAAO,EAAE,WAAW,MAAM,CAAC,EAAE,gCAAgC,EAAE,EAAE;gBACjE,IAAI,EAAE,cAAc,MAAM,CAAC,EAAE,cAAc;aAC5C,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AACvE,CAAC;AAED,uDAAuD;AACvD,SAAS,UAAU,CAAC,CAAS;IAC3B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC;QAC/D,OAAO,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @sketchscreens/core-schema
+ *
+ * The contract at the center of SketchScreens: the `ProjectMap` shape that the
+ * extractor produces and the renderer consumes. Import the zod schemas to
+ * validate, or the inferred types to build maps in TypeScript.
+ */
+export { ElementType, ElementVariant, ElementRegion, ElementAlign, ScreenElement, ScreenSpec, Edge, Surface, ProjectMapMeta, ProjectMap, groupSegments, } from "./schema.js";
+export type { ElementType as ElementTypeT, ElementVariant as ElementVariantT, ElementRegion as ElementRegionT, ElementAlign as ElementAlignT, ScreenElement as ScreenElementT, ScreenSpec as ScreenSpecT, Edge as EdgeT, Surface as SurfaceT, ProjectMapMeta as ProjectMapMetaT, ProjectMap as ProjectMapT, } from "./schema.js";
+export { validateProjectMap, parseProjectMap, type ValidationIssue, type ValidationResult, type IssueSeverity, } from "./validate.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,WAAW,EACX,cAAc,EACd,aAAa,EACb,YAAY,EACZ,aAAa,EACb,UAAU,EACV,IAAI,EACJ,OAAO,EACP,cAAc,EACd,UAAU,EACV,aAAa,GACd,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,WAAW,IAAI,YAAY,EAC3B,cAAc,IAAI,eAAe,EACjC,aAAa,IAAI,cAAc,EAC/B,YAAY,IAAI,aAAa,EAC7B,aAAa,IAAI,cAAc,EAC/B,UAAU,IAAI,WAAW,EACzB,IAAI,IAAI,KAAK,EACb,OAAO,IAAI,QAAQ,EACnB,cAAc,IAAI,eAAe,EACjC,UAAU,IAAI,WAAW,GAC1B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+/**
+ * @sketchscreens/core-schema
+ *
+ * The contract at the center of SketchScreens: the `ProjectMap` shape that the
+ * extractor produces and the renderer consumes. Import the zod schemas to
+ * validate, or the inferred types to build maps in TypeScript.
+ */
+export { ElementType, ElementVariant, ElementRegion, ElementAlign, ScreenElement, ScreenSpec, Edge, Surface, ProjectMapMeta, ProjectMap, groupSegments, } from "./schema.js";
+export { validateProjectMap, parseProjectMap, } from "./validate.js";
+// NOTE: the filesystem audit (auditSourceFiles) lives in ./audit.js and is
+// intentionally NOT re-exported here — it imports node:fs and would pollute the
+// browser bundle. CLIs import it via the "@sketchscreens/core-schema/audit"
+// subpath export (see package.json).
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,WAAW,EACX,cAAc,EACd,aAAa,EACb,YAAY,EACZ,aAAa,EACb,UAAU,EACV,IAAI,EACJ,OAAO,EACP,cAAc,EACd,UAAU,EACV,aAAa,GACd,MAAM,aAAa,CAAC;AAerB,OAAO,EACL,kBAAkB,EAClB,eAAe,GAIhB,MAAM,eAAe,CAAC;AAEvB,2EAA2E;AAC3E,gFAAgF;AAChF,4EAA4E;AAC5E,qCAAqC"}