@fluixi/utils 1.0.0-alpha.82 → 1.0.0-alpha.84

package/dist/lib/object/reconcile.cjs

@@ -1 +1,126 @@
-"use strict";var g=Object.defineProperty;var O=Object.getOwnPropertyDescriptor;var w=Object.getOwnPropertyNames;var b=Object.prototype.hasOwnProperty;var j=(i,e)=>{for(var r in e)g(i,r,{get:e[r],enumerable:!0})},A=(i,e,r,f)=>{if(e&&typeof e=="object"||typeof e=="function")for(let a of w(e))!b.call(i,a)&&a!==r&&g(i,a,{get:()=>e[a],enumerable:!(f=O(e,a))||f.enumerable});return i};var h=i=>A(g({},"__esModule",{value:!0}),i);var v={};j(v,{reconcile:()=>q});module.exports=h(v);function p(i){if(i==null||typeof i!="object")return!1;let e=Object.getPrototypeOf(i);return e===Object.prototype||e===null}function k(i,e,r){return i===e?e:Array.isArray(i)?T(i,Array.isArray(e)?e:[],r):p(i)?m(i,p(e)?e:{},r):i}function T(i,e,r){let{key:f,keepRef:a}=r,u=e.length,o=i.length,s=new Array(u);for(let n=0;n<u;n++)s[n]=e[n];if(f===!1){if(a){for(let l=0;l<o;l++){let R=k(i[l],s[l],r);R!==s[l]&&(e[l]=R)}return u>o&&e.splice(o),e}let n=o!==u,t=new Array(o);for(let l=0;l<o;l++)t[l]=k(i[l],s[l],r),t[l]!==s[l]&&(n=!0);return n?t:e}let d=new Map;for(let n=0;n<u;n++){let t=s[n];t!=null&&typeof t=="object"&&f in t&&d.set(t[f],t)}let y=new Array(o);for(let n=0;n<o;n++){let t=i[n];t!=null&&typeof t=="object"&&f in t?y[n]=k(t,d.get(t[f]),r):y[n]=k(t,s[n],r)}if(a){for(let n=0;n<o;n++)y[n]!==s[n]&&(e[n]=y[n]);return u>o&&e.splice(o),e}let c=o!==u;for(let n=0;!c&&n<o;n++)y[n]!==s[n]&&(c=!0);return c?y:e}function m(i,e,r){let{merge:f,keepRef:a}=r,u=Object.keys(i),o=Object.keys(e),s=Object.create(null);for(let c=0;c<o.length;c++)s[o[c]]=e[o[c]];let d=null,y=()=>(d||(d=a?e:{...s}),d);if(!f)for(let c=0;c<o.length;c++){let n=o[c];n in i||delete y()[n]}for(let c=0;c<u.length;c++){let n=u[c],t=s[n],l=k(i[n],t,r);(l!==t||!(n in s))&&(y()[n]=l)}return d??e}function q(i,e){let r={key:e?.key!==void 0?e.key:"id",merge:e?.merge??!1,keepRef:e?.keepRef??!1};return f=>f==null?i:k(i,f,r)}
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/object/reconcile.ts
+var reconcile_exports = {};
+__export(reconcile_exports, {
+  reconcile: () => reconcile
+});
+module.exports = __toCommonJS(reconcile_exports);
+function isPlain(v) {
+  if (v == null || typeof v !== "object") return false;
+  const p = Object.getPrototypeOf(v);
+  return p === Object.prototype || p === null;
+}
+function reconcileValue(next, current, opts) {
+  if (next === current) return current;
+  if (Array.isArray(next)) return reconcileArr(next, Array.isArray(current) ? current : [], opts);
+  if (isPlain(next)) return reconcileObj(next, isPlain(current) ? current : {}, opts);
+  return next;
+}
+function reconcileArr(next, current, opts) {
+  const { key, keepRef } = opts;
+  const curLen = current.length;
+  const nextLen = next.length;
+  const curItems = new Array(curLen);
+  for (let i = 0; i < curLen; i++) curItems[i] = current[i];
+  if (key === false) {
+    if (keepRef) {
+      for (let i = 0; i < nextLen; i++) {
+        const rv = reconcileValue(next[i], curItems[i], opts);
+        if (rv !== curItems[i]) current[i] = rv;
+      }
+      if (curLen > nextLen) current.splice(nextLen);
+      return current;
+    }
+    let changed2 = nextLen !== curLen;
+    const out = new Array(nextLen);
+    for (let i = 0; i < nextLen; i++) {
+      out[i] = reconcileValue(next[i], curItems[i], opts);
+      if (out[i] !== curItems[i]) changed2 = true;
+    }
+    return changed2 ? out : current;
+  }
+  const currentMap = /* @__PURE__ */ new Map();
+  for (let i = 0; i < curLen; i++) {
+    const item = curItems[i];
+    if (item != null && typeof item === "object" && key in item) {
+      currentMap.set(item[key], item);
+    }
+  }
+  const resolved = new Array(nextLen);
+  for (let i = 0; i < nextLen; i++) {
+    const n = next[i];
+    if (n != null && typeof n === "object" && key in n) {
+      resolved[i] = reconcileValue(n, currentMap.get(n[key]), opts);
+    } else {
+      resolved[i] = reconcileValue(n, curItems[i], opts);
+    }
+  }
+  if (keepRef) {
+    for (let i = 0; i < nextLen; i++) {
+      if (resolved[i] !== curItems[i]) current[i] = resolved[i];
+    }
+    if (curLen > nextLen) current.splice(nextLen);
+    return current;
+  }
+  let changed = nextLen !== curLen;
+  for (let i = 0; !changed && i < nextLen; i++) {
+    if (resolved[i] !== curItems[i]) changed = true;
+  }
+  return changed ? resolved : current;
+}
+function reconcileObj(next, current, opts) {
+  const { merge, keepRef } = opts;
+  const nextKeys = Object.keys(next);
+  const currentKeys = Object.keys(current);
+  const curValues = /* @__PURE__ */ Object.create(null);
+  for (let i = 0; i < currentKeys.length; i++) {
+    curValues[currentKeys[i]] = current[currentKeys[i]];
+  }
+  let out = null;
+  const getOut = () => {
+    if (!out) out = keepRef ? current : { ...curValues };
+    return out;
+  };
+  if (!merge) {
+    for (let i = 0; i < currentKeys.length; i++) {
+      const k = currentKeys[i];
+      if (!(k in next)) delete getOut()[k];
+    }
+  }
+  for (let i = 0; i < nextKeys.length; i++) {
+    const k = nextKeys[i];
+    const cv = curValues[k];
+    const rv = reconcileValue(next[k], cv, opts);
+    if (rv !== cv || !(k in curValues)) getOut()[k] = rv;
+  }
+  return out ?? current;
+}
+function reconcile(next, options) {
+  const opts = {
+    key: options?.key !== void 0 ? options.key : "id",
+    merge: options?.merge ?? false,
+    keepRef: options?.keepRef ?? false
+  };
+  return (current) => {
+    if (current === void 0 || current === null) return next;
+    return reconcileValue(next, current, opts);
+  };
+}

package/dist/lib/object/reconcile.mjs

@@ -1 +1,105 @@
-function R(i){if(i==null||typeof i!="object")return!1;let n=Object.getPrototypeOf(i);return n===Object.prototype||n===null}function d(i,n,f){return i===n?n:Array.isArray(i)?p(i,Array.isArray(n)?n:[],f):R(i)?O(i,R(n)?n:{},f):i}function p(i,n,f){let{key:s,keepRef:k}=f,a=n.length,o=i.length,c=new Array(a);for(let e=0;e<a;e++)c[e]=n[e];if(s===!1){if(k){for(let r=0;r<o;r++){let g=d(i[r],c[r],f);g!==c[r]&&(n[r]=g)}return a>o&&n.splice(o),n}let e=o!==a,t=new Array(o);for(let r=0;r<o;r++)t[r]=d(i[r],c[r],f),t[r]!==c[r]&&(e=!0);return e?t:n}let y=new Map;for(let e=0;e<a;e++){let t=c[e];t!=null&&typeof t=="object"&&s in t&&y.set(t[s],t)}let u=new Array(o);for(let e=0;e<o;e++){let t=i[e];t!=null&&typeof t=="object"&&s in t?u[e]=d(t,y.get(t[s]),f):u[e]=d(t,c[e],f)}if(k){for(let e=0;e<o;e++)u[e]!==c[e]&&(n[e]=u[e]);return a>o&&n.splice(o),n}let l=o!==a;for(let e=0;!l&&e<o;e++)u[e]!==c[e]&&(l=!0);return l?u:n}function O(i,n,f){let{merge:s,keepRef:k}=f,a=Object.keys(i),o=Object.keys(n),c=Object.create(null);for(let l=0;l<o.length;l++)c[o[l]]=n[o[l]];let y=null,u=()=>(y||(y=k?n:{...c}),y);if(!s)for(let l=0;l<o.length;l++){let e=o[l];e in i||delete u()[e]}for(let l=0;l<a.length;l++){let e=a[l],t=c[e],r=d(i[e],t,f);(r!==t||!(e in c))&&(u()[e]=r)}return y??n}function w(i,n){let f={key:n?.key!==void 0?n.key:"id",merge:n?.merge??!1,keepRef:n?.keepRef??!1};return s=>s==null?i:d(i,s,f)}export{w as reconcile};
+// src/lib/object/reconcile.ts
+function isPlain(v) {
+  if (v == null || typeof v !== "object") return false;
+  const p = Object.getPrototypeOf(v);
+  return p === Object.prototype || p === null;
+}
+function reconcileValue(next, current, opts) {
+  if (next === current) return current;
+  if (Array.isArray(next)) return reconcileArr(next, Array.isArray(current) ? current : [], opts);
+  if (isPlain(next)) return reconcileObj(next, isPlain(current) ? current : {}, opts);
+  return next;
+}
+function reconcileArr(next, current, opts) {
+  const { key, keepRef } = opts;
+  const curLen = current.length;
+  const nextLen = next.length;
+  const curItems = new Array(curLen);
+  for (let i = 0; i < curLen; i++) curItems[i] = current[i];
+  if (key === false) {
+    if (keepRef) {
+      for (let i = 0; i < nextLen; i++) {
+        const rv = reconcileValue(next[i], curItems[i], opts);
+        if (rv !== curItems[i]) current[i] = rv;
+      }
+      if (curLen > nextLen) current.splice(nextLen);
+      return current;
+    }
+    let changed2 = nextLen !== curLen;
+    const out = new Array(nextLen);
+    for (let i = 0; i < nextLen; i++) {
+      out[i] = reconcileValue(next[i], curItems[i], opts);
+      if (out[i] !== curItems[i]) changed2 = true;
+    }
+    return changed2 ? out : current;
+  }
+  const currentMap = /* @__PURE__ */ new Map();
+  for (let i = 0; i < curLen; i++) {
+    const item = curItems[i];
+    if (item != null && typeof item === "object" && key in item) {
+      currentMap.set(item[key], item);
+    }
+  }
+  const resolved = new Array(nextLen);
+  for (let i = 0; i < nextLen; i++) {
+    const n = next[i];
+    if (n != null && typeof n === "object" && key in n) {
+      resolved[i] = reconcileValue(n, currentMap.get(n[key]), opts);
+    } else {
+      resolved[i] = reconcileValue(n, curItems[i], opts);
+    }
+  }
+  if (keepRef) {
+    for (let i = 0; i < nextLen; i++) {
+      if (resolved[i] !== curItems[i]) current[i] = resolved[i];
+    }
+    if (curLen > nextLen) current.splice(nextLen);
+    return current;
+  }
+  let changed = nextLen !== curLen;
+  for (let i = 0; !changed && i < nextLen; i++) {
+    if (resolved[i] !== curItems[i]) changed = true;
+  }
+  return changed ? resolved : current;
+}
+function reconcileObj(next, current, opts) {
+  const { merge, keepRef } = opts;
+  const nextKeys = Object.keys(next);
+  const currentKeys = Object.keys(current);
+  const curValues = /* @__PURE__ */ Object.create(null);
+  for (let i = 0; i < currentKeys.length; i++) {
+    curValues[currentKeys[i]] = current[currentKeys[i]];
+  }
+  let out = null;
+  const getOut = () => {
+    if (!out) out = keepRef ? current : { ...curValues };
+    return out;
+  };
+  if (!merge) {
+    for (let i = 0; i < currentKeys.length; i++) {
+      const k = currentKeys[i];
+      if (!(k in next)) delete getOut()[k];
+    }
+  }
+  for (let i = 0; i < nextKeys.length; i++) {
+    const k = nextKeys[i];
+    const cv = curValues[k];
+    const rv = reconcileValue(next[k], cv, opts);
+    if (rv !== cv || !(k in curValues)) getOut()[k] = rv;
+  }
+  return out ?? current;
+}
+function reconcile(next, options) {
+  const opts = {
+    key: options?.key !== void 0 ? options.key : "id",
+    merge: options?.merge ?? false,
+    keepRef: options?.keepRef ?? false
+  };
+  return (current) => {
+    if (current === void 0 || current === null) return next;
+    return reconcileValue(next, current, opts);
+  };
+}
+export {
+  reconcile
+};

package/dist/lib/object/selector.cjs

@@ -1 +1,303 @@
-"use strict";var h=Object.defineProperty;var $=Object.getOwnPropertyDescriptor;var T=Object.getOwnPropertyNames;var x=Object.prototype.hasOwnProperty;var k=(e,n)=>{for(var a in n)h(e,a,{get:n[a],enumerable:!0})},I=(e,n,a,i)=>{if(n&&typeof n=="object"||typeof n=="function")for(let l of T(n))!x.call(e,l)&&l!==a&&h(e,l,{get:()=>n[l],enumerable:!(i=$(n,l))||i.enumerable});return e};var N=e=>I(h({},"__esModule",{value:!0}),e);var W={};k(W,{createFilterFunction:()=>g,createSelector:()=>E,detectSelectorType:()=>w,parseSelector:()=>v,stringifySelector:()=>A,validateSelector:()=>S});module.exports=N(W);var v=(e,n={})=>{let{type:a="auto",throwOnError:i=!1}=n;if(!e||typeof e!="string")return[];let l=[],s="",o=!1,d=!1,f="",y="",j=0,O=a==="auto"?(t=>t.includes("..")?"descendant":t.includes("[?(")?"filter":t.includes("[:")||t.includes("[0:")?"slice":t.includes("[,")||t.includes("[0,1]")?"union":t.includes("[*]")||t.includes(".*.")?"wildcard":t.includes("[]")?"array-wildcard":t.includes("[")&&t.includes("]")?"bracket":"dot")(e):a,m=t=>{let r=t.trim();if(r==="*"||r==="")return{type:"wildcard",value:r===""?"[]":"*",raw:r===""?"[]":t};if(r==="[]")return{type:"wildcard",value:"[]",raw:t};if(/^-?\d+$/.test(r))return{type:"index",value:parseInt(r,10),raw:t};if(r.includes(":")){let c=r.split(":").map(b=>b.trim()),u=c[0]===""?0:parseInt(c[0],10),p=c[1]===""?1/0:parseInt(c[1],10);if(isNaN(u)||isNaN(p)){if(i)throw new Error(`Invalid slice notation: ${t}`);return{type:"wildcard",value:"*",raw:t}}return{type:"slice",value:[u,p],raw:t}}if(r.includes(",")){let c=r.split(",").map(u=>{let p=parseInt(u.trim(),10);return isNaN(p)?-1:p}).filter(u=>u>=0);if(c.length===0){if(i)throw new Error(`Invalid union notation: ${t}`);return{type:"wildcard",value:"*",raw:t}}return{type:"union",value:c,raw:t}}if(r.startsWith("?(")&&r.endsWith(")")){let c=r.slice(2,-1);try{return{type:"filter",value:g(c),raw:t}}catch(u){if(i)throw u;return{type:"wildcard",value:"*",raw:t}}}return r.startsWith('"')&&r.endsWith('"')||r.startsWith("'")&&r.endsWith("'")?{type:"property",value:r.slice(1,-1),raw:t}:{type:"property",value:r,raw:t}};for(let t=0;t<e.length;t++){let r=e[t],c=e[t+1];if((r==='"'||r==="'")&&!d){d=!0,f=r;continue}else if(r===f&&d){d=!1,f="",r==='"'||r==="'"||(o?y+=r:s+=r);continue}if(d){o?y+=r:s+=r;continue}if(r==="["&&!o){s&&(l.push({type:"property",value:s,raw:s}),s=""),o=!0,y="";continue}if(r==="]"&&o&&!d){o=!1;let p=m(y);l.push(p);continue}let u=l.length>0?l[l.length-1]:null;if(r==="."&&!o&&!d){if(c==="."){let p=e.split("..")[0];l.push({type:"property",value:p,raw:p}),l.push({type:"descendant",value:"..",raw:".."}),t++}else s&&(s==="*"?l.push({type:"wildcard",value:s,raw:s}):l.push({type:"property",value:s,raw:s}),s="");continue}if(o)y+=r;else if(u&&u.type!=="descendant")s+=r;else{let p=e.split(u?.raw)[1];p!==void 0?s=p:s+=r}}return s&&l.push({type:"property",value:s,raw:s}),l.map(t=>{if(t.type==="property"&&typeof t.value=="string"&&/^-?\d+$/.test(t.value)){let r=parseInt(t.value,10);if(!isNaN(r))return{...t,type:"index",value:r}}return t})},g=e=>{let n=e.replace(/@\.([a-zA-Z_$][\w$]*)/g,(a,i)=>`item.${i}`).replace(/@/g,"item");try{return new Function("item",`return ${n}`)}catch{throw new Error(`Invalid filter expression: ${e}`)}},A=e=>{let n=[];for(let a=0;a<e.length;a++){let i=e[a],l=a>0?e[a-1]:null;switch(i.type){case"property":/[\.\[\]\s]/.test(String(i.value))?n.push(`["${i.value}"]`):(l&&l.type!=="descendant"&&n.push("."),n.push(String(i.value)));break;case"index":n.push(`[${i.value}]`);break;case"wildcard":i.value==="[]"?n.push("[]"):n.push("[*]");break;case"slice":let[o,d]=i.value;n.push(`[${o}:${d===1/0?"":d}]`);break;case"union":let f=i.value;n.push(`[${f.join(",")}]`);break;case"filter":n.push(`[?(${i.raw?.slice(2,-1)||""})]`);break;case"descendant":n.push("..");break}}return n.join("").replace(/\.\[/g,"[")},S=(e,n={})=>{if(Array.isArray(e))return e.map(a=>S(a,n));if(!/^[a-zA-Z]/.test(e))return{valid:!1,error:"Selector starts with '.'",type:w(e)};if(!/[a-zA-Z]$/.test(e))return{valid:!1,error:"Selector end with '.'",type:w(e)};try{let a=v(e,{throwOnError:!0}),i=w(e);return n.allowedTypes&&!n.allowedTypes.includes(i)?{valid:!1,error:`Selector type ${i} not allowed. Allowed: ${n.allowedTypes.join(", ")}`,type:i}:{valid:!0,type:w(e)}}catch(a){return{valid:!1,error:a.message}}},w=e=>e.includes("..")?"descendant":e.includes("[?(")?"filter":e.includes("[:")||e.includes("[0:")?"slice":/\[[^\]]*,[^\]]*\]/.test(e)?"union":e.includes("[*]")||e.includes(".*.")?"wildcard":e.includes("[]")?"array-wildcard":e.includes("[")&&e.includes("]")?"bracket":"dot",E=(e,n)=>e.replace(/\{(\w+)\}/g,(a,i)=>i in n?String(n[i]):`{${i}}`);
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/object/selector.ts
+var selector_exports = {};
+__export(selector_exports, {
+  createFilterFunction: () => createFilterFunction,
+  createSelector: () => createSelector,
+  detectSelectorType: () => detectSelectorType,
+  parseSelector: () => parseSelector,
+  stringifySelector: () => stringifySelector,
+  validateSelector: () => validateSelector
+});
+module.exports = __toCommonJS(selector_exports);
+var parseSelector = (selector, options = {}) => {
+  const { type = "auto", throwOnError = false } = options;
+  if (!selector || typeof selector !== "string") {
+    return [];
+  }
+  const segments = [];
+  let current = "";
+  let inBrackets = false;
+  let inQuotes = false;
+  let quoteChar = "";
+  let bracketContent = "";
+  let bracketDepth = 0;
+  const detectType = (str) => {
+    if (str.includes("..")) return "descendant";
+    if (str.includes("[?(")) return "filter";
+    if (str.includes("[:") || str.includes("[0:")) return "slice";
+    if (str.includes("[,") || str.includes("[0,1]")) return "union";
+    if (str.includes("[*]") || str.includes(".*.")) return "wildcard";
+    if (str.includes("[]")) return "array-wildcard";
+    if (str.includes("[") && str.includes("]")) return "bracket";
+    return "dot";
+  };
+  const actualType = type === "auto" ? detectType(selector) : type;
+  const parseBracketContent = (content) => {
+    const trimmed = content.trim();
+    if (trimmed === "*" || trimmed === "") {
+      return {
+        type: "wildcard",
+        value: trimmed === "" ? "[]" : "*",
+        raw: trimmed === "" ? "[]" : content
+      };
+    }
+    if (trimmed === "[]") {
+      return { type: "wildcard", value: "[]", raw: content };
+    }
+    if (/^-?\d+$/.test(trimmed)) {
+      return { type: "index", value: parseInt(trimmed, 10), raw: content };
+    }
+    if (trimmed.includes(":")) {
+      const parts = trimmed.split(":").map((p) => p.trim());
+      const start = parts[0] === "" ? 0 : parseInt(parts[0], 10);
+      const end = parts[1] === "" ? Infinity : parseInt(parts[1], 10);
+      if (isNaN(start) || isNaN(end)) {
+        if (throwOnError) throw new Error(`Invalid slice notation: ${content}`);
+        return { type: "wildcard", value: "*", raw: content };
+      }
+      return { type: "slice", value: [start, end], raw: content };
+    }
+    if (trimmed.includes(",")) {
+      const indices = trimmed.split(",").map((p) => {
+        const num = parseInt(p.trim(), 10);
+        return isNaN(num) ? -1 : num;
+      }).filter((n) => n >= 0);
+      if (indices.length === 0) {
+        if (throwOnError) throw new Error(`Invalid union notation: ${content}`);
+        return { type: "wildcard", value: "*", raw: content };
+      }
+      return { type: "union", value: indices, raw: content };
+    }
+    if (trimmed.startsWith("?(") && trimmed.endsWith(")")) {
+      const expr = trimmed.slice(2, -1);
+      try {
+        const filterFn = createFilterFunction(expr);
+        return { type: "filter", value: filterFn, raw: content };
+      } catch (error) {
+        if (throwOnError) throw error;
+        return { type: "wildcard", value: "*", raw: content };
+      }
+    }
+    if (trimmed.startsWith('"') && trimmed.endsWith('"') || trimmed.startsWith("'") && trimmed.endsWith("'")) {
+      return { type: "property", value: trimmed.slice(1, -1), raw: content };
+    }
+    return { type: "property", value: trimmed, raw: content };
+  };
+  for (let i = 0; i < selector.length; i++) {
+    const char = selector[i];
+    const nextChar = selector[i + 1];
+    if ((char === '"' || char === "'") && !inQuotes) {
+      inQuotes = true;
+      quoteChar = char;
+      continue;
+    } else if (char === quoteChar && inQuotes) {
+      inQuotes = false;
+      quoteChar = "";
+      if (!(char === '"' || char === "'")) {
+        if (inBrackets) {
+          bracketContent += char;
+        } else {
+          current += char;
+        }
+      }
+      continue;
+    }
+    if (inQuotes) {
+      if (inBrackets) {
+        bracketContent += char;
+      } else {
+        current += char;
+      }
+      continue;
+    }
+    if (char === "[" && !inBrackets) {
+      if (current) {
+        segments.push({ type: "property", value: current, raw: current });
+        current = "";
+      }
+      inBrackets = true;
+      bracketContent = "";
+      continue;
+    }
+    if (char === "]" && inBrackets && !inQuotes) {
+      inBrackets = false;
+      const segment = parseBracketContent(bracketContent);
+      segments.push(segment);
+      continue;
+    }
+    let lastDot = segments.length > 0 ? segments[segments.length - 1] : null;
+    if (char === "." && !inBrackets && !inQuotes) {
+      if (nextChar === ".") {
+        const l = selector.split("..")[0];
+        segments.push({ type: "property", value: l, raw: l });
+        segments.push({ type: "descendant", value: "..", raw: ".." });
+        i++;
+      } else if (current) {
+        if (current === "*") {
+          segments.push({ type: "wildcard", value: current, raw: current });
+        } else {
+          segments.push({ type: "property", value: current, raw: current });
+        }
+        current = "";
+      }
+      continue;
+    }
+    if (inBrackets) {
+      bracketContent += char;
+    } else {
+      if (lastDot && lastDot.type !== "descendant") {
+        current += char;
+      } else {
+        const l = selector.split(lastDot?.raw)[1];
+        if (l !== void 0) {
+          current = l;
+        } else {
+          current += char;
+        }
+      }
+    }
+  }
+  if (current) {
+    segments.push({ type: "property", value: current, raw: current });
+  }
+  return segments.map((segment) => {
+    if (segment.type === "property" && typeof segment.value === "string") {
+      if (/^-?\d+$/.test(segment.value)) {
+        const num = parseInt(segment.value, 10);
+        if (!isNaN(num)) {
+          return { ...segment, type: "index", value: num };
+        }
+      }
+    }
+    return segment;
+  });
+};
+var createFilterFunction = (expr) => {
+  const safeExpr = expr.replace(/@\.([a-zA-Z_$][\w$]*)/g, (_, prop) => `item.${prop}`).replace(/@/g, "item");
+  try {
+    return new Function("item", `return ${safeExpr}`);
+  } catch (error) {
+    throw new Error(`Invalid filter expression: ${expr}`);
+  }
+};
+var stringifySelector = (segments) => {
+  const parts = [];
+  for (let i = 0; i < segments.length; i++) {
+    const segment = segments[i];
+    const prevSegment = i > 0 ? segments[i - 1] : null;
+    switch (segment.type) {
+      case "property":
+        const needsQuotes = /[\.\[\]\s]/.test(String(segment.value));
+        if (needsQuotes) {
+          parts.push(`["${segment.value}"]`);
+        } else {
+          if (prevSegment && prevSegment.type !== "descendant") {
+            parts.push(".");
+          }
+          parts.push(String(segment.value));
+        }
+        break;
+      case "index":
+        parts.push(`[${segment.value}]`);
+        break;
+      case "wildcard":
+        if (segment.value === "[]") {
+          parts.push("[]");
+        } else {
+          parts.push("[*]");
+        }
+        break;
+      case "slice":
+        const [start, end] = segment.value;
+        parts.push(`[${start}:${end === Infinity ? "" : end}]`);
+        break;
+      case "union":
+        const indices = segment.value;
+        parts.push(`[${indices.join(",")}]`);
+        break;
+      case "filter":
+        parts.push(`[?(${segment.raw?.slice(2, -1) || ""})]`);
+        break;
+      case "descendant":
+        parts.push("..");
+        break;
+    }
+  }
+  return parts.join("").replace(/\.\[/g, "[");
+};
+var validateSelector = (selector, options = {}) => {
+  if (Array.isArray(selector)) {
+    return selector.map(
+      (sel) => validateSelector(sel, options)
+    );
+  }
+  if (!/^[a-zA-Z]/.test(selector)) {
+    return {
+      valid: false,
+      error: `Selector starts with '.'`,
+      type: detectSelectorType(selector)
+    };
+  }
+  if (!/[a-zA-Z]$/.test(selector)) {
+    return {
+      valid: false,
+      error: `Selector end with '.'`,
+      type: detectSelectorType(selector)
+    };
+  }
+  try {
+    const segments = parseSelector(selector, { throwOnError: true });
+    const type = detectSelectorType(selector);
+    if (options.allowedTypes) {
+      if (!options.allowedTypes.includes(type)) {
+        return {
+          valid: false,
+          error: `Selector type ${type} not allowed. Allowed: ${options.allowedTypes.join(
+            ", "
+          )}`,
+          type
+        };
+      }
+    }
+    return { valid: true, type: detectSelectorType(selector) };
+  } catch (error) {
+    return { valid: false, error: error.message };
+  }
+};
+var detectSelectorType = (selector) => {
+  if (selector.includes("..")) return "descendant";
+  if (selector.includes("[?(")) return "filter";
+  if (selector.includes("[:") || selector.includes("[0:")) return "slice";
+  if (/\[[^\]]*,[^\]]*\]/.test(selector)) return "union";
+  if (selector.includes("[*]") || selector.includes(".*.")) return "wildcard";
+  if (selector.includes("[]")) return "array-wildcard";
+  if (selector.includes("[") && selector.includes("]")) return "bracket";
+  return "dot";
+};
+var createSelector = (template, replacements) => {
+  return template.replace(/\{(\w+)\}/g, (_, key) => {
+    if (key in replacements) {
+      return String(replacements[key]);
+    }
+    return `{${key}}`;
+  });
+};