phoria2 1.0.0-rc.8 → 1.1.0

package/README.md

@@ -56,12 +56,12 @@ own). Pin the version so a new release can't change your page:
 <script type="importmap">
 {
   "imports": {
-    "phoria2": "https://cdn.jsdelivr.net/npm/phoria2@1.0.0-rc.8/dist/phoria2.js",
-    "phoria2/charts": "https://cdn.jsdelivr.net/npm/phoria2@1.0.0-rc.8/dist/charts.js",
-    "phoria2/particles": "https://cdn.jsdelivr.net/npm/phoria2@1.0.0-rc.8/dist/particles.js",
-    "phoria2/gltf": "https://cdn.jsdelivr.net/npm/phoria2@1.0.0-rc.8/dist/gltf.js",
-    "phoria2/motion": "https://cdn.jsdelivr.net/npm/phoria2@1.0.0-rc.8/dist/motion.js",
-    "phoria2/edit": "https://cdn.jsdelivr.net/npm/phoria2@1.0.0-rc.8/dist/edit.js"
+    "phoria2": "https://cdn.jsdelivr.net/npm/phoria2@1.1.0/dist/phoria2.js",
+    "phoria2/charts": "https://cdn.jsdelivr.net/npm/phoria2@1.1.0/dist/charts.js",
+    "phoria2/particles": "https://cdn.jsdelivr.net/npm/phoria2@1.1.0/dist/particles.js",
+    "phoria2/gltf": "https://cdn.jsdelivr.net/npm/phoria2@1.1.0/dist/gltf.js",
+    "phoria2/motion": "https://cdn.jsdelivr.net/npm/phoria2@1.1.0/dist/motion.js",
+    "phoria2/edit": "https://cdn.jsdelivr.net/npm/phoria2@1.1.0/dist/edit.js"
   }
 }
 </script>
@@ -164,6 +164,25 @@ A full example, with a chart that follows its data, is in
 | `phoria2/edit` | `TransformHandle` - a move and turn handle with grid and angle snapping - and `History` for undo, for planners and layout editors |
 | `phoria2/schema.json`, `phoria2/charts/schema.json` | JSON Schemas for scene descriptions (`create()`) and chart specs |
 
+## Versioning
+
+phoria2 follows [semver](https://semver.org) from 1.0: no 1.x release breaks code written against
+what is documented.
+
+- **Covered:** what the entry points above export, as the [reference](https://kevs3d.co.uk/phoria2/llms-full.txt) and the
+  published types describe it - names, options and their defaults, and what they do. The formats
+  `create()` reads and `toJSON()` writes, and chart specs, as their JSON Schemas describe them. The
+  conventions: +Y up, metres, radians, sRGB colour in, and light intensities - a scene keeps its
+  colours and its brightness from one 1.x release to the next.
+- **Not covered:** exact pixels, since drawing can get better (smoother edges, softer shadows); the
+  wording of errors and warnings (catch `PhoriaError`, not its message); modules imported from
+  `phoria2/src/...` directly, members left out of the types, and the shape of
+  `NullRenderer.lastFrame`; the demos.
+- **Minor releases add:** options, methods, node types, chart marks. A new option's default keeps
+  what happened before.
+- **Nothing is removed or renamed in 1.x.** What 2.0 will drop is deprecated first: a 1.x release
+  keeps it working and warns once in the console, saying exactly what to write instead.
+
 ## Browsers
 
 Any browser with WebGL 2: current Chrome, Edge, Firefox and Safari (desktop and iOS 15+).

package/dist/bloom.js

@@ -1,4 +1,4 @@
-import { F as e, N as t } from "./core.js";
+import { A as e, M as t } from "./core.js";
 // src/webgl/bloom.js
 var n = `precision highp float;
 in vec2 vUv;
@@ -6,7 +6,7 @@ uniform sampler2D uSource;
 uniform vec2 uTexel;
 uniform float uThreshold;
 out vec4 fragColor;
-${t}
+${e}
 vec3 tap(vec2 uv) {
 vec3 c = texture(uSource, uv).rgb;
 return uThreshold < 0.0 ? c : srgbToLinear(c);
@@ -29,7 +29,7 @@ uniform sampler2D uScene;
 uniform sampler2D uBloom;
 uniform float uStrength;
 out vec4 fragColor;
-${t}
+${e}
 void main() {
 vec4 scene = texture(uScene, vUv);
 vec3 glow = texture(uBloom, vUv).rgb * uStrength;
@@ -37,7 +37,7 @@ vec3 c = srgbToLinear(scene.rgb) + glow;
 float a = clamp(scene.a + max(glow.r, max(glow.g, glow.b)), 0.0, 1.0);
 fragColor = vec4(linearToSrgb(c), a);
 }
-`, a = [e, n], o = [e, r], s = [e, i], c = 6, l = class {
+`, a = [t, n], o = [t, r], s = [t, i], c = 6, l = class {
 	#e = null;
 	#t = !1;
 	constructor(e, t) {

package/dist/bloom.js.map

@@ -1 +1 @@
-{"version":3,"file":"bloom.js","names":["FULLSCREEN_VERTEX","COMMON","DOWN_FRAGMENT","UP_FRAGMENT","COMPOSITE_FRAGMENT","DOWN","UP","COMPOSITE","LEVELS","Bloom","gl","programs","#target","#float","#free","target","#targetFor","width","height","down","source","sw","sh","level","i","settings","up","weight","levels","from","to","composite","samples","multisampled","color","depth","texture","t","format","w","h","framebuffer","picture","b"],"sources":[],"mappings":""}
+{"version":3,"file":"bloom.js","names":["COMMON","FULLSCREEN_VERTEX","DOWN_FRAGMENT","UP_FRAGMENT","COMPOSITE_FRAGMENT","DOWN","UP","COMPOSITE","LEVELS","Bloom","gl","programs","#target","#float","#free","target","#targetFor","width","height","down","source","sw","sh","level","i","settings","up","weight","levels","from","to","composite","samples","multisampled","color","depth","texture","t","format","w","h","framebuffer","picture","b"],"sources":[],"mappings":""}