@graview/core 0.1.0

package/dist/scaffold/lens.js

@@ -0,0 +1,176 @@
+import { pascal, titleCase } from "./index.js";
+export function validateLensOptions(options) {
+    const problems = [];
+    if (!/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/.test(options.name)) {
+        problems.push(`"${options.name}" is not a slug: lower case, hyphen-separated, e.g. grounds-map`);
+    }
+    if (options.roles.length === 0) {
+        problems.push("a lens needs at least one role: --roles rows,columns,link");
+    }
+    for (const role of options.roles) {
+        if (!/^[a-z][A-Za-z0-9]*$/.test(role))
+            problems.push(`"${role}" is not a role name`);
+    }
+    return problems;
+}
+/** The files a new lens is: the lens itself, and the test that proves it. */
+export function scaffoldLens(options) {
+    const dir = (options.dir ?? "src/ui/lens").replace(/\/+$/, "");
+    const binds = options.binds ?? "fields";
+    const Name = pascal(options.name);
+    const title = titleCase(options.name);
+    const roles = options.roles;
+    return [
+        { path: `${dir}/${options.name}.tsx`, contents: lensTsx(options.name, Name, title, roles, binds) },
+        { path: `${dir}/${options.name}.reuse.test.tsx`, contents: reuseTest(options.name, Name, roles, binds) },
+    ];
+}
+function rolesType(roles, binds) {
+    return roles
+        .map((role) => binds === "fields"
+        ? `  /** The field that fills "${role}". */\n  readonly ${role}: string;`
+        : `  /** The kind or edge that fills "${role}". */\n  readonly ${role}: { readonly kind: string } | { readonly edge: string };`)
+        .join("\n");
+}
+function lensTsx(name, Name, title, roles, binds) {
+    return `import { Chip, Panel } from "@graview/primitives";
+import { useGraview, type ViewProps } from "@graview/react";
+import type { AnySchema } from "@graview/core";
+
+/**
+ * ${title} — a lens.
+ *
+ * A lens knows nothing about your domain: it knows there is ${roles
+        .map((role) => `a "${role}"`)
+        .join(", ")}, and an app says which of its own ${binds === "fields" ? "fields" : "kinds and edges"} fill them. That indirection is the whole point, and the test beside this
+ * file is where the claim is kept honest.
+ */
+
+export const ${constantName(name)}_REQUIRED_ROLES = [${roles.map((role) => `"${role}"`).join(", ")}] as const;
+
+export interface ${Name}Roles {
+${rolesType(roles, binds)}
+}
+
+/** Thrown when an app binds a role to something that is not there. */
+export class ${Name}BindingError extends Error {
+  /** A sentence about what to do, which the scene's panel prints. */
+  readonly hint: string;
+  constructor(message: string, hint: string) {
+    super(message);
+    this.name = "${Name}BindingError";
+    this.hint = hint;
+  }
+}
+
+/**
+ * FAIL LOUDLY ON A BAD BINDING — and loudly means this panel, not the page:
+ * the scene puts an error boundary around every view, so a throw draws the
+ * message and the hint where the picture would have been.
+ */
+function check<S extends AnySchema>(roles: ${Name}Roles, schema: S): void {
+  for (const role of ${constantName(name)}_REQUIRED_ROLES) {
+    if (roles[role] === undefined) {
+      throw new ${Name}BindingError(
+        \`${title} has no "\${role}" bound.\`,
+        \`Add \${role} to the lens bindings for this kind.\`,
+      );
+    }
+  }
+  void schema;
+}
+
+export function build${Name}(
+  nodes: readonly { readonly id: string; readonly kind: string }[],
+  roles: ${Name}Roles,
+  schema: AnySchema,
+): { readonly marks: readonly { readonly id: string; readonly label: string }[] } {
+  check(roles, schema);
+  /* TODO: read the roles, not the field names. This is the whole lens. */
+  return { marks: nodes.map((node) => ({ id: node.id, label: node.id })) };
+}
+
+/**
+ * Three fidelities, and \`summary\` is DENSER CONTENT rather than the same
+ * content scaled down.
+ */
+export function create${Name}Lens<S extends AnySchema>(roles: ${Name}Roles) {
+  function View(props: ViewProps<S>) {
+    const { store } = useGraview<S>();
+    const built = build${Name}(props.nodes ?? [], roles, store.schema);
+    if (props.fidelity === "glyph") {
+      return <Chip label={\`\${props.label ?? "${title}"} · \${built.marks.length}\`} />;
+    }
+    return (
+      <Panel title={props.label ?? "${title}"} meta={\`\${built.marks.length}\`}>
+        {built.marks.map((mark) => (
+          /*
+           * EVERY REAL THING IS A TARGET. That one attribute is the whole
+           * contract: the host routes the click, gives it a tab stop and a
+           * role. Drawing in SVG? Set aria-label yourself — a shape has no
+           * text to be named by.
+           */
+          <div
+            key={mark.id}
+            data-graview-pick={mark.id}
+            data-graview-emphasis={props.implicated?.includes(mark.id) ? "lit" : undefined}
+          >
+            {mark.label}
+          </div>
+        ))}
+      </Panel>
+    );
+  }
+  return {
+    name: "${name}",
+    requiredRoles: [...${constantName(name)}_REQUIRED_ROLES],
+    roles,
+    View,
+  };
+}
+`;
+}
+function reuseTest(name, Name, roles, binds) {
+    const bound = roles
+        .map((role) => (binds === "fields" ? `${role}: "TODO"` : `${role}: { kind: "TODO" }`))
+        .join(", ");
+    return `import { createSchema, defineNode, z } from "@graview/core";
+import { describe, expect, it } from "vitest";
+import { build${Name} } from "./${name}.js";
+
+/**
+ * THE REUSE TEST, RED ON PURPOSE.
+ *
+ * This is the claim a lens exists to support and the one nothing can make
+ * for you: build it against a domain it was NOT designed for, and if you
+ * cannot write this test, say so plainly — you have written a view, and a
+ * view is a legitimate thing to have written.
+ *
+ * The domain below is deliberately nothing to do with the app. Change the
+ * bindings to this domain's own fields, make it pass, and the claim is true.
+ */
+const shift = defineNode("shift", {
+  fields: z.object({ label: z.string(), on: z.string(), place: z.string() }),
+  plural: "Shifts",
+});
+const volunteer = defineNode("volunteer", { fields: z.object({ label: z.string() }), plural: "Volunteers" });
+const rota = createSchema([shift, volunteer]);
+
+describe("${name} in a domain nothing here is about", () => {
+  it("builds against a rota, with no change to the lens", () => {
+    const built = build${Name}(
+      [{ id: "s1", kind: "shift" }],
+      { ${bound} },
+      rota as never,
+    );
+    expect(built.marks).toHaveLength(1);
+    /* TODO: assert something this lens is FOR, not that it returned. */
+    expect.fail("Bind the roles to this domain and assert what the picture says.");
+  });
+});
+`;
+}
+function constantName(name) {
+    return name.replace(/-/g, "_").toUpperCase();
+}
+//# sourceMappingURL=lens.js.map

package/dist/scaffold/lens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lens.js","sourceRoot":"","sources":["../../src/scaffold/lens.ts"],"names":[],"mappings":"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"}

package/dist/scaffold/names.d.ts

@@ -0,0 +1,44 @@
+import type { ScaffoldOptions } from "./index.js";
+export declare const SLUG: RegExp;
+export declare function slugify(text: string): string;
+export declare function titleCase(slug: string): string;
+export declare function camel(slug: string): string;
+export declare function pascal(slug: string): string;
+/**
+ * The reasons a name or a kind cannot be used, said before any file exists.
+ * A kind is a TypeScript identifier and a URL segment and an edge target,
+ * so it is held to the strictest of those.
+ */
+export declare function validateScaffoldOptions(options: ScaffoldOptions): readonly string[];
+export type Ids = {
+    name: string;
+    kind: string;
+    plural: string;
+    spoken: string;
+    spokenPlural: string;
+    /** The kind spoken with its article: "an item", "a work order". */
+    aSpoken: string;
+    /** The same, capitalised for the head of a sentence. */
+    ASpoken: string;
+    Kind: string;
+    Plural: string;
+    kindVar: string;
+    KindPascal: string;
+    appVar: string;
+    brandVar: string;
+    schemaVar: string;
+    SchemaType: string;
+    StoreType: string;
+    AppComponent: string;
+    accent: string;
+    port: number;
+    link: string | undefined;
+    frameworkRepo: string | undefined;
+    range: string;
+    packageManager: "pnpm" | "npm";
+    packageName: string;
+};
+export declare function escapeHtml(text: string): string;
+export declare function escapeString(text: string): string;
+export declare function escapeTemplate(text: string): string;
+//# sourceMappingURL=names.d.ts.map

package/dist/scaffold/names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../../src/scaffold/names.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAQlD,eAAO,MAAM,IAAI,QAAoC,CAAC;AAEtD,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAM5C;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK9C;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG3C;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,eAAe,GAAG,SAAS,MAAM,EAAE,CA0BnF;AAED,MAAM,MAAM,GAAG,GAAG;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,GAAG,KAAK,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAIF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/scaffold/names.js

@@ -0,0 +1,69 @@
+/*
+ * WHAT A NEW PROJECT IS CALLED, and every way that name is spelled: a slug
+ * for paths, a title for people, camel and pascal for code, and the escapes
+ * that let a name sit safely inside the files written about it.
+ */
+export const SLUG = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
+export function slugify(text) {
+    return text
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+export function titleCase(slug) {
+    return slug
+        .split("-")
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join(" ");
+}
+export function camel(slug) {
+    return slug.replace(/-([a-z0-9])/g, (_, c) => c.toUpperCase());
+}
+export function pascal(slug) {
+    const c = camel(slug);
+    return c.charAt(0).toUpperCase() + c.slice(1);
+}
+/**
+ * The reasons a name or a kind cannot be used, said before any file exists.
+ * A kind is a TypeScript identifier and a URL segment and an edge target,
+ * so it is held to the strictest of those.
+ */
+export function validateScaffoldOptions(options) {
+    const problems = [];
+    if (!options.name || options.name.trim().length === 0) {
+        problems.push("a name is required — the product's name, as a person would say it");
+    }
+    const kind = options.kind ?? "item";
+    if (!SLUG.test(kind)) {
+        problems.push(`the kind "${kind}" must be a slug: lowercase letters, digits and hyphens, starting with a letter`);
+    }
+    const plural = options.plural ?? `${kind}s`;
+    if (!SLUG.test(plural)) {
+        problems.push(`the plural "${plural}" must be a slug like the kind: lowercase letters, digits and hyphens`);
+    }
+    if (["kind", "edge", "node", "rule", "graph"].includes(kind)) {
+        problems.push(`the kind "${kind}" is a word the framework uses for itself; pick the thing your product is about`);
+    }
+    if (options.packageName !== undefined && !/^(@[a-z0-9-]+\/)?[a-z0-9][a-z0-9-._]*$/.test(options.packageName)) {
+        problems.push(`the package name "${options.packageName}" is not one npm accepts`);
+    }
+    if (options.port !== undefined && !(Number.isInteger(options.port) && options.port > 0 && options.port < 65536)) {
+        problems.push(`the port ${String(options.port)} is not a port`);
+    }
+    if (options.accent !== undefined && !/^#[0-9a-fA-F]{6}$/.test(options.accent)) {
+        problems.push(`the accent "${options.accent}" must be a six-digit hex colour like #2e7d32`);
+    }
+    return problems;
+}
+/* -------------------------------------------------------------- escapes */
+export function escapeHtml(text) {
+    return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+export function escapeString(text) {
+    return text.replace(/\\/g, "\\\\").replace(/"/g, '\\"');
+}
+export function escapeTemplate(text) {
+    return text.replace(/\\/g, "\\\\").replace(/`/g, "\`").replace(/\$\{/g, "\${");
+}
+//# sourceMappingURL=names.js.map

package/dist/scaffold/names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.js","sourceRoot":"","sources":["../../src/scaffold/names.ts"],"names":[],"mappings":"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"}

package/dist/scaffold/project.d.ts

@@ -0,0 +1,41 @@
+import type { Ids } from "./names.js";
+/** The packages a product depends on, in the order the skill lists them. */
+export declare const GRAVIEW_PACKAGES: readonly ["core", "layout", "tools", "render", "react", "primitives", "pages", "ship", "embed", "studio"];
+/**
+ * Everything a linked project resolves from the framework checkout: the
+ * packages a product imports, plus the skills and the tool it takes as
+ * devDependencies. Each must be built before `--link` can work.
+ */
+export declare const LINKED_PACKAGES: readonly string[];
+export declare const SURVEY_SAYS: string[];
+export declare const AUDIT_SAYS: string[];
+export declare const A11Y_SAYS: string[];
+/**
+ * A harness that has not been written yet, and says so rather than passing.
+ *
+ * A green verdict from a script that measured nothing is worse than no
+ * script: it is a claim. This one exits non-zero, names what it is for, and
+ * points at the framework's own implementation to steal.
+ */
+export declare function harness(name: string, says: readonly string[], ids: Ids): string;
+/** The workspace root: what the app is, and where the harnesses go. */
+export declare function workspaceRoot(ids: Ids, link: string | undefined): string;
+/** The compiler options both the app and anything beside it share. */
+export declare function tsconfigBase(): string;
+/** One test run for the whole workspace, whatever grows beside the app. */
+export declare function rootVitest(): string;
+export declare function packageJson(ids: Ids, workspace: boolean): string;
+export declare function tsconfig(workspace: boolean): string;
+export declare function tsconfigBuild(): string;
+export declare function viteConfig(ids: Ids): string;
+export declare function gitignore(): string;
+export declare function readme(ids: Ids): string;
+export declare function ciYml(ids: Ids): string;
+/**
+ * A project that consumes the framework by path needs the framework on the
+ * runner, at the same relative path, built. The project is checked out into
+ * a directory of its own and the framework beside it, so \`link:../<name>\`
+ * resolves exactly as it does on a laptop.
+ */
+export declare function linkedCiYml(ids: Ids, pnpm: boolean): string;
+//# sourceMappingURL=project.d.ts.map

package/dist/scaffold/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/scaffold/project.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAEtC,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,2GAoBnB,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAA+C,CAAC;AAO7F,eAAO,MAAM,WAAW,UAIvB,CAAC;AAEF,eAAO,MAAM,UAAU,UAMtB,CAAC;AAEF,eAAO,MAAM,SAAS,UAIrB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,GAAG,GAAG,MAAM,CAqB/E;AAED,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAgCxE;AAED,sEAAsE;AACtE,wBAAgB,YAAY,IAAI,MAAM,CAsBrC;AAED,2EAA2E;AAC3E,wBAAgB,UAAU,IAAI,MAAM,CAOnC;AAID,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,CAiEhE;AAED,wBAAgB,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,MAAM,CAyCnD;AAED,wBAAgB,aAAa,IAAI,MAAM,CAoBtC;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAkL3C;AAOD,wBAAgB,SAAS,IAAI,MAAM,CAWlC;AAED,wBAAgB,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CAwEvC;AAID,wBAAgB,KAAK,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM,CA2BtC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAwC3D"}