@mark1russell7/visuals 0.1.1 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +60 -6
- package/build/globe.d.ts +7 -7
- package/build/globe.js +35 -35
- package/build/globe.js.map +1 -1
- package/build/index.d.ts +2 -2
- package/build/index.js +2 -2
- package/build/marks.d.ts +192 -0
- package/build/marks.d.ts.map +1 -0
- package/build/marks.js +231 -0
- package/build/marks.js.map +1 -0
- package/build/{motion-BwDDtx3D.js → motion-0tsT6sY4.js} +10 -10
- package/build/motion-0tsT6sY4.js.map +1 -0
- package/build/{stage-C9NHD-6Q.d.ts → stage-CtWLSoV-.d.ts} +6 -6
- package/build/{stage-C9NHD-6Q.d.ts.map → stage-CtWLSoV-.d.ts.map} +1 -1
- package/build/{theme-CJ2SAcHX.d.ts → theme-CKXd_emk.d.ts} +12 -12
- package/build/theme-CKXd_emk.d.ts.map +1 -0
- package/build/three.d.ts +1 -1
- package/build/three.js +18 -18
- package/build/three.js.map +1 -1
- package/package.json +9 -3
- package/build/motion-BwDDtx3D.js.map +0 -1
- package/build/theme-CJ2SAcHX.d.ts.map +0 -1
package/build/three.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"three.js","names":["World"],"sources":["../src/stage/stage.ts"],"sourcesContent":["import { DirectionalLight, HemisphereLight, PerspectiveCamera, Raycaster, Scene as World, Vector2, WebGLRenderer, type Object3D } from \"three\";\nimport { OrbitControls } from \"three/addons/controls/OrbitControls.js\";\nimport { nearDepth, stageLimits, surfaceOf, type StageExtent, type StageLimits, type StageView, type ViewFrame } from \"../extent.ts\";\nimport { keyAction } from \"../keys.ts\";\nimport { isClick, markOf, NO_MARKS, type Mark, type Marks } from \"../marks.ts\";\nimport { moveAt, type Move } from \"../motion.ts\";\nimport type { StageTheme } from \"../theme.ts\";\nimport { cameraPosition, clampPlace, speedAt, viewOf, type Place } from \"../view.ts\";\n\n/** The record under the pointer: its name, and the value that the content gives for it. */\nexport interface StagePick<P> {\n /** The name of the record. The marks of the stage use this name. */\n readonly record: string;\n /** The value of the record for the page, for example its kind and its source. */\n readonly value: P;\n}\n\n/** One picture of a stage, for the step of its content. */\nexport interface StageFrame {\n readonly camera: PerspectiveCamera;\n /** The time since the last picture, in seconds. */\n readonly seconds: number;\n /**\n * This value is true for the first picture of a content, and for a person who asks for less motion.\n * Each change then has no time: the content sets each value to its goal immediately.\n */\n readonly settle: boolean;\n /** The height of the picture, in CSS pixels. */\n readonly height: number;\n /** The vertical angle of the picture, in degrees. */\n readonly fieldOfView: number;\n}\n\n/**\n * The content of a stage: the three.js objects of one scene, and what the stage asks of them.\n * `P` is the type of the value of a pick, and `T` is the type of the theme.\n */\nexport interface StageContent<P, T extends StageTheme = StageTheme> {\n /** The three.js objects of the content. The stage adds them to its world, and removes them. */\n readonly objects: readonly Object3D[];\n /** The space that the content fills. */\n readonly extent: StageExtent;\n /** This function tells if the content has a record with a name. */\n has(record: string): boolean;\n /** This function gives the record that a ray from the camera finds first, or `undefined` for no record. */\n pick(ray: Raycaster): StagePick<P> | undefined;\n /** This function gives each part its colors, from the theme and the mark of its record. */\n paint(theme: T, mark: (record: string) => Mark): void;\n /**\n * This function changes the parts that depend on the camera or on the time, before each picture.\n * It gives true while a part continues to change. The stage then makes the next picture.\n */\n step?(frame: StageFrame): boolean;\n /** This function releases the memory of the graphics card that the content uses. */\n dispose(): void;\n}\n\n/** The lights of a stage. A content with materials that use no light ignores them. */\nexport interface StageLights {\n /** The strength of the light from above and below. */\n readonly sky: number;\n /** The strength of the light from one direction. */\n readonly sun: number;\n /** The position that the light from one direction comes from. */\n readonly from: { readonly x: number; readonly y: number; readonly z: number };\n}\n\n/** The options of a stage. */\nexport interface StageOptions<P, T extends StageTheme = StageTheme> {\n /** The first content. The stage disposes each content that it gets. */\n readonly content: StageContent<P, T>;\n readonly theme: T;\n /** The name of the picture for a screen reader. */\n readonly label: string;\n /** The views of the stage, each with a name. */\n readonly views: Readonly<Record<string, StageView>>;\n /** The name of the first view. The keys `Home` and `0` show it. */\n readonly home: string;\n /** The name of the view of a key, for example `{ t: \"top\" }`. A letter has no case. */\n readonly keys?: Readonly<Record<string, string>> | undefined;\n /** The vertical angle of the picture, in degrees. A small angle gives the look of a drawing. The default is 32. */\n readonly fieldOfView?: number | undefined;\n /** The smallest and the largest polar angle of the camera, in radians. The default keeps the camera above the plane of the target. */\n readonly polar?: { readonly min?: number | undefined; readonly max?: number | undefined } | undefined;\n /** This value is true if a person can move the target with a drag of the second button. The default is true. */\n readonly pan?: boolean | undefined;\n readonly lights?: StageLights | undefined;\n /** The stage starts this function when the pointer goes to a different record, or to no record. */\n readonly onHover?: ((pick: P | undefined) => void) | undefined;\n /** The stage starts this function when a person selects a record with the pointer, or selects no record. */\n readonly onSelect?: ((pick: P | undefined) => void) | undefined;\n}\n\n/** A stage in a page: one canvas with a camera that a person moves, and one content. */\nexport interface Stage<P, T extends StageTheme = StageTheme> {\n /** The canvas of the stage. It is in the container. */\n readonly canvas: HTMLCanvasElement;\n /** This function shows a different content, and disposes the old content. The view stays if a person moved it. */\n setContent(content: StageContent<P, T>): void;\n /** This function changes the colors. */\n setTheme(theme: T): void;\n /** This function moves the camera to a view: a name of the options, or a view function. `animate` has the default true. */\n setView(view: string | StageView, animate?: boolean): void;\n /** This function gives the place of the camera. */\n place(): Place;\n /** This function marks records by their names, as the pointer does. An empty list removes the marks. */\n highlight(records: readonly string[]): void;\n /** This function selects one record by its name, or no record. It does not start `onSelect`. */\n select(record: string | undefined): void;\n /** This function paints the content again and makes a new picture. Use it after a change of the content. */\n refresh(): void;\n /** This function removes the canvas and releases the memory of the graphics card. It disposes the content. */\n dispose(): void;\n}\n\n/** The default vertical angle of the picture, in degrees. */\nexport const FIELD_OF_VIEW = 32;\n\n/** The default lights: a strong light from above and below, and a light from the front left. */\nexport const STAGE_LIGHTS: StageLights = { sky: 2.2, sun: 1.5, from: { x: -10, y: 24, z: 15 } };\n\n/** The time of the move between two views, in milliseconds. */\nconst MOVE_TIME = 380;\n\n/** The turn of the camera for a drag across the height of the picture, as a part of a full turn, far from the surface. */\nconst TURN_SPEED = 0.9;\n\n/** The smallest polar angle. At 0, the azimuth of a camera has no meaning. */\nconst SMALLEST_POLAR = 0.0005;\n\n/** The default largest polar angle: the camera stays above the plane of the target. */\nconst LARGEST_POLAR = Math.PI / 2 - 0.05;\n\n/** This function tells if the person asks for less motion. */\nfunction lessMotion(): boolean {\n return typeof matchMedia === \"function\" && matchMedia(\"(prefers-reduced-motion: reduce)\").matches;\n}\n\n/**\n * This function makes a stage in a container of a page. The stage fills the container, so give the container a size.\n *\n * A person turns the content with a drag, and moves nearer with the wheel after a click in the picture.\n * A click selects the record under the pointer. With the keyboard, the arrow keys turn the content, `+` and `-` change the distance,\n * and `Home` shows the first view. The stage makes a picture only after a change.\n *\n * The function gives `undefined` when the browser has no WebGL 2. It does not throw, and it writes no error to the console.\n * The page then shows a different picture of the same data.\n */\nexport function createStage<P, T extends StageTheme = StageTheme>(container: HTMLElement, options: StageOptions<P, T>): Stage<P, T> | undefined {\n const canvas = container.ownerDocument.createElement(\"canvas\");\n const context = canvas.getContext(\"webgl2\", { alpha: true, antialias: true, depth: true, stencil: false, premultipliedAlpha: true, powerPreference: \"default\" });\n if (context === null) return undefined;\n let renderer: WebGLRenderer;\n try {\n renderer = new WebGLRenderer({ canvas, context, alpha: true, antialias: true });\n } catch {\n return undefined;\n }\n renderer.setClearColor(0x000000, 0);\n\n canvas.style.display = \"block\";\n canvas.style.width = \"100%\";\n canvas.style.height = \"100%\";\n canvas.style.cursor = \"grab\";\n canvas.style.touchAction = \"none\";\n canvas.tabIndex = 0;\n canvas.setAttribute(\"role\", \"application\");\n canvas.setAttribute(\"aria-label\", options.label);\n container.append(canvas);\n\n const fieldOfView = options.fieldOfView ?? FIELD_OF_VIEW;\n const polar = { min: options.polar?.min ?? SMALLEST_POLAR, max: options.polar?.max ?? LARGEST_POLAR };\n const lights = options.lights ?? STAGE_LIGHTS;\n const world = new World();\n const sky = new HemisphereLight(\"#ffffff\", \"#ffffff\", lights.sky);\n const sun = new DirectionalLight(\"#ffffff\", lights.sun);\n sun.position.set(lights.from.x, lights.from.y, lights.from.z);\n world.add(sky, sun);\n const camera = new PerspectiveCamera(fieldOfView, 1, 0.05, 1000);\n\n let content = options.content;\n let theme = options.theme;\n for (const object of content.objects) world.add(object);\n\n let marks: Marks = NO_MARKS;\n let view: string | StageView = options.home;\n let move: Move | undefined;\n /** This value is true after a person moved the view. Then a new size of the container does not move the camera. */\n let moved = false;\n /** This value is true until the content had a step with no time. */\n let settle = true;\n /** The height of the picture, in CSS pixels. */\n let height = 1;\n let frame = 0;\n let lastTime = 0;\n let disposed = false;\n\n const invalidate = (): void => {\n if (frame === 0 && !disposed) frame = requestAnimationFrame(tick);\n };\n\n const controls = new OrbitControls(camera, canvas);\n controls.enableDamping = !lessMotion();\n controls.dampingFactor = 0.14;\n controls.minPolarAngle = polar.min;\n controls.maxPolarAngle = polar.max;\n controls.rotateSpeed = TURN_SPEED;\n controls.screenSpacePanning = true;\n controls.enablePan = options.pan ?? true;\n // The wheel moves the page until a person uses the picture. Thus the picture does not stop a person who reads down the page.\n controls.enableZoom = false;\n\n const viewFrame = (): ViewFrame => ({ extent: content.extent, fieldOfView, aspect: camera.aspect });\n let limits: StageLimits = stageLimits(viewFrame(), Object.values(options.views), polar);\n\n const paint = (): void => {\n const now = marks;\n content.paint(theme, (record) => markOf(now, record));\n invalidate();\n };\n\n /** This function sets the turn speed and the zoom speed from the height of the camera above the surface. */\n const setSpeed = (): void => {\n const speed = speedAt(camera.position.distanceTo(controls.target), surfaceOf(content.extent));\n controls.rotateSpeed = TURN_SPEED * speed;\n controls.zoomSpeed = speed;\n };\n const placeNow = (): Place => {\n const target = { x: controls.target.x, y: controls.target.y, z: controls.target.z };\n return { target, ...viewOf(camera.position, target) };\n };\n const put = (to: Place): void => {\n const next = clampPlace(to, limits);\n const eye = cameraPosition(next.target, next, next.distance);\n controls.target.set(next.target.x, next.target.y, next.target.z);\n camera.position.set(eye.x, eye.y, eye.z);\n camera.lookAt(controls.target);\n setSpeed();\n };\n /** This function gives the view function of a view, or `undefined` for a name that the options do not have. */\n const viewFunction = (of: string | StageView): StageView | undefined => (typeof of === \"string\" ? options.views[of] : of);\n\n /**\n * This function sets the nearest depth that the camera draws, from the distance of the camera to the content.\n * A camera far from the content then has small steps of depth at the content, so a layer near a surface stays above it.\n */\n const setDepth = (): void => {\n const { center } = content.extent;\n const distance = Math.hypot(camera.position.x - center.x, camera.position.y - center.y, camera.position.z - center.z);\n const near = nearDepth(limits, content.extent, distance);\n if (near === camera.near && limits.far === camera.far) return;\n camera.near = near;\n camera.far = limits.far;\n camera.updateProjectionMatrix();\n };\n /** This function sets the limits of the camera from the content and the shape of the picture. */\n const setLimits = (): void => {\n limits = stageLimits(viewFrame(), Object.values(options.views), polar);\n controls.minDistance = limits.minDistance;\n controls.maxDistance = limits.maxDistance;\n setDepth();\n };\n /**\n * This function stops the turn that continues after a drag. The camera stays where it is.\n * Without it, the camera continues to turn after a move to a view, and the view is not exact.\n */\n const stopDrift = (): void => {\n if (!controls.enableDamping) return;\n const now = placeNow();\n // With no damping, an update of the controls uses all of the turn that remains. The camera then goes back.\n controls.enableDamping = false;\n controls.update();\n controls.enableDamping = true;\n put(now);\n };\n const goTo = (next: string | StageView, animate: boolean): void => {\n const found = viewFunction(next);\n if (found === undefined) return;\n view = next;\n moved = false;\n stopDrift();\n const to = found(viewFrame());\n if (animate && !lessMotion()) {\n move = { from: placeNow(), to, start: performance.now(), duration: MOVE_TIME };\n } else {\n move = undefined;\n put(to);\n }\n invalidate();\n };\n\n /** This function sets the size of the picture from the size of the container. It gives false for a container with no size. */\n const setSize = (): boolean => {\n const width = container.clientWidth;\n const tall = container.clientHeight;\n if (width === 0 || tall === 0) return false;\n height = tall;\n renderer.setPixelRatio(Math.min(globalThis.devicePixelRatio, 2));\n renderer.setSize(width, tall, false);\n camera.aspect = width / tall;\n camera.updateProjectionMatrix();\n return true;\n };\n\n /** This function moves the camera one step of a move between two views. It gives true while the move continues. */\n const stepMove = (now: number): boolean => {\n if (move === undefined) return false;\n const step = moveAt(move, now, surfaceOf(content.extent));\n put(step.place);\n if (step.done) move = undefined;\n return true;\n };\n\n function tick(now: number): void {\n frame = 0;\n if (disposed) return;\n const seconds = lastTime === 0 ? 1 / 60 : Math.min((now - lastTime) / 1000, 0.1);\n let active = stepMove(now);\n setSpeed();\n active = controls.update() || active;\n setDepth();\n const stepped = content.step?.({ camera, seconds, settle: settle || lessMotion(), height, fieldOfView }) ?? false;\n settle = false;\n renderer.render(world, camera);\n active = stepped || active;\n lastTime = active ? now : 0;\n if (active) invalidate();\n }\n\n const raycaster = new Raycaster();\n const pointer = new Vector2();\n /** This function gives the record under a pointer. */\n const pickAt = (event: PointerEvent): StagePick<P> | undefined => {\n const box = canvas.getBoundingClientRect();\n if (box.width === 0 || box.height === 0) return undefined;\n pointer.set(((event.clientX - box.left) / box.width) * 2 - 1, 1 - ((event.clientY - box.top) / box.height) * 2);\n raycaster.setFromCamera(pointer, camera);\n return content.pick(raycaster);\n };\n\n const setHover = (pick: StagePick<P> | undefined): void => {\n const record = pick?.record;\n if (record === marks.hovered) return;\n marks = { ...marks, hovered: record };\n canvas.style.cursor = record === undefined ? \"grab\" : \"pointer\";\n paint();\n options.onHover?.(pick?.value);\n };\n\n const listeners = new AbortController();\n const signal = listeners.signal;\n let down: { readonly id: number; readonly x: number; readonly y: number } | undefined;\n const setInUse = (inUse: boolean): void => {\n controls.enableZoom = inUse;\n };\n canvas.addEventListener(\n \"pointerdown\",\n (event) => {\n setInUse(true);\n canvas.focus({ preventScroll: true });\n down = { id: event.pointerId, x: event.clientX, y: event.clientY };\n },\n { signal },\n );\n canvas.addEventListener(\n \"pointermove\",\n (event) => {\n if (event.buttons === 0 && event.pointerType !== \"touch\") setHover(pickAt(event));\n },\n { signal },\n );\n canvas.addEventListener(\n \"pointerup\",\n (event) => {\n const start = down;\n down = undefined;\n if (start === undefined || start.id !== event.pointerId) return;\n if (!isClick(start, { x: event.clientX, y: event.clientY })) return;\n const pick = pickAt(event);\n marks = { ...marks, selected: pick?.record };\n paint();\n options.onSelect?.(pick?.value);\n },\n { signal },\n );\n canvas.addEventListener(\n \"pointercancel\",\n () => {\n down = undefined;\n },\n { signal },\n );\n canvas.addEventListener(\n \"pointerleave\",\n (event) => {\n setHover(undefined);\n if (event.pointerType === \"mouse\") setInUse(false);\n },\n { signal },\n );\n canvas.addEventListener(\"blur\", () => setInUse(false), { signal });\n canvas.addEventListener(\n \"keydown\",\n (event) => {\n if (event.altKey || event.ctrlKey || event.metaKey) return;\n const action = keyAction(event.key, placeNow(), { home: options.home, views: options.keys, surface: surfaceOf(content.extent) });\n if (action === undefined) return;\n event.preventDefault();\n setInUse(true);\n if (action.type === \"view\") {\n goTo(action.view, true);\n return;\n }\n moved = true;\n move = undefined;\n stopDrift();\n put(action.place);\n invalidate();\n },\n { signal },\n );\n canvas.addEventListener(\"webglcontextlost\", (event) => event.preventDefault(), { signal });\n canvas.addEventListener(\"webglcontextrestored\", invalidate, { signal });\n\n controls.addEventListener(\"start\", () => {\n moved = true;\n move = undefined;\n canvas.style.cursor = \"grabbing\";\n invalidate();\n });\n controls.addEventListener(\"end\", () => {\n canvas.style.cursor = marks.hovered === undefined ? \"grab\" : \"pointer\";\n });\n controls.addEventListener(\"change\", invalidate);\n\n const applyTheme = (): void => {\n sky.color.set(theme.sky);\n sky.groundColor.set(theme.ground);\n paint();\n };\n\n const observer = new ResizeObserver(() => {\n if (disposed || !setSize()) return;\n setLimits();\n if (!moved) goTo(view, false);\n invalidate();\n });\n\n setSize();\n setLimits();\n goTo(options.home, false);\n applyTheme();\n observer.observe(container);\n\n return {\n canvas,\n setContent(next: StageContent<P, T>): void {\n if (disposed || next === content) return;\n for (const object of content.objects) world.remove(object);\n content.dispose();\n content = next;\n for (const object of content.objects) world.add(object);\n const selected = marks.selected !== undefined && content.has(marks.selected) ? marks.selected : undefined;\n marks = { ...marks, hovered: undefined, selected };\n settle = true;\n setLimits();\n if (!moved) goTo(view, false);\n paint();\n },\n setTheme(next: T): void {\n theme = next;\n applyTheme();\n },\n setView(next: string | StageView, animate: boolean = true): void {\n goTo(next, animate);\n },\n place: placeNow,\n highlight(records: readonly string[]): void {\n marks = { ...marks, marked: new Set(records) };\n paint();\n },\n select(record: string | undefined): void {\n marks = { ...marks, selected: record };\n paint();\n },\n refresh: paint,\n dispose(): void {\n if (disposed) return;\n disposed = true;\n cancelAnimationFrame(frame);\n observer.disconnect();\n listeners.abort();\n controls.dispose();\n for (const object of content.objects) world.remove(object);\n content.dispose();\n renderer.dispose();\n canvas.remove();\n },\n };\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"three.js","names":["World"],"sources":["../src/stage/stage.ts"],"sourcesContent":["import { DirectionalLight, HemisphereLight, PerspectiveCamera, Raycaster, Scene as World, Vector2, WebGLRenderer, type Object3D } from \"three\";\nimport { OrbitControls } from \"three/addons/controls/OrbitControls.js\";\nimport { nearDepth, stageLimits, surfaceOf, type StageExtent, type StageLimits, type StageView, type ViewFrame } from \"../extent.ts\";\nimport { keyAction } from \"../keys.ts\";\nimport { isClick, highlightOf, NO_HIGHLIGHTS, type Highlight, type Highlights } from \"../highlight.ts\";\nimport { moveAt, type Move } from \"../motion.ts\";\nimport type { StageTheme } from \"../theme.ts\";\nimport { cameraPosition, clampPlace, speedAt, viewOf, type Place } from \"../view.ts\";\n\n/** The record under the pointer: its name, and the value that the content gives for it. */\nexport interface StagePick<P> {\n /** The name of the record. The highlights of the stage use this name. */\n readonly record: string;\n /** The value of the record for the page, for example its kind and its source. */\n readonly value: P;\n}\n\n/** One picture of a stage, for the step of its content. */\nexport interface StageFrame {\n readonly camera: PerspectiveCamera;\n /** The time since the last picture, in seconds. */\n readonly seconds: number;\n /**\n * This value is true for the first picture of a content, and for a person who asks for less motion.\n * Each change then has no time: the content sets each value to its goal immediately.\n */\n readonly settle: boolean;\n /** The height of the picture, in CSS pixels. */\n readonly height: number;\n /** The vertical angle of the picture, in degrees. */\n readonly fieldOfView: number;\n}\n\n/**\n * The content of a stage: the three.js objects of one scene, and what the stage asks of them.\n * `P` is the type of the value of a pick, and `T` is the type of the theme.\n */\nexport interface StageContent<P, T extends StageTheme = StageTheme> {\n /** The three.js objects of the content. The stage adds them to its world, and removes them. */\n readonly objects: readonly Object3D[];\n /** The space that the content fills. */\n readonly extent: StageExtent;\n /** This function tells if the content has a record with a name. */\n has(record: string): boolean;\n /** This function gives the record that a ray from the camera finds first, or `undefined` for no record. */\n pick(ray: Raycaster): StagePick<P> | undefined;\n /** This function gives each part its colors, from the theme and the highlight of its record. */\n paint(theme: T, highlight: (record: string) => Highlight): void;\n /**\n * This function changes the parts that depend on the camera or on the time, before each picture.\n * It gives true while a part continues to change. The stage then makes the next picture.\n */\n step?(frame: StageFrame): boolean;\n /** This function releases the memory of the graphics card that the content uses. */\n dispose(): void;\n}\n\n/** The lights of a stage. A content with materials that use no light ignores them. */\nexport interface StageLights {\n /** The strength of the light from above and below. */\n readonly sky: number;\n /** The strength of the light from one direction. */\n readonly sun: number;\n /** The position that the light from one direction comes from. */\n readonly from: { readonly x: number; readonly y: number; readonly z: number };\n}\n\n/** The options of a stage. */\nexport interface StageOptions<P, T extends StageTheme = StageTheme> {\n /** The first content. The stage disposes each content that it gets. */\n readonly content: StageContent<P, T>;\n readonly theme: T;\n /** The name of the picture for a screen reader. */\n readonly label: string;\n /** The views of the stage, each with a name. */\n readonly views: Readonly<Record<string, StageView>>;\n /** The name of the first view. The keys `Home` and `0` show it. */\n readonly home: string;\n /** The name of the view of a key, for example `{ t: \"top\" }`. A letter has no case. */\n readonly keys?: Readonly<Record<string, string>> | undefined;\n /** The vertical angle of the picture, in degrees. A small angle gives the look of a drawing. The default is 32. */\n readonly fieldOfView?: number | undefined;\n /** The smallest and the largest polar angle of the camera, in radians. The default keeps the camera above the plane of the target. */\n readonly polar?: { readonly min?: number | undefined; readonly max?: number | undefined } | undefined;\n /** This value is true if a person can move the target with a drag of the second button. The default is true. */\n readonly pan?: boolean | undefined;\n readonly lights?: StageLights | undefined;\n /** The stage starts this function when the pointer goes to a different record, or to no record. */\n readonly onHover?: ((pick: P | undefined) => void) | undefined;\n /** The stage starts this function when a person selects a record with the pointer, or selects no record. */\n readonly onSelect?: ((pick: P | undefined) => void) | undefined;\n}\n\n/** A stage in a page: one canvas with a camera that a person moves, and one content. */\nexport interface Stage<P, T extends StageTheme = StageTheme> {\n /** The canvas of the stage. It is in the container. */\n readonly canvas: HTMLCanvasElement;\n /** This function shows a different content, and disposes the old content. The view stays if a person moved it. */\n setContent(content: StageContent<P, T>): void;\n /** This function changes the colors. */\n setTheme(theme: T): void;\n /** This function moves the camera to a view: a name of the options, or a view function. `animate` has the default true. */\n setView(view: string | StageView, animate?: boolean): void;\n /** This function gives the place of the camera. */\n place(): Place;\n /** This function highlights records by their names, as the pointer does. An empty list removes the highlights. */\n highlight(records: readonly string[]): void;\n /** This function selects one record by its name, or no record. It does not start `onSelect`. */\n select(record: string | undefined): void;\n /** This function paints the content again and makes a new picture. Use it after a change of the content. */\n refresh(): void;\n /** This function removes the canvas and releases the memory of the graphics card. It disposes the content. */\n dispose(): void;\n}\n\n/** The default vertical angle of the picture, in degrees. */\nexport const FIELD_OF_VIEW = 32;\n\n/** The default lights: a strong light from above and below, and a light from the front left. */\nexport const STAGE_LIGHTS: StageLights = { sky: 2.2, sun: 1.5, from: { x: -10, y: 24, z: 15 } };\n\n/** The time of the move between two views, in milliseconds. */\nconst MOVE_TIME = 380;\n\n/** The turn of the camera for a drag across the height of the picture, as a part of a full turn, far from the surface. */\nconst TURN_SPEED = 0.9;\n\n/** The smallest polar angle. At 0, the azimuth of a camera has no meaning. */\nconst SMALLEST_POLAR = 0.0005;\n\n/** The default largest polar angle: the camera stays above the plane of the target. */\nconst LARGEST_POLAR = Math.PI / 2 - 0.05;\n\n/** This function tells if the person asks for less motion. */\nfunction lessMotion(): boolean {\n return typeof matchMedia === \"function\" && matchMedia(\"(prefers-reduced-motion: reduce)\").matches;\n}\n\n/**\n * This function makes a stage in a container of a page. The stage fills the container, so give the container a size.\n *\n * A person turns the content with a drag, and moves nearer with the wheel after a click in the picture.\n * A click selects the record under the pointer. With the keyboard, the arrow keys turn the content, `+` and `-` change the distance,\n * and `Home` shows the first view. The stage makes a picture only after a change.\n *\n * The function gives `undefined` when the browser has no WebGL 2. It does not throw, and it writes no error to the console.\n * The page then shows a different picture of the same data.\n */\nexport function createStage<P, T extends StageTheme = StageTheme>(container: HTMLElement, options: StageOptions<P, T>): Stage<P, T> | undefined {\n const canvas = container.ownerDocument.createElement(\"canvas\");\n const context = canvas.getContext(\"webgl2\", { alpha: true, antialias: true, depth: true, stencil: false, premultipliedAlpha: true, powerPreference: \"default\" });\n if (context === null) return undefined;\n let renderer: WebGLRenderer;\n try {\n renderer = new WebGLRenderer({ canvas, context, alpha: true, antialias: true });\n } catch {\n return undefined;\n }\n renderer.setClearColor(0x000000, 0);\n\n canvas.style.display = \"block\";\n canvas.style.width = \"100%\";\n canvas.style.height = \"100%\";\n canvas.style.cursor = \"grab\";\n canvas.style.touchAction = \"none\";\n canvas.tabIndex = 0;\n canvas.setAttribute(\"role\", \"application\");\n canvas.setAttribute(\"aria-label\", options.label);\n container.append(canvas);\n\n const fieldOfView = options.fieldOfView ?? FIELD_OF_VIEW;\n const polar = { min: options.polar?.min ?? SMALLEST_POLAR, max: options.polar?.max ?? LARGEST_POLAR };\n const lights = options.lights ?? STAGE_LIGHTS;\n const world = new World();\n const sky = new HemisphereLight(\"#ffffff\", \"#ffffff\", lights.sky);\n const sun = new DirectionalLight(\"#ffffff\", lights.sun);\n sun.position.set(lights.from.x, lights.from.y, lights.from.z);\n world.add(sky, sun);\n const camera = new PerspectiveCamera(fieldOfView, 1, 0.05, 1000);\n\n let content = options.content;\n let theme = options.theme;\n for (const object of content.objects) world.add(object);\n\n let highlights: Highlights = NO_HIGHLIGHTS;\n let view: string | StageView = options.home;\n let move: Move | undefined;\n /** This value is true after a person moved the view. Then a new size of the container does not move the camera. */\n let moved = false;\n /** This value is true until the content had a step with no time. */\n let settle = true;\n /** The height of the picture, in CSS pixels. */\n let height = 1;\n let frame = 0;\n let lastTime = 0;\n let disposed = false;\n\n const invalidate = (): void => {\n if (frame === 0 && !disposed) frame = requestAnimationFrame(tick);\n };\n\n const controls = new OrbitControls(camera, canvas);\n controls.enableDamping = !lessMotion();\n controls.dampingFactor = 0.14;\n controls.minPolarAngle = polar.min;\n controls.maxPolarAngle = polar.max;\n controls.rotateSpeed = TURN_SPEED;\n controls.screenSpacePanning = true;\n controls.enablePan = options.pan ?? true;\n // The wheel moves the page until a person uses the picture. Thus the picture does not stop a person who reads down the page.\n controls.enableZoom = false;\n\n const viewFrame = (): ViewFrame => ({ extent: content.extent, fieldOfView, aspect: camera.aspect });\n let limits: StageLimits = stageLimits(viewFrame(), Object.values(options.views), polar);\n\n const paint = (): void => {\n const now = highlights;\n content.paint(theme, (record) => highlightOf(now, record));\n invalidate();\n };\n\n /** This function sets the turn speed and the zoom speed from the height of the camera above the surface. */\n const setSpeed = (): void => {\n const speed = speedAt(camera.position.distanceTo(controls.target), surfaceOf(content.extent));\n controls.rotateSpeed = TURN_SPEED * speed;\n controls.zoomSpeed = speed;\n };\n const placeNow = (): Place => {\n const target = { x: controls.target.x, y: controls.target.y, z: controls.target.z };\n return { target, ...viewOf(camera.position, target) };\n };\n const put = (to: Place): void => {\n const next = clampPlace(to, limits);\n const eye = cameraPosition(next.target, next, next.distance);\n controls.target.set(next.target.x, next.target.y, next.target.z);\n camera.position.set(eye.x, eye.y, eye.z);\n camera.lookAt(controls.target);\n setSpeed();\n };\n /** This function gives the view function of a view, or `undefined` for a name that the options do not have. */\n const viewFunction = (of: string | StageView): StageView | undefined => (typeof of === \"string\" ? options.views[of] : of);\n\n /**\n * This function sets the nearest depth that the camera draws, from the distance of the camera to the content.\n * A camera far from the content then has small steps of depth at the content, so a layer near a surface stays above it.\n */\n const setDepth = (): void => {\n const { center } = content.extent;\n const distance = Math.hypot(camera.position.x - center.x, camera.position.y - center.y, camera.position.z - center.z);\n const near = nearDepth(limits, content.extent, distance);\n if (near === camera.near && limits.far === camera.far) return;\n camera.near = near;\n camera.far = limits.far;\n camera.updateProjectionMatrix();\n };\n /** This function sets the limits of the camera from the content and the shape of the picture. */\n const setLimits = (): void => {\n limits = stageLimits(viewFrame(), Object.values(options.views), polar);\n controls.minDistance = limits.minDistance;\n controls.maxDistance = limits.maxDistance;\n setDepth();\n };\n /**\n * This function stops the turn that continues after a drag. The camera stays where it is.\n * Without it, the camera continues to turn after a move to a view, and the view is not exact.\n */\n const stopDrift = (): void => {\n if (!controls.enableDamping) return;\n const now = placeNow();\n // With no damping, an update of the controls uses all of the turn that remains. The camera then goes back.\n controls.enableDamping = false;\n controls.update();\n controls.enableDamping = true;\n put(now);\n };\n const goTo = (next: string | StageView, animate: boolean): void => {\n const found = viewFunction(next);\n if (found === undefined) return;\n view = next;\n moved = false;\n stopDrift();\n const to = found(viewFrame());\n if (animate && !lessMotion()) {\n move = { from: placeNow(), to, start: performance.now(), duration: MOVE_TIME };\n } else {\n move = undefined;\n put(to);\n }\n invalidate();\n };\n\n /** This function sets the size of the picture from the size of the container. It gives false for a container with no size. */\n const setSize = (): boolean => {\n const width = container.clientWidth;\n const tall = container.clientHeight;\n if (width === 0 || tall === 0) return false;\n height = tall;\n renderer.setPixelRatio(Math.min(globalThis.devicePixelRatio, 2));\n renderer.setSize(width, tall, false);\n camera.aspect = width / tall;\n camera.updateProjectionMatrix();\n return true;\n };\n\n /** This function moves the camera one step of a move between two views. It gives true while the move continues. */\n const stepMove = (now: number): boolean => {\n if (move === undefined) return false;\n const step = moveAt(move, now, surfaceOf(content.extent));\n put(step.place);\n if (step.done) move = undefined;\n return true;\n };\n\n function tick(now: number): void {\n frame = 0;\n if (disposed) return;\n const seconds = lastTime === 0 ? 1 / 60 : Math.min((now - lastTime) / 1000, 0.1);\n let active = stepMove(now);\n setSpeed();\n active = controls.update() || active;\n setDepth();\n const stepped = content.step?.({ camera, seconds, settle: settle || lessMotion(), height, fieldOfView }) ?? false;\n settle = false;\n renderer.render(world, camera);\n active = stepped || active;\n lastTime = active ? now : 0;\n if (active) invalidate();\n }\n\n const raycaster = new Raycaster();\n const pointer = new Vector2();\n /** This function gives the record under a pointer. */\n const pickAt = (event: PointerEvent): StagePick<P> | undefined => {\n const box = canvas.getBoundingClientRect();\n if (box.width === 0 || box.height === 0) return undefined;\n pointer.set(((event.clientX - box.left) / box.width) * 2 - 1, 1 - ((event.clientY - box.top) / box.height) * 2);\n raycaster.setFromCamera(pointer, camera);\n return content.pick(raycaster);\n };\n\n const setHover = (pick: StagePick<P> | undefined): void => {\n const record = pick?.record;\n if (record === highlights.hovered) return;\n highlights = { ...highlights, hovered: record };\n canvas.style.cursor = record === undefined ? \"grab\" : \"pointer\";\n paint();\n options.onHover?.(pick?.value);\n };\n\n const listeners = new AbortController();\n const signal = listeners.signal;\n let down: { readonly id: number; readonly x: number; readonly y: number } | undefined;\n const setInUse = (inUse: boolean): void => {\n controls.enableZoom = inUse;\n };\n canvas.addEventListener(\n \"pointerdown\",\n (event) => {\n setInUse(true);\n canvas.focus({ preventScroll: true });\n down = { id: event.pointerId, x: event.clientX, y: event.clientY };\n },\n { signal },\n );\n canvas.addEventListener(\n \"pointermove\",\n (event) => {\n if (event.buttons === 0 && event.pointerType !== \"touch\") setHover(pickAt(event));\n },\n { signal },\n );\n canvas.addEventListener(\n \"pointerup\",\n (event) => {\n const start = down;\n down = undefined;\n if (start === undefined || start.id !== event.pointerId) return;\n if (!isClick(start, { x: event.clientX, y: event.clientY })) return;\n const pick = pickAt(event);\n highlights = { ...highlights, selected: pick?.record };\n paint();\n options.onSelect?.(pick?.value);\n },\n { signal },\n );\n canvas.addEventListener(\n \"pointercancel\",\n () => {\n down = undefined;\n },\n { signal },\n );\n canvas.addEventListener(\n \"pointerleave\",\n (event) => {\n setHover(undefined);\n if (event.pointerType === \"mouse\") setInUse(false);\n },\n { signal },\n );\n canvas.addEventListener(\"blur\", () => setInUse(false), { signal });\n canvas.addEventListener(\n \"keydown\",\n (event) => {\n if (event.altKey || event.ctrlKey || event.metaKey) return;\n const action = keyAction(event.key, placeNow(), { home: options.home, views: options.keys, surface: surfaceOf(content.extent) });\n if (action === undefined) return;\n event.preventDefault();\n setInUse(true);\n if (action.type === \"view\") {\n goTo(action.view, true);\n return;\n }\n moved = true;\n move = undefined;\n stopDrift();\n put(action.place);\n invalidate();\n },\n { signal },\n );\n canvas.addEventListener(\"webglcontextlost\", (event) => event.preventDefault(), { signal });\n canvas.addEventListener(\"webglcontextrestored\", invalidate, { signal });\n\n controls.addEventListener(\"start\", () => {\n moved = true;\n move = undefined;\n canvas.style.cursor = \"grabbing\";\n invalidate();\n });\n controls.addEventListener(\"end\", () => {\n canvas.style.cursor = highlights.hovered === undefined ? \"grab\" : \"pointer\";\n });\n controls.addEventListener(\"change\", invalidate);\n\n const applyTheme = (): void => {\n sky.color.set(theme.sky);\n sky.groundColor.set(theme.ground);\n paint();\n };\n\n const observer = new ResizeObserver(() => {\n if (disposed || !setSize()) return;\n setLimits();\n if (!moved) goTo(view, false);\n invalidate();\n });\n\n setSize();\n setLimits();\n goTo(options.home, false);\n applyTheme();\n observer.observe(container);\n\n return {\n canvas,\n setContent(next: StageContent<P, T>): void {\n if (disposed || next === content) return;\n for (const object of content.objects) world.remove(object);\n content.dispose();\n content = next;\n for (const object of content.objects) world.add(object);\n const selected = highlights.selected !== undefined && content.has(highlights.selected) ? highlights.selected : undefined;\n highlights = { ...highlights, hovered: undefined, selected };\n settle = true;\n setLimits();\n if (!moved) goTo(view, false);\n paint();\n },\n setTheme(next: T): void {\n theme = next;\n applyTheme();\n },\n setView(next: string | StageView, animate: boolean = true): void {\n goTo(next, animate);\n },\n place: placeNow,\n highlight(records: readonly string[]): void {\n highlights = { ...highlights, highlighted: new Set(records) };\n paint();\n },\n select(record: string | undefined): void {\n highlights = { ...highlights, selected: record };\n paint();\n },\n refresh: paint,\n dispose(): void {\n if (disposed) return;\n disposed = true;\n cancelAnimationFrame(frame);\n observer.disconnect();\n listeners.abort();\n controls.dispose();\n for (const object of content.objects) world.remove(object);\n content.dispose();\n renderer.dispose();\n canvas.remove();\n },\n };\n}\n"],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://json.schemastore.org/package",
|
|
3
3
|
"name": "@mark1russell7/visuals",
|
|
4
|
-
"version": "0.
|
|
5
|
-
"description": "3D stages for data on three.js: a camera that a person moves, views by name, picking,
|
|
4
|
+
"version": "0.2.0",
|
|
5
|
+
"description": "3D stages for data on three.js: a camera that a person moves, views by name, picking, highlights and themes, a globe of the Earth, and the shared marks of the viewers as data.",
|
|
6
6
|
"license": "MIT",
|
|
7
7
|
"repository": {
|
|
8
8
|
"type": "git",
|
|
@@ -21,7 +21,8 @@
|
|
|
21
21
|
"orbit",
|
|
22
22
|
"picking",
|
|
23
23
|
"globe",
|
|
24
|
-
"webgl"
|
|
24
|
+
"webgl",
|
|
25
|
+
"marks"
|
|
25
26
|
],
|
|
26
27
|
"type": "module",
|
|
27
28
|
"sideEffects": false,
|
|
@@ -42,6 +43,11 @@
|
|
|
42
43
|
"import": "./build/globe.js",
|
|
43
44
|
"default": "./build/globe.js"
|
|
44
45
|
},
|
|
46
|
+
"./marks": {
|
|
47
|
+
"types": "./build/marks.d.ts",
|
|
48
|
+
"import": "./build/marks.js",
|
|
49
|
+
"default": "./build/marks.js"
|
|
50
|
+
},
|
|
45
51
|
"./package.json": "./package.json"
|
|
46
52
|
},
|
|
47
53
|
"files": [
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"motion-BwDDtx3D.js","names":[],"sources":["../src/keys.ts","../src/marks.ts","../src/motion.ts"],"sourcesContent":["import { speedAt, type Place } from \"./view.ts\";\n\n/** The angle of one step of an arrow key, in radians, for a camera far from the surface. */\nexport const KEY_TURN: number = Math.PI / 24;\n\n/** The factor of the height of a camera above the surface for one step of the key `+`. */\nexport const KEY_ZOOM = 0.85;\n\n/** What a key does on a stage: it moves the camera to a place, or it shows a view. */\nexport type KeyAction = { readonly type: \"place\"; readonly place: Place } | { readonly type: \"view\"; readonly view: string };\n\n/** The keys of a stage. */\nexport interface KeyOptions {\n /** The name of the view of the keys `Home` and `0`. */\n readonly home: string;\n /** The name of the view of each other key, for example `{ t: \"top\" }`. A letter has no case. */\n readonly views?: Readonly<Record<string, string>> | undefined;\n /** The radius of the ball around the target that the camera stays out of, or 0 for no ball. */\n readonly surface?: number | undefined;\n}\n\n/**\n * This function gives the action of a key on a stage, or `undefined` for a key with no action.\n *\n * The arrow keys turn the camera around the target. The keys `+` and `-` change the height above the surface.\n * The keys `Home` and `0` show the home view. Near the surface, a step of an arrow key is smaller.\n * The result has no limits: the stage puts the place in its limits.\n */\nexport function keyAction(key: string, now: Place, options: KeyOptions): KeyAction | undefined {\n const surface = options.surface ?? 0;\n const turn = KEY_TURN * speedAt(now.distance, surface);\n const zoom = (factor: number): Place => ({ ...now, distance: surface + (now.distance - surface) * factor });\n switch (key) {\n case \"ArrowLeft\":\n return { type: \"place\", place: { ...now, azimuth: now.azimuth - turn } };\n case \"ArrowRight\":\n return { type: \"place\", place: { ...now, azimuth: now.azimuth + turn } };\n case \"ArrowUp\":\n return { type: \"place\", place: { ...now, polar: now.polar - turn } };\n case \"ArrowDown\":\n return { type: \"place\", place: { ...now, polar: now.polar + turn } };\n case \"+\":\n case \"=\":\n return { type: \"place\", place: zoom(KEY_ZOOM) };\n case \"-\":\n case \"_\":\n return { type: \"place\", place: zoom(1 / KEY_ZOOM) };\n case \"Home\":\n case \"0\":\n return { type: \"view\", view: options.home };\n default: {\n const view = key.length === 1 ? options.views?.[key.toLowerCase()] : undefined;\n return view === undefined ? undefined : { type: \"view\", view };\n }\n }\n}\n","/** The mark of a record. 0 is no mark. 1 is a record under the pointer or in the marked list. 2 is the selected record. */\nexport type Mark = 0 | 1 | 2;\n\n/** The records of a stage that have a mark. Each record has a name. */\nexport interface Marks {\n /** The name of the record under the pointer. */\n readonly hovered: string | undefined;\n /** The name of the selected record. */\n readonly selected: string | undefined;\n /** The names of the records that the page marks. */\n readonly marked: ReadonlySet<string>;\n}\n\n/** The marks of a stage with no pointer on it and no selected record. */\nexport const NO_MARKS: Marks = { hovered: undefined, selected: undefined, marked: new Set() };\n\n/** This function gives the mark of a record. The selected record has the highest mark. */\nexport function markOf(marks: Marks, record: string): Mark {\n if (record === marks.selected) return 2;\n return record === marks.hovered || marks.marked.has(record) ? 1 : 0;\n}\n\n/** A pointer that moves this distance or less between down and up makes a click, in CSS pixels. */\nexport const CLICK_DISTANCE = 4;\n\n/**\n * This function tells if a pointer that went down and up made a click. A pointer that moved more than `limit` made a drag.\n * The positions and the limit are in CSS pixels.\n */\nexport function isClick(down: { readonly x: number; readonly y: number }, up: { readonly x: number; readonly y: number }, limit: number = CLICK_DISTANCE): boolean {\n return Math.hypot(up.x - down.x, up.y - down.y) <= limit;\n}\n","import { placeBetween, type Place } from \"./view.ts\";\n\n/** A move of a camera from one place to a different place. */\nexport interface Move {\n readonly from: Place;\n readonly to: Place;\n /** The time of the start of the move, in milliseconds. */\n readonly start: number;\n /** The time that the move takes, in milliseconds. */\n readonly duration: number;\n}\n\n/** The place of a camera at one time of a move. */\nexport interface MoveStep {\n readonly place: Place;\n /** This value is true at the end of the move, and after it. */\n readonly done: boolean;\n}\n\n/**\n * This function gives a part of a move with a slow start and a slow end. `part` goes from 0 to 1.\n * The result goes from 0 to 1, and it is 0.5 at the middle.\n */\nexport function easeInOut(part: number): number {\n const clamped = Math.min(Math.max(part, 0), 1);\n return clamped < 0.5 ? 4 * clamped * clamped * clamped : 1 - (-2 * clamped + 2) ** 3 / 2;\n}\n\n/**\n * This function gives the place of a camera at the time `now` of a move, in milliseconds.\n * A move with no duration is at its end immediately. `surface` is the radius of the ball around the target, or 0 for no ball.\n */\nexport function moveAt(move: Move, now: number, surface: number = 0): MoveStep {\n const part = move.duration > 0 ? Math.min(Math.max((now - move.start) / move.duration, 0), 1) : 1;\n if (part >= 1) return { place: move.to, done: true };\n return { place: placeBetween(move.from, move.to, easeInOut(part), surface), done: false };\n}\n\n/**\n * This function moves a value one step to its goal. Each step goes a constant part of the way that remains.\n *\n * `seconds` is the time of the step, and `time` is the time in which the value goes most of the way, in seconds.\n * A step with no time gives the goal. A value nearer to the goal than `snap` becomes the goal, so the steps have an end.\n */\nexport function approach(value: number, goal: number, seconds: number, time: number, snap: number = 0.01): number {\n if (!(seconds > 0) || !(time > 0)) return goal;\n const next = value + (goal - value) * (1 - Math.exp(0 - seconds / time));\n return Math.abs(goal - next) < snap ? goal : next;\n}\n"],"mappings":";;;AAGA,MAAa,WAAmB,KAAK,KAAK;;AAG1C,MAAa,WAAW;;;;;;;;AAsBxB,SAAgB,UAAU,KAAa,KAAY,SAA4C;CAC7F,MAAM,UAAU,QAAQ,WAAW;CACnC,MAAM,OAAO,WAAW,QAAQ,IAAI,UAAU,OAAO;CACrD,MAAM,QAAQ,YAA2B;EAAE,GAAG;EAAK,UAAU,WAAW,IAAI,WAAW,WAAW;CAAO;CACzG,QAAQ,KAAR;EACE,KAAK,aACH,OAAO;GAAE,MAAM;GAAS,OAAO;IAAE,GAAG;IAAK,SAAS,IAAI,UAAU;GAAK;EAAE;EACzE,KAAK,cACH,OAAO;GAAE,MAAM;GAAS,OAAO;IAAE,GAAG;IAAK,SAAS,IAAI,UAAU;GAAK;EAAE;EACzE,KAAK,WACH,OAAO;GAAE,MAAM;GAAS,OAAO;IAAE,GAAG;IAAK,OAAO,IAAI,QAAQ;GAAK;EAAE;EACrE,KAAK,aACH,OAAO;GAAE,MAAM;GAAS,OAAO;IAAE,GAAG;IAAK,OAAO,IAAI,QAAQ;GAAK;EAAE;EACrE,KAAK;EACL,KAAK,KACH,OAAO;GAAE,MAAM;GAAS,OAAO,KAAK,QAAQ;EAAE;EAChD,KAAK;EACL,KAAK,KACH,OAAO;GAAE,MAAM;GAAS,OAAO,KAAK,IAAI,QAAQ;EAAE;EACpD,KAAK;EACL,KAAK,KACH,OAAO;GAAE,MAAM;GAAQ,MAAM,QAAQ;EAAK;EAC5C,SAAS;GACP,MAAM,OAAO,IAAI,WAAW,IAAI,QAAQ,QAAQ,IAAI,YAAY,KAAK,KAAA;GACrE,OAAO,SAAS,KAAA,IAAY,KAAA,IAAY;IAAE,MAAM;IAAQ;GAAK;EAC/D;CACF;AACF;;;ACzCA,MAAa,WAAkB;CAAE,SAAS,KAAA;CAAW,UAAU,KAAA;CAAW,wBAAQ,IAAI,IAAI;AAAE;;AAG5F,SAAgB,OAAO,OAAc,QAAsB;CACzD,IAAI,WAAW,MAAM,UAAU,OAAO;CACtC,OAAO,WAAW,MAAM,WAAW,MAAM,OAAO,IAAI,MAAM,IAAI,IAAI;AACpE;;AAGA,MAAa,iBAAiB;;;;;AAM9B,SAAgB,QAAQ,MAAkD,IAAgD,QAAA,GAAyC;CACjK,OAAO,KAAK,MAAM,GAAG,IAAI,KAAK,GAAG,GAAG,IAAI,KAAK,CAAC,KAAK;AACrD;;;;;;ACRA,SAAgB,UAAU,MAAsB;CAC9C,MAAM,UAAU,KAAK,IAAI,KAAK,IAAI,MAAM,CAAC,GAAG,CAAC;CAC7C,OAAO,UAAU,KAAM,IAAI,UAAU,UAAU,UAAU,KAAK,KAAK,UAAU,MAAM,IAAI;AACzF;;;;;AAMA,SAAgB,OAAO,MAAY,KAAa,UAAkB,GAAa;CAC7E,MAAM,OAAO,KAAK,WAAW,IAAI,KAAK,IAAI,KAAK,KAAK,MAAM,KAAK,SAAS,KAAK,UAAU,CAAC,GAAG,CAAC,IAAI;CAChG,IAAI,QAAQ,GAAG,OAAO;EAAE,OAAO,KAAK;EAAI,MAAM;CAAK;CACnD,OAAO;EAAE,OAAO,aAAa,KAAK,MAAM,KAAK,IAAI,UAAU,IAAI,GAAG,OAAO;EAAG,MAAM;CAAM;AAC1F;;;;;;;AAQA,SAAgB,SAAS,OAAe,MAAc,SAAiB,MAAc,OAAe,KAAc;CAChH,IAAI,EAAE,UAAU,MAAM,EAAE,OAAO,IAAI,OAAO;CAC1C,MAAM,OAAO,SAAS,OAAO,UAAU,IAAI,KAAK,IAAI,IAAI,UAAU,IAAI;CACtE,OAAO,KAAK,IAAI,OAAO,IAAI,IAAI,OAAO,OAAO;AAC/C"}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"theme-CJ2SAcHX.d.ts","names":[],"sources":["../src/view.ts","../src/extent.ts","../src/marks.ts","../src/theme.ts"],"mappings":";;;;;UAMiB;;WAEN;;WAEA;;;UAIM,cAAc;WACpB,QAAQ;WACR;;;UAIM;;WAEN,MAAM;;WAEN,OAAO;;WAEP,IAAI;;;UAIE;;WAEN;;WAEA;;WAEA;;WAEA;;;iBAIK,SAAS,MAAM,aAAa;;;;;;;;iBAwB5B,YAAY,iBAAiB,UAAU,QAAQ,QAAQ,MAAM,YAAY,aAAa;;;;;;;;;iBAsBtF,YAAY,gBAAgB,eAAe,aAAa;;iBAaxD,eAAe,QAAQ,QAAQ,MAAM,YAAY,mBAAmB;;iBAMpE,OAAO,QAAQ,QAAQ,QAAQ,SAAS;WAAwB;;;iBAUhE,YAAY,cAAc;;iBAO1B,WAAW,OAAO,OAAO,QAAQ,cAAc;;;;;;;;iBAgB/C,QAAQ,kBAAkB;;;;;;;iBAW1B,aAAa,MAAM,OAAO,IAAI,OAAO,cAAc,mBAAsB;;UCnJxE;;WAEN,kBAAkB;;WAElB,QAAQ;;;;;WAKR;;WAEA;;WAEA;;;UAIM;WACN,QAAQ;;WAER;;WAEA;;;KAIC,aAAa,OAAO,cAAc;;UAG7B,oBAAoB;WAC1B;WACA;;;cAIE;;iBAGG,UAAU,QAAQ;;;;;iBASlB,QAAQ,QAAQ,YAAY,kBAA8B;;;;;;;iBAa1D,QAAQ,QAAQ,YAAY,eAAe,kBAA8B;;;;;;;iBAczE,SAAS,iBAAiB,UAAU,kBAA8B;;iBA0ClE,QAAQ,QAAQ;;;;;;;iBAYhB,UAAU,QAAQ,aAAa,QAAQ,aAAa;;;;;;;iBAWpD,YAAY,OAAO,WAAW,gBAAgB,aAAa;WAAkB;WAAsB;IAAgB;;KC9IvH;;UAGK;;WAEN;;WAEA;;WAEA,QAAQ;;;cAIN,UAAU;;iBAGP,OAAO,OAAO,OAAO,iBAAiB;;cAMzC;;;;;iBAMG,QAAQ;WAAiB;WAAoB;GAAa;WAAe;WAAoB;GAAa;;;;;UCzBzG;;WAEN;;WAEA"}
|