@monospaced/set-core 0.0.0

package/dist/spec.d.ts

@@ -0,0 +1,178 @@
+/** Where a rule applies. */
+export type SetSpecTarget = {
+    readonly on: "host";
+} | {
+    readonly on: "descendant";
+    readonly selector: string;
+};
+/** Condition under which a rule fires. */
+export type SetSpecCondition = {
+    readonly kind: "always";
+} | {
+    readonly kind: "when-provided";
+    readonly prop: string;
+} | {
+    readonly kind: "when-non-empty";
+    readonly prop: string;
+} | {
+    readonly kind: "when-truthy";
+    readonly prop: string;
+} | {
+    readonly kind: "when-equals";
+    readonly prop: string;
+    readonly to: string | number | boolean;
+} | {
+    readonly kind: "when-in";
+    readonly prop: string;
+    readonly values: ReadonlyArray<string | number | boolean>;
+} | {
+    readonly kind: "when-not-in";
+    readonly prop: string;
+    readonly values: ReadonlyArray<string | number | boolean>;
+} | {
+    readonly kind: "all";
+    readonly of: ReadonlyArray<SetSpecCondition>;
+} | {
+    readonly kind: "any";
+    readonly of: ReadonlyArray<SetSpecCondition>;
+} | {
+    readonly kind: "not";
+    readonly of: SetSpecCondition;
+};
+/** Value expression for an emitted attribute. Omit to mean presence-only. */
+export type SetSpecValue = {
+    readonly kind: "literal";
+    readonly text: string;
+} | {
+    readonly kind: "prop";
+    readonly prop: string;
+} | {
+    readonly kind: "template";
+    readonly pattern: string;
+};
+/** Single attribute-emission rule on the host or a structural descendant. */
+export interface SetSpecAttributeRule {
+    readonly target: SetSpecTarget;
+    readonly attribute: string;
+    readonly condition: SetSpecCondition;
+    readonly value?: SetSpecValue;
+}
+/** Machine-readable type of a prop. */
+export type SetSpecPropType = {
+    readonly kind: "string";
+} | {
+    readonly kind: "text";
+} | {
+    readonly kind: "html";
+} | {
+    readonly kind: "boolean";
+} | {
+    readonly kind: "number";
+    readonly min?: number;
+    readonly max?: number;
+    readonly integer?: boolean;
+} | {
+    readonly kind: "enum";
+    readonly values: ReadonlyArray<string | number>;
+} | {
+    readonly kind: "array";
+    readonly itemShape: Readonly<Record<string, SetComponentSpecProp>>;
+} | {
+    readonly kind: "iconName";
+} | {
+    readonly kind: "union";
+    readonly variants: ReadonlyArray<SetSpecPropType>;
+};
+export interface SetComponentSpecProp {
+    readonly description: string;
+    readonly type: SetSpecPropType;
+    readonly required?: boolean;
+    readonly requiredWhen?: string;
+    readonly ignoredWhen?: string;
+    readonly default?: unknown;
+}
+export interface SetComponentSpecEvent {
+    readonly description: string;
+    readonly bubbles?: boolean;
+    readonly cancelable?: boolean;
+    readonly detail?: string;
+}
+/**
+ * Host element identity. A plain string names a fixed element; the object form
+ * switches the element tag by the value of a discriminant prop (e.g. `button`
+ * renders as `<button>` or `<a>` depending on `mode`).
+ */
+export type SetSpecElement = string | {
+    readonly kind: "switch";
+    readonly prop: string;
+    readonly cases: Readonly<Record<string, string>>;
+};
+/** Host element identity. `class` is the always-emit host class, if any. */
+export interface SetSpecOutput {
+    readonly element: SetSpecElement;
+    readonly class?: string;
+}
+/**
+ * How the component accepts content.
+ *
+ * - `none`: component emits no user-supplied content.
+ * - `text`: single slot of escaped plain text, named by `prop`.
+ * - `html`: single slot of trusted HTML string, named by `prop`.
+ * - `structured`: typed record array, named by `prop`; item shape lives on
+ *   that prop's `SetSpecPropType` (`kind: "array"`).
+ * - `slots`: multiple named content props. Each slot names its prop and kind.
+ */
+export type SetSpecContent = {
+    readonly kind: "none";
+} | {
+    readonly kind: "text";
+    readonly prop: string;
+} | {
+    readonly kind: "html";
+    readonly prop: string;
+} | {
+    readonly kind: "structured";
+    readonly prop: string;
+} | {
+    readonly kind: "slots";
+    readonly slots: ReadonlyArray<{
+        readonly prop: string;
+        readonly kind: "text" | "html";
+    }>;
+};
+export interface SetComponentSpec {
+    readonly name: string;
+    readonly description: string;
+    readonly output: SetSpecOutput;
+    readonly content: SetSpecContent;
+    readonly props: Readonly<Record<string, SetComponentSpecProp>>;
+    readonly events: Readonly<Record<string, SetComponentSpecEvent>>;
+    readonly rules: {
+        readonly attributes: ReadonlyArray<SetSpecAttributeRule>;
+    };
+}
+type PropBag = Readonly<Record<string, unknown>>;
+export declare const evaluateSpecCondition: (condition: SetSpecCondition, props: PropBag, spec: SetComponentSpec) => boolean;
+/**
+ * Resolved expected attribute output.
+ * - `"present"`: attribute is emitted without a value (boolean attribute)
+ * - string: attribute is emitted with that exact value
+ */
+export type ResolvedSpecValue = {
+    readonly kind: "present";
+} | {
+    readonly kind: "value";
+    readonly text: string;
+};
+export declare const resolveSpecValue: (value: SetSpecValue | undefined, props: PropBag, spec: SetComponentSpec) => ResolvedSpecValue;
+/** Collect every prop name referenced by a condition subtree. */
+export declare const collectConditionProps: (condition: SetSpecCondition) => ReadonlyArray<string>;
+/** Collect every prop name referenced by a value expression. */
+export declare const collectValueProps: (value: SetSpecValue | undefined) => ReadonlyArray<string>;
+type StoryArgType = Record<string, unknown>;
+export declare const specToArgTypes: (spec: SetComponentSpec) => Record<string, StoryArgType>;
+export declare const specToComponentDescription: (spec: SetComponentSpec) => string | undefined;
+export declare const specToPropsTable: (spec: SetComponentSpec) => string;
+export declare const specToEventsTable: (spec: SetComponentSpec) => string | undefined;
+export {};
+//# sourceMappingURL=spec.d.ts.map

package/dist/spec.d.ts.map

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

package/dist/test/spec.d.ts

@@ -0,0 +1,14 @@
+import { type SetComponentSpec } from "../spec";
+export interface SpecConsistencyConfig<Props> {
+    readonly spec: SetComponentSpec;
+    readonly renderer: (props: Props) => string;
+    readonly baseProps: Props;
+    /**
+     * Extra props to merge when probing a specific prop, to satisfy cross-prop
+     * constraints declared in the SPEC (for example a `requiredWhen` partner).
+     * Keyed by the prop being probed.
+     */
+    readonly propOverrides?: Readonly<Record<string, Partial<Props>>>;
+}
+export declare function describeSpecConsistency<Props extends object>(config: SpecConsistencyConfig<Props>): void;
+//# sourceMappingURL=spec.d.ts.map

package/dist/test/spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec.d.ts","sourceRoot":"","sources":["../../src/test/spec.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,gBAAgB,EAItB,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,qBAAqB,CAAC,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;CACnE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,SAAS,MAAM,EAC1D,MAAM,EAAE,qBAAqB,CAAC,KAAK,CAAC,GACnC,IAAI,CAiDN"}

package/dist/types.d.ts

@@ -0,0 +1,6 @@
+export type SetAlign = "start" | "center" | "end";
+export type SetInlineSize = "full" | "fit";
+export type SetStatusTone = "info" | "success" | "warning" | "error";
+export type SetControlSize = "sm" | "md";
+export type SetHeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;AAClD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,KAAK,CAAC;AAC3C,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AACrE,MAAM,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,CAAC;AACzC,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@monospaced/set-core",
+  "version": "0.0.0",
+  "description": "SSR-first component library for Set. Native HTML output via custom elements, with a co-located CSS contract.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/monospaced/set.git",
+    "directory": "packages/core"
+  },
+  "type": "module",
+  "style": "./dist/core.css",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./styles.css": "./dist/core.css"
+  },
+  "dependencies": {
+    "tdesign-icons-svg": "^0.4.5"
+  },
+  "devDependencies": {
+    "@testing-library/dom": "^10.4.1",
+    "@testing-library/user-event": "^14.6.1",
+    "@types/node": "^25.8.0",
+    "autoprefixer": "^10.5.0",
+    "jsdom": "^29.1.1",
+    "postcss": "^8.5.14",
+    "prettier": "^3.8.3",
+    "typescript": "^5.9.3",
+    "vite": "^7.3.2",
+    "vitest": "^4.1.6",
+    "@monospaced/set-config": "0.0.0",
+    "@monospaced/set-system": "0.0.0",
+    "@monospaced/set-markdown": "0.0.0"
+  },
+  "scripts": {
+    "build": "vite build && pnpm run build:types",
+    "build:types": "tsc -p tsconfig.build.json",
+    "icons:generate": "node scripts/generate-icons.mjs",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  }
+}