feat(utils): sourceMappingURL

src/utils/__tests__/source-mapping-url.util.spec.ts

@@ -0,0 +1,33 @@
+import type { Testcase } from '@tests/utils/types'
+import type { SourceMapComment } from '@trext/types'
+import testSubject from '../source-mapping-url.util'
+
+/**
+ * @file Unit Tests - sourceMappingURL
+ * @module trext/utils/tests/unit/sourceMappingURL
+ */
+
+describe('unit:utils/sourceMappingURL', () => {
+  type Case = Testcase<SourceMapComment> & {
+    filename: string
+    ext: string | undefined
+  }
+
+  const cases: Case[] = [
+    {
+      expected: '//# sourceMappingURL=dog.interface.js',
+      ext: undefined,
+      filename: 'dog.interface.js'
+    }
+  ]
+
+  const name = "should return source map comment given ['$filename',$ext]"
+
+  it.each<Case>(cases)(name, testcase => {
+    // Arrange
+    const { expected, ext, filename } = testcase
+
+    // Act + Expect
+    expect(testSubject(filename, ext)).toBe(expected)
+  })
+})

src/utils/index.ts

@@ -5,3 +5,4 @@
 
 export { default as ignore404 } from './ignore-404.util'
 export { default as saveFile } from './save-file.util'
+export { default as sourceMappingURL } from './source-mapping-url.util'

src/utils/source-mapping-url.util.ts

@@ -0,0 +1,20 @@
+import { SourceMapComment } from '@trext/types'
+import path from 'path'
+
+/**
+ * @file Utilities - sourceMappingURL
+ * @module trext/utils/sourceMappingURL
+ */
+
+/**
+ * Returns a source map comment.
+ *
+ * @param {string} filename - Name of source file
+ * @param {string} [ext] - Extension to remove
+ * @return {SourceMapComment} Comment referencing a source map
+ */
+const sourceMappingURL = (filename: string, ext?: string): SourceMapComment => {
+  return `//# sourceMappingURL=${path.basename(filename, ext)}`
+}
+
+export default sourceMappingURL