feat: enhance file name transformer with additional options

[satnaing]

Description

• Add v2 badge-style option as alternative to v1 tab-style
• v2 features: border, rounded corners, positioned with CSS custom property
• v1 features: tab-style with rounded top corners, muted background
• Add hideDot option to control green dot indicator visibility
• Include comprehensive JSDoc documentation with usage examples
• Support both styling variants with configuration parameters

Comparison: v1 and v2

v1	v2

V1

export default defineConfig({
  // ...
  markdown: {
    // ...
    shikiConfig: {
      // ...
      transformers: [
        transformerFileName({ style: "v1", hideDot: false }),
        transformerNotationHighlight(),
        transformerNotationWordHighlight(),
        transformerNotationDiff({ matchAlgorithm: "v3" }),
      ],
    },
  },
  // ...
});

V2

export default defineConfig({
  // ...
  markdown: {
    // ...
    shikiConfig: {
      // ...
      transformers: [
        transformerFileName({ style: "v2", hideDot: false }),
        transformerNotationHighlight(),
        transformerNotationWordHighlight(),
        transformerNotationDiff({ matchAlgorithm: "v3" }),
      ],
    },
  },
  // ...
});

Types of changes

• Bug Fix (non-breaking change which fixes an issue)
• New Feature (non-breaking change which adds functionality)
• Documentation Update (if none of the other choices apply)
• Others (any other types not listed above)

Checklist

• I have read the Contributing Guide
• I have added the necessary documentation (if appropriate)
• Breaking Change (fix or feature that would cause existing functionality to not work as expected)

[cloudflare-workers-and-pages]

Deploying astro-paper with    Cloudflare Pages

Latest commit:	b16c7c7
Status:	✅  Deploy successful!
Preview URL:	https://7a322309.astro-paper.pages.dev
Branch Preview URL:	https://feat-enhance-file-name-trans.astro-paper.pages.dev

View logs