@faclon-labs/app-sdk 0.1.0 → 0.3.0

package/vendor/map-engine/runtime/overlays.js

@@ -0,0 +1,65 @@
+import { geometryFamily } from '../core/geometry-family.js';
+import { scaled } from '../present/present.js';
+const FAMILY = { area: 'areas', line: 'lines', point: 'points' };
+const kindOf = (o) => FAMILY[geometryFamily(o.geometry.type)];
+export const ANNOTATION_LAYER = (k) => `__annotations-${k}`;
+export const PROPOSAL_LAYER = (k) => `__proposals-${k}`;
+export const HIGHLIGHT_LAYER = (k) => `__highlight-${k}`;
+const KINDS = ['areas', 'lines', 'points'];
+export const ANNOTATION_COLOR = '#7A3FD6';
+export const PROPOSAL_COLOR = '#D97706';
+export const HIGHLIGHT_COLOR = '#F59E0B';
+const selectable = { selectable: true, hoverable: true };
+const quiet = { selectable: false, hoverable: false };
+function trio(id, z, color, opts) {
+    const label = opts.label ? { label: { property: 'label', size: 11 } } : {};
+    return [
+        { id: id('areas'), source: {}, visible: true, zIndex: z, interaction: opts.interaction, visualization: { type: 'polygon', style: [{ style: { color, opacity: opts.fill ?? 0.14, strokeColor: color, strokeWidth: 2, ...(opts.dash ? { dash: opts.dash } : {}) } }], ...label } },
+        { id: id('lines'), source: {}, visible: true, zIndex: z + 0.1, interaction: opts.interaction, visualization: { type: 'line', style: [{ style: { color, size: opts.lineWidth ?? 3, ...(opts.dash ? { dash: opts.dash } : {}) } }], ...label } },
+        { id: id('points'), source: {}, visible: true, zIndex: z + 0.2, interaction: opts.interaction, visualization: { type: 'marker', icon: { shape: opts.pointShape ?? 'diamond', size: opts.pointSize ?? 18 }, style: [{ style: { color, strokeColor: '#FFFFFF', opacity: opts.pointOpacity ?? 1 } }], ...label } },
+    ];
+}
+export const ANNOTATION_LAYERS = trio(ANNOTATION_LAYER, 9_000, ANNOTATION_COLOR, { interaction: selectable, label: true });
+export const PROPOSAL_LAYERS = trio(PROPOSAL_LAYER, 9_100, PROPOSAL_COLOR, { interaction: selectable, label: true, dash: [2, 1.5], fill: 0.1 });
+/** A wide translucent halo under nothing but the draft: the objects keep their own look, the halo marks them. */
+export function highlightLayers(color) {
+    return trio(HIGHLIGHT_LAYER, 9_500, color, { interaction: quiet, fill: 0.28, lineWidth: 12, pointSize: 44, pointOpacity: 0.4, pointShape: 'circle' });
+}
+/** The engine layer ids that carry objects people can select (annotations, proposals). */
+export const SELECTABLE_OVERLAYS = new Set([...ANNOTATION_LAYERS, ...PROPOSAL_LAYERS].map((l) => l.id));
+export const isOverlayLayer = (id) => id.startsWith('__annotations-') || id.startsWith('__proposals-') || id.startsWith('__highlight-');
+/** Per-object look from an annotation's own style, as `$s:` values the renderers read before the layer's rules. */
+function ownStyle(style) {
+    const out = {};
+    for (const k of ['color', 'strokeColor', 'opacity', 'size', 'strokeWidth'])
+        if (style?.[k] !== undefined)
+            out[scaled(k)] = style[k];
+    return out;
+}
+const empty = (id) => Object.fromEntries(KINDS.map((k) => [id(k), []]));
+export function annotationObjects(list) {
+    const out = empty(ANNOTATION_LAYER);
+    for (const a of list) {
+        const o = { objectId: a.id, geometry: a.geometry, properties: { label: a.label ?? '', note: a.note ?? '', kind: a.kind, ...(a.author ? { author: a.author } : {}), ...ownStyle(a.style) } };
+        out[ANNOTATION_LAYER(kindOf(o))].push(o);
+    }
+    return out;
+}
+export function proposalObjects(list) {
+    const out = empty(PROPOSAL_LAYER);
+    for (const p of list) {
+        const o = { objectId: p.id, geometry: p.geometry, properties: { label: p.label ? `Proposed: ${p.label}` : 'Proposed', note: p.note ?? '', origin: p.origin } };
+        out[PROPOSAL_LAYER(kindOf(o))].push(o);
+    }
+    return out;
+}
+/** Halo objects for the highlighted ids that are on the map now (they follow their objects). */
+export function highlightObjects(h, lookup) {
+    const out = empty(HIGHLIGHT_LAYER);
+    for (const id of h?.objectIds ?? []) {
+        const o = lookup(id);
+        if (o)
+            out[HIGHLIGHT_LAYER(kindOf(o))].push({ objectId: id, geometry: o.geometry });
+    }
+    return out;
+}

package/vendor/map-engine/runtime/runtime.d.ts

@@ -0,0 +1,4 @@
+import type { MapConfig } from '../core/types.js';
+export type { RuntimeState, MapRuntimeEvents, LayerFilter, ObjectInspection, FlyToOptions, LineOfSightOptions, MapRuntimeDeps, MapRuntimeStats, MapRuntimeOptions, MapRuntime, ResolvedReference } from './types.js';
+import type { MapRuntimeDeps, MapRuntimeOptions, MapRuntime } from './types.js';
+export declare function createMapRuntime(config: MapConfig, deps: MapRuntimeDeps, options?: MapRuntimeOptions): MapRuntime;