@cssints/apg-specs 0.0.0-stage → 0.5.1

package/dist/apg/link.bridge.d.mts

@@ -0,0 +1,24 @@
+import { ActionStep, Probe, ScenarioConfig, SpecBridge } from "../scenario.mjs";
+//#region src/apg/link.bridge.d.ts
+/**
+ * Scenario `config` -> what both targets are mounted with. A config with `href`
+ * (or `native: true`) renders a native anchor; `elementType` picks a custom
+ * `role=link` element. `disabled`/`active` are DOM state the spec does not model.
+ */
+export interface LinkConfig {
+  readonly native: boolean;
+  readonly href: string | undefined;
+  readonly disabled: boolean;
+  readonly current: boolean;
+}
+export declare const linkConfig: (config: ScenarioConfig) => LinkConfig;
+/**
+ * Link vocabulary <-> `specs/apg/link.qnt`. Parts: `link` (and the fixture's
+ * outside `button`). `key`/`click` focus first, as a user would. The spec does
+ * not model `disabled`/`aria-current`; those stay DOM-only.
+ */
+export declare const linkBridge: SpecBridge;
+/** The user-level steps a differential walk draws from. */
+export declare const linkSteps: ReadonlyArray<ActionStep>;
+export declare const linkProbe: Probe;
+//#endregion

package/dist/apg/link.bridge.mjs

@@ -0,0 +1,126 @@
+import { Unsupported } from "../scenario.mjs";
+//#region src/apg/link.bridge.ts
+const specEvent = (tag) => ({ _tag: tag });
+const PART_URLS = /* @__PURE__ */ new Set(["elementType", "render"]);
+const linkConfig = (config) => {
+	let native = config["href"] !== void 0;
+	let href;
+	let disabled = false;
+	let current = false;
+	for (const [key, value] of Object.entries(config)) switch (key) {
+		case "native":
+			native = value === true;
+			break;
+		case "href":
+			if (typeof value !== "string") throw new Unsupported(`href ${JSON.stringify(value)}`);
+			href = value;
+			break;
+		case "isDisabled":
+		case "disabled":
+			disabled = value === true;
+			break;
+		case "active":
+			current = value === true;
+			break;
+		case "elementType":
+		case "render":
+			if (typeof value !== "string") throw new Unsupported(`config ${key}=${JSON.stringify(value)}`);
+			native = false;
+			break;
+		default:
+			if (PART_URLS.has(key)) break;
+			throw new Unsupported(`config ${key}=${JSON.stringify(value)}`);
+	}
+	if (href !== void 0) native = true;
+	return {
+		native,
+		href,
+		disabled,
+		current
+	};
+};
+const partOf = (target) => (target ?? "link").replace(/:0$/, "");
+/**
+* Link vocabulary <-> `specs/apg/link.qnt`. Parts: `link` (and the fixture's
+* outside `button`). `key`/`click` focus first, as a user would. The spec does
+* not model `disabled`/`aria-current`; those stay DOM-only.
+*/
+const linkBridge = {
+	setup: (config) => [linkConfig(config).native ? specEvent("setNative") : specEvent("setCustom")],
+	event: (step) => {
+		switch (step.event) {
+			case "focus":
+				if (partOf(step.target) !== "link") throw new Unsupported(`focus on ${step.target ?? ""}`);
+				return [specEvent("focusLink")];
+			case "blur": return [specEvent("blur")];
+			case "click": {
+				const part = partOf(step.target);
+				if (part === "link") return [specEvent("click")];
+				if (part === "button") return [specEvent("focusLink")];
+				throw new Unsupported(`click on ${part}`);
+			}
+			case "key":
+				if (partOf(step.target) !== "link") throw new Unsupported(`key on ${step.target ?? ""}`);
+				if (step.key === "Enter") return [specEvent("focusLink"), specEvent("press")];
+				if (step.key === " " || step.key === "Space") return [specEvent("focusLink"), specEvent("pressSpace")];
+				throw new Unsupported(`key ${step.key ?? ""}`);
+			case "prop": switch (step.prop) {
+				case "back": return [specEvent("back")];
+				case "native":
+				case "setNative": return [specEvent("setNative")];
+				case "custom":
+				case "setCustom": return [specEvent("setCustom")];
+				case "disabled":
+				case "isDisabled":
+				case "href":
+				case "active":
+				case "current": return [];
+				default: throw new Unsupported(`prop ${step.prop ?? ""}`);
+			}
+			default: throw new Unsupported(`event ${step.event}`);
+		}
+	},
+	focus: (state) => {
+		const where = state["focus"];
+		return where === "link" || where === "target" ? where : null;
+	},
+	attr: (state, target, name) => {
+		if (partOf(target) !== "link") throw new Unsupported(`attribute ${name} on ${target}`);
+		if (name === "role") return state["native"] === true ? null : "link";
+		if (name === "tabindex") return state["tabindex"] === true ? "0" : null;
+		throw new Unsupported(`attribute ${name} on ${target}`);
+	},
+	visible: () => [],
+	events: () => []
+};
+/** The user-level steps a differential walk draws from. */
+const linkSteps = [
+	{
+		event: "focus",
+		target: "link"
+	},
+	{
+		event: "key",
+		key: "Enter",
+		target: "link"
+	},
+	{
+		event: "key",
+		key: " ",
+		target: "link"
+	},
+	{
+		event: "click",
+		target: "link"
+	},
+	{
+		event: "prop",
+		prop: "back"
+	}
+];
+const linkProbe = {
+	attrs: [["link", "role"], ["link", "tabindex"]],
+	events: []
+};
+//#endregion
+export { linkBridge, linkConfig, linkProbe, linkSteps };