@stephenchenorg/astro 5.0.2 → 6.1.0

package/dist/page/index.js

@@ -1,4 +1,88 @@
-export { default as PageFieldRender } from "./components/PageFieldRender.astro";
-export * from "./field/index.js";
-export * from "./seo-meta/index.js";
-export * from "./types.js";
+import { gql } from "graphql-tag";
+
+//#region src/page/field/fragments.ts
+/**
+* Page fields fragment requires explicit import image
+* fields fragment `imageFields` from Image module.
+*/
+const pageFields = gql`
+  fragment PageFields on Page {
+    title
+    seo_title
+    seo_description
+    seo_keyword
+    seo_json_ld
+    seo_head
+    seo_body
+    og_title
+    og_description
+    og_image
+    fields {
+      key
+      content
+      type
+      image {
+        ...ImageFields
+      }
+    }
+  }
+`;
+
+//#endregion
+//#region src/page/field/helpers.ts
+function isPlainTextField(field) {
+	return field.type === "text";
+}
+function isPlainTextareaField(field) {
+	return field.type === "textarea";
+}
+function isContentField(field) {
+	return field.type === "html";
+}
+function isImageField(field) {
+	return field.type === "image";
+}
+function pageTextField(fields, key) {
+	const field = fields.find((field$1) => field$1.key === key && isPlainTextField(field$1));
+	return field ? field.content : "";
+}
+function pageImageFieldForBackground(fields, key) {
+	const field = fields.find((field$1) => field$1.key === key && isImageField(field$1));
+	return field ? `background-image: url('${field.image.desktop}');` : "";
+}
+
+//#endregion
+//#region src/page/seo-meta/fragments.ts
+const seoMetaFields = (dummyClass) => gql(`
+  fragment DummyClassSeoMetaFields on DummyClass {
+    seo_title
+    seo_description
+    seo_keyword
+    seo_json_ld
+    seo_head
+    seo_body
+    og_title
+    og_description
+    og_image
+  }
+`.replace(/DummyClass/g, dummyClass));
+
+//#endregion
+//#region src/page/seo-meta/helpers.ts
+function seoMeta(options, modelMeta) {
+	return {
+		title: modelMeta?.title || options.title,
+		seo_title: modelMeta?.seo_title || options.seo_title || null,
+		seo_description: modelMeta?.seo_description || options.seo_description || options.description || null,
+		seo_keyword: modelMeta?.seo_keyword || options.seo_keyword || null,
+		seo_json_ld: modelMeta?.seo_json_ld || options.seo_json_ld || null,
+		seo_head: modelMeta?.seo_head || options.seo_head,
+		seo_body: modelMeta?.seo_body || options.seo_body,
+		og_title: modelMeta?.og_title || options.og_title || options.title || null,
+		og_description: modelMeta?.og_description || options.og_description || options.description || null,
+		og_image: modelMeta?.og_image || options.og_image || options.image || null
+	};
+}
+
+//#endregion
+export { isContentField, isImageField, isPlainTextField, isPlainTextareaField, pageFields, pageImageFieldForBackground, pageTextField, seoMeta, seoMetaFields };

package/dist/pagination-astro/index.d.ts

@@ -1,2 +1,30 @@
-export * from './types';
-export * from './usePagination';
+//#region src/pagination-astro/types.d.ts
+interface Paginator<T> {
+  total: number;
+  per_page: number;
+  data: T[];
+}
+//#endregion
+//#region src/pagination-astro/usePagination.d.ts
+declare function usePagination(options: {
+  total: number;
+  currentPage: number;
+  url: string;
+  perPage?: number;
+  visiblePages?: number;
+}): {
+  items: number[];
+  showPagination: boolean;
+  currentPage: number;
+  canFirst: boolean;
+  canPrev: boolean;
+  canNext: boolean;
+  canLast: boolean;
+  firstUrl: string;
+  prevUrl: string;
+  nextUrl: string;
+  lastUrl: string;
+  getUrl: (page: number) => string;
+};
+//#endregion
+export { Paginator, usePagination };

package/dist/pagination-astro/index.js

@@ -1,2 +1,37 @@
-export * from "./types.js";
-export * from "./usePagination.js";
+//#region src/pagination-astro/usePagination.ts
+function usePagination(options) {
+	const { total, currentPage, perPage = 12 } = options;
+	const items = [];
+	const totalPages = Math.ceil(total / perPage);
+	const visiblePages = Math.min(options.visiblePages || 5, totalPages);
+	const sideCount = Math.floor(visiblePages / 2);
+	let start = Math.max(1, currentPage - sideCount);
+	let end = Math.min(totalPages, currentPage + sideCount);
+	if (end - start + 1 < visiblePages && currentPage > 0) {
+		if (currentPage <= sideCount) end = Math.min(totalPages, start + visiblePages - 1);
+		else if (currentPage > totalPages - sideCount) start = Math.max(1, end - visiblePages + 1);
+	}
+	for (let i = start; i <= end; i++) items.push(i);
+	function getUrl(page) {
+		const url = new URL(options.url);
+		url.searchParams.set("page", String(page));
+		return url.toString();
+	}
+	return {
+		items,
+		showPagination: total > perPage,
+		currentPage,
+		canFirst: currentPage > 1,
+		canPrev: currentPage > 1,
+		canNext: currentPage < totalPages,
+		canLast: currentPage < totalPages,
+		firstUrl: getUrl(1),
+		prevUrl: getUrl(currentPage - 1),
+		nextUrl: getUrl(currentPage + 1),
+		lastUrl: getUrl(totalPages),
+		getUrl
+	};
+}
+
+//#endregion
+export { usePagination };

package/dist/pagination-vue/index.d.ts

@@ -1,2 +1,33 @@
-export * from './types';
-export * from './usePagination';
+import * as vue1 from "vue";
+import { MaybeRefOrGetter } from "vue";
+
+//#region src/pagination-vue/types.d.ts
+interface Paginator<T> {
+  total: number;
+  per_page: number;
+  data: T[];
+}
+//#endregion
+//#region src/pagination-vue/usePagination.d.ts
+declare function usePagination(options: {
+  total: MaybeRefOrGetter<number>;
+  currentPage: MaybeRefOrGetter<number>;
+  url: string;
+  perPage?: MaybeRefOrGetter<number>;
+  visiblePages?: MaybeRefOrGetter<number>;
+}): {
+  items: vue1.ComputedRef<number[]>;
+  showPagination: vue1.ComputedRef<boolean>;
+  currentPage: vue1.ComputedRef<number>;
+  canFirst: vue1.ComputedRef<boolean>;
+  canPrev: vue1.ComputedRef<boolean>;
+  canNext: vue1.ComputedRef<boolean>;
+  canLast: vue1.ComputedRef<boolean>;
+  firstUrl: vue1.ComputedRef<string>;
+  prevUrl: vue1.ComputedRef<string>;
+  nextUrl: vue1.ComputedRef<string>;
+  lastUrl: vue1.ComputedRef<string>;
+  getUrl: (page: number) => string;
+};
+//#endregion
+export { Paginator, usePagination };

package/dist/pagination-vue/index.js

@@ -1,2 +1,44 @@
-export * from "./types.js";
-export * from "./usePagination.js";
+import { computed, toValue } from "vue";
+
+//#region src/pagination-vue/usePagination.ts
+function usePagination(options) {
+	const total = computed(() => toValue(options.total));
+	const currentPage = computed(() => toValue(options.currentPage));
+	const perPage = computed(() => toValue(options.perPage || 12));
+	const totalPages = computed(() => Math.ceil(total.value / perPage.value));
+	const visiblePages = computed(() => Math.min(toValue(options.visiblePages || 5), totalPages.value));
+	const sideCount = computed(() => Math.floor(visiblePages.value / 2));
+	const items = computed(() => {
+		const items$1 = [];
+		let start = Math.max(1, currentPage.value - sideCount.value);
+		let end = Math.min(totalPages.value, currentPage.value + sideCount.value);
+		if (end - start + 1 < visiblePages.value && currentPage.value > 0) {
+			if (currentPage.value <= sideCount.value) end = Math.min(totalPages.value, start + visiblePages.value - 1);
+			else if (currentPage.value > totalPages.value - sideCount.value) start = Math.max(1, end - visiblePages.value + 1);
+		}
+		for (let i = start; i <= end; i++) items$1.push(i);
+		return items$1;
+	});
+	function getUrl(page) {
+		const url = new URL(options.url);
+		url.searchParams.set("page", String(page));
+		return url.toString();
+	}
+	return {
+		items,
+		showPagination: computed(() => total.value > perPage.value),
+		currentPage,
+		canFirst: computed(() => currentPage.value > 1),
+		canPrev: computed(() => currentPage.value > 1),
+		canNext: computed(() => currentPage.value < totalPages.value),
+		canLast: computed(() => currentPage.value < totalPages.value),
+		firstUrl: computed(() => getUrl(1)),
+		prevUrl: computed(() => getUrl(currentPage.value - 1)),
+		nextUrl: computed(() => getUrl(currentPage.value + 1)),
+		lastUrl: computed(() => getUrl(totalPages.value)),
+		getUrl
+	};
+}
+
+//#endregion
+export { usePagination };

package/dist/product-variant/index.d.ts

@@ -1,2 +1,73 @@
-export * from './ProductVariantSelector';
-export * from './types';
+//#region src/product-variant/types.d.ts
+interface ProductVariant {
+  id: number;
+  /** 商品規格 Key */
+  combination_key: string | null;
+  /** 原價 */
+  listing_price: number;
+  /** 實際售價 */
+  selling_price: number;
+  /** 商品庫存數量 */
+  inventory: number;
+}
+interface ProductVariantAttribute {
+  id: number;
+  title: string;
+  options: ProductVariantAttributeOption[];
+}
+interface ProductVariantAttributeOption {
+  id: number;
+  title: string;
+}
+//#endregion
+//#region src/product-variant/ProductVariantSelector.d.ts
+declare class ProductVariantSelector {
+  /**
+   * 可用的商品變體列表（所有 SKU）
+   */
+  availableVariants: ProductVariant[];
+  /**
+   * 商品屬性選項列表（如顏色、尺寸等）
+   */
+  variantAttributes: ProductVariantAttribute[];
+  /**
+   * 使用者已選擇的屬性值
+   */
+  selectedAttributes: Record<number, {
+    optionId: number;
+    label: string;
+  }>;
+  /**
+   * 匹配到的商品規格物件
+   */
+  currentVariant: ProductVariant | undefined;
+  constructor({
+    availableVariants,
+    variantAttributes
+  }: {
+    availableVariants: ProductVariant[];
+    variantAttributes: ProductVariantAttribute[];
+  });
+  /**
+   * 選擇商品規格
+   */
+  selectVariant(attributeId: number, optionId: number, label: string): void;
+  /**
+   * 獲取已選擇的商品規格選項標籤
+   */
+  getSelectedAttributesLabel(): string;
+  /**
+   * 確認是否已選擇所有商品規格選項
+   */
+  areAllAttributesSelected(): boolean;
+  /**
+   * 確認是否已選擇有效的商品規格
+   */
+  isValidVariantSelected(): boolean;
+  /**
+   * 確認是否有足夠的庫存
+   */
+  hasEnoughStock(stock: number): boolean;
+}
+//#endregion
+export { ProductVariant, ProductVariantAttribute, ProductVariantAttributeOption, ProductVariantSelector };

package/dist/product-variant/index.js

@@ -1,2 +1,63 @@
-export * from "./ProductVariantSelector.js";
-export * from "./types.js";
+//#region src/product-variant/ProductVariantSelector.ts
+var ProductVariantSelector = class {
+	/**
+	* 可用的商品變體列表（所有 SKU）
+	*/
+	availableVariants = [];
+	/**
+	* 商品屬性選項列表（如顏色、尺寸等）
+	*/
+	variantAttributes = [];
+	/**
+	* 使用者已選擇的屬性值
+	*/
+	selectedAttributes = {};
+	/**
+	* 匹配到的商品規格物件
+	*/
+	currentVariant = void 0;
+	constructor({ availableVariants, variantAttributes }) {
+		this.availableVariants = availableVariants;
+		this.variantAttributes = variantAttributes;
+		if (availableVariants.length === 1 && availableVariants[0].combination_key === null) this.currentVariant = availableVariants[0];
+	}
+	/**
+	* 選擇商品規格
+	*/
+	selectVariant(attributeId, optionId, label) {
+		this.selectedAttributes[attributeId] = {
+			optionId,
+			label
+		};
+		const variantCombinationKey = Object.values(this.selectedAttributes).map((attr) => attr.optionId).sort((a, b) => a - b).join("-");
+		this.currentVariant = this.availableVariants.find((variant) => variant.combination_key === variantCombinationKey);
+	}
+	/**
+	* 獲取已選擇的商品規格選項標籤
+	*/
+	getSelectedAttributesLabel() {
+		return Object.values(this.selectedAttributes).map((attr) => attr.label).join(", ");
+	}
+	/**
+	* 確認是否已選擇所有商品規格選項
+	*/
+	areAllAttributesSelected() {
+		return Object.keys(this.selectedAttributes).length === this.variantAttributes.length;
+	}
+	/**
+	* 確認是否已選擇有效的商品規格
+	*/
+	isValidVariantSelected() {
+		return typeof this.currentVariant !== "undefined" && this.currentVariant.inventory > 0;
+	}
+	/**
+	* 確認是否有足夠的庫存
+	*/
+	hasEnoughStock(stock) {
+		const specificationStock = this.currentVariant?.inventory || 0;
+		return specificationStock > 0 && specificationStock >= stock;
+	}
+};
+
+//#endregion
+export { ProductVariantSelector };

package/dist/query-params/components/ProvideUrlConfig.astro

@@ -1,5 +1,5 @@
 ---
-import type { UrlConfig } from '../types'
+import type { UrlConfig } from '@stephenchenorg/astro/query-params'
 
 interface Props {
   config: UrlConfig
@@ -18,7 +18,6 @@ window.__astro_provide_url_config__ = config;
 </script>
 
 <script>
-// Must be imported from the regular package path to avoid duplicate instances
 import { urlConfigStore } from '@stephenchenorg/astro/query-params'
 
 const props = window.__astro_provide_url_config__

package/dist/query-params/index.d.ts

@@ -1,6 +1,35 @@
-export { default as ProvideUrlConfig } from './components/ProvideUrlConfig.astro';
-export * from './config';
-export * from './store';
-export * from './types';
-export * from './url';
-export * from './utils';
+import * as nanostores16 from "nanostores";
+import qs from "query-string";
+
+//#region src/query-params/types.d.ts
+interface UrlConfig {
+  baseUrl: string;
+  hash?: string;
+  params: Record<string, any>;
+  defaultParams?: Record<string, any>;
+}
+//#endregion
+//#region src/query-params/config.d.ts
+declare function createUrlConfig(config: UrlConfig): UrlConfig;
+//#endregion
+//#region src/query-params/store.d.ts
+declare const urlConfigStore: nanostores16.PreinitializedWritableAtom<UrlConfig> & object;
+//#endregion
+//#region src/query-params/url.d.ts
+declare global {
+  interface Window {
+    __astro_provide_url_config__?: UrlConfig;
+  }
+}
+interface QueryParamsUrlOptions {
+  clear?: boolean;
+  transformParams?: (params: Record<string, any>) => Record<string, any>;
+}
+declare function queryParamsUrl(additionalParams: Record<string, any>, urlConfig?: UrlConfig, options?: QueryParamsUrlOptions): string;
+declare function parseQueryParams(search: string): qs.ParsedQuery<string>;
+//#endregion
+//#region src/query-params/utils.d.ts
+declare function mergeUrlParams<Params extends Record<string, any> = Record<string, any>>(baseParams: Params, userParams: Partial<Params>): Params;
+declare function cleanParams(params: Record<string, any>, defaultParams: Record<string, any>): Record<string, any>;
+//#endregion
+export { QueryParamsUrlOptions, UrlConfig, cleanParams, createUrlConfig, mergeUrlParams, parseQueryParams, queryParamsUrl, urlConfigStore };

package/dist/query-params/index.js

@@ -1,6 +1,62 @@
-export { default as ProvideUrlConfig } from "./components/ProvideUrlConfig.astro";
-export * from "./config.js";
-export * from "./store.js";
-export * from "./types.js";
-export * from "./url.js";
-export * from "./utils.js";
+import { atom } from "nanostores";
+import qs from "query-string";
+
+//#region src/query-params/config.ts
+function createUrlConfig(config) {
+	return config;
+}
+
+//#endregion
+//#region src/query-params/store.ts
+const urlConfigStore = atom({
+	baseUrl: "",
+	hash: "",
+	params: {},
+	defaultParams: {}
+});
+
+//#endregion
+//#region src/query-params/utils.ts
+function mergeUrlParams(baseParams, userParams) {
+	return Object.keys(baseParams).reduce((result, key) => {
+		if (userParams[key] === null) result[key] = null;
+		else if (Array.isArray(baseParams[key])) result[key] = Array.from(new Set([...baseParams[key], ...userParams[key] || []]));
+		else result[key] = typeof userParams[key] !== "undefined" ? userParams[key] : baseParams[key];
+		return result;
+	}, {});
+}
+function cleanParams(params, defaultParams) {
+	const newParams = JSON.parse(JSON.stringify(params));
+	Object.keys(newParams).forEach((key) => {
+		if (Object.keys(defaultParams).includes(key) && newParams[key] === defaultParams[key]) newParams[key] = null;
+	});
+	return newParams;
+}
+
+//#endregion
+//#region src/query-params/url.ts
+function queryParamsUrl(additionalParams, urlConfig = {
+	baseUrl: "",
+	params: {}
+}, options = {}) {
+	const { clear = false, transformParams } = options;
+	const config = typeof window !== "undefined" ? urlConfigStore.get() : urlConfig;
+	let params = {};
+	if (!clear) {
+		params = mergeUrlParams(config.params, additionalParams);
+		if (transformParams) params = transformParams(params);
+		params = cleanParams(params, config.defaultParams || {});
+	}
+	const queryString = qs.stringify(params, {
+		skipEmptyString: true,
+		skipNull: true,
+		sort: false
+	});
+	return `${config.baseUrl}${queryString ? "?" : ""}${queryString}${config.hash ? `#${config.hash}` : ""}`;
+}
+function parseQueryParams(search) {
+	return qs.parse(search);
+}
+
+//#endregion
+export { cleanParams, createUrlConfig, mergeUrlParams, parseQueryParams, queryParamsUrl, urlConfigStore };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stephenchenorg/astro",
   "type": "module",
-  "version": "5.0.2",
+  "version": "6.1.0",
   "description": "Stephenchenorg Astro 前端通用套件",
   "license": "MIT",
   "homepage": "https://stephenchenorg-astro.netlify.app",
@@ -10,7 +10,14 @@
     "url": "git+https://github.com/stephenchenorg/package.astro.git"
   },
   "keywords": [
-    "astro"
+    "astro",
+    "vue",
+    "components",
+    "query-string",
+    "pagination",
+    "product-variant",
+    "form-validator",
+    "query-params"
   ],
   "exports": {
     "./api": {
@@ -29,10 +36,13 @@
       "types": "./dist/image/index.d.ts",
       "import": "./dist/image/index.js"
     },
+    "./image/components/Image.astro": "./dist/image/components/Image.astro",
+    "./image/components/ResponsiveImage.astro": "./dist/image/components/ResponsiveImage.astro",
     "./page": {
       "types": "./dist/page/index.d.ts",
       "import": "./dist/page/index.js"
     },
+    "./page/components/PageFieldRender.astro": "./dist/page/components/PageFieldRender.astro",
     "./pagination-astro": {
       "types": "./dist/pagination-astro/index.d.ts",
       "import": "./dist/pagination-astro/index.js"
@@ -48,7 +58,8 @@
     "./query-params": {
       "types": "./dist/query-params/index.d.ts",
       "import": "./dist/query-params/index.js"
-    }
+    },
+    "./query-params/components/ProvideUrlConfig.astro": "./dist/query-params/components/ProvideUrlConfig.astro"
   },
   "typesVersions": {
     "*": {
@@ -67,7 +78,7 @@
     "node": ">=22"
   },
   "scripts": {
-    "build": "mkdist --declaration --ext=js && sh ./scripts/postbuild.sh",
+    "build": "tsdown",
     "lint": "eslint \"*.{js,ts,json}\" \"src/**/*.ts\"",
     "test": "vitest",
     "code-check": "astro check && npm run lint && npm run test -- --run",
@@ -99,7 +110,7 @@
     "bumpp": "^10.2.0",
     "eslint": "^9.30.1",
     "eslint-plugin-astro": "^1.3.1",
-    "mkdist": "^2.3.0",
+    "tsdown": "^0.12.9",
     "typescript": "^5.8.3",
     "vitest": "^3.2.4",
     "vue": "^3.5.17"

package/dist/api/error.d.ts

@@ -1,54 +0,0 @@
-export interface GraphQLFieldError {
-    code?: number;
-    message: string;
-    locations?: {
-        line: number;
-        column: number;
-    }[];
-    path?: (string | number)[];
-    extensions?: GraphQLRequestExtensions;
-    data?: Record<string, any>;
-}
-export interface GraphQLRequestExtensions {
-    debugMessage?: string;
-    file?: string;
-    line?: number;
-    trace?: {
-        file: string;
-        line: number;
-        call: number;
-    }[];
-}
-export interface GraphQLRequestErrorOptions {
-    code?: number;
-    message: string;
-    query: string;
-    variables?: Record<string, any>;
-    extensions?: GraphQLRequestExtensions;
-    fieldErrors?: GraphQLFieldError[];
-}
-export declare class GraphQLRequestError extends Error {
-    type: string;
-    name: string;
-    title: string;
-    code: number | undefined;
-    originalMessage: string;
-    query: string;
-    variables: Record<string, any> | undefined;
-    extensions: GraphQLRequestExtensions | undefined;
-    fieldErrors: GraphQLFieldError[] | undefined;
-    constructor(props: GraphQLRequestErrorOptions, options?: ErrorOptions);
-    isNotFound(): boolean;
-    private buildMessage;
-    static is(err: unknown): err is GraphQLRequestError;
-}
-export declare class GraphQLNotFoundError extends GraphQLRequestError {
-    type: string;
-    name: string;
-}
-export declare class GraphQLValidationError extends GraphQLRequestError {
-    type: string;
-    name: string;
-    errors: Record<string, string[]>;
-    constructor(props: GraphQLRequestErrorOptions, options?: ErrorOptions);
-}