@asymmetric-effort/specifyjs 0.2.98 → 0.2.100

package/dist/types/shared/types.d.ts

@@ -0,0 +1,128 @@
+/** Unique symbol to identify SpecifyJS elements */
+export declare const SPEC_ELEMENT_TYPE: unique symbol;
+export declare const SPEC_FRAGMENT_TYPE: unique symbol;
+export declare const SPEC_PORTAL_TYPE: unique symbol;
+export declare const SPEC_PROVIDER_TYPE: unique symbol;
+export declare const SPEC_CONSUMER_TYPE: unique symbol;
+export declare const SPEC_FORWARD_REF_TYPE: unique symbol;
+export declare const SPEC_MEMO_TYPE: unique symbol;
+export declare const SPEC_LAZY_TYPE: unique symbol;
+export declare const SPEC_SUSPENSE_TYPE: unique symbol;
+export declare const SPEC_STRICT_MODE_TYPE: unique symbol;
+export declare const SPEC_PROFILER_TYPE: unique symbol;
+/** A key used for reconciliation */
+export type Key = string | number | null;
+/** A ref can be a callback, an object, or null */
+export type Ref<T = unknown> = RefCallback<T> | RefObject<T> | null;
+export type RefCallback<T> = (instance: T | null) => void;
+export interface RefObject<T> {
+    current: T | null;
+}
+/** Props are an arbitrary key-value map */
+export type Props = Record<string, unknown> & {
+    children?: SpecNode;
+    key?: Key;
+    ref?: Ref;
+};
+/** Valid child types in a SpecifyJS tree */
+export type SpecChild = SpecElement | string | number | boolean | null | undefined;
+export type SpecNode = SpecChild | SpecNode[];
+/** A functional component */
+export type FunctionComponent<P extends Props = Props> = (props: P) => SpecNode;
+/** A class component constructor */
+export interface ClassComponentConstructor<P extends Props = Props, S = unknown> {
+    new (props: P): ClassComponentInstance<P, S>;
+    getDerivedStateFromProps?(props: P, state: S): Partial<S> | null;
+    getDerivedStateFromError?(error: unknown): Partial<S> | null;
+}
+/** Instance of a class component */
+export interface ClassComponentInstance<P extends Props = Props, S = unknown> {
+    props: P;
+    state: S;
+    setState(updater: Partial<S> | ((prevState: S, props: P) => Partial<S> | null)): void;
+    forceUpdate(callback?: () => void): void;
+    render(): SpecNode;
+    componentDidMount?(): void;
+    componentDidUpdate?(prevProps: P, prevState: S, snapshot?: unknown): void;
+    componentWillUnmount?(): void;
+    shouldComponentUpdate?(nextProps: P, nextState: S): boolean;
+    getSnapshotBeforeUpdate?(prevProps: P, prevState: S): unknown;
+    componentDidCatch?(error: unknown, info: ErrorInfo): void;
+    _fiber: unknown;
+    _pendingState: Array<Partial<S> | ((prevState: S, props: P) => Partial<S> | null)>;
+    _forceUpdate: boolean;
+    _enqueueUpdate(callback?: () => void): void;
+}
+export interface ErrorInfo {
+    componentStack: string;
+}
+/** A component type can be a function, a class, or a special symbol type */
+export type ComponentType<P extends Props = Props> = FunctionComponent<P> | ClassComponentConstructor<P> | string | symbol;
+/** The core element structure — equivalent to React.Element */
+export interface SpecElement<P extends Props = Props> {
+    $$typeof: typeof SPEC_ELEMENT_TYPE;
+    type: ComponentType<P>;
+    props: P;
+    key: Key;
+    ref: Ref;
+}
+/** Fiber node types for the reconciler */
+export declare const enum FiberTag {
+    FunctionComponent = 0,
+    ClassComponent = 1,
+    HostRoot = 2,
+    HostComponent = 3,
+    HostText = 4,
+    Fragment = 5,
+    ContextProvider = 6,
+    ContextConsumer = 7,
+    ForwardRef = 8,
+    MemoComponent = 9,
+    LazyComponent = 10,
+    SuspenseComponent = 11,
+    Profiler = 12,
+    Portal = 13
+}
+/** Effect flags for fiber work */
+export declare const enum EffectTag {
+    NoEffect = 0,
+    Placement = 1,
+    Update = 2,
+    Deletion = 4,
+    ChildDeletion = 8,
+    Snapshot = 16,
+    Passive = 32,
+    Layout = 64,
+    Ref = 128
+}
+/** Fiber node — the internal work unit */
+export interface Fiber<P extends Props = Props> {
+    tag: FiberTag;
+    type: ComponentType<P> | null;
+    key: Key;
+    ref: Ref;
+    stateNode: unknown;
+    pendingProps: P;
+    memoizedProps: P | null;
+    memoizedState: unknown;
+    return: Fiber | null;
+    child: Fiber | null;
+    sibling: Fiber | null;
+    index: number;
+    alternate: Fiber | null;
+    effectTag: EffectTag;
+    updateQueue: unknown;
+    dependencies: unknown;
+    lanes: number;
+    childLanes: number;
+}
+/** Context type */
+export interface SpecContext<T> {
+    $$typeof: symbol;
+    Provider: ComponentType;
+    Consumer: ComponentType;
+    _currentValue: T;
+    _defaultValue: T;
+    displayName?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types/shared/types.d.ts.map

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

package/dist/types/shared/warnings.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Issue a one-time warning (deduplicated by message).
+ */
+export declare function warn(message: string): void;
+/**
+ * Issue an error-level warning.
+ */
+export declare function error(message: string): void;
+/**
+ * Issue a deprecation warning (one-time, deduplicated).
+ * @param oldApi - The deprecated API name
+ * @param newApi - The replacement API name
+ * @param removeVersion - The version when the deprecated API will be removed
+ */
+export declare function deprecate(oldApi: string, newApi: string, removeVersion: string): void;
+/**
+ * Reset warned messages (for testing).
+ */
+export declare function resetWarnings(): void;
+//# sourceMappingURL=warnings.d.ts.map

package/dist/types/shared/warnings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warnings.d.ts","sourceRoot":"","sources":["../../../src/shared/warnings.ts"],"names":[],"mappings":"AAWA;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAS1C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAK3C;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAIrF;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAEpC"}

package/dist/types/telemetry/index.d.ts

@@ -0,0 +1,3 @@
+export { type TraceId, type SpanId, type TraceContext, type SpanKind, type SpanStatus, type SpanEvent, type Span, type StartSpanOptions, type TracerConfig, type Tracer, generateTraceId, generateSpanId, parseTraceparent, formatTraceparent, startSpan, endSpan, createTracer, useTracing, } from './tracing';
+export { type DataPoint, type Counter, type Histogram, type Gauge, type Instrument, type InstrumentOptions, type MeterProviderConfig, type MeterProvider, createMeterProvider, formatOtlpMetrics, formatOtlpTraces, exportToEndpoint, } from './metrics';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/telemetry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/telemetry/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,MAAM,EACX,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,IAAI,EACT,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,MAAM,EAEX,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,SAAS,EACT,OAAO,EACP,YAAY,EACZ,UAAU,GACX,MAAM,WAAW,CAAC;AAEnB,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,KAAK,EACV,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAElB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,WAAW,CAAC"}

package/dist/types/telemetry/metrics.d.ts

@@ -0,0 +1,68 @@
+import type { Span } from './tracing';
+export interface DataPoint {
+    value: number;
+    attributes: Record<string, string | number | boolean>;
+    timestamp: number;
+}
+export interface Counter {
+    readonly name: string;
+    readonly description: string;
+    /** Monotonically increment the counter. */
+    add(value: number, attributes?: Record<string, string | number | boolean>): void;
+    /** Read-only snapshot of data points. */
+    readonly dataPoints: ReadonlyArray<DataPoint>;
+}
+export interface Histogram {
+    readonly name: string;
+    readonly description: string;
+    /** Record a measurement. */
+    record(value: number, attributes?: Record<string, string | number | boolean>): void;
+    /** Read-only snapshot of data points. */
+    readonly dataPoints: ReadonlyArray<DataPoint>;
+}
+export interface Gauge {
+    readonly name: string;
+    readonly description: string;
+    /** Set the current value. */
+    set(value: number, attributes?: Record<string, string | number | boolean>): void;
+    /** Read-only snapshot of data points. */
+    readonly dataPoints: ReadonlyArray<DataPoint>;
+}
+export type Instrument = Counter | Histogram | Gauge;
+export interface InstrumentOptions {
+    description?: string;
+    unit?: string;
+}
+export interface MeterProviderConfig {
+    serviceName: string;
+    endpoint?: string;
+    headers?: Record<string, string>;
+    exportInterval?: number;
+}
+export interface MeterProvider {
+    counter(name: string, opts?: InstrumentOptions): Counter;
+    histogram(name: string, opts?: InstrumentOptions): Histogram;
+    gauge(name: string, opts?: InstrumentOptions): Gauge;
+    /** Export all instrument data to the configured endpoint. */
+    flush(): Promise<void>;
+    /** Read-only access to all registered instruments. */
+    readonly instruments: ReadonlyArray<Instrument>;
+    readonly config: Readonly<MeterProviderConfig>;
+}
+export declare function createMeterProvider(config: MeterProviderConfig): MeterProvider;
+/**
+ * Build an OTLP-compatible JSON payload for metrics.
+ *
+ * Structure follows the OTLP/HTTP JSON proto mapping:
+ * https://opentelemetry.io/docs/specs/otlp/#otlphttp
+ */
+export declare function formatOtlpMetrics(instruments: ReadonlyArray<Instrument>, serviceName?: string): Record<string, unknown>;
+/**
+ * Build an OTLP-compatible JSON payload for traces/spans.
+ */
+export declare function formatOtlpTraces(spans: ReadonlyArray<Span>, serviceName?: string, serviceVersion?: string): Record<string, unknown>;
+/**
+ * Send a JSON payload to an OTLP-compatible endpoint via `fetch`.
+ */
+export declare function exportToEndpoint(url: string, headers: Record<string, string>, body: Record<string, unknown>): Promise<void>;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/types/telemetry/metrics.d.ts.map

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

package/dist/types/telemetry/tracing.d.ts

@@ -0,0 +1,96 @@
+/** 16-byte (32 hex char) trace identifier. */
+export type TraceId = string;
+/** 8-byte (16 hex char) span identifier. */
+export type SpanId = string;
+/** W3C Trace Context carrier. */
+export interface TraceContext {
+    traceId: TraceId;
+    spanId: SpanId;
+    traceFlags: string;
+    parentSpanId?: SpanId;
+}
+/** Generate a 32-hex-char trace ID (16 random bytes). */
+export declare function generateTraceId(): TraceId;
+/** Generate a 16-hex-char span ID (8 random bytes). */
+export declare function generateSpanId(): SpanId;
+/**
+ * Parse a W3C `traceparent` header.
+ *
+ * Format: `{version}-{traceId}-{spanId}-{traceFlags}`
+ * Returns `null` when the header is invalid.
+ */
+export declare function parseTraceparent(header: string): TraceContext | null;
+/**
+ * Format a {@link TraceContext} as a W3C `traceparent` header string.
+ *
+ * Output: `00-{traceId}-{spanId}-{traceFlags}`
+ */
+export declare function formatTraceparent(ctx: TraceContext): string;
+export type SpanKind = 'internal' | 'server' | 'client' | 'producer' | 'consumer';
+export interface SpanStatus {
+    code: 'unset' | 'ok' | 'error';
+    message?: string;
+}
+export interface SpanEvent {
+    name: string;
+    timestamp: number;
+    attributes?: Record<string, string | number | boolean>;
+}
+export interface Span {
+    traceId: TraceId;
+    spanId: SpanId;
+    parentSpanId?: SpanId;
+    name: string;
+    kind: SpanKind;
+    startTime: number;
+    endTime?: number;
+    status: SpanStatus;
+    attributes: Record<string, string | number | boolean>;
+    events: SpanEvent[];
+}
+export interface StartSpanOptions {
+    kind?: SpanKind;
+    parentSpanId?: SpanId;
+    traceId?: TraceId;
+    attributes?: Record<string, string | number | boolean>;
+}
+/**
+ * Create and start a new span. The span is **not** automatically associated
+ * with a tracer — use {@link Tracer.startSpan} for automatic parent tracking.
+ */
+export declare function startSpan(name: string, opts?: StartSpanOptions): Span;
+/** End a span by recording its end time. */
+export declare function endSpan(span: Span): void;
+export interface TracerConfig {
+    serviceName: string;
+    serviceVersion?: string;
+    endpoint?: string;
+    headers?: Record<string, string>;
+    batchSize?: number;
+    flushInterval?: number;
+}
+export interface Tracer {
+    /** Create a span, automatically parented to the current active span. */
+    startSpan(name: string, opts?: StartSpanOptions): Span;
+    /**
+     * Execute `fn` with `span` as the active span. The span is automatically
+     * ended when `fn` completes (sync or async). The previous active span is
+     * restored afterward.
+     */
+    withSpan<T>(span: Span, fn: () => T): T;
+    /** Export all pending (buffered) spans to the configured endpoint. */
+    flush(): Promise<void>;
+    /** Access the currently-active span (top of the span stack), or `undefined`. */
+    activeSpan(): Span | undefined;
+    /** Read-only view of the pending span buffer. */
+    readonly pendingSpans: ReadonlyArray<Span>;
+    /** Tracer configuration. */
+    readonly config: Readonly<TracerConfig>;
+}
+export declare function createTracer(config: TracerConfig): Tracer;
+/**
+ * Hook that creates a span for the component render lifecycle.
+ * Auto-starts on mount, records render duration, ends on unmount.
+ */
+export declare function useTracing(tracer: Tracer, name: string): void;
+//# sourceMappingURL=tracing.d.ts.map

package/dist/types/telemetry/tracing.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asymmetric-effort/specifyjs",
-  "version": "0.2.98",
+  "version": "0.2.100",
   "description": "A declarative TypeScript UI framework built for performance and simplicity",
   "publishConfig": {
     "access": "public"
@@ -69,11 +69,11 @@
     "dist"
   ],
   "scripts": {
-    "build": "bun x rollup -c",
-    "dev": "bun x rollup -c -w",
-    "test": "bun x vitest run --pool forks --no-file-parallelism",
-    "test:watch": "bun x vitest",
-    "test:coverage": "bun x vitest run --pool forks --no-file-parallelism --coverage",
+    "build": "node build.mjs",
+    "dev": "node build.mjs",
+    "test": "bun --preload ./tests/setup-nogginlessdom.ts --preload ./tests/setup.ts test tests/ ../components/",
+    "test:watch": "bun --preload ./tests/setup-nogginlessdom.ts --preload ./tests/setup.ts test --watch tests/ ../components/",
+    "test:coverage": "bun --preload ./tests/setup-nogginlessdom.ts --preload ./tests/setup.ts test --coverage tests/ ../components/",
     "test:e2e": "bun x playwright test",
     "dev:e2e": "bun x vite --port 3000",
     "lint": "bun x eslint src/ tests/",
@@ -93,25 +93,16 @@
   ],
   "license": "MIT",
   "devDependencies": {
-    "@asymmetric-effort/nogginlessdom": "^0.0.5",
+    "@asymmetric-effort/nogginlessdom": "^0.0.16",
     "@playwright/test": "^1.59.0",
-    "@rollup/plugin-node-resolve": "^16.0.0",
-    "@rollup/plugin-terser": "^1.0.0",
-    "@rollup/plugin-typescript": "^12.0.0",
     "@types/node": "^25.6.2",
     "@typescript-eslint/eslint-plugin": "^8.0.0",
     "@typescript-eslint/parser": "^8.0.0",
-    "@vitest/coverage-istanbul": "^4.1.5",
-    "@vitest/coverage-v8": "^4.1.5",
     "eslint": "^10.3.0",
-    "jsdom": "^29.1.1",
     "prettier": "^3.0.0",
-    "rollup": "^4.0.0",
-    "rollup-plugin-dts": "^6.0.0",
     "tslib": "^2.6.0",
     "typescript": "^5.6.0",
-    "vite": "^6.4.2",
-    "vitest": "^4.1.5"
+    "vite": "^6.4.2"
   },
   "engines": {
     "node": ">=24.0.0"