@stephenchenorg/astro 1.0.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+# The MIT License (MIT)
+
+Copyright (c) 2025-present Lucas Yang <yangchenshin77@gmail.com>
+
+> Permission is hereby granted, free of charge, to any person obtaining a copy
+> of this software and associated documentation files (the "Software"), to deal
+> in the Software without restriction, including without limitation the rights
+> to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+> copies of the Software, and to permit persons to whom the Software is
+> furnished to do so, subject to the following conditions:
+>
+> The above copyright notice and this permission notice shall be included in
+> all copies or substantial portions of the Software.
+>
+> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+> IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+> FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+> AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+> LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+> OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+> THE SOFTWARE.

package/README.md

@@ -0,0 +1,24 @@
+# Stephenchenorg Astro 前端通用套件
+
+## 使用
+
+```bash
+# npm
+npm install @stephenchenorg/astro
+# yarn
+yarn add @stephenchenorg/astro
+```
+
+## 開發
+
+```bash
+yarn
+yarn build
+```
+
+## 發布新版
+
+```bash
+npm login
+npm publish
+```

package/dist/api/error.d.ts

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

package/dist/api/error.js

@@ -0,0 +1,74 @@
+export class GraphQLRequestError extends Error {
+  type = "GraphQLRequestError";
+  name = "GraphQLRequestError";
+  title = "GraphQL request error.";
+  originalMessage;
+  query;
+  variables;
+  extensions;
+  constructor(props, options) {
+    const { message, query, variables, extensions } = props;
+    super("GraphQL request error.", options);
+    const originalStack = this.stack;
+    this.title = "GraphQL request error.";
+    this.originalMessage = message;
+    this.query = query;
+    this.variables = variables;
+    this.extensions = extensions;
+    this.message = this.buildMessage();
+    this.stack = originalStack;
+  }
+  isNotFound() {
+    return this.originalMessage.includes("Http Status 404");
+  }
+  buildMessage() {
+    let message = `${this.originalMessage}
+`;
+    if (this.extensions) {
+      if (this.extensions.debugMessage) {
+        message += "\n";
+        message += `${this.extensions.debugMessage}
+`;
+      }
+      if (this.extensions.file || this.extensions.line || this.extensions.trace) {
+        message += "\n";
+        message += "[stacktrace]\n";
+        if (this.extensions.file) {
+          message += `file: ${this.extensions.file}
+`;
+        }
+        if (this.extensions.line) {
+          message += `line: ${this.extensions.line}
+`;
+        }
+        if (this.extensions.trace && Array.isArray(this.extensions.trace)) {
+          message += "trace:\n";
+          for (const trace of this.extensions.trace.slice(0, 3)) {
+            message += `  - file: ${trace.file}
+`;
+            message += `    line: ${trace.line}
+`;
+            message += `    call: ${trace.call}
+`;
+          }
+        }
+      }
+    }
+    if (this.query) {
+      message += "\n";
+      message += `[query]
+${this.query}
+`;
+    }
+    if (this.variables) {
+      message += "\n";
+      message += `[variables]
+${JSON.stringify(this.variables, null, 2)}
+`;
+    }
+    return message;
+  }
+  static is(err) {
+    return err.type === "GraphQLRequestError";
+  }
+}

package/dist/api/index.d.ts

@@ -0,0 +1 @@
+export * from './error';

package/dist/api/index.js

@@ -0,0 +1 @@
+export * from "./error.js";

package/dist/company-setting/fragments.d.ts

@@ -0,0 +1 @@
+export declare const companySettingFields: import("graphql/language/ast").DocumentNode;

package/dist/company-setting/fragments.js

@@ -0,0 +1,20 @@
+import { gql } from "graphql-tag";
+export const companySettingFields = gql`
+  fragment CompanySettingFields on CompanySetting {
+    lang
+    name
+    description
+    logo
+    address_1
+    address_2
+    email_1
+    email_2
+    fb_link
+    ig_link
+    line_link
+    phone_1
+    phone_2
+    twitter_link
+    threads_link
+  }
+`;

package/dist/company-setting/index.d.ts

@@ -0,0 +1,2 @@
+export * from './fragments';
+export * from './types';

package/dist/company-setting/index.js

@@ -0,0 +1,2 @@
+export * from "./fragments.js";
+export * from "./types.js";

package/dist/company-setting/types.d.ts

@@ -0,0 +1,20 @@
+export interface DataCompanySetting {
+    companySetting: CompanySetting;
+}
+export interface CompanySetting {
+    lang: string;
+    name: string;
+    description: string;
+    logo: string;
+    address_1: string;
+    address_2: string;
+    email_1: string;
+    email_2: string;
+    fb_link: string;
+    ig_link: string;
+    line_link: string;
+    phone_1: string;
+    phone_2: string;
+    twitter_link: string;
+    threads_link: string;
+}

package/dist/image/components/Image.astro

@@ -0,0 +1,10 @@
+---
+interface Props extends astroHTML.JSX.ImgHTMLAttributes {
+  src: string | null
+  srcBlur?: string | null
+}
+
+const { src, ...attributes } = Astro.props
+---
+
+{src && <img src={src} {...attributes} />}

package/dist/image/components/ResponsiveImage.astro

@@ -0,0 +1,23 @@
+---
+interface Props extends astroHTML.JSX.ImgHTMLAttributes {
+  desktop: string | null
+  desktopBlur?: string | null
+  mobile?: string | null
+  mobileBlur?: string | null
+}
+
+const { desktop, desktopBlur, mobile, mobileBlur, src: _, ...attributes } = Astro.props
+
+const breakpoint = 768
+---
+
+{desktop && (
+  mobile ? (
+    <picture>
+      {mobile && <source media={`(max-width: ${breakpoint - 0.02}px)`} srcset={mobile} />}
+      <img src={desktop} {...attributes} />
+    </picture>
+  ) : (
+    <img src={desktop} {...attributes} />
+  )
+)}

package/dist/image/fragments.d.ts

@@ -0,0 +1,3 @@
+export declare const imageFields: import("graphql/language/ast").DocumentNode;
+export declare const coverFields: import("graphql/language/ast").DocumentNode;
+export declare const backgroundFields: import("graphql/language/ast").DocumentNode;

package/dist/image/fragments.js

@@ -0,0 +1,25 @@
+import { gql } from "graphql-tag";
+export const imageFields = gql`
+  fragment ImageFields on Image {
+    desktop
+    desktop_blur
+    mobile
+    mobile_blur
+  }
+`;
+export const coverFields = gql`
+  fragment CoverFields on Cover {
+    desktop
+    desktop_blur
+    mobile
+    mobile_blur
+  }
+`;
+export const backgroundFields = gql`
+  fragment BackgroundFields on Background {
+    desktop
+    desktop_blur
+    mobile
+    mobile_blur
+  }
+`;

package/dist/image/index.d.ts

@@ -0,0 +1,5 @@
+import Image from './components/Image.astro';
+import ResponsiveImage from './components/ResponsiveImage.astro';
+export * from './fragments';
+export * from './types';
+export { Image, ResponsiveImage };

package/dist/image/index.js

@@ -0,0 +1,5 @@
+import Image from "./components/Image.astro";
+import ResponsiveImage from "./components/ResponsiveImage.astro";
+export * from "./fragments.js";
+export * from "./types.js";
+export { Image, ResponsiveImage };

package/dist/image/types.d.ts

@@ -0,0 +1,6 @@
+export interface ImageSource {
+    desktop: string | null;
+    desktop_blur: string | null;
+    mobile: string | null;
+    mobile_blur: string | null;
+}

package/dist/page/components/PageFieldRender.astro

@@ -0,0 +1,34 @@
+---
+import { isPlainTextField, isPlainTextareaField, isContentField, isImageField } from '../field/helpers'
+import type { PageField } from '../types'
+import { ResponsiveImage } from '../../image'
+
+interface Props {
+  fields: PageField[]
+  key: string
+  attributes?: Record<string, any>
+}
+
+const { fields, key, attributes } = Astro.props
+
+const field = fields.find(field => field.key === key)
+---
+
+{
+  field && (
+    isPlainTextField(field) ? <Fragment set:text={field.content} /> :
+    isPlainTextareaField(field) ? <Fragment set:html={field.content} /> :
+    isContentField(field) ? <Fragment set:html={field.content} /> :
+    isImageField(field) ? (
+      <ResponsiveImage
+        desktop={field.image.desktop}
+        desktopBlur={field.image.desktop_blur}
+        mobile={field.image.mobile}
+        mobileBlur={field.image.mobile_blur}
+        alt={`Image of ${key}`}
+        {...attributes}
+      />
+    ) :
+    null
+  )
+}

package/dist/page/field/fragments.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Page fields fragment requires explicit import image
+ * fields fragment `imageFields` from Image module.
+ */
+export declare const pageFields: import("graphql/language/ast").DocumentNode;

package/dist/page/field/fragments.js

@@ -0,0 +1,23 @@
+import { gql } from "graphql-tag";
+export 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
+      }
+    }
+  }
+`;

package/dist/page/field/helpers.d.ts

@@ -0,0 +1,7 @@
+import type { PageField, PagePlainTextField, PagePlainTextareaField, PageContentField, PageImageField } from '../types';
+export declare function isPlainTextField(field: PageField): field is PagePlainTextField;
+export declare function isPlainTextareaField(field: PageField): field is PagePlainTextareaField;
+export declare function isContentField(field: PageField): field is PageContentField;
+export declare function isImageField(field: PageField): field is PageImageField;
+export declare function pageTextField(fields: PageField[], key: string): any;
+export declare function pageImageFieldForBackground(fields: PageField[], key: string): string;

package/dist/page/field/helpers.js

@@ -0,0 +1,20 @@
+export function isPlainTextField(field) {
+  return field.type === "text";
+}
+export function isPlainTextareaField(field) {
+  return field.type === "textarea";
+}
+export function isContentField(field) {
+  return field.type === "html";
+}
+export function isImageField(field) {
+  return field.type === "image";
+}
+export function pageTextField(fields, key) {
+  const field = fields.find((field2) => field2.key === key && isPlainTextField(field2));
+  return field ? field.content : "";
+}
+export function pageImageFieldForBackground(fields, key) {
+  const field = fields.find((field2) => field2.key === key && isImageField(field2));
+  return field ? `background-image: url('${field.image.desktop}');` : "";
+}

package/dist/page/field/index.d.ts

@@ -0,0 +1,2 @@
+export * from './fragments';
+export * from './helpers';

package/dist/page/field/index.js

@@ -0,0 +1,2 @@
+export * from "./fragments.js";
+export * from "./helpers.js";

package/dist/page/index.d.ts

@@ -0,0 +1,5 @@
+import PageFieldRender from './components/PageFieldRender.astro';
+export * from './field';
+export * from './seo-meta';
+export * from './types';
+export { PageFieldRender };

package/dist/page/index.js

@@ -0,0 +1,5 @@
+import PageFieldRender from "./components/PageFieldRender.astro";
+export * from "./field/index.js";
+export * from "./seo-meta/index.js";
+export * from "./types.js";
+export { PageFieldRender };

package/dist/page/seo-meta/fragments.d.ts

@@ -0,0 +1 @@
+export declare const seoMetaFields: (dummyClass: string) => import("graphql/language/ast").DocumentNode;

package/dist/page/seo-meta/fragments.js

@@ -0,0 +1,14 @@
+import { gql } from "graphql-tag";
+export 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));

package/dist/page/seo-meta/helpers.d.ts

@@ -0,0 +1,7 @@
+import type { PageMeta } from '../types';
+export type UseSeoMetaOptions = Partial<Omit<PageMeta, 'title'>> & {
+    title: string;
+    description?: string | null;
+    image?: string | null;
+};
+export declare function seoMeta(options: UseSeoMetaOptions, userOptions?: PageMeta): PageMeta;

package/dist/page/seo-meta/helpers.js

@@ -0,0 +1,14 @@
+export function seoMeta(options, userOptions) {
+  return {
+    title: userOptions?.title || options.title,
+    seo_title: userOptions?.seo_title || options.seo_title || null,
+    seo_description: userOptions?.seo_description || options.description || null,
+    seo_keyword: userOptions?.seo_keyword || options.seo_keyword || null,
+    seo_json_ld: userOptions?.seo_json_ld || options.seo_json_ld || null,
+    seo_head: userOptions?.seo_head || options.seo_head,
+    seo_body: userOptions?.seo_body || options.seo_body,
+    og_title: userOptions?.og_title || options.og_title || options.title || null,
+    og_description: userOptions?.og_description || options.og_description || options.description || null,
+    og_image: userOptions?.og_image || options.og_image || options.image || null
+  };
+}

package/dist/page/seo-meta/index.d.ts

@@ -0,0 +1,2 @@
+export * from './fragments';
+export * from './helpers';

package/dist/page/seo-meta/index.js

@@ -0,0 +1,2 @@
+export * from "./fragments.js";
+export * from "./helpers.js";

package/dist/page/types.d.ts

@@ -0,0 +1,69 @@
+export interface DataPage {
+    page: Page;
+}
+export interface Page extends PageMeta {
+    fields: PageField[];
+}
+export interface PageMeta {
+    title: string;
+    seo_title: string | null;
+    seo_description: string | null;
+    seo_keyword: string | null;
+    seo_json_ld: string | null;
+    seo_head?: string | null;
+    seo_body?: string | null;
+    og_title: string | null;
+    og_description: string | null;
+    og_image: string | null;
+}
+export interface PageField {
+    key: string;
+    type: 'text' | 'textarea' | 'html' | 'image';
+    content: string | null;
+    image: {
+        desktop: string | null;
+        desktop_blur: string | null;
+        mobile: string | null;
+        mobile_blur: string | null;
+    };
+}
+export interface PagePlainTextField extends PageField {
+    type: 'text';
+    content: string;
+    image: {
+        desktop: null;
+        desktop_blur: null;
+        mobile: null;
+        mobile_blur: null;
+    };
+}
+export interface PagePlainTextareaField extends PageField {
+    type: 'textarea';
+    content: string;
+    image: {
+        desktop: null;
+        desktop_blur: null;
+        mobile: null;
+        mobile_blur: null;
+    };
+}
+export interface PageContentField extends PageField {
+    type: 'html';
+    content: string;
+    image: {
+        desktop: null;
+        desktop_blur: null;
+        mobile: null;
+        mobile_blur: null;
+    };
+}
+export interface PageImageField extends PageField {
+    type: 'image';
+    content: null;
+    image: {
+        desktop: string;
+        desktop_blur: string;
+        mobile: string;
+        mobile_blur: string;
+    };
+}

package/dist/pagination/index.d.ts

@@ -0,0 +1,2 @@
+export * from './usePagination';
+export * from './types';

package/dist/pagination/index.js

@@ -0,0 +1,2 @@
+export * from "./usePagination.js";
+export * from "./types.js";

package/dist/pagination/stub/Pagination.astro

@@ -0,0 +1,39 @@
+---
+import { usePagination } from '@stephenchenorg/astro/pagination'
+
+interface Props {
+  total: number
+  perPage?: number
+  visiblePages?: number
+  currentPage?: number
+}
+
+const {
+  items,
+  showPagination,
+  currentPage,
+  canPrev,
+  canNext,
+  prevUrl,
+  nextUrl,
+  getUrl,
+} = usePagination({
+  total: Astro.props.total,
+  perPage: Astro.props.perPage,
+  visiblePages: Astro.props.visiblePages,
+  currentPage: Astro.props.currentPage || Number(Astro.url.searchParams.get('page')) || 1,
+  url: Astro.request.url,
+})
+---
+
+{showPagination && (
+  <div>
+    {canPrev && <a href={prevUrl}>&lt;</a>}
+    {items.map(page =>
+      page === currentPage
+        ? <span>{page}</span>
+        : <a href={getUrl(page)}>{page}</a>
+    )}
+    {canNext && <a href={nextUrl}>&gt;</a>}
+  </div>
+)}

package/dist/pagination/types.d.ts

@@ -0,0 +1,5 @@
+export interface Paginator<T> {
+    total: number;
+    per_page: number;
+    data: T[];
+}

package/dist/pagination/usePagination.d.ts

@@ -0,0 +1,20 @@
+export declare function usePagination(options: {
+    total: number;
+    currentPage: number;
+    url: string;
+    perPage?: number;
+    visiblePages?: number;
+}): {
+    items: never[];
+    showPagination: boolean;
+    currentPage: number;
+    canFirst: boolean;
+    canPrev: boolean;
+    canNext: boolean;
+    canLast: boolean;
+    firstUrl: string;
+    prevUrl: string;
+    nextUrl: string;
+    lastUrl: string;
+    getUrl: (page: number) => string;
+};

package/dist/pagination/usePagination.js

@@ -0,0 +1,42 @@
+export 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
+  };
+}

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

@@ -0,0 +1,30 @@
+---
+import type { UrlConfig } from '../types'
+
+interface Props {
+  config: UrlConfig
+}
+
+const config: UrlConfig = {
+  baseUrl: Astro.props.config.baseUrl,
+  params: Astro.props.config.params,
+  defaultParams: Astro.props.config.defaultParams,
+}
+---
+
+<script is:inline define:vars={{ config }}>
+window.__astro_provide_url_config__ = config;
+</script>
+
+<script>
+import { urlConfigStore } from '../store'
+
+// @ts-ignore
+const props = window.__astro_provide_url_config__
+
+const baseUrl: string = props?.baseUrl || location.pathname
+const params: Record<string, any> = props?.params || {}
+const defaultParams: Record<string, any> = props?.defaultParams || {}
+
+urlConfigStore.set({ baseUrl, params, defaultParams })
+</script>

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

@@ -0,0 +1,2 @@
+import type { UrlConfig } from './types';
+export declare function createUrlConfig(config: UrlConfig): UrlConfig;

package/dist/query-params/config.js

@@ -0,0 +1,3 @@
+export function createUrlConfig(config) {
+  return config;
+}

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

@@ -0,0 +1,6 @@
+import ProvideUrlConfig from './components/ProvideUrlConfig.astro';
+export * from './config';
+export * from './url';
+export * from './utils';
+export * from './types';
+export { ProvideUrlConfig };

package/dist/query-params/index.js

@@ -0,0 +1,6 @@
+import ProvideUrlConfig from "./components/ProvideUrlConfig.astro";
+export * from "./config.js";
+export * from "./url.js";
+export * from "./utils.js";
+export * from "./types.js";
+export { ProvideUrlConfig };

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

@@ -0,0 +1,2 @@
+import type { UrlConfig } from './types';
+export declare const urlConfigStore: import("nanostores").PreinitializedWritableAtom<UrlConfig> & object;

package/dist/query-params/store.js

@@ -0,0 +1,6 @@
+import { atom } from "nanostores";
+export const urlConfigStore = atom({
+  baseUrl: "",
+  params: {},
+  defaultParams: {}
+});

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

@@ -0,0 +1,5 @@
+export interface UrlConfig {
+    baseUrl: string;
+    params: Record<string, any>;
+    defaultParams?: Record<string, any>;
+}

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

@@ -0,0 +1,7 @@
+import qs from 'query-string';
+import type { UrlConfig } from './types';
+export interface QueryParamsUrlOptions {
+    transformParams?: (params: Record<string, any>) => Record<string, any>;
+}
+export declare function queryParamsUrl(additionalParams: Record<string, any>, urlConfig?: UrlConfig, options?: QueryParamsUrlOptions): string;
+export declare function parseQueryParams(search: string): qs.ParsedQuery<string>;

package/dist/query-params/url.js

@@ -0,0 +1,25 @@
+import qs from "query-string";
+import { urlConfigStore } from "./store.js";
+import { cleanParams, mergeUrlParams } from "./utils.js";
+export function queryParamsUrl(additionalParams, urlConfig = {
+  baseUrl: "",
+  params: {},
+  defaultParams: {}
+}, options = {}) {
+  const { transformParams } = options;
+  const config = typeof window !== "undefined" ? urlConfigStore.get() : urlConfig;
+  let params = mergeUrlParams(config.params, additionalParams);
+  if (transformParams) {
+    params = transformParams(params);
+  }
+  const cleanedParams = cleanParams(params, config.defaultParams || {});
+  const queryString = qs.stringify(cleanedParams, {
+    skipEmptyString: true,
+    skipNull: true,
+    sort: false
+  });
+  return `${config.baseUrl}${queryString ? "?" : ""}${queryString}`;
+}
+export function parseQueryParams(search) {
+  return qs.parse(search);
+}

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

@@ -0,0 +1,2 @@
+export declare function mergeUrlParams<Params extends Record<string, any> = Record<string, any>>(baseParams: Params, userParams: Partial<Params>): Params;
+export declare function cleanParams(params: Record<string, any>, defaultParams: Record<string, any>): Record<string, any>;

package/dist/query-params/utils.js

@@ -0,0 +1,19 @@
+export function mergeUrlParams(baseParams, userParams) {
+  return Object.keys(baseParams).reduce((result, key) => {
+    if (Array.isArray(baseParams[key])) {
+      result[key] = Array.from(/* @__PURE__ */ new Set([...baseParams[key], ...userParams[key] || []]));
+    } else {
+      result[key] = typeof userParams[key] !== "undefined" ? userParams[key] : baseParams[key];
+    }
+    return result;
+  }, {});
+}
+export 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;
+}

package/package.json

@@ -0,0 +1,81 @@
+{
+  "name": "@stephenchenorg/astro",
+  "type": "module",
+  "version": "1.0.0",
+  "description": "Stephenchenorg Astro 前端通用套件",
+  "license": "MIT",
+  "homepage": "https://stephenchenorg-astro.netlify.app",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/stephenchenorg/astro.git"
+  },
+  "keywords": [
+    "astro"
+  ],
+  "exports": {
+    "./api": {
+      "types": "./dist/api/index.d.ts",
+      "import": "./dist/api/index.js"
+    },
+    "./company-setting": {
+      "types": "./dist/company-setting/index.d.ts",
+      "import": "./dist/company-setting/index.js"
+    },
+    "./image": {
+      "types": "./dist/image/index.d.ts",
+      "import": "./dist/image/index.js"
+    },
+    "./page": {
+      "types": "./dist/page/index.d.ts",
+      "import": "./dist/page/index.js"
+    },
+    "./pagination": {
+      "types": "./dist/pagination/index.d.ts",
+      "import": "./dist/pagination/index.js"
+    },
+    "./query-params": {
+      "types": "./dist/query-params/index.d.ts",
+      "import": "./dist/query-params/index.js"
+    }
+  },
+  "typesVersions": {
+    "*": {
+      "*": [
+        "./dist/*"
+      ]
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "mkdist --declaration --ext=js",
+    "code-check": "astro check",
+    "prepack": "npm run build",
+    "release": "bumpp --commit \"Release v%s\" && npm publish"
+  },
+  "peerDependencies": {
+    "astro": "^5.0.0"
+  },
+  "dependencies": {
+    "awesome-graphql-client": "^2.1.0",
+    "graphql": "^16.10.0",
+    "graphql-tag": "^2.12.6",
+    "nanostores": "^0.11.4",
+    "query-string": "^9.1.1"
+  },
+  "devDependencies": {
+    "@astrojs/check": "^0.9.4",
+    "@graphql-typed-document-node/core": "^3.2.0",
+    "astro": "^5.3.1",
+    "bumpp": "^10.0.3",
+    "mkdist": "^2.2.0",
+    "typescript": "~5.7.2"
+  }
+}