@topik/core 0.1.0-alpha.4 → 0.1.0-alpha.6

package/dist/course-navigation.d.mts

@@ -0,0 +1,52 @@
+//#region src/course-navigation.d.ts
+/** @internal Logical page sources become Markdown files and must agree on directory spelling. */
+export declare function validateCoursePageSources(paths: readonly string[]): boolean;
+/** Portable reference context for one Course, independent of filesystem access. */
+export type CourseReferenceContext = {
+  course: string;
+  modules: readonly {
+    name: string;
+    slug: string;
+  }[];
+  pages: readonly {
+    name: string;
+    module: string;
+    slug: string;
+    sourcePath: string;
+  }[];
+};
+export type ResolvedCoursePage = {
+  page: string;
+  module: string;
+  route: string;
+  sourcePath: string;
+};
+export type ResolvedCourseNavigation = {
+  course: string;
+  pages: readonly ResolvedCoursePage[];
+  pageByName: ReadonlyMap<string, ResolvedCoursePage>;
+  pageByRoute: ReadonlyMap<string, ResolvedCoursePage>;
+  pageBySourcePath: ReadonlyMap<string, ResolvedCoursePage>;
+};
+export type ResolvedCourseContentLink = {
+  page: ResolvedCoursePage;
+  route: string;
+  hash: string;
+  search: string;
+};
+export type ResolvedCourseContentReference = {
+  kind: "page";
+  target: ResolvedCourseContentLink;
+} | {
+  kind: "asset";
+} | {
+  kind: "external";
+} | {
+  kind: "unresolved";
+};
+/** Public routes use module/page slugs; Markdown links use explicit logical source paths. */
+export declare function resolveCourseNavigation(context: CourseReferenceContext): ResolvedCourseNavigation;
+export declare function resolveCourseContentReference(href: string, currentPageName: string, resolved: ResolvedCourseNavigation): ResolvedCourseContentReference;
+/** Resolve relative source references or root-relative public routes without guessing files. */
+export declare function resolveCourseContentHref(href: string, currentPageName: string, resolved: ResolvedCourseNavigation): ResolvedCourseContentLink | null;
+//#endregion

package/dist/course-navigation.mjs

@@ -0,0 +1 @@
+export { t as resolveCourseContentHref, n as resolveCourseContentReference, r as resolveCourseNavigation, i as validateCoursePageSources } from "./course-navigation-CWlVc0a0.mjs";

package/dist/folder-links-DI4xfipU.mjs

@@ -0,0 +1,57 @@
+//#region src/folder-links.ts
+/** Resolve decoded source paths consistently without URL root-clamping or Node-only APIs. */
+function resolveNavigationPath(href, sourcePath, directory = "") {
+	if (/^[a-z][a-z0-9+.-]*:/i.test(href) || href.startsWith("//")) return void 0;
+	try {
+		const path = decodeURIComponent(href.split(/[?#]/, 1)[0]);
+		const base = path.startsWith("/") ? directory : sourcePath.split("/").slice(0, -1).join("/");
+		const relative = path.startsWith("/") ? path.slice(1) : path || sourcePath.split("/").at(-1);
+		const parts = [];
+		for (const part of `${base}/${relative}`.split("/")) {
+			if (!part || part === ".") continue;
+			if (part === "..") {
+				if (!parts.length) return void 0;
+				parts.pop();
+			} else parts.push(part);
+		}
+		if (!parts.length && (isFolderHref(href) || path === "/")) return "";
+		return parts.length ? parts.join("/") : void 0;
+	} catch {
+		return;
+	}
+}
+/** Folder shorthand selects declared content, never an arbitrary directory listing. */
+function folderLandingCandidates(directory, pages) {
+	const prefix = directory ? `${directory}/` : "";
+	return [...pages].filter(([path]) => path.startsWith(prefix) && /^(?:index|readme)$/i.test(path.slice(prefix.length))).map(([, page]) => page);
+}
+function hasDeclaredFolder(directory, pages) {
+	const prefix = directory ? `${directory}/` : "";
+	return [...pages.keys()].some((path) => path.startsWith(prefix));
+}
+/** Explicit Markdown filenames retain their historical trailing-separator spelling. */
+function isFolderHref(href) {
+	const pathname = href.split(/[?#]/, 1)[0];
+	try {
+		const path = decodeURIComponent(pathname);
+		if (path === "/") return false;
+		return !/\.(?:mdx?|markdown)\/*$/i.test(path) && (path.endsWith("/") || /(?:^|\/)\.{1,2}$/.test(path));
+	} catch {
+		return /(?:\/|%2f)$|(?:^|\/|%2f)(?:\.|%2e){1,2}$/i.test(pathname);
+	}
+}
+function resolveDeclaredSourcePage(path, pages, folder = false) {
+	if (!folder && !hasDeclaredFolder(path, pages)) return pages.get(path);
+	const candidates = folderLandingCandidates(path, pages);
+	return candidates.length === 1 ? candidates[0] : void 0;
+}
+/** Wiki's index aliases are public routes in every consumer, including compilation. */
+function resolveDeclaredPublicRoute(href, pages, wiki = false) {
+	if (!href.startsWith("/") || isFolderHref(href)) return void 0;
+	const path = resolveNavigationPath(href, "");
+	if (path === void 0 || /\.(?:mdx?|markdown)$/i.test(path)) return void 0;
+	const route = wiki ? path === "index" ? "" : path.replace(/\/index$/, "") : path;
+	return pages.get(route);
+}
+//#endregion
+export { resolveDeclaredSourcePage as a, resolveDeclaredPublicRoute as i, hasDeclaredFolder as n, resolveNavigationPath as o, isFolderHref as r, folderLandingCandidates as t };