@react-pakistan/util-functions 2.0.2 → 3.0.1

package/general/generate-employer-aggregate-rating-schema.d.mts

@@ -0,0 +1,29 @@
+/**
+ * Generate schema.org JSON-LD for `EmployerAggregateRating` and the
+ * hosting `Organization`.
+ *
+ * The helper builds an `EmployerAggregateRating` object and nests it
+ * inside an `Organization` representation of the employer. Use the
+ * `EmployerAggregateOptions` interface for inputs.
+ * @returns A JSON-LD compatible `Organization` object with
+ * `aggregateRating` included
+ */
+interface OrgRef {
+    name: string;
+    url?: string;
+    sameAs?: string;
+}
+interface EmployerAggregateOptions {
+    employer: string | OrgRef;
+    ratingValue?: number;
+    ratingCount?: number;
+    reviewCount?: number;
+    bestRating?: number;
+    worstRating?: number;
+    url?: string;
+    description?: string;
+    datePublished?: string;
+}
+declare const generateEmployerAggregateRatingSchema: ({ employer, ratingValue, ratingCount, reviewCount, bestRating, worstRating, url, description, datePublished, }: EmployerAggregateOptions) => any;
+
+export { generateEmployerAggregateRatingSchema as default, generateEmployerAggregateRatingSchema };

package/general/generate-employer-aggregate-rating-schema.mjs

@@ -0,0 +1 @@
+const m=e=>{if(typeof e=="string")return{"@type":"Organization",name:e};const t={"@type":"Organization",name:e.name};return e.url&&(t.url=e.url),e.sameAs&&(t.sameAs=e.sameAs),t},f=({employer:e,ratingValue:t,ratingCount:r,reviewCount:a,bestRating:i,worstRating:g,url:s,description:o,datePublished:u})=>{const n={"@type":"EmployerAggregateRating"};t!=null&&(n.ratingValue=t),r!=null&&(n.ratingCount=r),a!=null&&(n.reviewCount=a),i!=null&&(n.bestRating=i),g!=null&&(n.worstRating=g),s&&(n.url=s),o&&(n.description=o),u&&(n.datePublished=u);const l={"@context":"https://schema.org","@type":"Organization",...m(e)};return l.aggregateRating=n,l};var y=f;export{y as default,f as generateEmployerAggregateRatingSchema};

package/general/generate-event-schema.d.mts

@@ -0,0 +1,63 @@
+/**
+ * Generate schema.org `Event` JSON-LD.
+ *
+ * Supports `Place` and `VirtualLocation` types for `location`, optional
+ * `offers`, performers, organizer, and availability/status normalization.
+ * Currency values are validated with `skipInvalidCurrency` when present.
+ *
+ * See `EventSchemaOptions` below for the complete input shape.
+ * @returns A JSON-LD compatible `Event` object
+ */
+interface EventImage {
+    url: string;
+    width?: number;
+    height?: number;
+}
+interface EventLocationAddress {
+    streetAddress?: string;
+    addressLocality?: string;
+    postalCode?: string;
+    addressRegion?: string;
+    addressCountry?: string;
+}
+interface EventLocation {
+    type?: 'Place' | 'VirtualLocation';
+    name?: string;
+    url?: string;
+    address?: string | EventLocationAddress;
+}
+interface EventOrganizer {
+    name: string;
+    url?: string;
+}
+interface EventPerformer {
+    name: string;
+    url?: string;
+    type?: 'Person' | 'Organization';
+}
+interface EventOffer {
+    price?: string | number;
+    priceCurrency?: string;
+    availability?: string;
+    url?: string;
+    priceValidUntil?: string;
+}
+interface EventSchemaOptions {
+    name: string;
+    startDate: string;
+    endDate?: string;
+    description?: string;
+    location?: string | EventLocation;
+    url?: string;
+    image?: string | EventImage;
+    organizer?: string | EventOrganizer;
+    performers?: string | EventPerformer | Array<string | EventPerformer>;
+    offers?: EventOffer | EventOffer[];
+    isAccessibleForFree?: boolean;
+    eventStatus?: string;
+    eventAttendanceMode?: string;
+    skipInvalidCurrency?: boolean;
+}
+declare const generateEventSchema: ({ name, startDate, endDate, description, location, url, image, organizer, performers, offers, isAccessibleForFree, eventStatus, eventAttendanceMode, skipInvalidCurrency, }: EventSchemaOptions) => any;
+
+export { generateEventSchema };

package/general/generate-event-schema.mjs

@@ -0,0 +1 @@
+const z=r=>{if(r)return typeof r=="string"?r:{"@type":"ImageObject",url:r.url,...r.width&&{width:r.width},...r.height&&{height:r.height}}},c=r=>r?/^[A-Z]{3}$/.test(r):!1,C=["InStock","OutOfStock","PreOrder","PreSale","Discontinued","OnlineOnly","InStoreOnly","LimitedAvailability","BackOrder"],S=r=>{if(r)try{const t=String(r);if(t.startsWith("http")){const s=t.replace(/https?:\/\/schema\.org\//i,"");return C.includes(s)?`https://schema.org/${s}`:void 0}return C.includes(t)?`https://schema.org/${t}`:void 0}catch{return}},O=r=>{if(r)return r.startsWith("http")?r:`https://schema.org/${r}`},V=r=>{if(!r)return;if(typeof r=="string")return r;if(r.type==="VirtualLocation"){const s={"@type":"VirtualLocation"};return r.url&&(s.url=r.url),r.name&&(s.name=r.name),s}const t={"@type":"Place"};return r.name&&(t.name=r.name),r.url&&(t.url=r.url),r.address&&(typeof r.address=="string"?t.address=r.address:t.address={"@type":"PostalAddress",...r.address.streetAddress&&{streetAddress:r.address.streetAddress},...r.address.addressLocality&&{addressLocality:r.address.addressLocality},...r.address.postalCode&&{postalCode:r.address.postalCode},...r.address.addressRegion&&{addressRegion:r.address.addressRegion},...r.address.addressCountry&&{addressCountry:r.address.addressCountry}}),t},w=r=>{if(r)return typeof r=="string"?{"@type":"Organization",name:r}:{"@type":"Organization",name:r.name,...r.url&&{url:r.url}}},A=r=>typeof r=="string"?{"@type":"Person",name:r}:{"@type":r.type||"Person",name:r.name,...r.url&&{url:r.url}},U=({name:r,startDate:t,endDate:s,description:o,location:b,url:y,image:L,organizer:I,performers:d,offers:f,isAccessibleForFree:g,eventStatus:l,eventAttendanceMode:p,skipInvalidCurrency:P=!1})=>{const n={"@context":"https://schema.org","@type":"Event",name:r,startDate:t};s&&(n.endDate=s),o&&(n.description=o);const m=z(L);m&&(n.image=m);const h=V(b);h&&(n.location=h),y&&(n.mainEntityOfPage={"@type":"WebPage","@id":y});const v=w(I);if(v&&(n.organizer=v),d&&(Array.isArray(d)?n.performer=d.map(i=>A(i)):n.performer=A(d)),typeof g=="boolean"&&(n.isAccessibleForFree=g),l){const i=O(l);i&&(n.eventStatus=i)}if(p){const i=O(p);i&&(n.eventAttendanceMode=i)}if(f){const i=Array.isArray(f)?f:[f],u=i.map(e=>{if(e.priceCurrency&&!c(e.priceCurrency))return{__invalidCurrency:e.priceCurrency};const a={"@type":"Offer"};if(e.price!=null&&(a.price=e.price),e.priceCurrency&&(a.priceCurrency=e.priceCurrency),e.url&&(a.url=e.url),e.priceValidUntil&&(a.priceValidUntil=e.priceValidUntil),e.availability){const E=S(e.availability);E&&(a.availability=E)}return a}).filter(e=>e&&!("__invalidCurrency"in e));if(i.some(e=>e.priceCurrency&&!c(e.priceCurrency))&&!P){const e=i.find(a=>a.priceCurrency&&!c(a.priceCurrency));throw new Error(`Invalid currency code: ${e?.priceCurrency}`)}u.length===1?n.offers=u[0]:u.length>1&&(n.offers=u)}return n};export{U as generateEventSchema};

package/general/generate-faq-schema.d.mts

@@ -0,0 +1,32 @@
+/**
+ * Generate a schema.org `FAQPage` JSON-LD object.
+ *
+ * Each FAQ item becomes a `Question` with an `acceptedAnswer` of type
+ * `Answer`. Plain-text answers are wrapped in a single paragraph tag.
+ * If the provided answer already contains HTML tags it will be preserved
+ * as-is to avoid double-wrapping.
+ *
+ * @param props.data - Array of FAQ items with `question` and `answer`
+ * @returns A JSON-LD `FAQPage` object
+ */
+interface FAQItem {
+    question: string;
+    answer: string;
+}
+interface FAQProps {
+    data: FAQItem[];
+}
+declare const generateFAQSchema: ({ data }: FAQProps) => {
+    '@context': string;
+    '@type': string;
+    mainEntity: {
+        '@type': string;
+        name: string;
+        acceptedAnswer: {
+            '@type': string;
+            text: string;
+        };
+    }[];
+};
+
+export { generateFAQSchema };

package/general/generate-faq-schema.mjs

@@ -0,0 +1 @@
+const s=e=>{if(!e)return e;const t=e.trim();return t.startsWith("<")&&t.includes(">")?e:`<p>${e}</p>`},i=({data:e})=>({"@context":"https://schema.org","@type":"FAQPage",mainEntity:e.map(({answer:r,question:n})=>({"@type":"Question",name:n,acceptedAnswer:{"@type":"Answer",text:s(r)}}))});export{i as generateFAQSchema};

package/general/generate-grid.d.mts

@@ -0,0 +1,17 @@
+/**
+ * A util function generate CSS Grid on the length of provided array
+ * it creates n x n grid layout dynamically
+ *
+ * @param array array - array of any data type
+ * @returns IGrid - an Object that have col & row properties
+ * @author Taimoor Khan
+ * @remarks React UI Collection
+ */
+/** End file docs */
+interface IGrid {
+    col: string;
+    row: string;
+}
+declare const generateGrid: (array: Array<any>) => IGrid;
+
+export { generateGrid };

package/general/generate-grid.mjs

@@ -0,0 +1 @@
+const o=r=>({1:{col:"1fr",row:"1fr"},2:{col:"1fr",row:"1fr 1fr"},3:{col:"1fr 1fr",row:"1fr"},4:{col:"1fr 1fr",row:"1fr 1fr"},5:{col:"1fr 1fr 1fr",row:"1fr 1fr"},6:{col:"1fr 1fr 1fr",row:"1fr 1fr"},7:{col:"1fr 1fr 1fr",row:"1fr 1fr 1fr"},8:{col:"1fr 1fr 1fr",row:"1fr 1fr 1fr"},9:{col:"1fr 1fr 1fr",row:"1fr 1fr 1fr"}})[r.length];export{o as generateGrid};

package/general/generate-image-metadata-schema.d.mts

@@ -0,0 +1,36 @@
+/**
+ * Generate schema.org `ImageObject` JSON-LD for image metadata.
+ *
+ * Accepts author/copyright holders, thumbnail, licenses and descriptive
+ * metadata and formats them into an `ImageObject` suitable for JSON-LD
+ * embedding. Only provided fields are emitted.
+ *
+ * See `ImageMetadataOptions` for the exact accepted fields.
+ * @returns A JSON-LD compatible `ImageObject`
+ */
+interface SimplePerson {
+    name: string;
+    url?: string;
+}
+interface ImageThumbnail {
+    url: string;
+    width?: number;
+    height?: number;
+}
+interface ImageMetadataOptions {
+    name?: string;
+    contentUrl: string;
+    description?: string;
+    caption?: string;
+    uploadDate?: string;
+    author?: string | SimplePerson;
+    copyrightHolder?: string | SimplePerson;
+    license?: string;
+    encodingFormat?: string;
+    contentSize?: string;
+    thumbnail?: string | ImageThumbnail;
+    keywords?: string[];
+}
+declare const generateImageMetadataSchema: ({ name, contentUrl, description, caption, uploadDate, author, copyrightHolder, license, encodingFormat, contentSize, thumbnail, keywords, }: ImageMetadataOptions) => any;
+
+export { generateImageMetadataSchema };

package/general/generate-image-metadata-schema.mjs

@@ -0,0 +1 @@
+const c=n=>{if(n)return typeof n=="string"?{"@type":"Person",name:n}:{"@type":"Person",name:n.name,...n.url&&{url:n.url}}},y=n=>{if(n)return typeof n=="string"?n:{"@type":"ImageObject",url:n.url,...n.width&&{width:n.width},...n.height&&{height:n.height}}},b=({name:n,contentUrl:f,description:i,caption:r,uploadDate:a,author:l,copyrightHolder:d,license:s,encodingFormat:g,contentSize:o,thumbnail:p,keywords:t})=>{const e={"@context":"https://schema.org","@type":"ImageObject",contentUrl:f};n&&(e.name=n),i&&(e.description=i),r&&(e.caption=r),a&&(e.uploadDate=a);const m=c(l);m&&(e.author=m);const h=c(d);h&&(e.copyrightHolder=h),s&&(e.license=s),g&&(e.encodingFormat=g),o&&(e.contentSize=o);const u=y(p);return u&&(e.thumbnail=u),t&&t.length>0&&(e.keywords=t.join(", ")),e};export{b as generateImageMetadataSchema};

package/general/generate-job-posting-schema.d.mts

@@ -0,0 +1,49 @@
+/**
+ * Generate schema.org `JobPosting` JSON-LD.
+ *
+ * Supports structured `hiringOrganization`, `jobLocation`, and `baseSalary`
+ * representations. Currency validation is available via
+ * `skipInvalidCurrency` to catch malformed currency codes.
+ *
+ * See `JobPostingOptions` for the supported inputs.
+ * @returns A JSON-LD compatible `JobPosting` object
+ */
+interface SimpleOrganization {
+    name: string;
+    url?: string;
+    logo?: string;
+}
+interface SimpleAddress {
+    streetAddress?: string;
+    addressLocality?: string;
+    postalCode?: string;
+    addressRegion?: string;
+    addressCountry?: string;
+}
+interface JobLocation {
+    name?: string;
+    address?: string | SimpleAddress;
+}
+interface BaseSalary {
+    value?: string | number;
+    currency?: string;
+    unitText?: string;
+}
+interface JobPostingOptions {
+    title: string;
+    description?: string;
+    datePosted: string;
+    validThrough?: string;
+    employmentType?: string | string[];
+    hiringOrganization?: string | SimpleOrganization;
+    jobLocation?: JobLocation | string;
+    baseSalary?: number | string | BaseSalary;
+    qualifications?: string;
+    skills?: string[];
+    identifier?: string;
+    url?: string;
+    skipInvalidCurrency?: boolean;
+}
+declare const generateJobPostingSchema: ({ title, description, datePosted, validThrough, employmentType, hiringOrganization, jobLocation, baseSalary, qualifications, skills, identifier, url, skipInvalidCurrency, }: JobPostingOptions) => any;
+
+export { generateJobPostingSchema };

package/general/generate-job-posting-schema.mjs

@@ -0,0 +1 @@
+const O=e=>{if(!e)return;if(typeof e=="string")return{"@type":"Organization",name:e};const t={"@type":"Organization",name:e.name};return e.url&&(t.url=e.url),e.logo&&(t.logo={"@type":"ImageObject",url:e.logo}),t},h=e=>{if(!e)return;if(typeof e=="string")return e;const t={"@type":"Place"};return e.name&&(t.name=e.name),e.address&&(typeof e.address=="string"?t.address=e.address:t.address={"@type":"PostalAddress",...e.address.streetAddress&&{streetAddress:e.address.streetAddress},...e.address.addressLocality&&{addressLocality:e.address.addressLocality},...e.address.postalCode&&{postalCode:e.address.postalCode},...e.address.addressRegion&&{addressRegion:e.address.addressRegion},...e.address.addressCountry&&{addressCountry:e.address.addressCountry}}),t},l=e=>e?/^[A-Z]{3}$/.test(e):!1,A=({title:e,description:t,datePosted:p,validThrough:d,employmentType:o,hiringOrganization:m,jobLocation:b,baseSalary:s,qualifications:g,skills:a,identifier:u,url:y,skipInvalidCurrency:L=!1})=>{const n={"@context":"https://schema.org","@type":"JobPosting",title:e,datePosted:p};t&&(n.description=t),d&&(n.validThrough=d),o&&(n.employmentType=o);const f=O(m);f&&(n.hiringOrganization=f);const c=h(b);if(c&&(n.jobLocation=c),s!=null)if(typeof s=="number"||typeof s=="string")n.baseSalary={"@type":"MonetaryAmount",value:s};else{const r=s;if(r.currency&&!l(r.currency)&&!L)throw new Error(`Invalid currency code: ${r.currency}`);const i={"@type":"MonetaryAmount"};r.value!=null&&(i.value=r.value),r.currency&&l(r.currency)&&(i.currency=r.currency),r.unitText&&(i.unitText=r.unitText),n.baseSalary=i}return g&&(n.qualifications=g),a&&a.length>0&&(n.skills=a.join(", ")),u&&(n.identifier=u),y&&(n.jobLocation=n.jobLocation||{"@type":"Place",name:y}),n};export{A as generateJobPostingSchema};

package/general/generate-local-business-schema.d.mts

@@ -0,0 +1,42 @@
+/**
+ * Generate schema.org `LocalBusiness` JSON-LD.
+ *
+ * Accepts common local business metadata (address, telephone, opening
+ * hours, geo coordinates, aggregateRating, etc.) and returns an object
+ * formatted for JSON-LD. Address may be provided as a simple string or a
+ * structured `SimpleAddress` object.
+ *
+ * See `LocalBusinessOptions` below for supported fields.
+ * @returns A JSON-LD compatible `LocalBusiness` object
+ */
+interface SimpleAddress {
+    streetAddress?: string;
+    addressLocality?: string;
+    postalCode?: string;
+    addressRegion?: string;
+    addressCountry?: string;
+}
+interface LocalBusinessOptions {
+    name: string;
+    description?: string;
+    url?: string;
+    telephone?: string;
+    email?: string;
+    address?: string | SimpleAddress;
+    openingHours?: string[];
+    geo?: {
+        latitude: string | number;
+        longitude: string | number;
+    };
+    priceRange?: string;
+    image?: string;
+    logo?: string;
+    aggregateRating?: {
+        ratingValue: number | string;
+        reviewCount?: number;
+    };
+    sameAs?: string[];
+}
+declare const generateLocalBusinessSchema: ({ name, description, url, telephone, email, address, openingHours, geo, priceRange, image, logo, aggregateRating, sameAs, }: LocalBusinessOptions) => any;
+
+export { generateLocalBusinessSchema };

package/general/generate-local-business-schema.mjs

@@ -0,0 +1 @@
+const y=e=>{if(e)return typeof e=="string"?e:{"@type":"PostalAddress",...e.streetAddress&&{streetAddress:e.streetAddress},...e.addressLocality&&{addressLocality:e.addressLocality},...e.postalCode&&{postalCode:e.postalCode},...e.addressRegion&&{addressRegion:e.addressRegion},...e.addressCountry&&{addressCountry:e.addressCountry}}},m=({name:e,description:d,url:o,telephone:g,email:a,address:f,openingHours:r,geo:i,priceRange:l,image:u,logo:c,aggregateRating:t,sameAs:n})=>{const s={"@context":"https://schema.org","@type":"LocalBusiness",name:e};d&&(s.description=d),o&&(s.url=o),g&&(s.telephone=g),a&&(s.email=a);const p=y(f);return p&&(s.address=p),r&&r.length>0&&(s.openingHours=r),i&&(s.geo={"@type":"GeoCoordinates",latitude:String(i.latitude),longitude:String(i.longitude)}),l&&(s.priceRange=l),u&&(s.image=u),c&&(s.logo={"@type":"ImageObject",url:c}),t&&(s.aggregateRating={"@type":"AggregateRating",ratingValue:t.ratingValue,...t.reviewCount!=null&&{reviewCount:t.reviewCount}}),n&&n.length>0&&(s.sameAs=n),s};export{m as generateLocalBusinessSchema};

package/general/generate-math-solver-schema.d.mts

@@ -0,0 +1,45 @@
+/**
+ * Generate schema.org JSON-LD for a `MathSolver` application.
+ *
+ * Accepts application metadata (author, provider, softwareVersion, offers,
+ * etc.) and formats optional fields into a minimal `MathSolver` object
+ * suitable for embedding as JSON-LD. Only provided fields are included.
+ *
+ * See `MathSolverOptions` below for the accepted input shape.
+ * @returns A JSON-LD compatible `MathSolver` object
+ */
+interface PersonSimple {
+    name: string;
+    url?: string;
+}
+interface OrganizationSimple {
+    name: string;
+    url?: string;
+}
+interface ImageSimple {
+    url: string;
+    width?: number;
+    height?: number;
+}
+interface OfferSimple {
+    price?: string | number;
+    priceCurrency?: string;
+    url?: string;
+}
+interface MathSolverOptions {
+    name: string;
+    description?: string;
+    url?: string;
+    image?: string | ImageSimple;
+    author?: string | PersonSimple;
+    provider?: string | OrganizationSimple;
+    softwareVersion?: string;
+    applicationCategory?: string;
+    operatingSystem?: string | string[];
+    programmingLanguage?: string | string[];
+    license?: string;
+    offers?: OfferSimple | OfferSimple[];
+}
+declare const generateMathSolverSchema: ({ name, description, url, image, author, provider, softwareVersion, applicationCategory, operatingSystem, programmingLanguage, license, offers, }: MathSolverOptions) => any;
+
+export { generateMathSolverSchema };

package/general/generate-math-solver-schema.mjs

@@ -0,0 +1 @@
+const d=r=>{if(r)return typeof r=="string"?{"@type":"Person",name:r}:{"@type":"Person",name:r.name,...r.url&&{url:r.url}}},O=r=>{if(r)return typeof r=="string"?{"@type":"Organization",name:r}:{"@type":"Organization",name:r.name,...r.url&&{url:r.url}}},v=r=>{if(r)return typeof r=="string"?r:{"@type":"ImageObject",url:r.url,...r.width&&{width:r.width},...r.height&&{height:r.height}}},P=({name:r,description:a,url:s,image:h,author:y,provider:S,softwareVersion:g,applicationCategory:m,operatingSystem:p,programmingLanguage:u,license:f,offers:i})=>{const e={"@context":"https://schema.org","@type":"MathSolver",name:r};a&&(e.description=a),s&&(e.url=s);const o=v(h);o&&(e.image=o);const l=d(y);l&&(e.author=l);const c=O(S);if(c&&(e.provider=c),g&&(e.softwareVersion=g),m&&(e.applicationCategory=m),p&&(e.operatingSystem=p),u&&(e.programmingLanguage=u),f&&(e.license=f),i){const t=(Array.isArray(i)?i:[i]).map(n=>({"@type":"Offer",...n.price!=null&&{price:n.price},...n.priceCurrency&&{priceCurrency:n.priceCurrency},...n.url&&{url:n.url}}));e.offers=t.length===1?t[0]:t}return e};export{P as generateMathSolverSchema};

package/general/generate-movie-carousel-schema.d.mts

@@ -0,0 +1,51 @@
+/**
+ * Generate schema.org `ItemList` JSON-LD for a movie carousel (list of
+ * `Movie` entries).
+ *
+ * Each movie item can include director/actor references, offers,
+ * aggregate ratings and genre metadata. Images are normalized to
+ * `ImageObject` entries.
+ *
+ * See `MovieCarouselOptions` and `MovieItem` for input details.
+ * @returns A JSON-LD compatible `ItemList` of `Movie` objects
+ */
+interface PersonRef {
+    name: string;
+    url?: string;
+}
+interface MovieOffer {
+    price?: string | number;
+    priceCurrency?: string;
+    availability?: string;
+    url?: string;
+}
+interface MovieItem {
+    id?: string;
+    name: string;
+    url?: string;
+    image?: string | {
+        url: string;
+        width?: number;
+        height?: number;
+    };
+    description?: string;
+    director?: string | PersonRef | Array<string | PersonRef>;
+    actor?: string | PersonRef | Array<string | PersonRef>;
+    datePublished?: string;
+    duration?: string;
+    genre?: string | string[];
+    aggregateRating?: {
+        ratingValue: number | string;
+        reviewCount?: number;
+    };
+    offers?: MovieOffer | MovieOffer[];
+}
+interface MovieCarouselOptions {
+    name?: string;
+    url?: string;
+    items: MovieItem[];
+    skipInvalidCurrency?: boolean;
+}
+declare const generateMovieCarouselSchema: ({ name, url, items, skipInvalidCurrency, }: MovieCarouselOptions) => any;
+
+export { generateMovieCarouselSchema };

package/general/generate-movie-carousel-schema.mjs

@@ -0,0 +1 @@
+const u=e=>typeof e=="string"?{"@type":"Person",name:e}:{"@type":"Person",name:e.name,...e.url&&{url:e.url}},h=e=>{if(e)return typeof e=="string"?e:{"@type":"ImageObject",url:e.url,...e.width&&{width:e.width},...e.height&&{height:e.height}}},g=e=>e?/^[A-Z]{3}$/.test(e):!1,y=["InStock","OutOfStock","PreOrder","PreSale","Discontinued","OnlineOnly","InStoreOnly","LimitedAvailability","BackOrder"],v=e=>{if(e)try{const a=String(e);if(a.startsWith("http")){const c=a.replace(/https?:\/\/schema\.org\//i,"");return y.includes(c)?`https://schema.org/${c}`:void 0}return y.includes(a)?`https://schema.org/${a}`:void 0}catch{return}},A=({name:e,url:a,items:c,skipInvalidCurrency:p=!1})=>{const f={"@context":"https://schema.org","@type":"ItemList",itemListElement:c.map((r,m)=>{const i={"@type":"Movie",name:r.name};r.url&&(i.url=r.url),r.id&&(i["@id"]=r.id);const l=h(r.image);if(l&&(i.image=l),r.description&&(i.description=r.description),r.datePublished&&(i.datePublished=r.datePublished),r.duration&&(i.duration=r.duration),r.genre&&(i.genre=Array.isArray(r.genre)?r.genre.join(", "):r.genre),r.director&&(Array.isArray(r.director)?i.director=r.director.map(s=>u(s)):i.director=u(r.director)),r.actor&&(Array.isArray(r.actor)?i.actor=r.actor.map(s=>u(s)):i.actor=u(r.actor)),r.aggregateRating&&(i.aggregateRating={"@type":"AggregateRating",ratingValue:r.aggregateRating.ratingValue,...r.aggregateRating.reviewCount!=null&&{reviewCount:r.aggregateRating.reviewCount}}),r.offers){const s=Array.isArray(r.offers)?r.offers:[r.offers],o=s.map(n=>{if(n.priceCurrency&&!g(n.priceCurrency))return{__invalidCurrency:n.priceCurrency};const t={"@type":"Offer"};if(n.price!=null&&(t.price=n.price),n.priceCurrency&&(t.priceCurrency=n.priceCurrency),n.availability){const d=v(n.availability);d&&(t.availability=d)}return n.url&&(t.url=n.url),t}).filter(n=>n&&!("__invalidCurrency"in n));if(s.some(n=>n.priceCurrency&&!g(n.priceCurrency))&&!p){const n=s.find(t=>t.priceCurrency&&!g(t.priceCurrency));throw new Error(`Invalid currency code: ${n?.priceCurrency}`)}o.length===1?i.offers=o[0]:o.length>1&&(i.offers=o)}return{"@type":"ListItem",position:m+1,item:i}})};return e&&(f.name=e),a&&(f.mainEntityOfPage={"@type":"WebPage","@id":a}),f};export{A as generateMovieCarouselSchema};

package/general/generate-organization-schema.d.mts

@@ -0,0 +1,49 @@
+/**
+ * Generate schema.org `Organization` JSON-LD.
+ *
+ * This helper builds a minimal `Organization` object including `address`,
+ * `logo`, `image`, `email`, and `telephone`. The input shape is an
+ * application-specific `Organization` interface defined below — the
+ * function emits only the provided properties to keep the result
+ * compact.
+ *
+ * @param options - Organization properties (see interface below)
+ * @returns A JSON-LD compatible `Organization` object
+ */
+interface Organization {
+    addressCountry: string;
+    addressLocality: string;
+    addressRegion: string;
+    appName: string;
+    baseUrl: string;
+    description: string;
+    email: string;
+    image: string;
+    logo: string;
+    postalCode: string;
+    sameAsArr: Array<string>;
+    streetAddress: string;
+    telephone: string;
+}
+declare const generateOrganizationSchema: ({ addressCountry, addressLocality, addressRegion, appName, baseUrl, description, email, image, logo, postalCode, sameAsArr, streetAddress, telephone, }: Organization) => {
+    '@context': string;
+    '@type': string;
+    image: string;
+    url: string;
+    sameAs: string[];
+    logo: string;
+    name: string;
+    description: string;
+    email: string;
+    telephone: string;
+    address: {
+        '@type': string;
+        streetAddress: string;
+        addressLocality: string;
+        addressCountry: string;
+        addressRegion: string;
+        postalCode: string;
+    };
+};
+
+export { generateOrganizationSchema };

package/general/generate-organization-schema.mjs

@@ -0,0 +1 @@
+const m=({addressCountry:s,addressLocality:e,addressRegion:r,appName:t,baseUrl:a,description:n,email:i,image:o,logo:g,postalCode:d,sameAsArr:l,streetAddress:p,telephone:$})=>({"@context":"https://schema.org","@type":"Organization",image:`${o}`,url:`${a}`,sameAs:l,logo:`${g}`,name:`${t}`,description:`${n}`,email:`${i}`,telephone:`${$}`,address:{"@type":"PostalAddress",streetAddress:`${p}`,addressLocality:`${e}`,addressCountry:`${s}`,addressRegion:`${r}`,postalCode:`${d}`}});export{m as generateOrganizationSchema};

package/general/generate-profile-page-schema.d.mts

@@ -0,0 +1,37 @@
+/**
+ * Generate schema.org `ProfilePage` JSON-LD describing a person or profile.
+ *
+ * Accepts a `mainEntity` person object along with optional author or
+ * organization metadata. Images are normalized to `ImageObject` entries.
+ *
+ * See `ProfilePageOptions` and `PersonRef` for the input shape.
+ * @returns A JSON-LD compatible `ProfilePage` object
+ */
+interface ImageRef {
+    url: string;
+    width?: number;
+    height?: number;
+}
+interface PersonRef {
+    name: string;
+    url?: string;
+    sameAs?: string[];
+    jobTitle?: string;
+    image?: string | ImageRef;
+}
+interface OrgRef {
+    name: string;
+    url?: string;
+}
+interface ProfilePageOptions {
+    name?: string;
+    headline?: string;
+    url?: string;
+    description?: string;
+    mainEntity?: PersonRef;
+    author?: PersonRef | OrgRef;
+    about?: string[];
+}
+declare const generateProfilePageSchema: ({ name, headline, url, description, mainEntity, author, about, }: ProfilePageOptions) => any;
+
+export { generateProfilePageSchema };

package/general/generate-profile-page-schema.mjs

@@ -0,0 +1 @@
+const m=e=>{if(e)return typeof e=="string"?e:{"@type":"ImageObject",url:e.url,...e.width&&{width:e.width},...e.height&&{height:e.height}}},o=e=>{if(!e)return;const n={"@type":"Person",name:e.name};e.url&&(n.url=e.url),e.sameAs&&(n.sameAs=e.sameAs),e.jobTitle&&(n.jobTitle=e.jobTitle);const t=m(e.image);return t&&(n.image=t),n},l=e=>{if(!e)return;if(e.jobTitle!==void 0||e.sameAs!==void 0)return o(e);const t={"@type":"Organization",name:e.name};return e.url&&(t.url=e.url),t},P=({name:e,headline:n,url:t,description:s,mainEntity:g,author:u,about:i})=>{const r={"@context":"https://schema.org","@type":"ProfilePage"};e&&(r.name=e),n&&(r.headline=n),t&&(r.mainEntityOfPage={"@type":"WebPage","@id":t}),s&&(r.description=s);const f=o(g);f&&(r.mainEntity=f);const a=l(u);return a&&(r.author=a),i&&i.length>0&&(r.about=i),r};export{P as generateProfilePageSchema};

package/general/generate-qa-page-schema.d.mts

@@ -0,0 +1,34 @@
+/**
+ * Generate schema.org `QAPage` JSON-LD (Question + Answers).
+ *
+ * The helper formats a single `Question` and its `Answer` entries,
+ * including author references and date fields. Use `acceptedAnswer` and
+ * `suggestedAnswer` to provide preferred or additional answers.
+ *
+ * See `QAPageOptions` and related types for the input contract.
+ * @returns A JSON-LD compatible `QAPage` object
+ */
+interface PersonRef {
+    name: string;
+    url?: string;
+}
+interface AnswerItem {
+    text: string;
+    author?: string | PersonRef;
+    datePublished?: string;
+}
+interface QuestionItem {
+    name: string;
+    text?: string;
+    author?: string | PersonRef;
+    datePublished?: string;
+    answers?: AnswerItem[];
+    acceptedAnswer?: AnswerItem;
+}
+interface QAPageOptions {
+    headline?: string;
+    mainEntity: QuestionItem;
+}
+declare const generateQAPageSchema: ({ headline, mainEntity, }: QAPageOptions) => any;
+
+export { generateQAPageSchema };

package/general/generate-qa-page-schema.mjs

@@ -0,0 +1 @@
+const a=t=>{if(!t)return;if(typeof t=="string")return{"@type":"Person",name:t};const e={"@type":"Person",name:t.name};return t.url&&(e.url=t.url),e},o=t=>{const e={"@type":"Answer"};return t.text&&(e.text=t.text),t.author&&(e.author=a(t.author)),t.datePublished&&(e.datePublished=t.datePublished),e},u=({headline:t,mainEntity:e})=>{const s={"@type":"Question",name:e.name};e.text&&(s.text=e.text),e.author&&(s.author=a(e.author)),e.datePublished&&(s.datePublished=e.datePublished),e.answers&&e.answers.length>0&&(s.answerCount=e.answers.length,s.acceptedAnswer=e.acceptedAnswer?o(e.acceptedAnswer):void 0,s.suggestedAnswer=e.answers.filter(r=>!e.acceptedAnswer||r.text!==e.acceptedAnswer.text).map(r=>o(r)));const n={"@context":"https://schema.org","@type":"QAPage",mainEntity:s};return t&&(n.headline=t),n};export{u as generateQAPageSchema};

package/general/generate-recipe-schema.d.mts

@@ -0,0 +1,49 @@
+/**
+ * Generate schema.org `Recipe` JSON-LD, with support for `HowToStep`
+ * instructions and `ItemList` ingredients.
+ *
+ * Accepts recipe metadata (times, yields, cuisine, ingredients, steps)
+ * and will format steps as `HowToStep` objects and images as `ImageObject`
+ * entries when provided.
+ *
+ * See `RecipeOptions` for the accepted input shape.
+ * @returns A JSON-LD compatible `Recipe` object
+ */
+interface ImageRef {
+    url: string;
+    width?: number;
+    height?: number;
+}
+interface PersonRef {
+    name: string;
+    url?: string;
+}
+interface HowToStep {
+    name?: string;
+    text: string;
+    image?: string | ImageRef;
+    url?: string;
+}
+interface AggregateRating {
+    ratingValue: number | string;
+    reviewCount?: number;
+}
+interface RecipeOptions {
+    name: string;
+    description?: string;
+    image?: string | ImageRef;
+    author?: string | PersonRef;
+    recipeYield?: string;
+    prepTime?: string;
+    cookTime?: string;
+    totalTime?: string;
+    recipeCategory?: string | string[];
+    recipeCuisine?: string | string[];
+    keywords?: string | string[];
+    recipeIngredient?: string[];
+    recipeInstructions?: HowToStep[];
+    aggregateRating?: AggregateRating;
+}
+declare const generateRecipeSchema: ({ name, description, image, author, recipeYield, prepTime, cookTime, totalTime, recipeCategory, recipeCuisine, keywords, recipeIngredient, recipeInstructions, aggregateRating, }: RecipeOptions) => any;
+
+export { generateRecipeSchema };

package/general/generate-recipe-schema.mjs

@@ -0,0 +1 @@
+const y=t=>{if(t)return typeof t=="string"?t:{"@type":"ImageObject",url:t.url,...t.width&&{width:t.width},...t.height&&{height:t.height}}},w=t=>{if(!t)return;if(typeof t=="string")return{"@type":"Person",name:t};const n={"@type":"Person",name:t.name};return t.url&&(n.url=t.url),n},d=t=>{const n={"@type":"HowToStep"};t.name&&(n.name=t.name),t.text&&(n.text=t.text),t.url&&(n.url=t.url);const r=y(t.image);return r&&(n.image=r),n},A=({name:t,description:n,image:r,author:R,recipeYield:u,prepTime:m,cookTime:c,totalTime:h,recipeCategory:i,recipeCuisine:a,keywords:g,recipeIngredient:s,recipeInstructions:f,aggregateRating:o})=>{const e={"@context":"https://schema.org","@type":"Recipe",name:t};n&&(e.description=n);const l=y(r);l&&(e.image=l);const p=w(R);return p&&(e.author=p),u&&(e.recipeYield=u),m&&(e.prepTime=m),c&&(e.cookTime=c),h&&(e.totalTime=h),i&&(e.recipeCategory=Array.isArray(i)?i.join(", "):i),a&&(e.recipeCuisine=Array.isArray(a)?a.join(", "):a),g&&(e.keywords=Array.isArray(g)?g.join(", "):g),s&&s.length>0&&(e.recipeIngredient=s),f&&f.length>0&&(e.recipeInstructions=f.map(d)),o&&(e.aggregateRating={"@type":"AggregateRating",ratingValue:o.ratingValue},o.reviewCount!=null&&(e.aggregateRating.reviewCount=o.reviewCount)),e};export{A as generateRecipeSchema};

package/general/generate-ref.d.mts

@@ -0,0 +1,11 @@
+interface Params {
+    refLength: number;
+}
+/**
+ * Generates a short reference code from a UUID slice and the current 2-digit year.
+ * @param params.refLength - Length of the UUID slice (default 5).
+ * @returns The generated reference string.
+ */
+declare const generateRef: ({ refLength }: Params) => string;
+
+export { generateRef };

package/general/generate-ref.js

@@ -1 +1 @@
-var a=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var m=Object.getOwnPropertyNames;var f=Object.prototype.hasOwnProperty;var u=(r,e)=>{for(var t in e)a(r,t,{get:e[t],enumerable:!0})},g=(r,e,t,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of m(e))!f.call(r,n)&&n!==t&&a(r,n,{get:()=>e[n],enumerable:!(o=c(e,n))||o.enumerable});return r};var p=r=>g(a({},"__esModule",{value:!0}),r);var L={};u(L,{generateRef:()=>l});module.exports=p(L);var s=require("uuid"),i=require("../constants/select-value-delimiter");const l=({refLength:r=5})=>{const e=(0,s.v4)().toUpperCase().slice(0,r),t=new Date().getFullYear().toString().slice(-2);return`${e}${i.VALUE_DELIMITER.SLASH}${t}`};0&&(module.exports={generateRef});
+var s=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var i=Object.getOwnPropertyNames;var u=Object.prototype.hasOwnProperty;var f=(r,e)=>{for(var t in e)s(r,t,{get:e[t],enumerable:!0})},g=(r,e,t,a)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of i(e))!u.call(r,n)&&n!==t&&s(r,n,{get:()=>e[n],enumerable:!(a=c(e,n))||a.enumerable});return r};var m=r=>g(s({},"__esModule",{value:!0}),r);var p={};f(p,{generateRef:()=>l});module.exports=m(p);var o=require("../constants/select-value-delimiter");const l=({refLength:r=5})=>{const{v4:e}=require("uuid"),t=e().toUpperCase().slice(0,r),a=new Date().getFullYear().toString().slice(-2);return`${t}${o.VALUE_DELIMITER.SLASH}${a}`};0&&(module.exports={generateRef});

package/general/generate-ref.mjs

@@ -0,0 +1 @@
+import{VALUE_DELIMITER as a}from"../constants/select-value-delimiter";const o=({refLength:e=5})=>{const{v4:r}=require("uuid"),t=r().toUpperCase().slice(0,e),n=new Date().getFullYear().toString().slice(-2);return`${t}${a.SLASH}${n}`};export{o as generateRef};