@nativemason/contracts 0.0.0-stage → 0.2.0

package/dist/graph.js

@@ -0,0 +1,36 @@
+import { AccessibilityEvidenceSchema } from './accessibility.js';
+import { TextFitEvidenceSchema, NativeTargetSchema } from './workflow.js';
+import { z } from 'zod';
+import { DeviceProfileSchema, RectSchema } from './geometry.js';
+import { SourceRefSchema, SourceRevisionsSchema } from './source.js';
+export const AuthoredTextPropsSchema = z.object({ fontSize: z.number().nonnegative().optional(), lineHeight: z.number().nonnegative().optional(), numberOfLines: z.number().int().positive().optional(), allowFontScaling: z.boolean().optional(), ellipsizeMode: z.enum(['head', 'middle', 'tail', 'clip']).optional() }).strict();
+export const TextMetricsSchema = z.object({ lineCount: z.number().int().nonnegative() }).strict();
+export const DiagnosticEvidenceSchema = z.enum(['confirmed', 'clear', 'unknown']);
+export const WebNodeDiagnosticsSchema = z.object({
+    clipping: DiagnosticEvidenceSchema,
+    centerHitTest: DiagnosticEvidenceSchema,
+    scrollOverflow: z.object({ horizontal: z.boolean(), vertical: z.boolean() }).strict(),
+    paintOrder: z.number().int().nullable(),
+    fonts: z.array(z.object({ family: z.string(), glyphCount: z.number().int().nonnegative(), isCustom: z.boolean().nullable() }).strict()),
+    lineBoxCount: z.number().int().nonnegative().nullable(),
+}).strict();
+export const WebDiagnosticsSchema = z.object({ nodes: z.record(z.string(), WebNodeDiagnosticsSchema), warnings: z.array(z.object({ elementId: z.string(), code: z.enum(['CLIPPED', 'OCCLUDED', 'FONT_LOAD_FAILED', 'EVIDENCE_UNAVAILABLE']), severity: z.enum(['confirmed', 'uncertain']), message: z.string() }).strict()) }).strict();
+export const SpatialNodeSchema = z.object({ id: z.string().min(1), parentId: z.string().nullable(), kind: z.enum(['View', 'Text', 'Pressable', 'TextInput', 'ScrollView', 'Image']), role: z.string().nullable(), rect: RectSchema, styles: z.record(z.string(), z.unknown()), source: SourceRefSchema.nullable(), editable: z.boolean(), editReason: z.string().nullable(), pressableState: z.enum(['pressed', 'rest']).optional(), accessibility: AccessibilityEvidenceSchema.optional(), textFit: TextFitEvidenceSchema.optional(), authoredTextProps: AuthoredTextPropsSchema.optional(), measuredLineCount: z.number().int().nonnegative().optional() }).strict();
+export const SpatialSnapshotSchema = z.object({ schemaVersion: z.literal(1), sessionId: z.string(), snapshotId: z.string(), platform: z.enum(['web', 'android', 'ios']), scenarioId: z.string(), profile: DeviceProfileSchema, revisions: SourceRevisionsSchema, nodes: z.array(SpatialNodeSchema), status: z.enum(['stable', 'unstable']), generation: z.number().int().nonnegative(), nativeTarget: NativeTargetSchema.optional(), webDiagnostics: WebDiagnosticsSchema.optional() }).strict().superRefine((snapshot, ctx) => {
+    if (snapshot.platform !== 'web' && snapshot.webDiagnostics)
+        ctx.addIssue({ code: 'custom', message: 'Web diagnostics cannot appear in Android snapshots', path: ['webDiagnostics'] });
+    snapshot.nodes.forEach((node, i) => {
+        if (snapshot.platform !== 'web' && node.accessibility?.directionSource === 'browser-computed')
+            ctx.addIssue({ code: 'custom', message: 'Browser direction evidence cannot appear in native snapshots', path: ['nodes', i, 'accessibility', 'directionSource'] });
+        if (snapshot.platform !== 'web' && node.accessibility?.browser)
+            ctx.addIssue({ code: 'custom', message: 'Browser accessibility evidence cannot appear in native snapshots', path: ['nodes', i, 'accessibility', 'browser'] });
+        for (const dependency of node.source?.dependencies ?? [])
+            if (!snapshot.revisions[dependency])
+                ctx.addIssue({ code: 'custom', message: 'Required style dependency revision is missing', path: ['nodes', i, 'source', 'dependencies'], params: { bridgeCode: 'STALE_SOURCE' } });
+        if (node.source && snapshot.revisions[node.source.path] !== node.source.hash)
+            ctx.addIssue({ code: 'custom', message: 'Node source hash disagrees with snapshot revisions', path: ['nodes', i, 'source', 'hash'], params: { bridgeCode: 'STALE_SOURCE' } });
+    });
+});
+export const SpatialDeltaSchema = z.object({ added: z.array(z.string()), removed: z.array(z.string()), changed: z.array(z.object({ id: z.string(), before: RectSchema, after: RectSchema, delta: RectSchema.extend({ width: z.number(), height: z.number() }) })) });
+export const OverlaySceneSchema = z.object({ width: z.number(), height: z.number(), marks: z.array(z.object({ label: z.number(), id: z.string(), rect: RectSchema })), targets: z.array(z.object({ id: z.string(), rect: RectSchema })) });
+export const ProfileOverridesSchema = z.object({ fontScale: z.number().positive().optional(), orientation: z.enum(['portrait', 'landscape']).optional() }).strict().refine(value => Object.keys(value).length > 0, 'Profile override must set a value');

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export * from './geometry.js';
+export * from './styles.js';
+export * from './source.js';
+export * from './graph.js';
+export * from './constraints.js';
+export * from './native-protocol.js';
+export * from './tools.js';
+export * from './workflow.js';
+export * from './diagnostics.js';
+export * from './design.js';
+export * from './accessibility.js';
+export * from './evidence.js';

package/dist/index.js

@@ -0,0 +1,12 @@
+export * from './geometry.js';
+export * from './styles.js';
+export * from './source.js';
+export * from './graph.js';
+export * from './constraints.js';
+export * from './native-protocol.js';
+export * from './tools.js';
+export * from './workflow.js';
+export * from './diagnostics.js';
+export * from './design.js';
+export * from './accessibility.js';
+export * from './evidence.js';