@overpunch/vf-clamp 2.1.4 → 2.2.0

package/dist/index.cjs

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const N=require("node:module");var g=typeof document<"u"?document.currentScript:null;const O=N.createRequire(typeof document>"u"?require("url").pathToFileURL(__filename).href:g&&g.tagName.toUpperCase()==="SCRIPT"&&g.src||new URL("index.cjs",document.baseURI).href),{preparePyodide:l,PyodideFile:u}=O("@web-alchemy/fonttools/src/pyodide.js");let h=null;async function j(){return h||(h=l().then(e=>e.runPythonAsync(`
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const $=require("node:module");var T=typeof document<"u"?document.currentScript:null;const k=$.createRequire(typeof document>"u"?require("url").pathToFileURL(__filename).href:T&&T.tagName.toUpperCase()==="SCRIPT"&&T.src||new URL("index.cjs",document.baseURI).href),{preparePyodide:d,PyodideFile:x}=k("@web-alchemy/fonttools/src/pyodide.js");let b=null;async function C(){return b||(b=d().then(t=>t.runPythonAsync(`
 from fontTools.ttLib import TTFont
 
 def vf_convert_flavor(file_options):
@@ -7,7 +7,7 @@ def vf_convert_flavor(file_options):
     font.save(file_options['output-file'])
 
 vf_convert_flavor
-`))),h}async function V(e,o){const a=await l(),t=new u({pyodide:a}),n=new u({pyodide:a});try{await t.upload(e);const i=new Map([["input-file",t.filename],["output-file",n.filename],["flavor",o]]);return(await j())(i),n.download()}finally{try{t.delete()}catch{}try{n.delete()}catch{}}}async function I(e){return V(e,"woff")}async function D(e){return V(e,"woff2")}let w=null;async function L(){return w||(w=l().then(e=>e.runPythonAsync(`
+`))),b}async function P(t,o){const a=await d(),e=new x({pyodide:a}),n=new x({pyodide:a});try{await e.upload(t);const i=new Map([["input-file",e.filename],["output-file",n.filename],["flavor",o]]);return(await C())(i),n.download()}finally{try{e.delete()}catch{}try{n.delete()}catch{}}}async function j(t){return P(t,"woff")}async function M(t){return P(t,"woff2")}let F=null;async function E(){return F||(F=d().then(t=>t.runPythonAsync(`
 import json
 from fontTools.ttLib import TTFont
 
@@ -42,7 +42,7 @@ def get_instances_fn(input_file):
     return json.dumps({'axes': axes, 'instances': instances})
 
 get_instances_fn
-`))),w}async function R(e){const o=await l(),a=e instanceof ArrayBuffer?new Uint8Array(e):e,t=new u({pyodide:o});try{await t.upload(a);const i=(await L())(t.filename);return JSON.parse(i)}finally{try{t.delete()}catch{}}}let v=null,y=null,A=null,T=null,b=null;async function M(){return v||(v=l().then(e=>e.runPythonAsync(`
+`))),F}async function L(t){const o=await d(),a=t instanceof ArrayBuffer?new Uint8Array(t):t,e=new x({pyodide:o});try{await e.upload(a);const i=(await E())(e.filename);return JSON.parse(i)}finally{try{e.delete()}catch{}}}let S=null,I=null,V=null,D=null,O=null;async function z(){return S||(S=d().then(t=>t.runPythonAsync(`
 from fontTools import ttLib
 
 def patch_font_names_fn(file_options):
@@ -95,7 +95,7 @@ def patch_font_names_fn(file_options):
     font.save(file_options['output-file'])
 
 patch_font_names_fn
-`))),v}async function U(){return y||(y=l().then(e=>e.runPythonAsync(`
+`))),S}async function W(){return I||(I=d().then(t=>t.runPythonAsync(`
 from fontTools.ttLib import TTFont
 from fontTools.varLib import instancer
 import json
@@ -124,7 +124,7 @@ def vf_clamp_instantiate(file_options, axes_json):
     partial.save(file_options['output-file'])
 
 vf_clamp_instantiate
-`))),y}async function k(){return A||(A=l().then(e=>e.runPythonAsync(`
+`))),I}async function q(){return V||(V=d().then(t=>t.runPythonAsync(`
 from fontTools.ttLib import TTFont
 
 def vf_clamp_normalize_wght(file_options, new_min_str):
@@ -181,7 +181,7 @@ def vf_clamp_normalize_wght(file_options, new_min_str):
     font.save(file_options['output-file'])
 
 vf_clamp_normalize_wght
-`))),A}async function C(){return T||(T=l().then(e=>e.runPythonAsync(`
+`))),V}async function B(){return D||(D=d().then(t=>t.runPythonAsync(`
 from fontTools.ttLib import TTFont
 
 def vf_clamp_prune_stat(file_options):
@@ -239,7 +239,7 @@ def vf_clamp_prune_stat(file_options):
     font.save(file_options['output-file'])
 
 vf_clamp_prune_stat
-`))),T}async function $(){return b||(b=l().then(e=>e.runPythonAsync(`
+`))),D}async function G(){return O||(O=d().then(t=>t.runPythonAsync(`
 from fontTools.ttLib import TTFont
 
 def vf_clamp_update_os2(file_options):
@@ -284,4 +284,4 @@ def vf_clamp_update_os2(file_options):
     font.save(file_options['output-file'])
 
 vf_clamp_update_os2
-`))),b}function z(e){return e.replace(/[^A-Za-z0-9 -]/g,"").trim().split(/\s+/).join("-").replace(/^-+|-+$/g,"").slice(0,63)}async function W(e,o){if(!o)return e;const a=await l(),t=new u({pyodide:a}),n=new u({pyodide:a});try{const i=z(o);await t.upload(e);const r=new Map([["input-file",t.filename],["output-file",n.filename],["family-name",o],["postscript-name",i]]);return(await M())(r),n.download()}catch(i){return console.warn(`vf-clamp: name table patching failed for "${o}" — returning unpatched buffer`,i),e}finally{try{t.delete()}catch{}try{n.delete()}catch{}}}function q(e){return typeof e=="number"?e:e===null?null:[e.min,e.max]}async function B(e,o){const a=await l(),t=new u({pyodide:a}),n=new u({pyodide:a});try{await t.upload(e);const i=new Map([["input-file",t.filename],["output-file",n.filename]]);return(await U())(i,JSON.stringify(o)),n.download()}finally{try{t.delete()}catch{}try{n.delete()}catch{}}}async function E(e){const o=await l(),a=new u({pyodide:o}),t=new u({pyodide:o});try{await a.upload(e);const n=new Map([["input-file",a.filename],["output-file",t.filename]]);return(await C())(n),t.download()}catch(n){return console.warn("vf-clamp: STAT prune failed — returning unpruned buffer",n),e}finally{try{a.delete()}catch{}try{t.delete()}catch{}}}async function G(e){const o=await l(),a=new u({pyodide:o}),t=new u({pyodide:o});try{await a.upload(e);const n=new Map([["input-file",a.filename],["output-file",t.filename]]);return(await $())(n),t.download()}catch(n){return console.warn("vf-clamp: OS/2 + macStyle update failed — returning original buffer",n),e}finally{try{a.delete()}catch{}try{t.delete()}catch{}}}async function J(e,o){const a=await l(),t=new u({pyodide:a}),n=new u({pyodide:a});try{await t.upload(e);const i=new Map([["input-file",t.filename],["output-file",n.filename]]);return(await k())(i,String(o)),n.download()}catch(i){return console.warn("vf-clamp: wght normalisation failed — returning unnormalised buffer",i),e}finally{try{t.delete()}catch{}try{n.delete()}catch{}}}function H(e,o){const a=new Map(o.map(i=>[i.name,i])),t={};for(const i of e){const r=a.get(i);if(!r)throw new Error(`Named instance "${i}" not found in font`);for(const[s,m]of Object.entries(r.coordinates))t[s]?(t[s].min=Math.min(t[s].min,m),t[s].max=Math.max(t[s].max,m)):t[s]={min:m,max:m}}const n={};for(const[i,{min:r,max:s}]of Object.entries(t))n[i]=r===s?r:{min:r,max:s};return n}async function Z(e,o){var s,m;if(o.outputs.length===0)return[];const a=e instanceof ArrayBuffer?new Uint8Array(e):e,t=o.format??"ttf";let n=[],i=[];if(o.outputs.some(f=>{var p;return(p=f.instances)==null?void 0:p.length})){const f=await R(a);n=f.instances,i=f.axes}const r=[];for(const f of o.outputs){let p={};(s=f.instances)!=null&&s.length&&(p=H(f.instances,n)),f.axes&&(p={...p,...f.axes});for(const d of i){const x=p[d.tag];if(x!=null&&typeof x=="object"){const _=x;if(d.default<_.min||d.default>_.max){const P=Math.max(_.min,Math.min(_.max,d.default));console.warn(`vf-clamp: axis "${d.tag}" default (${d.default}) is outside restricted range [${_.min}, ${_.max}] — will be clamped to ${P}`)}}}const F={};for(const[d,x]of Object.entries(p))x!==null&&(F[d]=q(x));const S=f.name??((m=f.instances)!=null&&m.length?f.instances.length===1?f.instances[0]:`${f.instances[0]}-${f.instances[f.instances.length-1]}`:"output");let c=await B(a,F);c=await E(c),o.normalizeWeightAxis&&(c=await J(c,100)),c=await G(c),c=await W(c,S),t==="woff2"?c=await D(c):t==="woff"&&(c=await I(c)),r.push({name:S,buffer:c,format:t})}return r}function K(e,o){if(e===o)return e;const a=e.split(" "),t=o.split(" ");let n=0;for(;n<a.length&&n<t.length&&a[n]===t[n];)n++;let i=0;for(;i<a.length-n&&i<t.length-n&&a[a.length-1-i]===t[t.length-1-i];)i++;const r=a.slice(0,n).join(" "),s=a.slice(n,a.length-(i||0)).join(" "),m=t.slice(n,t.length-(i||0)).join(" "),f=i>0?a.slice(a.length-i).join(" "):"",p=s&&m?`${s}-${m}`:s||m;return[r,p,f].filter(Boolean).join(" ")}exports.clampFont=Z;exports.compactName=K;exports.convertToWoff=I;exports.convertToWoff2=D;exports.getInstances=R;
+`))),O}function H(t){return t.replace(/[^A-Za-z0-9 -]/g,"").trim().split(/\s+/).join("-").replace(/^-+|-+$/g,"").slice(0,63)}async function J(t,o){if(!o)return t;const a=await d(),e=new x({pyodide:a}),n=new x({pyodide:a});try{const i=H(o);await e.upload(t);const s=new Map([["input-file",e.filename],["output-file",n.filename],["family-name",o],["postscript-name",i]]);return(await z())(s),n.download()}catch(i){throw Object.assign(new Error(`vf-clamp: name table patching failed for "${o}"`),{cause:i})}finally{try{e.delete()}catch{}try{n.delete()}catch{}}}function Z(t){return typeof t=="number"?t:t===null?null:[t.min,t.max]}async function K(t,o){const a=await d(),e=new x({pyodide:a}),n=new x({pyodide:a});try{await e.upload(t);const i=new Map([["input-file",e.filename],["output-file",n.filename]]);return(await W())(i,JSON.stringify(o)),n.download()}finally{try{e.delete()}catch{}try{n.delete()}catch{}}}async function Q(t){const o=await d(),a=new x({pyodide:o}),e=new x({pyodide:o});try{await a.upload(t);const n=new Map([["input-file",a.filename],["output-file",e.filename]]);return(await B())(n),e.download()}catch(n){throw Object.assign(new Error("vf-clamp: STAT pruning failed"),{cause:n})}finally{try{a.delete()}catch{}try{e.delete()}catch{}}}async function X(t){const o=await d(),a=new x({pyodide:o}),e=new x({pyodide:o});try{await a.upload(t);const n=new Map([["input-file",a.filename],["output-file",e.filename]]);return(await G())(n),e.download()}catch(n){throw Object.assign(new Error("vf-clamp: OS/2 and macStyle update failed"),{cause:n})}finally{try{a.delete()}catch{}try{e.delete()}catch{}}}async function Y(t,o){const a=await d(),e=new x({pyodide:a}),n=new x({pyodide:a});try{await e.upload(t);const i=new Map([["input-file",e.filename],["output-file",n.filename]]);return(await q())(i,String(o)),n.download()}catch(i){throw Object.assign(new Error("vf-clamp: wght normalisation failed"),{cause:i})}finally{try{e.delete()}catch{}try{n.delete()}catch{}}}function tt(t,o){const a=new Map(o.map(i=>[i.name,i])),e={};for(const i of t){const s=a.get(i);if(!s)throw new Error(`Named instance "${i}" not found in font`);for(const[f,c]of Object.entries(s.coordinates))e[f]?(e[f].min=Math.min(e[f].min,c),e[f].max=Math.max(e[f].max,c)):e[f]={min:c,max:c}}const n={};for(const[i,{min:s,max:f}]of Object.entries(e))n[i]=s===f?s:{min:s,max:f};return n}function et(t){return t.length>=4&&t[0]===79&&t[1]===84&&t[2]===84&&t[3]===79}async function nt(t,o){var f,c,w;if(o.outputs.length===0)return[];const a=t instanceof ArrayBuffer?new Uint8Array(t):t,e=o.format??"ttf",{instances:n,axes:i}=await L(a),s=[];for(const m of o.outputs){let _={};if((f=m.instances)!=null&&f.length&&(_=tt(m.instances,n)),m.axes&&(_={..._,...m.axes}),o.strict&&((c=m.instances)!=null&&c.length)){const p=new Set(m.instances),g=n.filter(h=>!p.has(h.name)&&i.every(y=>{const A=h.coordinates[y.tag]??y.default,v=_[y.tag];return v==null?!0:typeof v=="number"?A===v:A>=v.min&&A<=v.max})).map(h=>h.name);if(g.length)throw new Error(`vf-clamp: output "${m.name||m.instances.join(", ")}" would include unselected instances (${g.join(", ")}); use planOutputs() to split the selection`)}for(const p of i){const g=_[p.tag];if(g!=null&&typeof g=="object"){const h=g;if(p.default<h.min||p.default>h.max){const y=Math.max(h.min,Math.min(h.max,p.default));console.warn(`vf-clamp: axis "${p.tag}" default (${p.default}) is outside restricted range [${h.min}, ${h.max}] — will be clamped to ${y}`)}}}const r={};for(const[p,g]of Object.entries(_))g!==null&&(r[p]=Z(g));const u=m.name||((w=m.instances)!=null&&w.length?m.instances.length===1?m.instances[0]:`${m.instances[0]}-${m.instances[m.instances.length-1]}`:"output");let l=await K(a,r);if(e==="otf"&&!et(l))throw new Error("vf-clamp: format 'otf' needs a CFF/CFF2 source font; this font has TrueType outlines — use 'ttf'");l=await Q(l),o.normalizeWeightAxis&&(l=await Y(l,100)),l=await X(l),l=await J(l,u),e==="woff2"?l=await M(l):e==="woff"&&(l=await j(l)),s.push({name:u,buffer:l,format:e})}return s}function U(t,o){if(t===o)return t;const a=t.split(" "),e=o.split(" ");let n=0;for(;n<a.length&&n<e.length&&a[n]===e[n];)n++;let i=0;for(;i<a.length-n&&i<e.length-n&&a[a.length-1-i]===e[e.length-1-i];)i++;const s=a.slice(0,n).join(" "),f=a.slice(n,a.length-(i||0)).join(" "),c=e.slice(n,e.length-(i||0)).join(" "),w=i>0?a.slice(a.length-i).join(" "):"",m=f&&c?`${f}-${c}`:f||c;return[s,m,w].filter(Boolean).join(" ")}function R(t,o){const a={};for(const e of o){const n=t.map(i=>i.coordinates[e.tag]??e.default);a[e.tag]={min:Math.min(...n),max:Math.max(...n)}}return a}function N(t,o,a,e){return o.filter(n=>a.has(n.name)?!1:e.every(i=>{const s=n.coordinates[i.tag]??i.default,f=t[i.tag];return!f||s>=f.min&&s<=f.max}))}function at(t){return t.reduce((o,a)=>!o||a.maximum-a.minimum>o.maximum-o.minimum?a:o,void 0)}function it(t,o,a){const{axes:e,instances:n}=t,i=new Map(n.map(r=>[r.name,r])),s=[];for(const r of new Set(o)){const u=i.get(r);if(!u)throw new Error(`Named instance "${r}" not found in font`);s.push(u)}if(!s.length)return[];const f=new Set(s.map(r=>r.name));let c;if(!N(R(s,e),n,f,e).length)c=[s];else{c=s.map(u=>[u]);let r=!0;for(;r;){r=!1;t:for(let u=0;u<c.length;u++)for(let l=u+1;l<c.length;l++){const p=[...c[u],...c[l]];if(!N(R(p,e),n,f,e).length){c[u]=p,c.splice(l,1),r=!0;break t}}}}const w=at(e),m=w?[w,...e.filter(r=>r.tag!==w.tag)]:e,_=(r,u)=>{for(const l of m){const p=(r.coordinates[l.tag]??l.default)-(u.coordinates[l.tag]??l.default);if(p)return p}return 0};return c=c.map(r=>[...r].sort(_)).sort((r,u)=>_(r[0],u[0])),c.map(r=>{const u=r[0],l=r[r.length-1],p=r.length===1?u.name:U(u.name,l.name);return{name:a?`${a} ${p}`:p,instances:r.map(g=>g.name)}})}function ot(t,o){const a=new Map(t.instances.map(n=>[n.name,n])),e=o.map(n=>a.get(n)).filter(n=>!!n);return e.length?N(R(e,t.axes),t.instances,new Set(o),t.axes).map(n=>n.name):[]}exports.clampFont=nt;exports.compactName=U;exports.convertToWoff=j;exports.convertToWoff2=M;exports.getInstances=L;exports.planOutputs=it;exports.unboughtInstances=ot;

package/dist/index.d.ts

@@ -52,9 +52,15 @@ export declare interface ClampOptions {
     /**
      * Output format — defaults to 'ttf'.
      * 'woff' and 'woff2' transcode the result to a web-compressed flavour.
-     * 'otf' is a passthrough — the instancer preserves the input outline format.
+     * 'otf' is a label, not a conversion — it requires a CFF/CFF2 source and throws for TrueType outlines.
      */
     format?: OutputFormat;
+    /**
+     * Refuse any instances-based output whose range would include a named instance that was not listed
+     * (e.g. Regular + Bold would also hand over Medium and SemiBold). Throws instead of clamping.
+     * Use planOutputs() to split a customer's selection into safe outputs. Defaults to false.
+     */
+    strict?: boolean;
     /**
      * Remap the wght axis so its minimum becomes 100, making CSS font-weight values
      * (100–900) work as expected. Instance and STAT axis value coordinates are
@@ -147,14 +153,40 @@ export declare interface OutputConfig {
 /**
  * Output format for clampFont() — defaults to 'ttf'.
  * 'woff' and 'woff2' transcode to web-compressed flavours.
- * 'otf' is a passthrough (no outline conversion); the instancer preserves the input flavour.
+ * 'otf' requires a CFF/CFF2 source (no outline conversion is done) and throws for TrueType outlines.
  */
 export declare type OutputFormat = 'ttf' | 'otf' | 'woff' | 'woff2';
 
 /** Pin an axis at a single value — the axis is locked and removed from the output font's design space */
 export declare type PinnedAxis = number;
 
+/**
+ * Groups a customer's selected named instances into clampFont outputs so that no output's range
+ * contains a named instance the customer did not select.
+ *
+ * Selections merge into one output only when their combined range holds no unselected named
+ * instance: Regular + Medium + SemiBold + Bold → one output; Regular + Bold alone → two outputs
+ * (each pinned to its own instance). Output names come from compactName(), optionally prefixed
+ * with `family`.
+ *
+ * @param font - The font's axes and named instances, from getInstances()
+ * @param selected - Names of the instances the customer bought (must match exactly)
+ * @param family - Optional family name to prefix each output name with, e.g. "Encode Sans"
+ * @returns OutputConfig entries ready for clampFont(), sorted along the primary axis
+ * @throws If a selected name is not a named instance of the font
+ */
+export declare function planOutputs(font: FontInstancesResult, selected: string[], family?: string): OutputConfig[];
+
 /** @deprecated Use OutputConfig instead */
 export declare type SubfamilyConfig = OutputConfig;
 
+/**
+ * Lists the named instances that a single output built from `names` would include without being selected,
+ * e.g. ['Medium', 'SemiBold'] for Regular + Bold. An empty array means the output is purchase-safe.
+ *
+ * @param font - The font's axes and named instances, from getInstances()
+ * @param names - The instance names one output would hull
+ */
+export declare function unboughtInstances(font: FontInstancesResult, names: string[]): string[];
+
 export { }

package/dist/index.js

@@ -1,8 +1,8 @@
-import { createRequire as D } from "node:module";
-const I = D(import.meta.url), { preparePyodide: l, PyodideFile: u } = I("@web-alchemy/fonttools/src/pyodide.js");
-let g = null;
-async function P() {
-  return g || (g = l().then(
+import { createRequire as j } from "node:module";
+const R = j(import.meta.url), { preparePyodide: d, PyodideFile: x } = R("@web-alchemy/fonttools/src/pyodide.js");
+let T = null;
+async function M() {
+  return T || (T = d().then(
     (t) => t.runPythonAsync(`
 from fontTools.ttLib import TTFont
 
@@ -13,10 +13,10 @@ def vf_convert_flavor(file_options):
 
 vf_convert_flavor
 `)
-  )), g;
+  )), T;
 }
-async function V(t, o) {
-  const a = await l(), e = new u({ pyodide: a }), n = new u({ pyodide: a });
+async function P(t, o) {
+  const a = await d(), e = new x({ pyodide: a }), n = new x({ pyodide: a });
   try {
     await e.upload(t);
     const i = /* @__PURE__ */ new Map([
@@ -24,7 +24,7 @@ async function V(t, o) {
       ["output-file", n.filename],
       ["flavor", o]
     ]);
-    return (await P())(i), n.download();
+    return (await M())(i), n.download();
   } finally {
     try {
       e.delete();
@@ -36,15 +36,15 @@ async function V(t, o) {
     }
   }
 }
-async function R(t) {
-  return V(t, "woff");
+async function L(t) {
+  return P(t, "woff");
 }
-async function N(t) {
-  return V(t, "woff2");
+async function $(t) {
+  return P(t, "woff2");
 }
-let h = null;
-async function O() {
-  return h || (h = l().then(
+let b = null;
+async function k() {
+  return b || (b = d().then(
     (t) => t.runPythonAsync(`
 import json
 from fontTools.ttLib import TTFont
@@ -81,13 +81,13 @@ def get_instances_fn(input_file):
 
 get_instances_fn
 `)
-  )), h;
+  )), b;
 }
-async function j(t) {
-  const o = await l(), a = t instanceof ArrayBuffer ? new Uint8Array(t) : t, e = new u({ pyodide: o });
+async function E(t) {
+  const o = await d(), a = t instanceof ArrayBuffer ? new Uint8Array(t) : t, e = new x({ pyodide: o });
   try {
     await e.upload(a);
-    const i = (await O())(e.filename);
+    const i = (await k())(e.filename);
     return JSON.parse(i);
   } finally {
     try {
@@ -96,9 +96,9 @@ async function j(t) {
     }
   }
 }
-let w = null, v = null, y = null, A = null, T = null;
-async function L() {
-  return w || (w = l().then(
+let F = null, S = null, V = null, I = null, D = null;
+async function U() {
+  return F || (F = d().then(
     (t) => t.runPythonAsync(`
 from fontTools import ttLib
 
@@ -153,10 +153,10 @@ def patch_font_names_fn(file_options):
 
 patch_font_names_fn
 `)
-  )), w;
+  )), F;
 }
-async function M() {
-  return v || (v = l().then(
+async function C() {
+  return S || (S = d().then(
     (t) => t.runPythonAsync(`
 from fontTools.ttLib import TTFont
 from fontTools.varLib import instancer
@@ -187,10 +187,10 @@ def vf_clamp_instantiate(file_options, axes_json):
 
 vf_clamp_instantiate
 `)
-  )), v;
+  )), S;
 }
-async function U() {
-  return y || (y = l().then(
+async function z() {
+  return V || (V = d().then(
     (t) => t.runPythonAsync(`
 from fontTools.ttLib import TTFont
 
@@ -249,10 +249,10 @@ def vf_clamp_normalize_wght(file_options, new_min_str):
 
 vf_clamp_normalize_wght
 `)
-  )), y;
+  )), V;
 }
-async function k() {
-  return A || (A = l().then(
+async function B() {
+  return I || (I = d().then(
     (t) => t.runPythonAsync(`
 from fontTools.ttLib import TTFont
 
@@ -312,10 +312,10 @@ def vf_clamp_prune_stat(file_options):
 
 vf_clamp_prune_stat
 `)
-  )), A;
+  )), I;
 }
-async function $() {
-  return T || (T = l().then(
+async function W() {
+  return D || (D = d().then(
     (t) => t.runPythonAsync(`
 from fontTools.ttLib import TTFont
 
@@ -362,26 +362,26 @@ def vf_clamp_update_os2(file_options):
 
 vf_clamp_update_os2
 `)
-  )), T;
+  )), D;
 }
-function C(t) {
+function q(t) {
   return t.replace(/[^A-Za-z0-9 -]/g, "").trim().split(/\s+/).join("-").replace(/^-+|-+$/g, "").slice(0, 63);
 }
-async function z(t, o) {
+async function G(t, o) {
   if (!o) return t;
-  const a = await l(), e = new u({ pyodide: a }), n = new u({ pyodide: a });
+  const a = await d(), e = new x({ pyodide: a }), n = new x({ pyodide: a });
   try {
-    const i = C(o);
+    const i = q(o);
     await e.upload(t);
-    const r = /* @__PURE__ */ new Map([
+    const s = /* @__PURE__ */ new Map([
       ["input-file", e.filename],
       ["output-file", n.filename],
       ["family-name", o],
       ["postscript-name", i]
     ]);
-    return (await L())(r), n.download();
+    return (await U())(s), n.download();
   } catch (i) {
-    return console.warn(`vf-clamp: name table patching failed for "${o}" — returning unpatched buffer`, i), t;
+    throw Object.assign(new Error(`vf-clamp: name table patching failed for "${o}"`), { cause: i });
   } finally {
     try {
       e.delete();
@@ -393,18 +393,18 @@ async function z(t, o) {
     }
   }
 }
-function B(t) {
+function H(t) {
   return typeof t == "number" ? t : t === null ? null : [t.min, t.max];
 }
-async function E(t, o) {
-  const a = await l(), e = new u({ pyodide: a }), n = new u({ pyodide: a });
+async function J(t, o) {
+  const a = await d(), e = new x({ pyodide: a }), n = new x({ pyodide: a });
   try {
     await e.upload(t);
     const i = /* @__PURE__ */ new Map([
       ["input-file", e.filename],
       ["output-file", n.filename]
     ]);
-    return (await M())(i, JSON.stringify(o)), n.download();
+    return (await C())(i, JSON.stringify(o)), n.download();
   } finally {
     try {
       e.delete();
@@ -416,17 +416,17 @@ async function E(t, o) {
     }
   }
 }
-async function W(t) {
-  const o = await l(), a = new u({ pyodide: o }), e = new u({ pyodide: o });
+async function Z(t) {
+  const o = await d(), a = new x({ pyodide: o }), e = new x({ pyodide: o });
   try {
     await a.upload(t);
     const n = /* @__PURE__ */ new Map([
       ["input-file", a.filename],
       ["output-file", e.filename]
     ]);
-    return (await k())(n), e.download();
+    return (await B())(n), e.download();
   } catch (n) {
-    return console.warn("vf-clamp: STAT prune failed — returning unpruned buffer", n), t;
+    throw Object.assign(new Error("vf-clamp: STAT pruning failed"), { cause: n });
   } finally {
     try {
       a.delete();
@@ -438,17 +438,17 @@ async function W(t) {
     }
   }
 }
-async function q(t) {
-  const o = await l(), a = new u({ pyodide: o }), e = new u({ pyodide: o });
+async function K(t) {
+  const o = await d(), a = new x({ pyodide: o }), e = new x({ pyodide: o });
   try {
     await a.upload(t);
     const n = /* @__PURE__ */ new Map([
       ["input-file", a.filename],
       ["output-file", e.filename]
     ]);
-    return (await $())(n), e.download();
+    return (await W())(n), e.download();
   } catch (n) {
-    return console.warn("vf-clamp: OS/2 + macStyle update failed — returning original buffer", n), t;
+    throw Object.assign(new Error("vf-clamp: OS/2 and macStyle update failed"), { cause: n });
   } finally {
     try {
       a.delete();
@@ -460,17 +460,17 @@ async function q(t) {
     }
   }
 }
-async function G(t, o) {
-  const a = await l(), e = new u({ pyodide: a }), n = new u({ pyodide: a });
+async function Q(t, o) {
+  const a = await d(), e = new x({ pyodide: a }), n = new x({ pyodide: a });
   try {
     await e.upload(t);
     const i = /* @__PURE__ */ new Map([
       ["input-file", e.filename],
       ["output-file", n.filename]
     ]);
-    return (await U())(i, String(o)), n.download();
+    return (await z())(i, String(o)), n.download();
   } catch (i) {
-    return console.warn("vf-clamp: wght normalisation failed — returning unnormalised buffer", i), t;
+    throw Object.assign(new Error("vf-clamp: wght normalisation failed"), { cause: i });
   } finally {
     try {
       e.delete();
@@ -482,57 +482,60 @@ async function G(t, o) {
     }
   }
 }
-function J(t, o) {
+function X(t, o) {
   const a = new Map(o.map((i) => [i.name, i])), e = {};
   for (const i of t) {
-    const r = a.get(i);
-    if (!r) throw new Error(`Named instance "${i}" not found in font`);
-    for (const [s, m] of Object.entries(r.coordinates))
-      e[s] ? (e[s].min = Math.min(e[s].min, m), e[s].max = Math.max(e[s].max, m)) : e[s] = { min: m, max: m };
+    const s = a.get(i);
+    if (!s) throw new Error(`Named instance "${i}" not found in font`);
+    for (const [f, c] of Object.entries(s.coordinates))
+      e[f] ? (e[f].min = Math.min(e[f].min, c), e[f].max = Math.max(e[f].max, c)) : e[f] = { min: c, max: c };
   }
   const n = {};
-  for (const [i, { min: r, max: s }] of Object.entries(e))
-    n[i] = r === s ? r : { min: r, max: s };
+  for (const [i, { min: s, max: f }] of Object.entries(e))
+    n[i] = s === f ? s : { min: s, max: f };
   return n;
 }
-async function Z(t, o) {
-  var s, m;
+function Y(t) {
+  return t.length >= 4 && t[0] === 79 && t[1] === 84 && t[2] === 84 && t[3] === 79;
+}
+async function at(t, o) {
+  var f, c, w;
   if (o.outputs.length === 0) return [];
-  const a = t instanceof ArrayBuffer ? new Uint8Array(t) : t, e = o.format ?? "ttf";
-  let n = [], i = [];
-  if (o.outputs.some((f) => {
-    var p;
-    return (p = f.instances) == null ? void 0 : p.length;
-  })) {
-    const f = await j(a);
-    n = f.instances, i = f.axes;
-  }
-  const r = [];
-  for (const f of o.outputs) {
-    let p = {};
-    (s = f.instances) != null && s.length && (p = J(f.instances, n)), f.axes && (p = { ...p, ...f.axes });
-    for (const d of i) {
-      const x = p[d.tag];
-      if (x != null && typeof x == "object") {
-        const _ = x;
-        if (d.default < _.min || d.default > _.max) {
-          const S = Math.max(_.min, Math.min(_.max, d.default));
+  const a = t instanceof ArrayBuffer ? new Uint8Array(t) : t, e = o.format ?? "ttf", { instances: n, axes: i } = await E(a), s = [];
+  for (const m of o.outputs) {
+    let _ = {};
+    if ((f = m.instances) != null && f.length && (_ = X(m.instances, n)), m.axes && (_ = { ..._, ...m.axes }), o.strict && ((c = m.instances) != null && c.length)) {
+      const p = new Set(m.instances), g = n.filter((h) => !p.has(h.name) && i.every((y) => {
+        const A = h.coordinates[y.tag] ?? y.default, v = _[y.tag];
+        return v == null ? !0 : typeof v == "number" ? A === v : A >= v.min && A <= v.max;
+      })).map((h) => h.name);
+      if (g.length)
+        throw new Error(`vf-clamp: output "${m.name || m.instances.join(", ")}" would include unselected instances (${g.join(", ")}); use planOutputs() to split the selection`);
+    }
+    for (const p of i) {
+      const g = _[p.tag];
+      if (g != null && typeof g == "object") {
+        const h = g;
+        if (p.default < h.min || p.default > h.max) {
+          const y = Math.max(h.min, Math.min(h.max, p.default));
           console.warn(
-            `vf-clamp: axis "${d.tag}" default (${d.default}) is outside restricted range [${_.min}, ${_.max}] — will be clamped to ${S}`
+            `vf-clamp: axis "${p.tag}" default (${p.default}) is outside restricted range [${h.min}, ${h.max}] — will be clamped to ${y}`
           );
         }
       }
     }
-    const b = {};
-    for (const [d, x] of Object.entries(p))
-      x !== null && (b[d] = B(x));
-    const F = f.name ?? ((m = f.instances) != null && m.length ? f.instances.length === 1 ? f.instances[0] : `${f.instances[0]}-${f.instances[f.instances.length - 1]}` : "output");
-    let c = await E(a, b);
-    c = await W(c), o.normalizeWeightAxis && (c = await G(c, 100)), c = await q(c), c = await z(c, F), e === "woff2" ? c = await N(c) : e === "woff" && (c = await R(c)), r.push({ name: F, buffer: c, format: e });
+    const r = {};
+    for (const [p, g] of Object.entries(_))
+      g !== null && (r[p] = H(g));
+    const u = m.name || ((w = m.instances) != null && w.length ? m.instances.length === 1 ? m.instances[0] : `${m.instances[0]}-${m.instances[m.instances.length - 1]}` : "output");
+    let l = await J(a, r);
+    if (e === "otf" && !Y(l))
+      throw new Error("vf-clamp: format 'otf' needs a CFF/CFF2 source font; this font has TrueType outlines — use 'ttf'");
+    l = await Z(l), o.normalizeWeightAxis && (l = await Q(l, 100)), l = await K(l), l = await G(l, u), e === "woff2" ? l = await $(l) : e === "woff" && (l = await L(l)), s.push({ name: u, buffer: l, format: e });
   }
-  return r;
+  return s;
 }
-function K(t, o) {
+function tt(t, o) {
   if (t === o) return t;
   const a = t.split(" "), e = o.split(" ");
   let n = 0;
@@ -541,13 +544,75 @@ function K(t, o) {
   let i = 0;
   for (; i < a.length - n && i < e.length - n && a[a.length - 1 - i] === e[e.length - 1 - i]; )
     i++;
-  const r = a.slice(0, n).join(" "), s = a.slice(n, a.length - (i || 0)).join(" "), m = e.slice(n, e.length - (i || 0)).join(" "), f = i > 0 ? a.slice(a.length - i).join(" ") : "", p = s && m ? `${s}-${m}` : s || m;
-  return [r, p, f].filter(Boolean).join(" ");
+  const s = a.slice(0, n).join(" "), f = a.slice(n, a.length - (i || 0)).join(" "), c = e.slice(n, e.length - (i || 0)).join(" "), w = i > 0 ? a.slice(a.length - i).join(" ") : "", m = f && c ? `${f}-${c}` : f || c;
+  return [s, m, w].filter(Boolean).join(" ");
+}
+function O(t, o) {
+  const a = {};
+  for (const e of o) {
+    const n = t.map((i) => i.coordinates[e.tag] ?? e.default);
+    a[e.tag] = { min: Math.min(...n), max: Math.max(...n) };
+  }
+  return a;
+}
+function N(t, o, a, e) {
+  return o.filter((n) => a.has(n.name) ? !1 : e.every((i) => {
+    const s = n.coordinates[i.tag] ?? i.default, f = t[i.tag];
+    return !f || s >= f.min && s <= f.max;
+  }));
+}
+function et(t) {
+  return t.reduce((o, a) => !o || a.maximum - a.minimum > o.maximum - o.minimum ? a : o, void 0);
+}
+function it(t, o, a) {
+  const { axes: e, instances: n } = t, i = new Map(n.map((r) => [r.name, r])), s = [];
+  for (const r of new Set(o)) {
+    const u = i.get(r);
+    if (!u) throw new Error(`Named instance "${r}" not found in font`);
+    s.push(u);
+  }
+  if (!s.length) return [];
+  const f = new Set(s.map((r) => r.name));
+  let c;
+  if (!N(O(s, e), n, f, e).length)
+    c = [s];
+  else {
+    c = s.map((u) => [u]);
+    let r = !0;
+    for (; r; ) {
+      r = !1;
+      t: for (let u = 0; u < c.length; u++)
+        for (let l = u + 1; l < c.length; l++) {
+          const p = [...c[u], ...c[l]];
+          if (!N(O(p, e), n, f, e).length) {
+            c[u] = p, c.splice(l, 1), r = !0;
+            break t;
+          }
+        }
+    }
+  }
+  const w = et(e), m = w ? [w, ...e.filter((r) => r.tag !== w.tag)] : e, _ = (r, u) => {
+    for (const l of m) {
+      const p = (r.coordinates[l.tag] ?? l.default) - (u.coordinates[l.tag] ?? l.default);
+      if (p) return p;
+    }
+    return 0;
+  };
+  return c = c.map((r) => [...r].sort(_)).sort((r, u) => _(r[0], u[0])), c.map((r) => {
+    const u = r[0], l = r[r.length - 1], p = r.length === 1 ? u.name : tt(u.name, l.name);
+    return { name: a ? `${a} ${p}` : p, instances: r.map((g) => g.name) };
+  });
+}
+function ot(t, o) {
+  const a = new Map(t.instances.map((n) => [n.name, n])), e = o.map((n) => a.get(n)).filter((n) => !!n);
+  return e.length ? N(O(e, t.axes), t.instances, new Set(o), t.axes).map((n) => n.name) : [];
 }
 export {
-  Z as clampFont,
-  K as compactName,
-  R as convertToWoff,
-  N as convertToWoff2,
-  j as getInstances
+  at as clampFont,
+  tt as compactName,
+  L as convertToWoff,
+  $ as convertToWoff2,
+  E as getInstances,
+  it as planOutputs,
+  ot as unboughtInstances
 };